Grundlegendes zu Cloud Service-Inhaltsanfragen

Einführung introduction

Inhaltsanfragen umfassen an AEM Sites gesendete Anfragen. Diese Anfragen werden über Edge Delivery Services oder vom Kunden bereitgestellte Caching-Systeme wie ein Content Delivery Network (CDN) weitergeleitet. Diese Anfragen liefern strukturierte Daten im HTML- oder JSON-Format und unterstützen Seitenansichten (z. B. Seiten und Experience Fragments) oder JSON-Rückgaben über APIs (Headless).

Das System zählt die Inhaltsanfragen, wenn eine Benutzerin oder ein Benutzer eine Seite mithilfe von HTML oder JSON anzeigt. Es erfasst die Anfrage dort, wo das erste Caching-System sie erhält. Bestimmte HTTP-Anfragen werden beim Zählen von Inhaltsanfragen ein- bzw. ausgeschlossen. Siehe die vollständige Liste der eingeschlossenen HTTP-Inhaltsanfragen und der ausgeschlossenen HTTP-Inhaltsanfragen.

Über Cloud Service-Inhaltsanfragen understanding-cloud-service-content-requests

Eine Seitenanfrage bezieht sich auf eine HTTP-Anfrage, die strukturierte Kerninhalte (z. B. HTML oder JSON) zum Rendern der Hauptseite abruft. Dazu gehören keine Anfragen für Assets wie Bilder oder Skripte.

Für Kunden, die das standardmäßige CDN verwenden, zählt AEM as a Cloud Service Inhaltsanfragen, gemessen auf Server-seitiger Ebene. Diese Messung erfolgt automatisch und ist nicht auf Client-seitiges Analyse-Tracking angewiesen.

AEM (Adobe Experience Manager) as a Cloud Service identifiziert Inhaltsanfragen anhand der von der AEM-Instanz generierten und im CDN empfangenen Antworttypen. Insbesondere werden Anfragen gezählt, die HTML (text/html) oder JSON (application/json) zurückgeben. Diese Formate liefern in der Regel primäre Seiteninhalte zum herkömmlichen Rendern von Sites oder zur Headless-Bereitstellung.

Anfragen für statische Assets wie JavaScript-Dateien, CSS-Stylesheets und Bilder werden nicht als Inhaltsanfragen gezählt.

Inhaltsanfragen werden unabhängig davon gemessen, ob die Antwort vom CDN-Cache bereitgestellt oder an die ursprüngliche AEM-Umgebung weitergeleitet wurde.

Abweichungen von Cloud Service-Inhaltsanfragen content-requests-variances

Inhaltsanfragen können Abweichungen von den Analyseberichts-Tools einer Organisation aufweisen, die in der folgenden Tabelle zusammengefasst sind. Vermeiden Sie im Allgemeinen die Verwendung von Analyse-Tools, die auf eine Client-seitige Instrumentation angewiesen sind, um die Anzahl der Inhaltsanfragen für eine Site zu melden. Bei diesen Tools wird häufig ein großer Teil des Traffics verpasst, da ihre Aktivierung von einer Benutzerzustimmung abhängt. Analytics-Tools, die Daten Server-seitig in Protokolldateien erfassen, oder CDN-Berichte für Kunden, die ihr eigenes CDN zu AEM as a Cloud Service hinzufügen, bieten eine bessere Zählung.

Informationen zum Anzeigen und Nachverfolgen der Nutzung von Inhaltsanfragen anhand Ihres Lizenz-Limits finden Sie im Lizenz-Dashboard.

Regeln für die Server-seitige Sammlung serverside-collection

AEM as a Cloud Service wendet Server-seitige Sammlungsregeln an, um Inhaltsanfragen zu zählen. Diese Regeln schließen bekannte Bots (wie Suchmaschinen-Crawlers) aus, einschließlich erkannter KI-/LLM-Crawlers und einer Reihe von Überwachungsdiensten, die die Website regelmäßig pingen. Andere synthetische, automatisierte oder überwachende Traffics, die nicht auf dieser Ausschlussliste stehen, werden als abrechnungsfähige Inhaltsanfragen gezählt.

In der folgenden Tabelle sind die Typen der eingeschlossenen und ausgeschlossenen Inhaltsanfragen mit jeweils kurzen Beschreibungen aufgeführt.

Arten von enthaltenen Inhaltsanfragen included-content-requests

Siehe auch Lizenz-Dashboard.

Typen von ausgeschlossenen Inhaltsanfragen excluded-content-request

Verwalten von Inhaltsanfragen managing-content-requests

Wie in Varianzen von Cloud Service-Inhaltsanfragen erwähnt, können Inhaltsanfragen aus mehreren Gründen höher als erwartet sein, z. B. weil der Traffic das CDN erreicht. Als AEM-Kunde ist es hilfreich, wenn Sie Ihre Inhaltsanfragen überwachen und verwalten, damit Sie Ihr Lizenzbudget einhalten. Die Verwaltung von Inhaltsanfragen ist eine Kombination aus Implementierungstechniken ​ Traffic-Filterregeln.

Implementierungstechniken für die Verwaltung von Inhaltsanfragen implementation-techniques-to-manage-crs

Traffic-Filterregeln zur Verwaltung von Inhaltsanfragen traffic-filter-rules-to-manage-crs

Um Ihre Inhaltsanfragen besser zu steuern, analysieren Sie Ihren CDN-Traffic, bevor Sie Filterregeln definieren. Mit dem CDN-Protokollanalyse-Tool erhalten Sie Einblicke in die CDN-Leistung und Anfragemuster. Zunächst müssen Sie verstehen, woher Ihr Traffic kommt und ob unerwartete Signalisierungsmuster vorhanden sind (ein gängiges Bot-Muster besteht darin, einen leeren Benutzeragenten zu verwenden).

Zu überwachende und zu protokollierende Elemente:

Sie können Anfragetransformationen verwenden, um Eigenschaften zum Anfrageprotokoll hinzuzufügen, damit sie in CDN-Protokollen und Dashboards angezeigt werden. So protokollieren Sie beispielsweise den Bot-Namen und das Client-Netzwerk (AS-Name) für die Analyse:

requestTransformations:
  rules:
    - name: log-on-request
      when: "*"
      actions:
        - type: set
          logProperty: bot_name
          value: { reqProperty: botName }
        - type: set
          logProperty: cli_network
          value: { reqProperty: clientAsName }

Nachdem Sie unerwünschten Traffic (nach Land, Netzwerk, Bot oder anderen Signalen) identifiziert haben, können Sie ihn mit Traffic-Filterregeln blockieren. Beispielregel, die nach Client-Land, Netzwerk oder Bot-Namen blockiert:

trafficFilters:
  rules:
    - name: block-bad-client-traffic
      when:
        anyOf:
          - { reqProperty: clientCountry, equals: "XX" }
          - { reqProperty: clientAsName, equals: "UnwantedClientNetwork" }
          - { reqProperty: botName, equals: "UnwantedBot" }
          - { reqHeader: user-agent, exists: false }
          - { reqHeader: user-agent, equals: '' }
      action: block

Ersetzen Sie die Beispielwerte durch den Länder-Code, den Netzwerk- oder Bot-Namen, den Sie sperren möchten. Siehe Syntax von Traffic-Filterregeln und Bedingungsstruktur für weitere Optionen.

Einige Bots können eine Website an einem Tag mit Traffic überlasten und dann am nächsten Tag verschwinden. Solche Funktionen können alle Versuche erschweren, eine bestimmte IP-Adresse oder einen Benutzeragenten zu blockieren. Ein generischer Ansatz besteht in der Einführung einer Regel für Limits. Sehen Sie sich die Beispiele an und erstellen Sie eine Regel, die Ihrer Toleranz für eine schnelle Anfragerate entspricht. Überprüfen Sie die Bedingungsstruktur-Syntax für alle Ausnahmen, die Sie einer allgemeinen Ratenbeschränkung gestatten.