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.
Erste Schritte mit Amazon ECS Action Logs
Amazon ECS-Aktionsprotokolle verwenden Amazon CloudWatch Logs hat den Mechanismus für die Übermittlung von Protokollen verwendet, um detaillierte Aufzeichnungen von Serviceaktionen an Ihrem bevorzugten Ziel zu veröffentlichen. Wenn Sie Action Logs aktivieren, können Sie jeden Schritt verfolgen, den Amazon ECS bei Bereitstellungen und Daemon-Vorgängen unternimmt, einschließlich Infrastrukturbereitstellung, Ressourcenregistrierung und Fehlerdetails. Diese Transparenz hilft Ihnen, Probleme zu beheben, ohne Kontakt aufnehmen zu müssen AWS Unterstützung und Verkürzung der Zeit zur Identifizierung der Ursachen. Sie können Aktionsprotokolle für Ihre Cluster mithilfe der Amazon ECS-Konsole aktivieren oder CloudWatch Protokolliert APIs.
Voraussetzungen
Bevor Sie Aktionsprotokolle aktivieren, stellen Sie sicher, dass Ihre IAM-Identität über die erforderlichen Berechtigungen verfügt.
Erforderliche IAM-Berechtigungen
Ihre IAM-Identität muss über die folgenden Berechtigungen verfügen, um Aktionsprotokolle zu aktivieren und zu verwalten:
{ "Effect": "Allow", "Action": [ "logs:PutDeliverySource", "logs:PutDeliveryDestination", "logs:CreateDelivery", "logs:GetDelivery", "ecs:AllowVendedLogDeliveryForResource" ], "Resource": "*" }
Richtlinie für die Zielressource
Das Ziel CloudWatch Die Protokollgruppe „Protokolle“ muss über eine Ressourcenrichtlinie verfügen, die Folgendes zulässt delivery.logs.amazonaws.com Dienst zum Schreiben von Protokollen. Fügen Sie der Ressourcenrichtlinie für Protokollgruppen die folgende Anweisung hinzu:
{ "Effect": "Allow", "Principal": { "Service": "delivery.logs.amazonaws.com" }, "Action": [ "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:region:account-id:log-group:log-group-name:log-stream:*" }
Aktivieren Sie Aktionsprotokolle mithilfe der Amazon ECS-Konsole
Sie können Aktionsprotokolle direkt auf der Cluster-Detailseite in der Amazon ECS-Konsole aktivieren.
Um Aktionsprotokolle mithilfe der Konsole zu aktivieren
Öffnen Sie die Konsole unter https://console.aws.amazon.com/ecs/v2
. -
Wählen Sie im Navigationsbereich Cluster, und wählen Sie dann den Cluster aus.
-
Wählen Sie die Registerkarte Konfiguration aus.
-
In der Aktionsprotokolle Abschnitt, wählen Sie Hinzufügen.
-
Wählen Sie für Destination eine der folgenden Optionen:
-
CloudWatch Logs (Standard)
-
Amazon S3
-
Amazon Data Firehose
Für CloudWatch Protokolle erstellt Amazon ECS eine Standard-Protokollgruppe mit dem Namen
/aws/vendedlogs/ecs/action-logs/mit einer Aufbewahrungsfrist von 7 Tagen.cluster-name -
-
Wählen Sie Speichern.
Aktivieren Sie Aktionsprotokolle mit CloudWatch Protokolliert APIs
Sie können Aktionsprotokolle programmgesteuert aktivieren, indem Sie die CloudWatch Protokolliert verkaufte APIs für die Protokollzustellung. Dieser Ansatz erfordert drei Schritte: Registrierung der Übermittlungsquelle, Konfiguration des Ziels und Erstellung der Übertragung.
Um Aktionsprotokolle mit dem zu aktivieren AWS CLI
-
Registrieren Sie die Übermittlungsquelle, indem Sie den folgenden Befehl ausführen:
aws logs put-delivery-source \ --namemy-ecs-action-logs\ --resource-arn arn:aws:ecs:region:account-id:cluster/cluster-name\ --log-type ACTION_LOGS -
Konfigurieren Sie das Lieferziel, indem Sie den folgenden Befehl ausführen:
aws logs put-delivery-destination \ --namemy-ecs-logs-destination\ --output-format json \ --delivery-destination-configuration '{"destinationResourceArn": "arn:aws:logs:region:account-id:log-group:/aws/vendedlogs/ecs/action-logs/cluster-name"}' -
Erstellen Sie die Lieferung, um die Quelle mit dem Ziel zu verknüpfen, indem Sie den folgenden Befehl ausführen:
aws logs create-delivery \ --delivery-source-namemy-ecs-action-logs\ --delivery-destination-arn arn:aws:logs:region:account-id:delivery-destination:my-ecs-logs-destination
Überprüfen Sie die Protokollzustellung
Nachdem Sie die Aktionsprotokolle aktiviert haben, stellen Sie sicher, dass die Protokolle an Ihr Ziel gesendet werden.
Um die Übermittlung von Protokollen zu überprüfen
-
Lösen Sie eine Aktion in Ihrem Cluster aus. Erstellen oder aktualisieren Sie beispielsweise einen Daemon-Dienst.
-
Öffnen Sie den CloudWatch Konsole unter https://console.aws.amazon.com/cloudwatch/.
-
Wählen Sie im Navigationsbereich Protokollgruppen aus.
-
Wählen Sie Ihre Aktionsprotokoll-Protokollgruppe aus und vergewissern Sie sich, dass neue Protokollstreams angezeigt werden.
Aktionsprotokolle löschen
Sie können Aktionsprotokolle löschen, indem Sie das AWS CLI oder die Amazon ECS-Konsole.
Um Aktionsprotokolle zu löschen, muss Ihre IAM-Identität über die folgenden zusätzlichen Berechtigungen verfügen:
{ "Effect": "Allow", "Action": [ "logs:DeleteDelivery", "logs:DeleteDeliverySource", "logs:DeleteDeliveryDestination" ], "Resource": "*" }
Um Aktionsprotokolle mit dem zu löschen AWS CLI
-
Löschen Sie die Lieferung, indem Sie den folgenden Befehl ausführen:
aws logs delete-delivery \ --delivery-iddelivery-id -
Löschen Sie die Übermittlungsquelle, indem Sie den folgenden Befehl ausführen:
aws logs delete-delivery-source \ --namemy-ecs-action-logs -
Löschen Sie das Lieferziel, indem Sie den folgenden Befehl ausführen:
aws logs delete-delivery-destination \ --namemy-ecs-logs-destination
Um Aktionsprotokolle mithilfe der Konsole zu löschen, navigieren Sie zur Cluster-Detailseite und wählen Sie Konfiguration Tab, und wählen Sie dann Löschen in der Aktionsprotokolle Abschnitt.
Nächste Schritte
Nachdem Sie die Aktionsprotokolle aktiviert haben, verwenden Sie die folgenden Ressourcen, um Ihre Amazon ECS-Cluster zu überwachen und Fehler zu beheben: