# Seurannan määritys

### Edellytykset

Ennen kuin Netacea voi valvoa alustaasi onnistuneesti, varmista, että olet:

1. Toimittanut luettelon kaikista tunnetuista, turvallisista ja luotetuista käyttäjistä, kumppaneista ja kolmannen osapuolen sovelluksista. Tämä sisältää luettelon luotetuista boteista ja automatisoiduista työkaluista. Myös tiedot tunnetuista haitallisista toimijoista ovat arvokkaita.
2. Toimittanut luettelon suojauskäyttötapauksista ja poluista, jotka ovat alttiita kullekin niistä.
3. Saanut asiaankuuluvat lokien lähetyksen päätepisteet ja tunnistetiedot jaettua [Netacea-portaalin](https://docs.netacea.com/fi/netacea-laajennustiedot/accessing-your-integration-settings) kautta.

### Lokien suoratoiston käyttöönottovaiheet

* Kirjaudu sisään Fastly/Magento-verkkoliittymään.
* Siirry kohtaan Stores → Configuration → Advanced → System → Full Page Cache → Fastly Configuration → Tools → Real Time Log Streaming.
* Luo uusi reaaliaikainen lokien suoratoistotyö napsauttamalla "Create" kohdassa Create Endpoint, valitsemalla Amazon S3 ja napsauttamalla "Add".

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-07cb34c7b98389bb72ab1eef2b0f542c5e28e380%2Fimage%20(6)%20(2).png?alt=media" alt=""><figcaption></figcaption></figure>

* Täytä lokien suoratoistotyöhön seuraavat tiedot:

XLOCKX91\`\`\` {"@timestamp": "%{%Y-%m-%dT%H:%M:%S%z}t","bc\_type": %{if(req.http.netacea\_bctype\_string, "%u0022" + json.escape(req.http.netacea\_bctype\_string) + "%u0022", "null")}V,"bytes\_sent": "%B","cookie\_session\_status": %{if(req.http.x-netacea:cookie\_session\_status, "%u0022" + json.escape(req.http.x-netacea:cookie\_session\_status) + "%u0022", "null")}V,"client": "%{json.escape(client.ip)}V","domain": %{if(req.http.host, "%u0022" + json.escape(req.http.host) + "%u0022", "null")}V,"integration\_mode": %{"%u0022" + json.escape(req.http.x-netacea:integration\_mode) + "%u0022"}V,"integration\_type": %{if(req.http.integration\_type, "%u0022" + json.escape(req.http.integration\_type) + "%u0022", "null")}V,"integration\_version": %{if(req.http.integration\_version, "%u0022" + json.escape(req.http.integration\_version) + "%u0022", "null")}V,"method": "%{json.escape(req.method)}V","path": "%{json.escape(req.url.path)}V","mit\_svc\_latency":%{if(req.http.x-netacea:mit\_svc\_latency, "%u0022" + json.escape(req.http.x-netacea:mit\_svc\_latency) + "%u0022", "0")}V,"mit\_status":%{if(req.http.x-netacea:mit\_status, "%u0022" + json.escape(req.http.x-netacea:mit\_status) + "%u0022", "0")}V,"protocol": "%{json.escape(req.proto)}V","query": "%{json.escape(req.url.qs)}V","referrer": %{if(req.http.referer, "%u0022" + json.escape(req.http.referer) + "%u0022", "null")}V,"request\_time": %{time.elapsed}V,"status": "%{json.escape(resp.status)}V","user\_agent": %{if(req.http.user-agent, "%u0022" + json.escape(req.http.user-agent) + "%u0022", "null")}V,"user\_id": %{if(req.http.x-netacea-userid, "%u0022" + json.escape(req.http.x-netacea-userid) + "%u0022", "null")}V,"client\_ja3\_md5": %{if(tls.client.ja3\_md5, "%u0022" + json.escape(tls.client.ja3\_md5) + "%u0022", "null")}V,"x\_forwarded\_for": %{if(req.http.X-Forwarded-For, "%u0022" + json.escape(req.http.X-Forwarded-For) + "%u0022", "null")}V} \`\`\`92XLOCKXXLOCKX9798XLOCKX

<table><thead><tr><th width="216">Kenttä</th><th>Arvo</th></tr></thead><tbody><tr><td>Name</td><td>Anna päätepisteelle helposti muistettava ja ihmisluettava nimi, kuten Netacea_Logging.</td></tr><tr><td>Log Format</td><td><a href="#log-format">Log Format</a></td></tr><tr><td>Timestamp</td><td><a href="#undefined">Timestamp</a></td></tr><tr><td>Bucket Name</td><td>Netacean toimittama nimi</td></tr><tr><td>Access Key</td><td>Netacean toimittama käyttöavain</td></tr><tr><td>Secret Key</td><td>Netacean toimittama salainen avain</td></tr><tr><td>Path</td><td>Netacean toimittama polku</td></tr><tr><td>Domain</td><td>s3.eu-west-1.amazonaws.com</td></tr><tr><td>Log Line Format</td><td>Tyhjä</td></tr><tr><td>Compression</td><td>Gzip</td></tr><tr><td>GZIP Level</td><td></td></tr><tr><td>Period</td><td></td></tr></tbody></table>

{% hint style="warning" %}
Jos Shielding on käytössä Fastly-isännille, lue alla oleva kappale "Shielding-huomioitavaa" ennen lokituspäätepisteen luomista.
{% endhint %}

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-367810b88d1d79f38320d144aca452ee527996a5%2Fimage%20(22).png?alt=media" alt=""><figcaption></figcaption></figure>

#### **Log Format**

{% code overflow="wrap" %}

```
{"@timestamp": "%{%Y-%m-%dT%H:%M:%S%z}t","bc_type": %{if(req.http.netacea_bctype_string, "%u0022" + json.escape(req.http.netacea_bctype_string) + "%u0022", "null")}V,"bytes_sent": "%B","cookie_session_status": %{if(req.http.x-netacea:cookie_session_status, "%u0022" + json.escape(req.http.x-netacea:cookie_session_status) + "%u0022", "null")}V,"client": "%{json.escape(client.ip)}V","domain": %{if(req.http.host, "%u0022" + json.escape(req.http.host) + "%u0022", "null")}V,"integration_mode": %{"%u0022" + json.escape(req.http.x-netacea:integration_mode) + "%u0022"}V,"integration_type": %{if(req.http.integration_type, "%u0022" + json.escape(req.http.integration_type) + "%u0022", "null")}V,"integration_version": %{if(req.http.integration_version, "%u0022" + json.escape(req.http.integration_version) + "%u0022", "null")}V,"method": "%{json.escape(req.method)}V","path": "%{json.escape(req.url.path)}V","mit_svc_latency":%{if(req.http.x-netacea:mit_svc_latency, "%u0022" + json.escape(req.http.x-netacea:mit_svc_latency) + "%u0022", "0")}V,"mit_status":%{if(req.http.x-netacea:mit_status, "%u0022" + json.escape(req.http.x-netacea:mit_status) + "%u0022", "0")}V,"protocol": "%{json.escape(req.proto)}V","query": "%{json.escape(req.url.qs)}V","referrer": %{if(req.http.referer, "%u0022" + json.escape(req.http.referer) + "%u0022", "null")}V,"request_time": %{time.elapsed}V,"status": "%{json.escape(resp.status)}V","user_agent": %{if(req.http.user-agent, "%u0022" + json.escape(req.http.user-agent) + "%u0022", "null")}V,"user_id": %{if(req.http.x-netacea-userid, "%u0022" + json.escape(req.http.x-netacea-userid) + "%u0022", "null")}V,"client_ja3_md5": %{if(tls.client.ja3_md5, "%u0022" + json.escape(tls.client.ja3_md5) + "%u0022", "null")}V,"x_forwarded_for": %{if(req.http.X-Forwarded-For, "%u0022" + json.escape(req.http.X-Forwarded-For) + "%u0022", "null")}V}
```

{% endcode %}

#### Timestamp

```
%Y-%m-%dT%H:%M:%S.000
```

### Shielding-huomioitavaa

Fastly mahdollistaa käyttäjille isännän ominaisuuden nimeltä "[Shielding](https://developer.fastly.com/learning/concepts/shielding/)" käyttöönoton, jolla on etuja kuten alkuperäkuorman vähentäminen, välimuistin osumaprosentin parantaminen jne. Tämän ominaisuuden käyttöönotto Fastly-palvelussa, joka käyttää integraatiotamme, johtaa lokien kahdentumiseen, joita se lähettää Netacea-lokituksen kautta. Emme odota tätä.\
\
Tämän ongelman ratkaisemiseksi meidän on liitettävä Condition (ehto) Netacea-lokitukseen.

* Napsauta rataskuvaketta lokituspäätepisteen vieressä

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-626a51d81973b5103f49a8e33246896b0271301a%2Fimage%20(94).png?alt=media" alt=""><figcaption></figcaption></figure>

* Etsi ponnahdusikkunasta rivi "Condition" ja napsauta "Attach a condition"

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-1ced47a8c87470a821c3597ebd892061e06057a4%2Fimage%20(95).png?alt=media" alt=""><figcaption></figcaption></figure>

* Sen jälkeen voit napsauttaa "Create a new response condition"

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-c55046df2fc6c26dbd3016fc909858c3466b550b%2Fimage%20(96).png?alt=media" alt=""><figcaption></figcaption></figure>

* Avautuu ponnahdusikkuna, johon sinun tulee syöttää seuraavat tiedot:

<table><thead><tr><th width="186">Kenttä</th><th>Arvo</th></tr></thead><tbody><tr><td>Name</td><td>esim. Netacea_Log_Visit</td></tr><tr><td>Apply if</td><td><code>(req.url !~ "/media/" &#x26;&#x26; req.url !~ "/static/") &#x26;&#x26; fastly.ff.visits_this_service == 0</code></td></tr><tr><td>Priority</td><td>10 (oletus)</td></tr></tbody></table>

* Napsauta "Create". Sinun pitäisi nyt nähdä, että ehto on liitetty lokivirtaan

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-0bb08c3597bbc64934aad380df1765c689af14a9%2Fimage%20(97).png?alt=media" alt=""><figcaption></figcaption></figure>

* Nyt voit napsauttaa "Create" uudelleen, ja tämä päivittää lokituksen asianmukaisesti

### Viimeistely

Tarkista, että olet suorittanut seuraavat vaiheet:

* Määrittänyt[ lokien suoratoistuksen](#log-streaming) toimitettuun S3-säilöön
* Varmista, ettei virheilmoituksia näy

Olet nyt valmis ottamaan käyttöön napsauttamalla "Save Config"

{% hint style="info" %}
Välimuistin tyhjennys voidaan joskus tarvita. Tee tämä siirtymällä kohtaan System -> Cache Management ja napsauttamalla "Flush Magento Cache".
{% endhint %}

Valvonta on nyt otettu käyttöön Fastly/Magento-ympäristössä. Voit varmistaa, että käyttöönotto on aktiivinen:

* Tarkistamalla aktiivisen version uuden lokien lähetystyön osalta.
* Pyytämällä Netaceaa tarkistamaan sisäiset vastaanottojen mittarit.
* Pyytämällä Netaceaa validoimaan datan sisällön ja muodon.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.netacea.com/fi/netacea-laajennustiedot/fastly-magento/monitoring-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.