# Akamai DataStream 2

### **Akamai DataStream 2 -lokien toimitus S3:een**

Pääsylokien lähettämiseksi Akamaista Amazon S3 -ämpäriin voit käyttää **Akamai DataStream 2** -palvelua, joka on Akamain vakio- ja suositeltu menetelmä reaaliaikaiseen lokien toimitukseen. Alla on dokumentoidut vaiheet keskittyen **DataStream 2** -palvelun käyttöönottoon sekä konfigurointiohjeet erityisesti Netacea-isännöityyn S3-ämpäriin toimitusta varten.

### Edellytykset

Jotta verkkoliikenteen lokien suoratoisto Netacea-palveluun onnistuu, varmista seuraavat asiat:

* Sinulla on aktiivinen Akamai-tili ja täydet käyttöoikeudet Akamai Dashboardiin.
* Akamai DataStream 2 on käytössä.

{% hint style="info" %}
DataStream 2 sisältyy sisällöntoimitukseen ilman lisäkustannuksia. Ottaaksesi tämän ominaisuuden käyttöön, ota yhteyttä Akamai-asiakastiimiisi.
{% endhint %}

* Olet saanut tarvittavat AWS S3 -ämpärin tiedot (ämpäripolku, nimi, alue ja tunnistetiedot) Netacealta. Nämä löytyvät [täältä](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Olet tietoinen [vähimmäistietojoukkovaatimuksista](#step-2-data-set), joita Netacea tarvitsee lokianalyysiin.

## DataStream 2 -konfigurointi

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

#### Vaihe 1: Konfigurointi

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

#### Vaihe 2: Tietojoukko

Data Set -konfigurointivaiheessa käytä seuraavaa Netacean määrittämää vähimmäistietojoukkoa:

| **Pakollinen kenttä**                          | **Kuvaus**                                                                                                                                |
| ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Request time                                   | Aika, jolloin pyyntö vastaanotettiin                                                                                                      |
| Bytes                                          | Käyttäjän pyynnön yhteydessä 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 ensimmäisen vastaustavu kirjoittamisen välillä asiakassokettiin. |
| Custom field<mark style="color:red;">\*</mark> | Tämä kenttä tukee muuttujia ja se vaaditaan Netacea-spesifisten mukautettujen kenttien kirjaamiseen.                                      |
| True-Client-IP\*\*                             | Luotettu lähde alkuperäiselle asiakas-IP:lle                                                                                              |
| X-Forwarded-For\*\*                            | Asiakaspyynnön yhdistävä IP-osoite \[taulukko], jos välityspalvelimen kautta                                                              |

\*Näiden kenttien seurantaan sinun tulee ottaa käyttöön mukautettujen tietojoukkoproametrien kirjaaminen liitetyn Akamai-ominaisuuden **Log Request Details** -toiminnossa. Katso lisätietoja kohdasta [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters).

\*\* Hyödyllinen, kun välityspalvelimia on liikenteessä asiakkaalta > alkuperäpalvelimelle

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

#### Vaihe 3: Toimitus

1. Valitse **Amazon S3** kohteeksi.
2. Syötä **Name**-kenttään ihmisluettava kuvaus kohteelle.
3. Syötä **Bucket**-kenttään Netacean isännöimän S3-ämpärin nimi.
4. Täytä **Folder path** -kenttään "**`logs/"`**, ellei Netacea toisin ohjeista.
5. Syötä **Region**-kenttään AWS-aluekoodi, jossa ämpäri sijaitsee. Tämän tulisi olla `eu-west-1` (pienaakkosin), ellei toisin neuvota.
6. Syötä **Access key ID**- ja **Secret access key** -kenttiin Netacean toimittamat tunnistetiedot.
7. Klikkaa **Validate & Save** vahvistaaksesi yhteyden kohteeseen ja tallentaaksesi konfiguraation.
8. Varmista, että **Push frequency** on asetettu pienimpään mahdolliseen arvoon.

#### Vaihe 4: Yhteenveto ja aktivointi

1. Tarkista **Summary**-välilehdellä kaikki konfiguroidut tiedot huolellisesti.
2. Kun olet varmistanut tiedot, valitse **Activate stream upon saving** -valintaruutu.
3. Klikkaa **Save stream** viimeistelläksesi määrityksen.

#### Vaihe 5: Ota DataStream käyttöön säännön kautta

Virran aktivointi voi kestää jopa tunnin. Tietoja kerätään ja striimataan kuitenkin vasta **sen jälkeen**, kun olet lisännyt ja ottanut käyttöön [DataStream-toiminnon](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) säännön kautta sivustosi ominaisuuskonfiguraatiossa.

Tehdäksesi tämän:

1. Luo uusi ominaisuusversio nykyisestä aktiivisesta ominaisuudestasi.
2. Muokkaa uutta versiota.
3. Klikkaa **Property Configuration Settings** -kohdassa **+Rules** lisätäksesi uuden säännön.
4. Valitse **Blank Rule Template**, anna merkityksellinen nimi ja klikkaa **Insert Rule**.

<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>

**Konfiguroi sääntö**

* **Criteria-osio**\
  Lisää seuraava vastaavuusehto:
  * **If Hostname is one of `<hostname>`**

<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>

{% hint style="info" %}
Jos Netacea seuraa useita verkkosivustoja, voit sisällyttää useita isäntänimiä. Sisällytä vain ne, joita aiemmin luotu DataStream on tarkoitettu seuraamaan.
{% endhint %}

**Behaviors-osio**

* Lisää toiminto **ottaaksesi käyttöön aiemmin luodun DataStreamin**.

  > Voit myös kopioida ja käyttää uudelleen olemassa olevaa sääntöä tarvittaessa.

<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 toiminnot</p></figcaption></figure>

* Lisää toinen toiminto: **Log Request Details**
  * Aseta **Include Custom Log Field** arvoon `on`
  * Aseta **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 seuraamaan.**
{% endhint %}

### Aktivoi ominaisuus

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

{% hint style="success" %}
Seurantakonfiguraatio otetaan nyt käyttöön ominaisuudessa, johon se konfiguroitiin. Voit vahvistaa käyttöönoton oikeellisuuden:

* Pyytämällä Netaceaa tarkistamaan sisäiset seurantamittarit.
* Pyytämällä Netaceaa validoimaan tietosisällön ja -muodon.
  {% endhint %}

### Viimeiset vaiheet

Kun lokien toimitus on aktiivinen, **ilmoita asiasta Netacean Solutions Engineerille**. Tämä mahdollistaa:

* Tietojen vastaanoton vahvistamisen
* Tietojoukon muodon ja kattavuuden validoinnin
* Analyysin aloittamisen, kun riittävä määrä tietoa on kerätty

Jos tarvitset tukea käyttöönoton aikana, Netacean SE-tiimi on täällä auttamassa – älä epäröi ottaa yhteyttä.