# Akamai DataStream 2

### **Leverans av Akamai DataStream 2-loggar till S3**

För att skicka åtkomstloggar från Akamai till en Amazon S3-bucket kan du använda **Akamai DataStream 2**, som är Akamais standard och rekommenderade metod för loggleverans i realtid. Nedan finns de dokumenterade stegen med fokus på att konfigurera **DataStream 2**, med konfigurationsvägledning specifik för leverans till en S3-bucket som hostas av Netacea.

### Förutsättningar

För att framgångsrikt strömma webbtrafik-loggar till Netacea, säkerställ följande:

* Du har ett aktivt Akamai-konto med full åtkomst till Akamai Dashboard.
* Akamai DataStream 2 är aktiverat.

{% hint style="info" %}
DataStream 2 ingår i innehållsleverans och medför ingen extra kostnad. För att aktivera denna funktion, kontakta ditt Akamai-kontoteam.
{% endhint %}

* Du har fått nödvändiga AWS S3-bucket-uppgifter (bucket-sökväg, namn, region och autentiseringsuppgifter) från Netacea. Dessa finns [här](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Du känner till de [minimalt nödvändiga fälten i datasetet](#step-2-data-set) som Netacea behöver för logganalys.

## Konfiguration av DataStream 2

Följ Akamais dokumentation som finns [här](https://techdocs.akamai.com/datastream2/docs/quick-start) för att skapa och aktivera en DataStream 2-ström, baserat på följande konfiguration:

#### Steg 1: Konfiguration

Använd fliken **Configuration** för att ange grundläggande strömdetaljer och välja de egenskaper du vill övervaka.

#### Steg 2: Datauppsättning

Under konfigurationssteget för datauppsättningen, använd följande minimala datauppsättning som definieras av Netacea:

| **Obligatoriskt fält**                         | **Beskrivning**                                                                                                                                  |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Request time                                   | Tidpunkten då förfrågan mottogs                                                                                                                  |
| Bytes                                          | Antalet bytes som skickades som del av användarens förfrågan                                                                                     |
| Client IP                                      | IP-adressen från vilken förfrågan gjordes                                                                                                        |
| HTTP status codes                              | HTTP-statuskoden som returnerades av servern                                                                                                     |
| Protocol type                                  | Protokollet för förfrågan-svar-cykeln.                                                                                                           |
| Request host                                   | Värdet på host-headern i förfrågan                                                                                                               |
| Request method                                 | HTTP-metoden för förfrågan                                                                                                                       |
| Request path                                   | Sökvägen till den begärda resursen                                                                                                               |
| Query string                                   | Förfrågans frågesträng                                                                                                                           |
| User-Agent<mark style="color:red;">\*</mark>   | User agent-strängen som skickas i headern av klienten                                                                                            |
| Referer<mark style="color:red;">\*</mark>      | Webbsidan som användaren följde en länk från                                                                                                     |
| Turn around time                               | Den förflutna tiden i millisekunder mellan när den sista förfrågningshuvudet tas emot och den första byten av svaret skrivs till klientsocketen. |
| Custom field<mark style="color:red;">\*</mark> | Detta fält stöder variabler och krävs för att logga anpassade Netacea-specifika fält.                                                            |
| True-Client-IP\*\*                             | Den betrodda källan för den ursprungliga klient-IP:n                                                                                             |
| X-Forwarded-For\*\*                            | Anslutande IP-adress \[array] för en klientförfrågan, om den går via proxy                                                                       |

\*För att övervaka dessa fält måste du aktivera loggning av anpassade datauppsättningsparametrar i beteendet **Log Request Details** för den associerade Akamai-egenskapen. Se [Logga anpassade parametrar](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters) för mer information.

\*\* Användbart när proxyer finns i trafikvägen från klient > ursprung

{% hint style="warning" %}
Säkerställ att du väljer **JSON** som loggformat.
{% endhint %}

#### Steg 3: Leverans

1. Välj **Amazon S3** som destination.
2. I **Name**, ange en läsbar beskrivning för destinationen.
3. I **Bucket**, ange namnet på relevant S3-bucket som hostas av Netacea.
4. I **Folder path**, fyll i med "**`logs/"`** om inte annat anges av Netacea.
5. I **Region**, ange AWS-regionkoden där bucketen finns. Detta bör vara `eu-west-1` (gemener) om inte annat anges.
6. I **Access key ID** och **Secret access key**, ange autentiseringsuppgifterna som tillhandahålls av Netacea.
7. Klicka på **Validate & Save** för att validera anslutningen till destinationen och spara konfigurationen.
8. Säkerställ att **Push frequency** är inställd på lägsta möjliga värde.

#### Steg 4: Sammanfattning och aktivering

1. På fliken **Summary**, granska alla konfigurerade detaljer noggrant.
2. När allt är bekräftat, markera rutan **Activate stream upon saving**.
3. Klicka på **Save stream** för att slutföra konfigurationen.

#### Steg 5: Aktivera DataStream via en regel

Aktivering av strömmen kan ta upp till en timme. Data kommer dock endast att samlas in och strömmas **efter** att du har lagt till och aktiverat [DataStream-beteendet](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) via en regel i din webbplats egenskapskonfiguration.

Gör så här:

1. Skapa en ny egenskapsversion av din för närvarande aktiva egenskap.
2. Redigera den nya versionen.
3. Under **Property Configuration Settings**, klicka på **+Rules** för att lägga till en ny regel.
4. Välj **Blank Rule Template**, ange ett meningsfullt namn och klicka på **Insert Rule**.

<figure><img src="https://1757243805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGUMNWETAzwSHwJ2JpW3%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>

**Konfigurera regeln**

* **Kriterieavsnitt**\
  Lägg till följande matchningsvillkor:
  * **If Hostname is one of `<hostname>`**

<figure><img src="https://1757243805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGUMNWETAzwSHwJ2JpW3%2Fuploads%2Fgit-blob-abf200ab839be8f43c24f23110fc719b3c059867%2Fimage%20(9)%20(3).png?alt=media" alt=""><figcaption><p>Regelkriterier</p></figcaption></figure>

{% hint style="info" %}
Om Netacea övervakar flera webbplatser kan du inkludera flera värdnamn. Inkludera endast de som är avsedda att övervakas av den DataStream som skapades tidigare.
{% endhint %}

**Beteendeavsnitt**

* Lägg till ett beteende för att **aktivera den DataStream** som skapades tidigare.

  > Du kan också duplicera och återanvända en befintlig regel om det är lämpligt.

<figure><img src="https://1757243805-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYGUMNWETAzwSHwJ2JpW3%2Fuploads%2Fgit-blob-10d0e74a162432cba13d424d98267487b6e7a857%2Fimage%20(1)%20(1)%20(3).png?alt=media" alt=""><figcaption><p>Regelbeteenden</p></figcaption></figure>

* Lägg till ett annat beteende: **Log Request Details**
  * Ställ in **Include Custom Log Field** till `on`
  * Ställ in **Custom Log Field** till `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

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

DataStream och tillhörande regel är nu skapade.

{% hint style="info" %}
**Upprepa ovanstående procedur för varje separat webbplats (eller grupp av webbplatser) som Netacea kommer att övervaka.**
{% endhint %}

### Aktivera egenskapen

När alla DataStreams och regler har skapats, klicka på **Save** och använd fliken **Activate** för att aktivera (distribuera) dina ändringar till egenskapens konfiguration.

{% hint style="success" %}
Övervakningskonfigurationen kommer nu att distribueras på den egenskap den konfigurerades mot. Du kan bekräfta att distributionen är korrekt genom att:

* Be Netacea granska interna övervakningsmätvärden.
* Be Netacea validera datainnehåll och format.
  {% endhint %}

### Slutsteg

När loggleveransen är aktiv, **meddela din Netacea Solutions Engineer**. Detta gör att vi kan:

* Bekräfta mottagande av data
* Validera datauppsättningens format och fullständighet
* Påbörja analys när en tillräcklig datavolym har samlats in

Om du behöver support under konfigurationen finns Netacea SE-teamet här för att hjälpa till — tveka inte att höra av dig.