# Monitoring-Konfiguration

## Voraussetzungen

Um Web-Traffic-Protokolle erfolgreich an Netacea zu streamen, stellen Sie bitte sicher, dass Sie Folgendes haben:

* Ein aktives Akamai-Konto mit vollem Zugriff auf das Akamai Dashboard.
* Akamai DataStream 2 aktiviert.

{% hint style="info" %}
DataStream 2 ist in der Content-Delivery enthalten und verursacht keine zusätzlichen Kosten. Um diese Funktion zu aktivieren, wenden Sie sich an Ihr Akamai-Account-Team.
{% endhint %}

* Eine Liste der Schutz-Anwendungsfälle und der Pfade, die für jeden anfällig sind, bereitgestellt.
* Eine Liste aller bekannten, sicheren und auf der Whitelist stehenden Benutzer bereitgestellt. Dies umfasst eine Liste vertrauenswürdiger Bots, IPs und Geolocations. Informationen über bekannte böswillige Akteure sind ebenfalls wertvoll.
* Die Details (Bucket-Pfad, Name, Standort, Anmeldedaten) eines von Netacea gehosteten und bereitgestellten AWS S3 Buckets erhalten.

## DataStream 2-Konfiguration

Bitte folgen Sie der Akamai-Dokumentation [hier](https://techdocs.akamai.com/datastream2/docs/quick-start), um einen DataStream 2-Stream basierend auf der folgenden Konfiguration zu erstellen und zu aktivieren:

### Schritt 1: Konfiguration

Verwenden Sie die Registerkarte **Configuration**, um grundlegende Stream-Details einzugeben und alle Properties auszuwählen, die Sie überwachen möchten.

### Schritt 2: Data Set

Verwenden Sie während des Data Set-Konfigurationsschritts das folgende von Netacea definierte Mindest-Data-Set:

| **Erforderliches Feld**                        | **Beschreibung**                                                                                                                                             |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Request time                                   | Die Zeit, zu der die Anfrage empfangen wurde                                                                                                                 |
| Bytes                                          | Die Bytes, die als Teil der Benutzeranfrage gesendet wurden                                                                                                  |
| Client IP                                      | Die IP-Adresse, von der die Anfrage gestellt wurde                                                                                                           |
| HTTP status codes                              | Der vom Server zurückgegebene HTTP-Statuscode                                                                                                                |
| Protocol type                                  | Das Protokoll des Request-Response-Zyklus.                                                                                                                   |
| Request host                                   | Der Wert des Host-Headers in der Anfrage                                                                                                                     |
| Request method                                 | Die HTTP-Methode der Anfrage                                                                                                                                 |
| Request path                                   | Der Pfad der angeforderten Ressource                                                                                                                         |
| Query string                                   | Der Query-String der Anfrage                                                                                                                                 |
| User-Agent<mark style="color:red;">\*</mark>   | Der vom Client im Header gesendete User-Agent-String                                                                                                         |
| Referer<mark style="color:red;">\*</mark>      | Die Webseite, von der der Benutzer einem Link gefolgt ist                                                                                                    |
| Turn around time                               | Die verstrichene Zeit in Millisekunden zwischen dem Empfang des letzten Request-Headers und dem Schreiben des ersten Bytes der Antwort an den Client-Socket. |
| Custom field<mark style="color:red;">\*</mark> | Dieses Feld unterstützt Variablen und ist erforderlich, um Netacea-spezifische benutzerdefinierte Felder zu protokollieren.                                  |

{% hint style="info" %} <mark style="color:red;">\*</mark>Um diese Felder zu überwachen, müssen Sie die Protokollierung benutzerdefinierter Data-Set-Parameter im **Log Request Details**-Behavior der zugehörigen Akamai-Property aktivieren. Siehe [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters) für weitere Details.
{% endhint %}

{% hint style="warning" %}
Stellen Sie sicher, dass Sie **JSON** als Log-Format auswählen.
{% endhint %}

### Schritt 3: Delivery

* Wählen Sie **Amazon S3** als Destination.
* Geben Sie unter **Name** eine verständliche Beschreibung für die Destination ein.
* Geben Sie unter **Bucket** den Namen des entsprechenden von Netacea gehosteten S3 Buckets ein.
* Füllen Sie unter **Folder path** dieses Feld mit „**logs/**", sofern von Netacea nicht anders angewiesen.
* Geben Sie unter **Region** den AWS-Regionscode ein, in der sich der Bucket befindet. Dies sollte eu-west-1 (alles in Kleinbuchstaben) sein, sofern von Netacea nicht anders angewiesen.
* Geben Sie unter **Access key ID** und **Secret access key** die Werte ein, die mit dem von Netacea bereitgestellten Amazon S3 Bucket verbunden sind.
* Klicken Sie auf **Validate & Save**, um die Verbindung zur Destination zu validieren und die von Ihnen eingegebenen Details zu speichern.
* Stellen Sie sicher, dass die **Push frequency** auf den niedrigstmöglichen Wert eingestellt ist.

### Schritt 4: Zusammenfassung und Aktivierung

Überprüfen Sie auf der Registerkarte **Summary** alle Details des konfigurierten Streams und stellen Sie sicher, dass Sie die obigen Anweisungen befolgt haben. Wenn Sie bereit sind, aktivieren Sie das Kontrollkästchen **Activate stream upon saving** und klicken Sie auf **Save stream.**

### Schritt 5: DataStream über eine Rule aktivieren

Die Aktivierung eines Streams **dauert bis zu einer Stunde**, aber er beginnt erst dann mit dem Sammeln und Streamen von Daten, nachdem Sie das [DataStream behavior](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) über eine Rule in Ihrer Property-Konfiguration, die die Website hostet, hinzugefügt und aktiviert haben. Befolgen Sie diese Schritte, um die Rule zur Aktivierung Ihres DataStreams zu erstellen:

* Erstellen Sie eine neue Property-Version Ihrer bestehenden aktiven Property-Version und bearbeiten Sie die neu erstellte Version.
* Wählen Sie unter **Property Configuration Settings** +Rules, um eine neue Rule zu erstellen
* Wählen Sie das **Blank Rule Template** und geben Sie einen aussagekräftigen Namen für die Rule ein, bevor Sie auf **Insert Rule** klicken.<br>

  <figure><img src="https://1167149896-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6PpNBgdOJ87TpWxJ29CQ%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>
* Fügen Sie im Abschnitt **Criteria** die folgende Matching-Rule hinzu: `If Hostname is one of <hostname>`.

{% hint style="info" %}
Wenn Netacea mehrere Websites überwacht, können Sie mehrere Hostnamen hinzufügen. Fügen Sie nur Hostnamen hinzu, die vom zuvor erstellten DataStream überwacht werden sollen.
{% endhint %}

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

* Fügen Sie im Abschnitt **Behaviors** ein Behavior hinzu und **aktivieren** Sie den zuvor erstellten DataStream.

{% hint style="info" %}
Eine bestehende Rule kann dupliziert und wiederverwendet werden.
{% endhint %}

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

* Fügen Sie zusätzlich ein neues **Log Request Details**-Behavior hinzu. Setzen Sie 'Include Custom Log Field' auf 'on' und Custom Log Field auf `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

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

Der DataStream und die zugehörige Rule sind nun erstellt.

{% hint style="info" %}
**Wiederholen Sie das obige Verfahren für jede separate Website (oder Gruppe von Websites), die Netacea überwachen wird.**
{% endhint %}

## Property aktivieren

Wenn alle DataStreams und Rules erstellt wurden, klicken Sie auf **Save** und verwenden Sie die Registerkarte **Activate**, um Ihre Änderungen an der Konfiguration der Property zu aktivieren (bereitzustellen).

{% hint style="success" %}
Die Monitoring-Konfiguration wird nun auf der Property bereitgestellt, für die sie konfiguriert wurde. Sie können bestätigen, dass die Bereitstellung korrekt ist, indem Sie:

* Netacea bitten, interne Monitoring-Metriken zu überprüfen.
* Netacea bitten, den Dateninhalt und das Format zu validieren.
  {% endhint %}