View a markdown version of this page

Protokollierung, für die zusätzliche Berechtigungen [V2] erforderlich sind - CloudWatch Amazon-Protokolle
Beispiele für die Einrichtung von Protokollzustellungen

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.

Protokollierung, für die zusätzliche Berechtigungen [V2] erforderlich sind

Einige AWS Dienste verwenden eine neue Methode, um ihre Protokolle zu senden. Dies ist eine flexible Methode, mit der Sie die Protokollzustellung von diesen Services an eines oder mehrere der folgenden Ziele einrichten können: CloudWatch Logs, Amazon S3 oder Firehose und X-Ray für die Trace-Zustellung.

Eine funktionierende Protokollzustellung besteht aus drei Elementen:

  • ADeliverySource, ein logisches Objekt, das die Ressource (n) darstellt, die die Protokolle tatsächlich senden.

  • ADeliveryDestination, ein logisches Objekt, das das tatsächliche Lieferziel darstellt.

  • ADelivery, das eine Lieferquelle mit einem Lieferziel verbindet

Um die Protokollzustellung zwischen einem unterstützten AWS Dienst und einem Ziel zu konfigurieren, müssen Sie wie folgt vorgehen:

  • Erstellen Sie eine Lieferquelle mit PutDeliverySource.

  • Erstellen Sie ein Lieferziel mit PutDeliveryDestination.

  • Wenn Sie Protokolle kontoübergreifend bereitstellen, können Sie nur Amazon S3- und Firehose-Ziele verwenden. Sie müssen das Zielkonto verwenden PutDeliveryDestinationPolicy, um dem Ziel eine IAM Richtlinie zuzuweisen. Diese Richtlinie autorisiert die Erstellung einer Lieferung von der Versandquelle in Konto A zum Lieferziel in Konto B. Für die kontoübergreifende Zustellung müssen Sie die Berechtigungsrichtlinien manuell selbst erstellen. Einrichtungsbeispiele finden Sie unter. Cross-account Beispiel für eine Lieferung

  • Erstellen Sie eine Lieferung, indem Sie genau eine Versandquelle und ein Lieferziel verknüpfen, indem Sie CreateDelivery.

Beispiele für die Einrichtung von Protokollzustellungen

In den folgenden Beispielen werden die Versandquelle und das Lieferziel in demselben AWS Konto erstellt. Ersetzen Sie den ARN und den Protokolltyp der Quellressource durch Werte, die von dem Dienst unterstützt werden, der die Protokolle generiert. Für diese Beispiele ist keine Richtlinie für das Lieferziel erforderlich.

Erstellen Sie eine Zustellungsquelle für CloudWatch Logs Insights-Abfrageausführungsprotokolle

Im folgenden Beispiel wird eine Übermittlungsquelle für CloudWatch Logs Insights-Abfrageausführungsprotokolle erstellt. Die vollständigen ARN-Anforderungen logType und die Ressourcen-ARN-Anforderungen finden Sie unter PutDeliverySource.

Anmerkung

Der Platzhalter am Ende log-group:* ist erforderlich, da die Protokolle zur Abfrageausführung nicht an eine Protokollgruppe gebunden sind. AWS unterstützt keinen bestimmten Protokollgruppen-ARN für diesen Protokolltyp.

aws logs put-delivery-source \
    --name insights-query-logs \
    --resource-arn arn:aws:logs:region:account-id:log-group:* \
    --log-type INSIGHTS_QUERY_LOGS

Erstellen Sie eine Zustellungsquelle

Erstellen Sie die Lieferquelle und verwenden Sie dann eines der folgenden Zielbeispiele.

aws logs put-delivery-source \
    --name my-delivery-source \
    --resource-arn source-resource-arn \
    --log-type log-type

Erstellen Sie eine Lieferung an CloudWatch Logs

Erstellen Sie ein Übermittlungsziel für eine bestehende Protokollgruppe.

aws logs put-delivery-destination \
    --name my-cwl-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:logs:region:account-id:log-group:log-group-name"

Erstellen Sie die Lieferung.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-cwl-delivery-destination

Eine Lieferung an Amazon S3 erstellen

Erstellen Sie ein Lieferziel für einen vorhandenen Bucket.

aws logs put-delivery-destination \
    --name my-s3-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:s3:::bucket-name"

Erstellen Sie die Lieferung.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-s3-delivery-destination

Informationen zum Konfigurieren eines Zielpräfixes, Suffixpfads oder Hive-compatible Pfads finden Sie unterAmazon S3 S3-Objektschlüsselformat.

Erstellen Sie eine Lieferung an Firehose

Erstellen Sie ein Lieferziel für einen vorhandenen DirectPut Lieferstream.

aws logs put-delivery-destination \
    --name my-firehose-delivery-destination \
    --delivery-destination-configuration \
    "destinationResourceArn=arn:aws:firehose:region:account-id:deliverystream/delivery-stream-name"

Erstellen Sie die Lieferung.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-firehose-delivery-destination

Erstellen Sie eine Lieferung an X-Ray

Verwenden Sie für die Zustellung per Nachverfolgung einen Quelldienst und einen Protokolltyp, der die Lieferung an unterstützt X-Ray. Erstellen Sie das logische X-Ray Übermittlungsziel.

aws logs put-delivery-destination \
    --name my-xray-delivery-destination \
    --delivery-destination-type XRAY

Erstellen Sie die Lieferung.

aws logs create-delivery \
    --delivery-source-name my-delivery-source \
    --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-xray-delivery-destination

Verwenden Sie den folgenden Befehl, um die Lieferung zu überprüfen.

aws logs describe-deliveries \
    --delivery-source-name-prefix my-delivery-source

In den folgenden Abschnitten finden Sie Einzelheiten zu den Berechtigungen, die Sie benötigen, wenn Sie angemeldet sind, um die Protokollbereitstellung an die einzelnen Zieltypen mithilfe des V2-Prozesses einzurichten. Diese Berechtigungen können einer IAM-Rolle erteilt werden, mit der Sie angemeldet sind.

Wichtig

Es liegt in Ihrer Verantwortung, Ressourcen für die Protokollzustellung zu entfernen, nachdem Sie die Ressource gelöscht haben, die das Protokoll generiert hat. Gehen Sie dazu wie folgt vor.

  1. Löschen Sie das Delivery mithilfe der DeleteDeliveryOperation.

  2. Löschen Sie die DeliverySource mithilfe der DeleteDeliverySourceOperation.

  3. Wenn das mit demDeliverySource, was Sie gerade gelöscht haben, DeliveryDestination verknüpft ist, nur für dieses spezielle DeliverySource Objekt verwendet wird, können Sie es mithilfe des DeleteDeliveryDestinationsVorgangs entfernen.

Inhalt