# Overvågningskonfiguration

## Forudsætninger

For at kunne streame webtrafiklogs til Netacea skal du sikre dig, at du har:

* En aktiv Akamai-konto med fuld adgang til Akamai Dashboard.
* Aktiveret Akamai DataStream 2.

{% hint style="info" %}
DataStream 2 er inkluderet i content delivery og medfører ingen ekstra omkostninger. For at aktivere denne funktion skal du kontakte dit Akamai-kontoteam.
{% endhint %}

* Leveret en liste over beskyttelses-use cases og de stier, der er sårbare over for hver.
* Leveret en liste over alle kendte, sikre og hvidlistede brugere. Dette inkluderer en liste over betroede bots, IP'er og geografiske placeringer. Eventuelle oplysninger om kendte ondsindede aktører er også værdifulde.
* Modtaget oplysningerne (bucket-sti, navn, placering, legitimationsoplysninger) for en AWS S3 Bucket, der hostes og leveres af Netacea.

## DataStream 2-konfiguration

Følg venligst Akamai-dokumentationen, der findes [here](https://techdocs.akamai.com/datastream2/docs/quick-start) for at oprette og aktivere en DataStream 2-stream baseret på følgende konfiguration:

### Trin 1: Konfiguration

Brug fanen **Configuration** til at indtaste grundlæggende stream-oplysninger og vælge eventuelle properties, du ønsker at overvåge.

### Trin 2: Datasæt

Under konfigurationstrinnet for datasæt skal du bruge følgende minimumsdatasæt, defineret af Netacea:

| **Påkrævet felt**                              | **Beskrivelse**                                                                                                                                    |
| ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| Request time                                   | Tidspunktet, hvor anmodningen blev modtaget                                                                                                        |
| Bytes                                          | De Bytes, der blev sendt som en del af brugerens anmodning                                                                                         |
| Client IP                                      | IP-adressen, hvorfra anmodningen blev foretaget                                                                                                    |
| HTTP status codes                              | HTTP-statuskoden returneret af serveren                                                                                                            |
| Protocol type                                  | Protokollen for anmodning-svar-cyklussen.                                                                                                          |
| Request host                                   | Værdien af host-headeren i anmodningen                                                                                                             |
| Request method                                 | HTTP-metoden for anmodningen                                                                                                                       |
| Request path                                   | Stien til den anmodede ressource                                                                                                                   |
| Query string                                   | Query-strengen for anmodningen                                                                                                                     |
| User-Agent<mark style="color:red;">\*</mark>   | User agent-strengen sendt i headeren af klienten                                                                                                   |
| Referer<mark style="color:red;">\*</mark>      | Websiden, som brugeren fulgte et link fra                                                                                                          |
| Turn around time                               | Den forløbne tid i millisekunder mellem modtagelsen af den sidste anmodningsheader og skrivningen af den første byte af svaret til klientsocketen. |
| Custom field<mark style="color:red;">\*</mark> | Dette felt understøtter variabler og er påkrævet for at logge brugerdefinerede Netacea-specifikke felter.                                          |

{% hint style="info" %} <mark style="color:red;">\*</mark>For at overvåge disse felter skal du aktivere logning af brugerdefinerede datasætparametre i **Log Request Details**-adfærden for den tilknyttede Akamai-property. Se [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters) for flere detaljer.
{% endhint %}

{% hint style="warning" %}
Sørg for at vælge **JSON** som logformat.
{% endhint %}

### Trin 3: Levering

* Vælg **Amazon S3** som destination.
* I **Name** skal du indtaste en læsbar beskrivelse af destinationen.
* I **Bucket** skal du indtaste navnet på den relevante S3 Bucket, der hostes af Netacea.
* I **Folder path** skal du udfylde dette med "**logs/**", medmindre Netacea instruerer anderledes.
* I **Region** skal du indtaste AWS-regionkoden, hvor bucketen befinder sig. Dette bør være eu-west-1 (alle små bogstaver), medmindre Netacea instruerer anderledes.
* I **Access key ID** og **Secret access key** skal du indtaste værdierne, der er knyttet til Amazon S3-bucketen leveret af Netacea.
* Klik på **Validate & Save** for at validere forbindelsen til destinationen og gemme de oplysninger, du har angivet.
* Sørg for, at **Push frequency** er sat til den lavest mulige værdi.

### Trin 4: Oversigt og aktivering

På fanen **Summary** skal du gennemgå alle detaljer for den stream, du har konfigureret, og sikre dig, at du følger ovenstående instruktioner. Når du er klar, skal du markere feltet **Activate stream upon saving** og klikke på **Save stream.**

### Trin 5: Aktivér DataStream via en regel

Aktivering af en stream **tager op til en time**, men den begynder først at indsamle og streame data, efter du har tilføjet og aktiveret [DataStream behavior](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) via en regel i din property-konfiguration, der hoster websitet. Følg disse trin for at oprette reglen til at aktivere din DataStream:

* Opret en ny property-version af din eksisterende aktive property-version, og rediger den nyoprettede version.
* Under **Property Configuration Settings** skal du vælge +Rules for at oprette en ny regel
* Vælg **Blank Rule Template** og angiv et meningsfuldt navn for reglen, før du klikker på **Insert Rule**.<br>

  <figure><img src="https://4249910968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUvBdg0TpfmPcaNVS4gPi%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>
* I sektionen **Criteria** skal du tilføje følgende matchningsregel: `If Hostname is one of <hostname>`.

{% hint style="info" %}
Hvis Netacea overvåger flere websites, kan du tilføje flere hostnavne. Inkludér kun hostnavne, der vil blive overvåget af den DataStream, der blev oprettet tidligere.
{% endhint %}

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

* I sektionen **Behaviors** skal du tilføje en adfærd og **aktivere** den DataStream, der blev oprettet tidligere.

{% hint style="info" %}
En eksisterende regel kan duplikeres og genbruges.
{% endhint %}

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

* Tilføj desuden en ny **Log Request Details**-adfærd. Sæt 'Include Custom Log Field' til 'on', og Custom Log Field sættes til `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

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

DataStream og den tilknyttede regel er nu oprettet.

{% hint style="info" %}
**Gentag ovenstående procedure for hvert separat website (eller gruppe af websites), som Netacea vil overvåge.**
{% endhint %}

## Aktivér propertyen

Når alle DataStreams og regler er oprettet, skal du klikke på **Save** og bruge fanen **Activate** til at aktivere (udrulning) dine ændringer til propertyens konfiguration.

{% hint style="success" %}
Overvågningskonfigurationen vil nu blive udrullet på den property, den blev konfigureret imod. Du kan bekræfte, at udrulningen er korrekt ved at:

* Anmode Netacea om at gennemgå interne overvågningsmetrikker.
* Anmode Netacea om at validere dataindhold og -format.
  {% endhint %}