# Akamai DataStream 2 ### **Akamai DataStream 2 Log-Bereitstellung an S3** Um Zugriffsprotokolle von Akamai an einen Amazon S3-Bucket zu senden, können Sie **Akamai DataStream 2** verwenden, das die standardmäßige und empfohlene Methode von Akamai für die Echtzeit-Protokollbereitstellung ist. Nachfolgend finden Sie die dokumentierten Schritte zur Einrichtung von **DataStream 2** mit Konfigurationshinweisen speziell für die Bereitstellung in einen von Netacea gehosteten S3-Bucket. ### Voraussetzungen Um Web-Traffic-Protokolle erfolgreich an Netacea zu streamen, stellen Sie bitte Folgendes sicher: * Sie haben ein aktives Akamai-Konto mit vollem Zugriff auf das Akamai Dashboard. * Akamai DataStream 2 ist aktiviert. {% hint style="info" %} DataStream 2 ist in der Content-Delivery-Lösung enthalten und verursacht keine zusätzlichen Kosten. Um diese Funktion zu aktivieren, wenden Sie sich an Ihr Akamai-Kontoteam. {% endhint %} * Sie haben die erforderlichen AWS S3-Bucket-Details (Bucket-Pfad, Name, Region und Anmeldedaten) von Netacea erhalten. Diese finden Sie [hier](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide). * Sie kennen die [minimalen erforderlichen Datenfeld](#step-2-data-set)-Felder, die Netacea für die Protokollanalyse benötigt. ## DataStream 2-Konfiguration Bitte folgen Sie der Akamai-Dokumentation, die Sie [hier](https://techdocs.akamai.com/datastream2/docs/quick-start) finden, 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 die Properties auszuwählen, die Sie überwachen möchten. #### Schritt 2: Datensatz Verwenden Sie während des Datensatz-Konfigurationsschritts den folgenden von Netacea definierten Mindestdatensatz: | **Erforderliches Feld** | **Beschreibung** | | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Request time | Der Zeitpunkt, zu dem die Anfrage empfangen wurde | | Bytes | Die als Teil der Benutzeranfrage gesendeten Bytes | | 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 Anfrage-Antwort-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\* | Der User-Agent-String, der vom Client im Header gesendet wurde | | Referer\* | Die Webseite, von der der Benutzer einem Link gefolgt ist | | Turn around time | Die verstrichene Zeit in Millisekunden zwischen dem Empfang des letzten Anfrage-Headers und dem Schreiben des ersten Bytes der Antwort in den Client-Socket. | | Custom field\* | Dieses Feld unterstützt Variablen und ist erforderlich, um Netacea-spezifische benutzerdefinierte Felder zu protokollieren. | | True-Client-IP\*\* | Die vertrauenswürdige Quelle der ursprünglichen Client-IP | | X-Forwarded-For\*\* | Verbindende IP-Adresse \[Array] einer Client-Anfrage, wenn diese über einen Proxy läuft | \*Um diese Felder zu überwachen, müssen Sie das Protokollieren benutzerdefinierter Datensatzparameter im **Log Request Details**-Verhalten der zugehörigen Akamai-Property aktivieren. Weitere Details finden Sie unter [Benutzerdefinierte Parameter protokollieren](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters). \*\* Nützlich, wenn Proxys zwischen Client und Origin geschaltet sind {% hint style="warning" %} Stellen Sie sicher, dass Sie **JSON** als Log-Format auswählen. {% endhint %} #### Schritt 3: Bereitstellung 1. Wählen Sie **Amazon S3** als Ziel aus. 2. Geben Sie unter **Name** eine verständliche Beschreibung für das Ziel ein. 3. Geben Sie unter **Bucket** den Namen des entsprechenden, von Netacea gehosteten S3-Buckets ein. 4. Geben Sie unter **Folder path** „**`logs/"`** ein, sofern von Netacea nicht anders angewiesen. 5. Geben Sie unter **Region** den AWS-Regionscode ein, in dem sich der Bucket befindet. Dies sollte `eu-west-1` (alles kleingeschrieben) sein, sofern nicht anders angegeben. 6. Geben Sie unter **Access key ID** und **Secret access key** die von Netacea bereitgestellten Anmeldedaten ein. 7. Klicken Sie auf **Validate & Save**, um die Verbindung zum Ziel zu validieren und die Konfiguration zu speichern. 8. Stellen Sie sicher, dass **Push frequency** auf den niedrigstmöglichen Wert eingestellt ist. #### Schritt 4: Zusammenfassung und Aktivierung 1. Überprüfen Sie auf der Registerkarte **Summary** sorgfältig alle konfigurierten Details. 2. Nach der Bestätigung aktivieren Sie das Kontrollkästchen **Activate stream upon saving**. 3. Klicken Sie auf **Save stream**, um die Einrichtung abzuschließen. #### Schritt 5: Aktivieren des DataStream über eine Regel Die Aktivierung des Streams kann bis zu einer Stunde dauern. Daten werden jedoch erst erfasst und gestreamt, **nachdem** Sie das [DataStream-Verhalten](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) über eine Regel in der Property-Konfiguration Ihrer Website hinzugefügt und aktiviert haben. Gehen Sie dazu wie folgt vor: 1. Erstellen Sie eine neue Property-Version Ihrer derzeit aktiven Property. 2. Bearbeiten Sie die neue Version. 3. Klicken Sie unter **Property Configuration Settings** auf **+Rules**, um eine neue Regel hinzuzufügen. 4. Wählen Sie die **Blank Rule Template**, geben Sie einen aussagekräftigen Namen ein und klicken Sie auf **Insert Rule**.
**Regel konfigurieren** * **Kriterien-Abschnitt**\ Fügen Sie die folgende Übereinstimmungsbedingung hinzu: * **If Hostname is one of ``**

Regelkriterien

{% hint style="info" %} Wenn Netacea mehrere Websites überwacht, können Sie mehrere Hostnamen angeben. Fügen Sie nur diejenigen ein, die vom zuvor erstellten DataStream überwacht werden sollen. {% endhint %} **Verhaltens-Abschnitt** * Fügen Sie ein Verhalten hinzu, um den zuvor erstellten **DataStream zu aktivieren**. > Sie können auch eine vorhandene Regel duplizieren und wiederverwenden, wenn dies angemessen ist.

Regelverhaltensweisungen

* Fügen Sie ein weiteres Verhalten hinzu: **Log Request Details** * Setzen Sie **Include Custom Log Field** auf `on` * Setzen Sie **Custom Log Field** auf `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

Log Request Details

Der DataStream und die zugehörige Regel 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 Regeln erstellt wurden, klicken Sie auf **Save** und verwenden Sie die Registerkarte **Activate**, um Ihre Änderungen an der Property-Konfiguration zu aktivieren (bereitzustellen). {% hint style="success" %} Die Überwachungskonfiguration 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 Überwachungsmetriken zu überprüfen. * Netacea bitten, den Dateninhalt und das Format zu validieren. {% endhint %} ### Abschließende Schritte Sobald die Protokollbereitstellung aktiv ist, **benachrichtigen Sie Ihren Netacea Solutions Engineer**. Dies ermöglicht uns: * Den Datenempfang zu bestätigen * Das Datensatzformat und die Vollständigkeit zu validieren * Mit der Analyse zu beginnen, sobald ein ausreichendes Datenvolumen erfasst wurde Wenn Sie während der Einrichtung Unterstützung benötigen, steht Ihnen das Netacea SE-Team gerne zur Verfügung – zögern Sie nicht, uns zu kontaktieren.