Apigee-Zugriffslogs protokollieren

Diese Seite gilt für Apigee, aber nicht für Apigee Hybrid.

Apigee Edge-Dokumentation aufrufen

Vorschau

Dieses Produkt oder Feature unterliegt den "Nutzungsbedingungen für Pre-GA-Angebote" im Abschnitt "Allgemeine Dienstbedingungen" der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Features sind "im Ist-Zustand" verfügbar und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Apigee-Abo- und „Pay as you go“-Kunden können Cloud Logging-Ingress-Zugriffslogs für jede Apigee-Instanz in ihrer Organisation aktivieren. Nach der Aktivierung können Sie mit diesem Feature die Logs aufrufen, die von Ingress-Gateways in Ihrer Apigee-Infrastruktur generiert werden, z. B. einem externen Application Load Balancer oder einem Anthos-Gateway, um die Fehlerbehebung von Apigee API-Aufrufen zu erleichtern.

Wenn dieses Feature für eine oder mehrere Ihrer Apigee-Instanzen aktiviert ist, werden Ihnen die Logs in Rechnung gestellt, die an Ihr Projekt gesendet werden. Weitere Informationen zu den Kosten für das Logging finden Sie unter Cloud Logging – Preise. Google Cloud

In diesem Thema wird beschrieben, wie Apigee-Kunden Cloud Logging-Ingress-Zugriffslogs für die Apigee-Instanzen in ihrer Organisation aktivieren und verwenden können.

Hinweise

Zum Aktivieren des Features benötigen Sie die folgende Rolle und die folgenden Berechtigungen:

• Rollen: Apigee-Organisationsadministrator (roles/apigee.admin)
• Berechtigungen:
  • apigee.instances.create
  • apigee.instances.update

Rollen prüfen

1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

   IAM aufrufen
2. Wählen Sie das Projekt aus.

3. Suchen Sie in der Spalte Hauptkonto nach der Zeile mit Ihrer E-Mail-Adresse.

   Ist Ihre E-Mail-Adresse nicht in dieser Spalte enthalten, haben Sie keine Rollen.

4. Prüfen Sie in der Spalte Rolle der Zeile mit Ihrer E-Mail-Adresse, ob die Liste der Rollen die erforderlichen Rollen enthält.

Rollen zuweisen

1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

   IAM aufrufen
2. Wählen Sie das Projekt aus.
3. Klicken Sie auf Zugriff erlauben.
4. Geben Sie in das Feld Neue Hauptkonten Ihre E-Mail-Adresse ein.
5. Wählen Sie in der Liste Rolle auswählen eine Rolle aus.
6. Wenn Sie weitere Rollen zuweisen möchten, klicken Sie auf Weitere Rolle hinzufügen und fügen Sie weitere Rollen hinzu.
7. Klicken Sie auf Speichern.

Ingress-Zugriffslogging für Ihre Apigee-Instanzen aktivieren

Sie können das Cloud Logging-Ingress-Zugriffslogging aktivieren, wenn Sie eine Apigee-Instanz über die Apigee-Benutzeroberfläche oder die API erstellen oder bearbeiten.

Wenn Sie das Feature beim Erstellen oder Aktualisieren einer Apigee-Instanz aktivieren möchten, folgen Sie der Anleitung unter Instanzen verwalten, um eine Instanz zu erstellen oder zu bearbeiten.

Apigee-Benutzeroberfläche

Führen Sie im Abschnitt Logging der Seite Instanz erstellen oder Instanz bearbeiten folgende Schritte aus:

1. Klicken Sie auf den Ein/Aus-Button Logging aktivieren , um das Feature zu aktivieren.
2. Optional wählen Sie im Feld Antwortcode einen HTTP-Antwortcode aus, der als Filter für die Zugriffslogs dient.

   Wenn Sie alle Logs unabhängig vom HTTP-Antwortcode einbeziehen möchten, wählen Sie None (all HTTP responses) aus.

   Wenn Sie einen benutzerdefinierten Filter erstellen möchten, wählen Sie Custom aus und geben Sie den Filter im folgenden Format ein:

   status_code > XX && status code <= YY

   Beispiel:

   status_code >= 500 && status_code < 504

3. Nachdem Sie alle erforderlichen Informationen zum Erstellen oder Bearbeiten Ihrer Instanz angegeben haben, klicken Sie auf Speichern.

Apigee API

Verwenden Sie den folgenden Befehl, um eine vorhandene Instanz mit der Apigee API zu aktualisieren:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{
      "name": "INSTANCE_NAME",
      "accessLoggingConfig":
        {
          "enabled": "true",
          "filter": "status_code >= 0 && status_code < 600 "
        }
      }'

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• INSTANCE_NAME ist der Name der Apigee-Instanz, die Sie bearbeiten möchten.

Beachten Sie, dass mit diesem Befehl alle Logs zurückgegeben werden, die für die Eigenschaft filter angegeben wurden. Wenn Sie die Logs nach HTTP- oder anderen Statuscodes filtern möchten, können Sie den Wert filter anpassen.

Sobald die Instanz erfolgreich erstellt oder aktualisiert wurde, sollten die Ingress-Zugriffslogs für diese Instanz in Ihrem Projekt innerhalb von Minuten verfügbar sein.

Ingress-Zugriffslogs ansehen

Sobald das Feature aktiviert ist, können Sie die Ingress-Zugriffslogs für Instanzen in Ihrem Projekt innerhalb von Minuten mit dem Log-Explorer in der Google Cloud Console aufrufen.

Logeinträge im Log-Explorer aufrufen:

1. Wählen Sie in der Google Cloud Console Logging > Log-Explorer aus.

   Zum Log-Explorer

2. Achten Sie darauf, dass Ihr Google Cloud Projekt ausgewählt ist.
3. Geben Sie auf dem Tab Abfrage den Lognamen mit einer der folgenden Methoden in das Editorfeld Abfrage ein:
   • So verwenden Sie das Auswahlfeld Logname :
     1. Klicken Sie auf das Auswahlfeld Logname , um den Bereich Logname zu öffnen.
     2. Geben Sie ingress_instance in das Feld Lognamen auswählen ein.
     3. Klicken Sie auf Anwenden.
     4. Der Logname wird im Editorfeld Abfrage angezeigt.
   • Geben Sie den Lognamen direkt im Editorfeld Abfrage ein:

     logName="projects/ORG_NAME/logs/apigee.googleapis.com/ingress_instance"

4. Erstellen Sie den Rest der Abfrage im Editorfeld Abfrage. Die Logs werden in der Liste Abfrageergebnisse angezeigt.
5. Klicken Sie auf einen Logeintrag, um weitere Details zu sehen.

Fehlerbehebung mit Ingress-Zugriffslogs

Sobald das Feature aktiviert ist und Logs im Log-Explorer verfügbar sind, können Sie eine Reihe von Cloud Logging Funktionen zur Fehlerbehebung nutzen, darunter:

• Abfragen mit der Cloud Logging-Abfragesprache erstellen

  Sie können Logs abrufen und analysieren, wenn Sie den Log-Explorer verwenden. Dazu schreiben Sie Abfragen in das Editorfeld für Abfragen und treffen Auswahlen in den Filtermenüs, die in den Logeinträgen enthalten sind. Weitere Informationen zum Erstellen von Abfragen und Analysieren von Daten im Log-Explorer finden Sie unter Abfragen mit der Cloud Logging-Abfragesprache erstellen und speichern.

• Logbasierte Messwerte und Benachrichtigungen aktivieren

  Sie können einen eigenen logbasierten Messwert definieren, um Informationen zu erfassen, die für Ihre Apigee-Instanzen spezifisch sind. Weitere Informationen finden Sie unter Übersicht über logbasierte Messwerte.

  Sie können eine logbasierte Benachrichtigungsrichtlinie im Log-Explorer erstellen. Weitere Informationen und eine detaillierte Anleitung finden Sie unter Logbasierte Benachrichtigungsrichtlinie mit dem Log-Explorer erstellen.

• Nach HTTP-Statuscodes filtern

  Sie können Ihre Abfragen im Log-Explorer verfeinern, um nach HTTP-Statuscodes zu filtern, auch wenn Sie beim Aktivieren der Funktion nicht ausgewählt haben, Ihre Ingress-Zugriffslogs nach HTTP-Statuscode zu filtern. Verwenden Sie das folgende Format, um Ihrer Abfrage diesen Filter hinzuzufügen:

  status_code > XX && status code <= YY

  Beispiel:

  status_code >= 500 && status_code < 504

• Nach Ingress-Statuscodes filtern

  Neben dem Filtern nach HTTP-Statuscodes können Sie eine Abfrage erstellen, um nach ingress status_code 0 zu filtern. Dieser Code weist häufig auf ein Netzwerk- oder Verbindungsproblem hin, das verhindert, dass der Client eine Serverantwort erhält.

Eine detaillierte Erläuterung aller im Log-Explorer verfügbaren Funktionen finden Sie unter Logs mit dem Log-Explorer aufrufen.

Feature deaktivieren

Nachdem Sie die Fehlerbehebung für Ihre Apigee-Instanz abgeschlossen haben, können Sie die Instanz bearbeiten, um das Feature zu deaktivieren. Wenn Sie das Feature deaktivieren, wird der Zugriff auf die ingress_instance-Logs in Ihrem Projekt deaktiviert und die Abrechnung beendet.

Sie können die Instanz bearbeiten, um das Feature über die Apigee-Benutzeroberfläche oder die API zu deaktivieren.

Apigee-Benutzeroberfläche

So deaktivieren Sie das Feature über die Apigee-Benutzeroberfläche:

1. Rufen Sie in der Google Cloud Console die Seite Verwaltung > Instanzen auf.

   Zur Seite „VM-Instanzen“

2. Klicken Sie auf die Instanz, die Sie bearbeiten möchten.
3. Klicken Sie auf der Seite Instanzdetails auf Bearbeiten.
4. Klicken Sie auf der Seite Instanz bearbeiten auf den Ein/Aus-Button Logging aktivieren, um das Feature zu deaktivieren.
5. Klicken Sie auf Speichern.

Apigee API

Verwenden Sie den folgenden Befehl, um das Feature in Ihrer Instanz zu deaktivieren:

curl "https://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{
      "name": "INSTANCE_NAME",
      "accessLoggingConfig":
        {
            "enabled": "false"
        }
        }'

Wobei:

• ORG_NAME ist der Name Ihrer Apigee-Organisation.
• INSTANCE_NAME ist der Name der Apigee-Instanz, die Sie bearbeiten möchten.