# Seurannan määritys

## Edellytykset

Verkkoliikenteen lokien onnistunut suoratoisto Netaecealle edellyttää seuraavaa:

* Aktiivinen Akamai-tili, jolla on täydet käyttöoikeudet Akamai-hallintapaneeliin.
* Akamai DataStream 2 on otettu käyttöön.

{% hint style="info" %}
DataStream 2 sisältyy sisällönjakeluun eikä siitä aiheudu lisäkustannuksia. Ota yhteyttä Akamai-tilivastaavaasi ottaaksesi tämän ominaisuuden käyttöön.
{% endhint %}

* Toimitettu luettelo suojauksen käyttötapauksista ja poluista, jotka ovat alttiita kullekin niistä.
* Toimitettu luettelo kaikista tunnetuista, turvallisista ja sallituista käyttäjistä. Tämä sisältää luettelon luotetuista boteista, IP-osoitteista ja maantieteellisistä sijainneista. Myös tiedot tunnetuista haitallisista toimijoista ovat arvokkaita.
* Saatu tiedot (bucket-polku, nimi, sijainti, tunnistetiedot) Netaecan isännöimästä ja toimittamasta AWS S3 -bucketista.

## DataStream 2:n määritys

Noudata Akamain dokumentaatiota, joka löytyy [täältä](https://techdocs.akamai.com/datastream2/docs/quick-start), luodaksesi ja aktivoidaksesi DataStream 2 -streamin seuraavan määrityksen mukaisesti:

### Vaihe 1: Määritys

Käytä **Configuration**-välilehteä syöttääksesi streamin perustiedot ja valitaksesi ominaisuudet, joita haluat valvoa.

### Vaihe 2: Tietojoukko

Tietojoukon määritysvaiheessa käytä seuraavaa Netaecan määrittelemää vähimmäistietojoukkoa:

| **Pakollinen kenttä**                          | **Kuvaus**                                                                                                                                     |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Request time                                   | Aika, jolloin pyyntö vastaanotettiin                                                                                                           |
| Bytes                                          | Käyttäjän pyynnön osana lähetetyt tavut                                                                                                        |
| Client IP                                      | IP-osoite, josta pyyntö tehtiin                                                                                                                |
| HTTP status codes                              | Palvelimen palauttama HTTP-tilakoodi                                                                                                           |
| Protocol type                                  | Vastaus-pyyntö-syklin protokolla                                                                                                               |
| Request host                                   | Pyynnön host-otsikon arvo                                                                                                                      |
| Request method                                 | Pyynnön HTTP-metodi                                                                                                                            |
| Request path                                   | Pyydetyn resurssin polku                                                                                                                       |
| Query string                                   | Pyynnön kyselymerkkijono                                                                                                                       |
| User-Agent<mark style="color:red;">\*</mark>   | Asiakkaan otsikossa lähettämä user agent -merkkijono                                                                                           |
| Referer<mark style="color:red;">\*</mark>      | Verkkosivu, jolta käyttäjä seurasi linkkiä                                                                                                     |
| Turn around time                               | Kulunut aika millisekunteina viimeisen pyyntöotsikon vastaanottamisen ja vastauksen ensimmäisen tavun kirjoittamisen välillä asiakassokettiin. |
| Custom field<mark style="color:red;">\*</mark> | Tämä kenttä tukee muuttujia ja sitä tarvitaan mukautettujen Netacea-kohtaisten kenttien kirjaamiseen.                                          |

{% hint style="info" %} <mark style="color:red;">\*</mark>Näiden kenttien valvomiseksi sinun tulee ottaa käyttöön mukautettujen tietojoukkoparametrien kirjaaminen liittyvän Akamai-ominaisuuden **Log Request Details** -käyttäytymisessä. Katso lisätietoja kohdasta [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters).
{% endhint %}

{% hint style="warning" %}
Varmista, että valitset **JSON** lokimuodoksi.
{% endhint %}

### Vaihe 3: Toimitus

* Valitse **Amazon S3** kohteeksi.
* Syötä **Name**-kenttään ihmisen luettavissa oleva kuvaus kohteelle.
* Syötä **Bucket**-kenttään Netaecan isännöimän S3-bucketin nimi.
* Täytä **Folder path** -kenttään "**logs/**", ellei Netacea anna muita ohjeita.
* Syötä **Region**-kenttään AWS-aluekoodi, jossa bucket sijaitsee. Tämän tulisi olla eu-west-1 (kaikki pienaakkosin), ellei Netacea anna muita ohjeita.
* Syötä **Access key ID**- ja **Secret access key** -kenttiin Netaecan toimittamaan Amazon S3 -buckettiin liittyvät arvot.
* Napsauta **Validate & Save** vahvistaaksesi yhteyden kohteeseen ja tallentaaksesi antamasi tiedot.
* Varmista, että **Push frequency** on asetettu pienimpään mahdolliseen arvoon.

### Vaihe 4: Yhteenveto ja aktivointi

Tarkista **Summary**-välilehdellä kaikki määrittämäsi streamin tiedot ja varmista, että noudatat yllä olevia ohjeita. Kun olet valmis, valitse **Activate stream upon saving** -ruutu ja napsauta **Save stream.**

### Vaihe 5: DataStreamin käyttöönotto säännön kautta

Streamin aktivointi **kestää jopa tunnin**, mutta se alkaa kerätä ja suoratoistaa dataa vasta sen jälkeen, kun lisäät ja otat käyttöön [DataStream-käyttäytymisen](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) säännön kautta verkkosivuston isännöivässä ominaisuusmäärityksessä. Noudata näitä vaiheita luodaksesi säännön DataStreamin käyttöönottamiseksi:

* Luo uusi ominaisuusversio olemassa olevasta aktiivisesta ominaisuusversiosta ja muokkaa juuri luotua versiota.
* Valitse **Property Configuration Settings** -kohdassa +Rules luodaksesi uuden säännön
* Valitse **Blank Rule Template** ja anna säännölle kuvaava nimi ennen kuin napsautat **Insert Rule**.<br>

  <figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>
* Lisää **Criteria**-osioon seuraava vastaavuussääntö: `If Hostname is one of <hostname>`.

{% hint style="info" %}
Jos Netacea valvoo useita verkkosivustoja, voit lisätä useita isäntänimiä. Sisällytä vain isäntänimet, joita aiemmin luotu DataStream valvoo.
{% endhint %}

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-abf200ab839be8f43c24f23110fc719b3c059867%2Fimage%20(9)%20(3).png?alt=media" alt=""><figcaption><p>Säännön kriteerit</p></figcaption></figure>

* Lisää **Behaviors**-osioon käyttäytyminen ja **ota käyttöön** aiemmin luotu DataStream.

{% hint style="info" %}
Olemassa oleva sääntö voidaan kopioida ja käyttää uudelleen.
{% endhint %}

<figure><img src="https://656092103-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFxg3BbZHtg5d2d1nmEzK%2Fuploads%2Fgit-blob-10d0e74a162432cba13d424d98267487b6e7a857%2Fimage%20(1)%20(1)%20(3).png?alt=media" alt=""><figcaption><p>Säännön käyttäytymiset</p></figcaption></figure>

* Lisää myös uusi **Log Request Details** -käyttäytyminen. Aseta 'Include Custom Log Field' arvoon 'on' ja Custom Log Field arvoon `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

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

DataStream ja siihen liittyvä sääntö on nyt luotu.

{% hint style="info" %}
**Toista yllä oleva menettely jokaiselle erilliselle verkkosivustolle (tai verkkosivustoryhmälle), jota Netacea tulee valvomaan.**
{% endhint %}

## Ominaisuuden aktivointi

Kun kaikki DataStreamit ja säännöt on luotu, napsauta **Save** ja käytä **Activate**-välilehteä aktivoidaksesi (ottaaksesi käyttöön) muutoksesi ominaisuuden määritykseen.

{% hint style="success" %}
Valvontamääritys otetaan nyt käyttöön ominaisuudessa, jolle se määritettiin. Voit vahvistaa käyttöönoton oikeellisuuden:

* Pyytämällä Netaeceaa tarkistamaan sisäiset valvontamittarit.
* Pyytämällä Netaeceaa vahvistamaan datan sisällön ja muodon.
  {% endhint %}