# Akamai DataStream 2
### **Akamai DataStream 2 loglevering naar S3**
Om toegangslogs van Akamai naar een Amazon S3-bucket te verzenden, kunt u **Akamai DataStream 2** gebruiken. Dit is de standaard en aanbevolen methode van Akamai voor realtime loglevering. Hieronder vindt u de gedocumenteerde stappen gericht op het opzetten van **DataStream 2**, met configuratierichtlijnen specifiek voor levering naar een door Netacea gehoste S3-bucket.
### Vereisten
Om webverkeerlogs succesvol naar Netacea te streamen, dient u het volgende te waarborgen:
* U heeft een actief Akamai-account met volledige toegang tot het Akamai Dashboard.
* Akamai DataStream 2 is ingeschakeld.
{% hint style="info" %}
DataStream 2 is inbegrepen bij contentlevering en brengt geen extra kosten met zich mee. Neem contact op met uw Akamai-accountteam om deze functie in te schakelen.
{% endhint %}
* U heeft de benodigde AWS S3-bucketgegevens (bucketpad, naam, regio en inloggegevens) van Netacea ontvangen. Deze zijn [hier](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide) te vinden.
* U bent op de hoogte van de [minimaal vereiste dataset](#step-2-data-set)-velden die Netacea nodig heeft voor loganalyse.
## DataStream 2-configuratie
Volg de Akamai-documentatie die [hier](https://techdocs.akamai.com/datastream2/docs/quick-start) te vinden is om een DataStream 2-stream te creëren en te activeren, op basis van de volgende configuratie:
#### Stap 1: Configuratie
Gebruik het tabblad **Configuration** om basisstreamgegevens in te voeren en eventuele properties te kiezen die u wilt monitoren.
#### Stap 2: Dataset
Gebruik tijdens de Dataset-configuratiestap de volgende minimale dataset, gedefinieerd door Netacea:
| **Vereist veld** | **Beschrijving** |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Request time | Het tijdstip waarop het verzoek werd ontvangen |
| Bytes | De bytes verzonden als onderdeel van het verzoek van de gebruiker |
| Client IP | Het IP-adres van waaruit het verzoek werd gedaan |
| HTTP status codes | De HTTP-statuscode geretourneerd door de server |
| Protocol type | Het protocol van de verzoek-antwoordcyclus |
| Request host | De waarde van de host-header in het verzoek |
| Request method | De HTTP-methode van het verzoek |
| Request path | Het pad van de gevraagde resource |
| Query string | De querystring van het verzoek |
| User-Agent\* | De user-agentstring verzonden in de header door de client |
| Referer\* | De webpagina van waaruit de gebruiker een link volgde |
| Turn around time | De verstreken tijd in milliseconden tussen het ontvangen van de laatste request-header en het schrijven van de eerste byte van het antwoord naar de clientsocket |
| Custom field\* | Dit veld ondersteunt variabelen en is vereist voor het loggen van aangepaste Netacea-specifieke velden |
| True-Client-IP\*\* | De vertrouwde bron van het oorspronkelijke client-IP |
| X-Forwarded-For\*\* | Verbindend IP-adres \[array] van een clientverzoek, indien geproxied |
\*Om deze velden te monitoren moet u het loggen van aangepaste datasetparameters inschakelen in het **Log Request Details**-gedrag van de bijbehorende Akamai-property. Zie [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters) voor meer details.
\*\* Nuttig wanneer proxy's zich in de verkeerslijn van client > origin bevinden
{% hint style="warning" %}
Zorg ervoor dat u **JSON** selecteert als logformaat.
{% endhint %}
#### Stap 3: Levering
1. Selecteer **Amazon S3** als bestemming.
2. Voer in **Name** een leesbare beschrijving voor de bestemming in.
3. Voer in **Bucket** de naam in van de relevante S3-bucket die door Netacea wordt gehost.
4. Vul in **Folder path** "**`logs/"`** in, tenzij anders geïnstrueerd door Netacea.
5. Voer in **Region** de AWS-regiocode in waar de bucket zich bevindt. Dit moet `eu-west-1` (allemaal kleine letters) zijn, tenzij anders geadviseerd.
6. Voer in **Access key ID** en **Secret access key** de door Netacea verstrekte inloggegevens in.
7. Klik op **Validate & Save** om de verbinding met de bestemming te valideren en de configuratie op te slaan.
8. Zorg ervoor dat **Push frequency** is ingesteld op de laagst mogelijke waarde.
#### Stap 4: Samenvatting en activering
1. Controleer op het tabblad **Summary** alle geconfigureerde details zorgvuldig.
2. Vink na bevestiging het vakje **Activate stream upon saving** aan.
3. Klik op **Save stream** om de setup te voltooien.
#### Stap 5: Schakel de DataStream in via een regel
Het activeren van de stream kan tot een uur duren. Echter, data wordt alleen verzameld en gestreamd **nadat** u het [DataStream behavior](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) hebt toegevoegd en ingeschakeld via een regel in de property-configuratie van uw site.
Om dit te doen:
1. Maak een nieuwe property-versie van uw huidige actieve property.
2. Bewerk de nieuwe versie.
3. Klik onder **Property Configuration Settings** op **+Rules** om een nieuwe regel toe te voegen.
4. Selecteer de **Blank Rule Template**, geef een betekenisvolle naam en klik op **Insert Rule**.
**Configureer de regel**
* **Criteria-sectie**\
Voeg de volgende matchvoorwaarde toe:
* **If Hostname is one of ``**
Regelcriteria
{% hint style="info" %}
Als Netacea meerdere websites monitort, kunt u meerdere hostnamen opnemen. Neem alleen die hostnamen op die bedoeld zijn om gemonitord te worden door de eerder aangemaakte DataStream.
{% endhint %}
**Behaviors-sectie**
* Voeg een behavior toe om de eerder aangemaakte **DataStream in te schakelen**.
> U kunt ook een bestaande regel dupliceren en hergebruiken indien van toepassing.
Regelgedragen
* Voeg nog een behavior toe: **Log Request Details**
* Stel **Include Custom Log Field** in op `on`
* Stel **Custom Log Field** in op `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`
Log Request Details
De DataStream en bijbehorende regel zijn nu aangemaakt.
{% hint style="info" %}
**Herhaal de bovenstaande procedure voor elke afzonderlijke website (of groep websites) die Netacea zal monitoren.**
{% endhint %}
### Activeer de Property
Wanneer alle DataStreams en regels zijn aangemaakt, klikt u op **Save** en gebruikt u het tabblad **Activate** om uw wijzigingen aan de property-configuratie te activeren (implementeren).
{% hint style="success" %}
De monitoringconfiguratie wordt nu geïmplementeerd op de property waartegen deze is geconfigureerd. U kunt bevestigen dat de implementatie correct is door:
* Netacea te verzoeken interne monitoringmetrics te bekijken.
* Netacea te verzoeken de data-inhoud en het formaat te valideren.
{% endhint %}
### Laatste stappen
Zodra de loglevering actief is, **informeer uw Netacea Solutions Engineer**. Dit stelt ons in staat om:
* De ontvangst van data te bevestigen
* Het datasetformaat en de volledigheid te valideren
* Te beginnen met analyse zodra een voldoende volume aan data is verzameld
Als u ondersteuning nodig heeft tijdens de setup, staat het Netacea SE-team klaar om te helpen — aarzel niet om contact op te nemen.
%20(4).png?alt=media)
%20(3).png?alt=media)
%20(1)%20(3).png?alt=media)
.png?alt=media)