View a markdown version of this page

Protokollieren Sie Amazon ECS-API-Aufrufe mit AWS CloudTrail - Amazon Elastic Container Service

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.

Protokollieren Sie Amazon ECS-API-Aufrufe mit AWS CloudTrail

Amazon Elastic Container Service ist integriert in AWS CloudTrail, ein Dienst, der eine Aufzeichnung der von einem Benutzer, einer Rolle oder einem AWS-Service. CloudTrail erfasst alle API-Aufrufe für Amazon ECS als Ereignisse. Zu den erfassten Aufrufen gehören Aufrufe von der Amazon-ECS-Konsole und Code-Aufrufe an die Amazon-ECS-API-Vorgänge. Unter Verwendung der gesammelten Informationen von CloudTrail, Sie können die Anfrage, die an Amazon ECS gestellt wurde, die IP-Adresse, von der aus die Anfrage gestellt wurde, den Zeitpunkt der Anfrage sowie weitere Details ermitteln.

Jeder Ereignis- oder Protokolleintrag enthält Informationen zu dem Benutzer, der die Anforderung generiert hat. Die Identitätsinformationen unterstützen Sie bei der Ermittlung der folgenden Punkte:

  • Ob die Anforderung mit Anmeldeinformationen des Root-Benutzers oder des Benutzers gestellt wurde.

  • Die Anforderung wurde im Namen eines IAM-Identity-Center-Benutzers erstellt.

  • Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.

  • Ob die Anforderung aus einem anderen AWS-Service gesendet wurde.

CloudTrail ist aktiv in Ihrem AWS-Konto wenn du das Konto erstellst und du automatisch Zugriff auf CloudTrail Verlauf der Ereignisse. Das CloudTrail Verlauf der Veranstaltung bietet eine sichtbare, durchsuchbare, herunterladbare und unveränderliche Aufzeichnung der aufgezeichneten Verwaltungsereignisse der letzten 90 Tage in einer AWS-Region. Weitere Informationen finden Sie unter Arbeiten mit CloudTrail Verlauf des Ereignisses in der AWS CloudTrail Benutzerleitfaden. Es gibt keine CloudTrail Gebühren für das Ansehen der Verlauf der Veranstaltung.

Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS-Konto Erstellen Sie in den letzten 90 Tagen einen Trail oder einen CloudTrail See Datenspeicher für Ereignisse.

CloudTrail Wanderwege

EIN Wanderweg aktiviert CloudTrail um Protokolldateien an einen Amazon S3-Bucket zu liefern. Alle Trails, die mit dem erstellt wurden AWS-Managementkonsole sind multiregional. Sie können mithilfe von AWS CLI einen Einzel-Region- oder einen Multi-Region-Trail erstellen. Es wird empfohlen, einen Pfad mit mehreren Regionen zu erstellen, da Sie die Aktivitäten in allen Bereichen erfassen AWS-Regionen in deinem Konto. Wenn Sie einen Einzel-Region-Trail erstellen, können Sie nur die Ereignisse anzeigen, die im AWS-Region des Trails protokolliert wurden. Weitere Informationen zu Trails finden Sie unter Erstellen eines Trails für Ihr AWS-Konto und Erstellen eines Trails für eine Organisation im AWS CloudTrail -Benutzerhandbuch.

Sie können eine Kopie Ihrer laufenden Verwaltungsereignisse kostenlos an Ihren Amazon S3-Bucket senden von CloudTrail Wenn Sie einen Trail erstellen, fallen jedoch Amazon S3-Speichergebühren an. Für weitere Informationen über CloudTrail Preisgestaltung finden Sie unter AWS CloudTrail Preisgestaltung. Informationen zu Amazon-S3-Preisen finden Sie unter Amazon S3 – Preise.

CloudTrail Datenspeicher für See-Ereignisse

CloudTrail See lässt dich rennen SQL-based Abfragen zu Ihren Veranstaltungen. CloudTrail Lake konvertiert vorhandene Ereignisse im zeilenbasierten JSON-Format in Apache ORC formatieren. ORC ist ein spaltenförmiges Speicherformat, das für den schnellen Abruf von Daten optimiert ist. Die Ereignisse werden in Ereignisdatenspeichern zusammengefasst, bei denen es sich um unveränderliche Sammlungen von Ereignissen handelt, die auf Kriterien basieren, die Sie mit Hilfe von erweiterten Ereignisselektoren auswählen. Die Selektoren, die Sie auf einen Ereignisdatenspeicher anwenden, steuern, welche Ereignisse bestehen bleiben und für Sie zur Abfrage verfügbar sind. Für weitere Informationen über CloudTrail See, siehe Arbeitet mit AWS CloudTrail See in der AWS CloudTrail Benutzerleitfaden.

CloudTrail Das Speichern und Abfragen von Lake Event-Daten ist mit Kosten verbunden. Beim Erstellen eines Ereignisdatenspeichers wählen Sie die Preisoption aus, die für den Ereignisdatenspeicher genutzt werden soll. Die Preisoption bestimmt die Kosten für die Erfassung und Speicherung von Ereignissen sowie die standardmäßige und maximale Aufbewahrungsdauer für den Ereignisdatenspeicher. Für weitere Informationen über CloudTrail Preisgestaltung finden Sie unter AWS CloudTrail Preisgestaltung.

Amazon ECS-Verwaltungsereignisse in CloudTrail

Ereignisse im Management stellen Sie Informationen zu Verwaltungsvorgängen bereit, die an Ressourcen in Ihrem AWS-Konto. Sie werden auch als Vorgänge auf Steuerebene bezeichnet. In der Standardeinstellung CloudTrail protokolliert Verwaltungsereignisse.

Amazon Elastic Container Service protokolliert alle Vorgänge der Amazon-ECS-Steuerebene als Verwaltungsereignisse. Zum Beispiel Anrufe an die CreateService, RunTask und DeleteCluster Abschnitte generieren Einträge in der CloudTrail Protokolldateien. Für eine Liste der Steuerungsebenenoperationen von Amazon Elastic Container Service, bei denen Amazon ECS protokolliert CloudTrail, siehe Amazon Elastic Container Service API-Referenz.

Amazon ECS-Datenereignisse in CloudTrail

Datenereignisse stellt Informationen zu den Ressourcenoperationen bereit, die an oder in einer Ressource ausgeführt werden. In der Standardeinstellung CloudTrail protokolliert keine Datenereignisse. Das CloudTrail Verlauf der Veranstaltung zeichnet keine Datenereignisse auf.

Für Datenereignisse werden zusätzliche Gebühren fällig. Für weitere Informationen über CloudTrail Preisgestaltung finden Sie unter AWS CloudTrail Preisgestaltung.

Sie können Datenereignisse für die Amazon ECS-Ressourcentypen protokollieren, indem Sie den CloudTrail Konsole, AWS CLI, oder CloudTrail API-Operationen. Weitere Informationen zum Protokollieren von Datenereignissen finden Sie unter Protokollieren von Datenereignissen mit dem AWS-Managementkonsole und Protokollieren von Datenereignissen mit dem AWS Command Line Interface im AWS CloudTrail -Benutzerhandbuch.

In der folgenden Tabelle sind die Amazon ECS-Ressourcentypen aufgeführt, für die Sie Datenereignisse protokollieren können. Die Typ des Datenereignisses (Konsole) Die Spalte zeigt den Wert, aus dem Sie wählen können Typ des Datenereignisses Liste auf der CloudTrail Konsole. Die Der Wert resources.type Die Spalte zeigt den resources.type Wert, den Sie bei der Konfiguration erweiterter Event-Selektoren mit dem AWS CLI oder CloudTrail APIs. Die Daten-APIs, bei denen protokolliert wurde CloudTrail Die Spalte zeigt die API-Aufrufe, bei denen protokolliert wurde CloudTrail für den Ressourcentyp.

Typ des Datenereignisses (Konsole) resources.type-Wert Daten-APIs, bei denen protokolliert wurde CloudTrail
AwsApiCall AWS::ECS::ContainerInstance
  • ecs:Poll (für verwaltete EC2- und Amazon ECS-Instances)

  • ecs:StartTelemetrySession (für verwaltete EC2- und Amazon ECS-Instances)

  • ecs:PutSystemLogEvents (für von Amazon ECS verwaltete Instances)

Sie können erweiterte Event-Selektoren so konfigurieren, dass sie nach den Feldern eventName, readOnly und resources.ARN filtern, sodass nur die Ereignisse protokolliert werden, die für Sie wichtig sind. Weitere Informationen zu diesen Kontingenten finden Sie unter AdvancedFieldSelector in derAWS CloudTrail -API-Referenz.

Beispiele für Amazon-ECS-API-Ereignisse

Ein Ereignis stellt eine einzelne Anfrage aus einer beliebigen Quelle dar und enthält Informationen über den angeforderten API-Vorgang, Datum und Uhrzeit des Vorgangs, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass Ereignisse nicht in einer bestimmten Reihenfolge angezeigt werden.

Das folgende Beispiel zeigt eine CloudTrail Ereignis, das demonstriert CreateService Aktion.

Anmerkung

Dieses Beispiel wurde für eine bessere Lesbarkeit formatiert. In einem CloudTrail Protokolldatei, alle Einträge und Ereignisse werden in einer einzigen Zeile zusammengefasst. Außerdem ist dieses Beispiel auf einen einzigen Amazon-ECS-Eintrag beschränkt. In einem echten CloudTrail Logdatei, Sie sehen Einträge und Ereignisse von mehreren AWS Dienste.

{ "eventVersion": "1.04", "userIdentity": { "type": "AssumedRole", "principalId": "AIDACKCEVSQ6C2EXAMPLE:account_name", "arn": "arn:aws:sts::123456789012:user/Mary_Major", "accountId": "123456789012", "accessKeyId": "AKIAIOSFODNN7EXAMPLE", "sessionContext": { "attributes": { "mfaAuthenticated": "false", "creationDate": "2018-06-20T18:32:25Z" }, "sessionIssuer": { "type": "Role", "principalId": "AIDACKCEVSQ6C2EXAMPLE", "arn": "arn:aws:iam::123456789012:role/Admin", "accountId": "123456789012", "userName": "Mary_Major" } } }, "eventTime": "2018-06-20T19:04:36Z", "eventSource": "ecs.amazonaws.com", "eventName": "CreateCluster", "awsRegion": "us-east-1", "sourceIPAddress": "203.0.113.12", "userAgent": "console.amazonaws.com", "requestParameters": { "clusterName": "default" }, "responseElements": { "cluster": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/default", "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "status": "ACTIVE", "runningTasksCount": 0, "statistics": [], "clusterName": "default", "activeServicesCount": 0 } }, "requestID": "cb8c167e-EXAMPLE", "eventID": "e3c6f4ce-EXAMPLE", "eventType": "AwsApiCall", "recipientAccountId": "123456789012" }

Für Informationen über CloudTrail Inhalt aufzeichnen, siehe CloudTrail Inhalt aufzeichnen in der AWS CloudTrail Benutzerleitfaden.