Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Sie können API-Aufrufe unter Amazon Data Firehose protokollieren, um Probleme im Zusammenhang mit dem Client-Zugriff auf Ihre API zu beheben. Weitere Informationen zu Firehose finden Sie unter Was ist Amazon Data Firehose?.
Für die Zugriffsprotokollierung kann jeweils entweder CloudWatch oder Firehose aktiviert werden - nicht beide gleichzeitig. Sie können jedoch CloudWatch für die Ausführungsprotokollierung und Firehose für die Zugriffsprotokollierung aktivieren.
Themen
Firehose-Protokollformate für API Gateway
Die Firehose-Protokollierung verwendet dasselbe Format wie die CloudWatch-Protokollierung.
Berechtigungen für die Firehose-Protokollierung
Wenn die Firehose-Zugriffsprotokollierung für eine Stufe aktiviert ist, erstellt API Gateway eine servicebezogene Rolle für Ihr Konto, sofern die Rolle nicht bereits vorhanden ist. Die Rolle wird AWSServiceRoleForAPIGateway
benannt und die verwaltete APIGatewayServiceRolePolicy
-Richtlinie wird an sie angehängt. Weitere Informationen zu serviceverknüpften Rollen finden Sie unter Verwenden serviceverknüpfter Rollen.
Anmerkung
Der Name Ihres Firehose-Streams muss amazon-apigateway-
lauten.{your-stream-name}
Einrichten der Firehose-Zugriffsprotokollierung mithilfe der API-Gateway-Konsole
Zum Einrichten der API-Protokollierung müssen Sie die API für eine Stufe bereitgestellt haben. Ein Firehose-Stream muss bereits erstellt worden sein.
Melden Sie sich bei der API Gateway-Konsole unter https://console.aws.amazon.com/apigateway
an. -
Führen Sie eine der folgenden Aktionen aus:
-
Wählen Sie eine vorhandene API und anschließend eine Stufe aus.
-
Erstellen Sie eine API und stellen Sie diese einer Stufe bereit.
-
Klicken Sie im Hauptnavigationsbereich auf Stages (Stufen).
-
Wählen Sie im Abschnitt Logs and tracing (Protokolle und Nachverfolgung) die Option Edit (Bearbeiten) aus.
-
So aktivieren Sie die Zugriffsprotokollierung für einen Firehose-Stream:
-
Aktivieren Sie die Option Custom access logging (Benutzerdefinierte Zugriffsprotokollierung).
-
Geben Sie den ARN eines Firehose-Streams unter ARN für Zugriffsprotokollziel ein. Das ARN-Format ist
arn:aws:firehose:
.{region}
:{account-id}
:deliverystream/amazon-apigateway-{your-stream-name}
Anmerkung
Der Name Ihres Firehose-Streams muss
amazon-apigateway-
lauten.{your-stream-name}
-
Geben Sie unter Log Format (Protokollformat) ein Protokollformat ein. Sie können zwischen CLF, JSON, XML oder CSV wählen. Weitere Informationen zu Beispielprotokollformaten finden Sie unter CloudWatch Protokollformate für API Gateway.
-
-
Wählen Sie Änderungen speichern.
API Gateway kann ab sofort API-Aufrufe unter Firehose protokollieren. Sie müssen die API nicht erneut bereitstellen, wenn Sie die Stufeneinstellungen, Protokolle oder Stufenvariablen aktualisieren.