# Monitoring Configuratie

## Vereisten

Om webverkeerslogboeken succesvol naar Netacea te streamen, dient u te beschikken over:

* Een actief Akamai-account met volledige toegang tot het Akamai Dashboard.
* Ingeschakelde Akamai DataStream 2.

{% hint style="info" %}
DataStream 2 is inbegrepen bij content delivery en brengt geen extra kosten met zich mee. Neem contact op met uw Akamai-accountteam om deze functie in te schakelen.
{% endhint %}

* Een verstrekte lijst met beschermingsscenario's en de paden die kwetsbaar zijn voor elk scenario.
* Een verstrekte lijst met alle bekende, veilige en op de whitelist geplaatste gebruikers. Dit omvat een lijst met vertrouwde bots, IP-adressen en geolocaties. Informatie over bekende kwaadwillende actoren is eveneens waardevol.
* De ontvangen gegevens (bucketpad, naam, locatie, inloggegevens) van een AWS S3 Bucket die wordt gehost en verstrekt door Netacea.

## 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 maken en 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 stap voor datasetconfiguratie de volgende minimale dataset, zoals gedefinieerd door Netacea:

| **Vereist veld**                               | **Beschrijving**                                                                                                                                                   |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Request time                                   | Het tijdstip waarop het verzoek werd ontvangen                                                                                                                     |
| Bytes                                          | De bytes die zijn 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 die door de server werd geretourneerd                                                                                                           |
| Protocol type                                  | Het protocol van de response-request-cyclus.                                                                                                                       |
| 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<mark style="color:red;">\*</mark>   | De user agent-string die in de header door de client wordt verzonden                                                                                               |
| Referer<mark style="color:red;">\*</mark>      | De webpagina van waaruit de gebruiker een link heeft gevolgd                                                                                                       |
| 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 client-socket. |
| Custom field<mark style="color:red;">\*</mark> | Dit veld ondersteunt variabelen en is vereist voor het loggen van aangepaste Netacea-specifieke velden.                                                            |

{% hint style="info" %} <mark style="color:red;">\*</mark>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 informatie.
{% endhint %}

{% hint style="warning" %}
Zorg ervoor dat u **JSON** selecteert als logformaat.
{% endhint %}

### Stap 3: Levering

* Selecteer **Amazon S3** als bestemming.
* Voer in **Name** een leesbare beschrijving in voor de bestemming.
* Voer in **Bucket** de naam in van de relevante S3 Bucket die door Netacea wordt gehost.
* Vul in **Folder path** "**logs/**" in, tenzij anders geïnstrueerd door Netacea.
* Voer in **Region** de AWS-regiocode in waar de bucket zich bevindt. Dit moet eu-west-1 zijn (volledig in kleine letters), tenzij anders geïnstrueerd door Netacea.
* Voer in **Access key ID** en **Secret access key** de waarden in die horen bij de Amazon S3-bucket die door Netacea is verstrekt.
* Klik op **Validate & Save** om de verbinding met de bestemming te valideren en de verstrekte gegevens op te slaan.
* Zorg ervoor dat de **Push frequency** is ingesteld op de laagst mogelijke waarde.

### Stap 4: Samenvatting en activering

Controleer op het tabblad **Summary** alle details van de stream die u hebt geconfigureerd en zorg ervoor dat u de bovenstaande instructies hebt gevolgd. Wanneer u gereed bent, vinkt u het vakje **Activate stream upon saving** aan en klikt u op **Save stream.**

### Stap 5: Schakel de DataStream in via een regel

Het activeren van een stream **duurt tot een uur**, maar deze begint pas met het verzamelen en streamen van gegevens nadat u het [DataStream-gedrag](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) hebt toegevoegd en ingeschakeld via een regel in uw property-configuratie die de website host. Volg deze stappen om de regel te maken voor het inschakelen van uw DataStream:

* Maak een nieuwe property-versie van uw bestaande actieve property-versie en bewerk de nieuw gemaakte versie.
* Selecteer onder **Property Configuration Settings** +Rules om een nieuwe regel te maken
* Selecteer de **Blank Rule Template** en geef een betekenisvolle naam op voor de regel voordat u op **Insert Rule** klikt.<br>

  <figure><img src="https://2008922765-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKEeLcLvicQ5Zj7Chjz6g%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>
* Voeg in de sectie **Criteria** de volgende matchregel toe: `If Hostname is one of <hostname>`.

{% hint style="info" %}
Als Netacea meerdere websites monitort, kunt u meerdere hostnamen toevoegen. Neem alleen hostnamen op die worden gemonitord door de DataStream die eerder is aangemaakt.
{% endhint %}

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

* Voeg in de sectie **Behaviors** een gedrag toe en **schakel** de DataStream in die eerder is aangemaakt.

{% hint style="info" %}
Een bestaande regel kan worden gedupliceerd en hergebruikt.
{% endhint %}

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

* Voeg daarnaast een nieuw **Log Request Details**-gedrag toe. Stel 'Include Custom Log Field' in op 'on' en Custom Log Field op `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

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

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 waarvoor deze is geconfigureerd. U kunt bevestigen dat de implementatie correct is door:

* Netacea te verzoeken interne monitoringmetrics te controleren.
* Netacea te verzoeken de data-inhoud en het formaat te valideren.
  {% endhint %}