> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/de/insights/onsite/traffic/cloudfront-agent-analytics.md). # CloudFront Diese Anleitung führt dich durch die Konfiguration von Amazon CloudFront Echtzeit-Protokollen, um sie über Amazon Kinesis Data Firehose in AirOps zu streamen. Diese Anleitung führt Sie durch die Konfiguration von Amazon CloudFront **Echtzeit-Protokolle** in AirOps zu streamen über **Amazon Kinesis Data Firehose**. Sobald die Verbindung hergestellt ist, analysiert AirOps automatisch Ihren Traffic, klassifiziert Besuche von KI-Bots (ChatGPT, Claude, Perplexity, Google und mehr) und stellt Erkenntnisse in Ihrem Agent Analytics-Dashboard bereit. *** ### Voraussetzungen * Ein aktives **AirOps** Konto mit aktiviertem Agent Analytics * Eine **AWS-Konto** mit Zugriff auf CloudFront, Kinesis Data Firehose und IAM * Ein **CloudFront-Distribution** das Ihre Website bereitstellt * Dein **Workspace-API-Schlüssel:** verfügbar in Einstellungen (linke Navigationsleiste) > Workspace * Dein **Brand-Kit-ID:** verfügbar in der URL, indem Sie in der linken Navigationsleiste zu Context > BrandKits navigieren, etwa in der Form von `https://app.airops.com//data/brand_kits/` *** ### Schritt 1: Erstellen Sie einen Kinesis Data Firehose-Delivery-Stream 1. Öffnen Sie das **Amazon Kinesis** Konsole und navigieren Sie zu **Data Firehose**. 2. Klicken Sie auf **Firehose-Stream erstellen**. 3. Konfigurieren Sie Quelle und Ziel: * **Quelle:** `Direct PUT` * **Ziel:** `HTTP-Endpunkt` 4. Benennen Sie Ihren Stream (z. B. `airops-cloudfront-analytics`). #### Konfigurieren Sie das HTTP-Endpunkt-Ziel | Einstellung | Wert | | ---------------------- | ------------------------------------------------------------------------ | | **HTTP-Endpunkt-URL** | `https://ingest.airops.com/api/v1/cloudfront//ingest` | | **Zugriffsschlüssel** | Ihr AirOps-Workspace-API-Schlüssel | | **Inhaltskodierung** | `GZIP` | | **Wiederholungsdauer** | `300` Sekunden (empfohlen) |
#### Pufferhinweise konfigurieren | Einstellung | Empfohlener Wert | | ------------------- | ---------------- | | **Puffergröße** | `5 MiB` | | **Pufferintervall** | `60` Sekunden | Diese Einstellungen steuern, wie häufig Firehose Datenpakete an AirOps liefert. Dies sind die empfohlenen Einstellungen, damit Sie keine 429-Fehler von unseren Servern erhalten. #### Backup-Einstellungen konfigurieren * **S3-Backup-Bucket:** Wählen Sie einen S3-Bucket aus oder erstellen Sie einen für Sicherungen bei fehlgeschlagenen Zustellungen. * **Backup-Modus:** `Nur fehlgeschlagene Daten` (empfohlen). 5. Klicken Sie auf **Firehose-Stream erstellen**. *** ### Schritt 2: Erstellen Sie eine CloudFront-Konfiguration für Echtzeitprotokolle 1. Öffnen Sie das **CloudFront** Konsole. 2. Gehen Sie in der linken Navigation zu **Logging > Hinzufügen > Amazon Cloudwatch Logs**. 3. Wählen Sie An Amazon Kinesis Firehose liefern aus. 4. Wählen Sie Ziel-Stream: Ihr konfiguriertes Firehose 5. Konfigurieren Sie die folgenden zusätzlichen Einstellungen: | Einstellung | Wert | | ----------------- | ------ | | **Felder** | `alle` | | **Ausgabeformat** | `JSON` | #### Log-Felder auswählen Wählen Sie **alle** der folgenden Felder. Jedes ist erforderlich, und Protokolle, denen eines davon fehlt, können nicht verarbeitet werden: | Feld | Erforderlich | | --------------------- | ------------ | | `timestamp(date)` | Ja | | `timestamp(time)` | Ja | | `cs-method` | Ja | | `cs-uri-stem` | Ja | | `cs(User-Agent)` | Ja | | `cs(Referer)` | Ja | | `cs-protocol-version` | Ja | | `cs-protocol` | Ja | | `cs-bytes` | Ja | | `sc-status` | Ja | | `sc-bytes` | Ja | | `sc-content-type` | Ja | | `time-taken` | Ja | | `time-to-first-byte` | Ja | | `ssl-protocol` | Ja | | `ssl-cipher` | Ja | | `x-edge-location` | Ja | | `x-edge-result-type` | Ja | | `x-host-header` | Ja | `c-ip` und `cs-uri-query` sind nicht erforderlich, und AirOps speichert keine Viewer-IP-Adressen oder Query-Strings. Wenn Sie `alle` Felder übermittelt sie zwar, aber wir ignorieren sie. Wenn Sie sie lieber nicht teilen möchten, lassen Sie sie weg. 5. Klicken Sie auf **Konfiguration erstellen**. *** ### Schritt 3: Hängen Sie die Log-Konfiguration an Ihre Distribution an 1. Gehen Sie zu **CloudFront > Distributionen** und wählen Sie Ihre Distribution aus. 2. Navigiere zum **Verhaltensweisen** Registerkarte. 3. Wählen Sie das Verhalten aus, das Sie verfolgen möchten (typischerweise `Standard (*)`) und klicken Sie auf **Bearbeiten**. 4. Unter **Konfiguration für Echtzeitprotokolle**, wählen Sie die `airops-analytics` Konfiguration aus, die Sie gerade erstellt haben. 5. Klicken Sie auf **Änderungen speichern**. Wiederholen Sie dies für alle zusätzlichen Cache-Verhaltensweisen, die Sie überwachen möchten. *** ### Schritt 4: Überprüfen Sie die Verbindung Nachdem die Konfiguration angehängt wurde, sollten die Daten innerhalb von **2–5 Minuten**. 1. Erzeugen Sie etwas Traffic für Ihre CloudFront-Distribution (besuchen Sie Ihre Website). 2. Überprüfen Sie die Firehose **Überwachung** Registerkarte in der AWS-Konsole, um zu bestätigen, dass Datensätze zugestellt werden. 3. In deinem **AirOps-Dashboard**, navigiere zu **Agent Analytics** — Sie sollten bald Traffic-Daten sehen. #### Fehlerbehebung | Symptom | Wahrscheinliche Ursache | Behebung | | --------------------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------- | | Firehose zeigt Lieferfehler (401) an | Ungültiger API-Schlüssel | Überprüfen Sie Ihren API-Schlüssel in AirOps Einstellungen > Integrationen | | Firehose zeigt Lieferfehler (429) an | Ratenlimit überschritten | Erhöhen Sie das Pufferintervall oder die Puffergröße, um die Lieferfrequenz zu verringern | | Keine Daten in der Firehose-Überwachung | Log-Konfiguration nicht angehängt | Bestätigen Sie, dass die Konfiguration für Echtzeitprotokolle an das Verhalten Ihrer Distribution angehängt ist | | Daten in Firehose, aber nicht in AirOps | Verarbeitungsverzögerung | Warten Sie bis zu 10 Minuten; überprüfen Sie, dass Ihre Brand-Kit-ID in der Endpunkt-URL korrekt ist | *** ### Ratenlimits Der AirOps-Ingestor erzwingt ein Ratenlimit von **5 Anfragen pro Minute und API-Schlüssel**. Mit den empfohlenen Puffereinstellungen (5 MiB / 60 Sekunden) bleiben Sie deutlich innerhalb dieses Limits. Wenn Sie Distributionen mit sehr hohem Traffic haben, erhöhen Sie entsprechend die Puffergröße oder das Intervall. *** ### Was AirOps verfolgt Sobald die Verbindung hergestellt ist, führt AirOps automatisch Folgendes aus: * **Erfasst alle CloudFront-Anfragen** — Seitenaufrufe, Assets, API-Aufrufe * **Klassifiziert KI-Bot-Traffic** — identifiziert Besuche von ChatGPT, Claude, Google, Perplexity, Meta, Apple, Bing, Bytedance, Common Crawl und anderen * **Kategorisiert Crawling-Verhalten** — unterscheidet zwischen KI-Trainings-Crawlern, KI-Suchabrufen, KI-Indexierung und vom Nutzer initiiertem KI-Browsing * **Zeigt Analysen an** — Traffic-Aufschlüsselungen, Bot-zu-Mensch-Verhältnisse und Crawl-Trends in Ihrem Dashboard --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.airops.com/docs/de/insights/onsite/traffic/cloudfront-agent-analytics.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.