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.
# Überwachen
**Wichtig**
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf [AWS re:POST](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).
Sie können Ihre Stacks folgendermaßen überwachen.
+ OpsWorks Stacks verwendet Amazon CloudWatch , um dreizehn benutzerdefinierte Metriken mit detaillierter Überwachung für jede Instanz im Stack bereitzustellen.
+ OpsWorks Stacks lässt sich integrieren AWS CloudTrail , um jeden OpsWorks Stacks-API-Aufruf zu protokollieren und die Daten in einem Amazon S3 S3-Bucket zu speichern.
+ Sie können Amazon CloudWatch Logs verwenden, um die System-, Anwendungs- und benutzerdefinierten Protokolle Ihres Stacks zu überwachen.
**Topics**
+ [Stacks mit Amazon überwachen CloudWatch](monitoring-cloudwatch.md)
+ [Protokollierung OpsWorks von Stacks-API-Aufrufen mit AWS CloudTrail](monitoring-cloudtrail.md)
+ [Amazon CloudWatch Logs mit OpsWorks Stacks verwenden](monitoring-cloudwatch-logs.md)
+ [Stacks mithilfe von Amazon CloudWatch Events überwachen](monitoring-cloudwatch-events.md)
# Stacks mit Amazon überwachen CloudWatch
**Wichtig**
Der AWS OpsWorks Stacks Service hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf [AWS re:POST](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).
OpsWorks Stacks verwendet Amazon CloudWatch (CloudWatch), um Stacks zu überwachen.
+ **Für Linux-Stacks unterstützt OpsWorks Stacks dreizehn benutzerdefinierte Metriken, um eine detaillierte Überwachung für jede Instance im Stack zu ermöglichen, und fasst die Daten für Sie übersichtlicher auf der Monitoring-Seite zusammen.**
+ Für Windows-Stacks können Sie die EC2 Amazon-Standardmetriken für Ihre Instances mit der [CloudWatch Konsole](https://console.aws.amazon.com/cloudwatch/) überwachen.
Die Seite **Monitoring (Überwachung)** zeigt jedoch keine Windows-Metriken an.
Auf der **Monitoring-Seite** werden Metriken für einen gesamten Stack, eine Ebene oder eine Instance angezeigt. OpsWorks Stacks-Metriken unterscheiden sich von EC2 Amazon-Metriken. Sie können auch zusätzliche Metriken über die CloudWatch Konsole aktivieren, für diese fallen jedoch in der Regel zusätzliche Gebühren an. Sie können die zugrunde liegenden Daten auch wie folgt auf der CloudWatch Konsole anzeigen:
**Um OpsWorks benutzerdefinierte Metriken anzuzeigen in CloudWatch**
1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Wählen Sie auf der Navigationsleiste die Region des Stacks aus.
1. Wählen Sie im Navigationsbereich **Metriken** aus.
1. Wählen Sie unter OpsWorks Metriken die Optionen **Instanzmetriken**, **Layer-Metriken** oder **Stack-Metriken** aus.
![\[CloudWatch metrics summary showing 362 total metrics across EBS, EC2, ElastiCache, and OpsWorks categories.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/monitor_cloudwatch.png)
**Anmerkung**
OpsWorks Stacks sammelt Metriken, indem auf jeder Instanz (dem Instanzagenten) ein Prozess ausgeführt wird. Da Metriken mithilfe des Hypervisors unterschiedlich CloudWatch erfasst werden, können sich die Werte in der CloudWatch Konsole geringfügig von den entsprechenden Werten auf der **Monitoring-Seite** in der OpsWorks Stacks-Konsole unterscheiden.
Sie können die CloudWatch Konsole auch verwenden, um Alarme einzustellen. Weitere Informationen zum Erstellen von Alarmen finden Sie unter [ CloudWatch Amazon-Alarme erstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html). Eine Liste der CloudWatch benutzerdefinierten Metriken finden Sie unter [ OpsWorksAWS-Metriken und -Dimensionen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/ops-metricscollected.html). Weitere Informationen finden Sie auf [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html).
**Topics**
+ [AWS OpsWorks Stapelt Metriken](#opsworks-metrics-dimensions)
+ [Dimensionen für OpsWorks Stacks-Metriken](#opsworks-metricdimensions)
+ [Stack-Metriken](#monitoring-cloudwatch-stack)
+ [Layer-Metriken](#monitoring-cloudwatch-layer)
+ [Instance-Metriken](#monitoring-cloudwatch-instance)
## AWS OpsWorks Stapelt Metriken
OpsWorks Stacks sendet CloudWatch alle fünf Minuten die folgenden Metriken.
**CPU-Metriken**
| Metrik | Description |
| --- | --- |
| `cpu_idle` | Der Prozentsatz der Zeit, die sich die CPU im Leerlauf befindet. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `cpu_nice` | Der Prozentsatz der Zeit, in der die CPU Prozesse mit einem positiven `nice` Wert verarbeitet, die eine niedrigere Scheduling-Priorität haben. Weitere Informationen darüber, was damit gemessen wird, finden Sie unter [nice (Unix)](http://en.wikipedia.org/wiki/Nice_(Unix)). Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `cpu_steal` | Da AWS Hypervisor-CPU-Ressourcen auf eine zunehmende Anzahl von Instances verteilt, steigt die Virtualisierungslast, was sich darauf auswirken kann, wie oft der Hypervisor die angeforderte Arbeit an einer Instance ausführen kann. `cpu_steal`misst den Prozentsatz der Zeit, in der eine Instance darauf wartet, dass der Hypervisor physische CPU-Ressourcen zuweist. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder. InstanceId Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `cpu_system` | Der Prozentsatz der Zeit, in der die CPU Systemvorgänge verarbeitet. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `cpu_user` | Der Prozentsatz der Zeit, in der die CPU Benutzeroperationen verarbeitet. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `cpu_waitio` | Der Prozentsatz der Zeit, in der die CPU auf input/output Operationen wartet. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
**Speichermetriken**
| Metrik | Description |
| --- | --- |
| `memory_buffers` | Die Menge des gepufferten Speichers. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `memory_cached` | Die Menge des zwischengespeicherten Speichers. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `memory_free` | Die Menge an freiem Speicher. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `memory_swap` | Die Größe des Swap-Speichers. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `memory_total` | Die Gesamtgröße des Speichers. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `memory_used` | Die Menge des verwendeten Speichers. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
**Metriken laden**
| Metrik | Description |
| --- | --- |
| `load_1` | Die Auslastung wurde über einen Zeitraum von einer Minute gemittelt. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder. InstanceId Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `load_5` | Die durchschnittliche Auslastung betrug über einen Zeitraum von fünf Minuten. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder. InstanceId Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
| `load_15` | Die Belastung wurde über einen Zeitraum von 15 Minuten gemittelt. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Messwerte anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
**Prozessmetriken**
| Metrik | Description |
| --- | --- |
| `procs` | Die Anzahl der aktiven Prozesse. Gültige Dimensionen: Die IDs einzelnen Ressourcen, für die Sie Kennzahlen anzeigen: StackId, LayerId, oder InstanceId. Gültige Statistiken: `Average``Minimum`,`Maximum`,`Sum`, oder`Data Samples`. Einheit: keine |
## Dimensionen für OpsWorks Stacks-Metriken
OpsWorks Stacks-Metriken verwenden den OpsWorks Stacks-Namespace und stellen Metriken für die folgenden Dimensionen bereit:
| Dimension | Description |
| --- | --- |
| `StackId` | Durchschnittliche Werte für einen Stack. |
| `LayerId` | Durchschnittliche Werte für einen Layer. |
| `InstanceId` | Durchschnittliche Werte für eine Instance. |
## Stack-Metriken
Um eine Zusammenfassung der Metriken für einen gesamten Stack anzuzeigen, wählen Sie einen Stack im OpsWorks **Stacks-Dashboard** aus und klicken Sie dann im Navigationsbereich auf **Monitoring**. Das folgende Beispiel ist für einen Stack mit einem PHP- und einem DB-Layer ausgelegt.
![\[Monitoring dashboard showing CPU, memory, load, and process metrics for system layers over time.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/monitor_stack.png)
Die Stack-Ansicht zeigt für jeden Layer über einen bestimmten Zeitraum (1 Stunde, 8 Stunden, 24 Stunden, 1 Woche oder 2 Wochen) Diagramme der vier Metriktypen an. Beachten Sie Folgendes:
+ OpsWorks Stacks aktualisiert die Grafiken regelmäßig. Der Countdown-Timer oben rechts gibt die verbleibende Zeit bis zur nächsten Aktualisierung an.
+ Wenn ein Layer mehr als eine Instance besitzt, zeigt das Diagramm Durchschnittswerte für den Layer an.
+ Sie können den Zeitraum angeben, indem Sie oben rechts auf die Liste klicken und Ihren gewünschten Wert auswählen.
Für jeden Metriktyp können Sie in der Liste oben im Diagramm die Metrik auswählen, die Sie gerne anzeigen möchten.
## Layer-Metriken
Wenn Sie Metriken für einen bestimmten Layer anzeigen möchten, klicken Sie auf den Layer-Namen in der Ansicht **Monitoring Layers (Überwachungs-Layer)**. Das folgende Beispiel zeigt Metriken für den PHP-Layer, der über zwei Instances verfügt.
![\[Monitoring dashboard showing CPU, memory, load, and processes for two PHP app server instances over time.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/monitor_layer.png)
Die Metriktypen sind die gleichen wie bei den Stack-Metriken und Sie können mithilfe der List oben im Diagramm für jeden Typ die Metrikanzeige, auswählen, die Sie sehen möchten.
**Anmerkung**
Sie können auch Layer-Metriken anzeigen, indem Sie die Seite "Layer-Details" aufrufen und oben rechts auf **Monitoring (Überwachung)** klicken.
## Instance-Metriken
Wenn Sie Metriken für eine bestimmte Instance anzeigen möchten, klicken Sie auf den Instance-Namen in der Layer-Überwachungsansicht. Das folgende Beispiel zeigt Metriken für die PHP-Layer-Instance **php-app1**.
![\[Dashboard showing CPU, memory, load, and process metrics for a PHP application instance.\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/monitor_instance.png)
Die Diagramme fassen alle verfügbaren Metriken für jeden Metriktyp zusammen. Um die genauen Werte für einen bestimmten Zeitpunkt abzurufen, bewegen Sie mit der Maus den Schieberegler (der rote Pfeil in der vorherigen Abbildung) auf die entsprechende Position.
**Anmerkung**
Sie können auch Instance-Metriken anzeigen, indem Sie die Detailseite der Instance aufrufen und oben rechts **Monitoring (Überwachung)** auswählen.
# Protokollierung OpsWorks von Stacks-API-Aufrufen mit AWS CloudTrail
**Wichtig**
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf [AWS re:POST](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).
OpsWorks Stacks ist in einen Dienst integriert AWS CloudTrail, der eine Aufzeichnung der Aktionen bereitstellt, die von einer IAM-Identität oder einem AWS Dienst in Stacks ausgeführt werden. OpsWorks CloudTrail erfasst alle API-Aufrufe für OpsWorks Stacks als Ereignisse, einschließlich Aufrufe von der OpsWorks Stacks-Konsole und von Codeaufrufen an die Stacks. OpsWorks APIs Wenn Sie einen Trail erstellen, können Sie die kontinuierliche Übermittlung von CloudTrail Ereignissen an einen Amazon S3 S3-Bucket aktivieren, einschließlich Ereignissen für OpsWorks Stacks. Wenn Sie keinen Trail konfigurieren, können Sie die neuesten Ereignisse trotzdem in der CloudTrail Konsole im **Ereignisverlauf** anzeigen. Anhand der von CloudTrail gesammelten Informationen können Sie die Anfrage an OpsWorks Stacks, die IP-Adresse, von der aus die Anfrage gestellt wurde, wer die Anfrage gestellt hat, wann sie gestellt wurde, und weitere Details ermitteln.
Weitere Informationen CloudTrail dazu finden Sie im [AWS CloudTrail Benutzerhandbuch](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
## OpsWorks Stapelt Informationen in CloudTrail
CloudTrail ist in Ihrem AWS Konto aktiviert, wenn Sie das Konto erstellen. Wenn Aktivitäten in OpsWorks Stacks auftreten, wird diese Aktivität zusammen mit anderen AWS Serviceereignissen in der CloudTrail **Ereignishistorie in einem Ereignis** aufgezeichnet. Sie können aktuelle Ereignisse in Ihrem AWS Konto ansehen, suchen und herunterladen. Weitere Informationen finden Sie unter [Ereignisse mit CloudTrail Ereignisverlauf anzeigen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html).
Für eine fortlaufende Aufzeichnung der Ereignisse in Ihrem AWS Konto, einschließlich der Ereignisse für OpsWorks Stacks, erstellen Sie einen Trail. Ein Trail ermöglicht CloudTrail die Übermittlung von Protokolldateien an einen Amazon S3 S3-Bucket. Wenn Sie einen Trail in der Konsole anlegen, gilt dieser für alle -Regionen. Der Trail protokolliert Ereignisse aus allen Regionen der AWS Partition und übermittelt die Protokolldateien an den von Ihnen angegebenen Amazon S3 S3-Bucket. Darüber hinaus können Sie andere AWS Dienste konfigurieren, um die in den CloudTrail Protokollen gesammelten Ereignisdaten weiter zu analysieren und darauf zu reagieren. Weitere Informationen finden Sie unter:
+ [Übersicht zum Erstellen eines Trails](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Unterstützte Dienste und Integrationen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Konfiguration von Amazon SNS SNS-Benachrichtigungen für CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Empfangen von CloudTrail Protokolldateien aus mehreren Regionen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) und [Empfangen von CloudTrail Protokolldateien von mehreren Konten](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html)
Alle OpsWorks Stacks-Aktionen werden von der [AWS OpsWorks Stacks-API-Referenz protokolliert CloudTrail und sind in dieser](https://docs.aws.amazon.com/opsworks/latest/APIReference/Welcome.html) dokumentiert. Beispielsweise generieren Aufrufe der `[StartInstance](https://docs.aws.amazon.com/opsworks/latest/APIReference/API_StartInstance.html)` Aktionen `[CreateLayer](https://docs.aws.amazon.com/opsworks/latest/APIReference/API_CreateLayer.html)``[DescribeInstances](https://docs.aws.amazon.com/opsworks/latest/APIReference/API_DescribeInstances.html)`, und Einträge in den CloudTrail Protokolldateien.
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:
+ Gibt an, ob die Anforderung mit Root- oder IAM-Benutzer-Anmeldeinformationen ausgeführt wurde.
+ Gibt an, ob die Anforderung mit temporären Sicherheitsanmeldeinformationen für eine Rolle oder einen Verbundbenutzer gesendet wurde.
+ Ob die Anfrage von einem anderen AWS Dienst gestellt wurde.
Weitere Informationen finden Sie unter [CloudTrail userIdentity-Element](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).
## Grundlegendes zu OpsWorks Stacks-Protokolldateieinträgen
Ein Trail ist eine Konfiguration, die die Übertragung von Ereignissen als Protokolldateien an einen von Ihnen angegebenen Amazon S3 S3-Bucket ermöglicht. CloudTrail Protokolldateien enthalten einen oder mehrere Protokolleinträge. Ein Ereignis stellt eine einzelne Anforderung aus einer beliebigen Quelle dar und enthält Informationen über die angeforderte Aktion, Datum und Uhrzeit der Aktion, Anforderungsparameter usw. CloudTrail Protokolldateien sind kein geordneter Stack-Trace der öffentlichen API-Aufrufe, sodass sie nicht in einer bestimmten Reihenfolge angezeigt werden.
Das folgende Beispiel zeigt einen CloudTrail Protokolleintrag, der die `CreateLayer` Aktion demonstriert.
```
{
"Records": [
{
"awsRegion": "us-west-2",
"eventID": "342cd1ec-8214-4a0f-a68f-8e6352feb5af",
"eventName": "CreateLayer",
"eventSource": "opsworks.amazonaws.com",
"eventTime": "2014-05-28T16:05:29Z",
"eventVersion": "1.01"ed,
"requestID": "e3952a2b-e681-11e3-aa71-81092480ee2e",
"requestParameters": {
"attributes": {},
"customRecipes": {},
"name": "2014-05-28 16:05:29 +0000 a073",
"shortname": "customcf4571d5c0d6",
"stackId": "a263312e-f937-4949-a91f-f32b6b641b2c",
"type": "custom"
},
"responseElements": null,
"sourceIPAddress": "198.51.100.0",
"userAgent": "aws-sdk-ruby/2.0.0 ruby/2.1 x86_64-linux",
"userIdentity": {
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"accountId": "111122223333",
"arn": "arn:aws:iam::111122223333:user/A-User-Name",
"principalId": "AKIAI44QH8DHBEXAMPLE",
"type": "IAMUser",
"userName": "A-User-Name"
}
},
{
"awsRegion": "us-west-2",
"eventID": "a860d8f8-c1eb-449b-8f55-eafc373b49a4",
"eventName": "DescribeInstances",
"eventSource": "opsworks.amazonaws.com",
"eventTime": "2014-05-28T16:05:31Z",
"eventVersion": "1.01",
"requestID": "e4691bfd-e681-11e3-aa71-81092480ee2e",
"requestParameters": {
"instanceIds": [
"218289c4-0492-473d-a990-3fbe1efa25f6"
]
},
"responseElements": null,
"sourceIPAddress": "198.51.100.0",
"userAgent": "aws-sdk-ruby/2.0.0 ruby/2.1x86_64-linux",
"userIdentity": {
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"accountId": "111122223333",
"arn": "arn:aws:iam::111122223333:user/A-User-Name",
"principalId": "AKIAI44QH8DHBEXAMPLE",
"type": "IAMUser",
"userName": "A-User-Name"
}
}
]
}
```
# Amazon CloudWatch Logs mit OpsWorks Stacks verwenden
**Wichtig**
Der AWS OpsWorks Stacks Service hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf [AWS re:POST](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).
Um die Überwachung von Protokollen auf mehreren Instances zu vereinfachen, unterstützt OpsWorks Stacks Amazon CloudWatch Logs. Sie aktivieren CloudWatch Logs auf Layer-Ebene in OpsWorks Stacks. CloudWatch Die Log-Integration funktioniert mit den Linux-basierten Stacks Chef 11.10 und Chef 12. Wenn Sie CloudWatch Logs aktivieren, fallen zusätzliche Gebühren an. Überprüfen Sie daher die [ CloudWatchAmazon-Preise](https://aws.amazon.com/cloudwatch/pricing/), bevor Sie beginnen.
CloudWatch Logs überwacht ausgewählte Protokolle auf das Auftreten eines benutzerdefinierten Musters. Sie können die Überwachung beispielsweise auf Zeichenfolgen wie `NullReferenceException` oder die Häufigkeit solcher Ereignisse ausrichten. Nachdem Sie CloudWatch Logs in OpsWorks Stacks aktiviert haben, sendet der OpsWorks Stacks-Agent die Protokolle an Logs. CloudWatch Weitere Informationen zu CloudWatch Logs finden Sie unter [Erste Schritte mit CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_GettingStarted.html) Logs.
## Voraussetzungen
Bevor Sie CloudWatch Logs aktivieren können, müssen Ihre Instances Version 3444 oder höher des OpsWorks Stacks-Agenten in Chef 11.10-Stacks und 4023 oder höher in Chef 12-Stacks ausführen. Sie müssen auch ein kompatibles Instanzprofil für alle Instanzen verwenden, die Sie mithilfe von Logs überwachen. CloudWatch
Wenn Sie ein benutzerdefiniertes Instanzprofil verwenden (eines, das OpsWorks Stacks bei der Erstellung des Stacks nicht bereitgestellt hat), kann OpsWorks Stacks das Instanzprofil nicht automatisch aktualisieren. Sie müssen die **AWSOpsWorksCloudWatchLogs**Richtlinie mithilfe von IAM manuell an Ihr Profil anhängen. Weitere Informationen finden Sie im [IAM-Benutzerhandbuch unter Verwaltung von *IAM-Richtlinien*](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-using.html#attach-managed-policy-console).
**Wenn Sie Ihre Agentenversion oder Ihr Instanzprofil aktualisieren müssen, zeigt OpsWorks Stacks eine Erinnerung an, die dem folgenden Screenshot ähnelt, wenn Sie den Tab CloudWatch Logs auf der Layer-Seite öffnen.**
![\[CloudWatch Registerkarte „Logs“ auf der Layer-Seite\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cw_logs_upgrade.png)
Es kann einige Zeit in Anspruch nehmen, den Agenten auf allen Instances eines Layers zu aktualisieren. Wenn Sie versuchen, CloudWatch Logs on a Layer zu aktivieren, bevor das Agent-Upgrade abgeschlossen ist, wird eine Meldung ähnlich der folgenden angezeigt.
![\[CloudWatch Registerkarte „Protokolle“ auf der Layer-Seite\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cloudwatch_logs_upgrade_time.png)
## CloudWatch Protokolle aktivieren
1. Nachdem alle erforderlichen Upgrades von Agenten- und Instanzprofilen abgeschlossen sind, können Sie CloudWatch Logs aktivieren, indem Sie den Schieberegler auf der Registerkarte **CloudWatch Logs** auf **On** setzen.
![\[CloudWatch Steuerung des Schiebereglers Protokolle\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cw_logs_enable_switch.png)
1. Um Befehlsprotokolle zu streamen, verschieben Sie den Regler **Stream command logs (Befehlsprotokolle streamen)** auf **On (Ein)**. Dadurch werden Protokolle der Chef-Aktivitäten und der vom Benutzer initiierten Befehle auf den Instanzen Ihres Layers an CloudWatch Logs gesendet.
Die in diesen Protokollen enthaltenen Daten stimmen weitgehend mit dem überein, was Sie in den Ergebnissen eines [DescribeCommands](https://docs.aws.amazon.com/opsworks/latest/APIReference/API_DescribeCommands.html)Vorgangs sehen, wenn Sie das Ziel der Protokoll-URL öffnen. Es enthält Daten zu `setup`, `configure`, `deploy`, `undeploy`, `start`, `stop` sowie zu Rezeptausführungsbefehlen.
1. Um Protokolle zu Aktivitäten zu streamen, die an benutzerdefinierten Speicherorten auf den Instances des Layers gespeichert werden, z. B. `/var/log/apache/myapp/mylog*`, geben Sie den benutzerdefinierten Speicherort im Eingabefeld **Stream custom logs (Befehlsprotokolle streamen)** ein und klicken Sie auf **Add (Hinzufügen)** (**\$1**).
1. Wählen Sie **Speichern**. Innerhalb weniger Minuten sollten die OpsWorks Stacks-Protokollstreams in der CloudWatch Logs-Konsole sichtbar sein.
![\[CloudWatch Logs ist aktiviert\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cw_logs_enabled.png)
## CloudWatch Protokolle ausschalten
Um CloudWatch Logs zu deaktivieren, bearbeiten Sie Ihre Layer-Einstellungen.
1. Wählen Sie auf der Eigenschaftsseite des Layers **Edit (Bearbeiten)** aus.
![\[Schaltfläche "Edit (Bearbeiten)" auf der Layer-Seite "Properties (Eigenschaften)"\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cw_logs_enabled_edit.png)
1. Wählen Sie auf der Bearbeitungsseite die Registerkarte **CloudWatch Protokolle** aus.
1. Deaktivieren Sie im Bereich **CloudWatch Logs** die Option **Stream-Befehlsprotokolle**. Wählen Sie gegebenenfalls bei benutzerdefinierten Protokollen **X** aus, um die Protokolle aus den Protokoll-Streams zu löschen.
1. Wählen Sie **Speichern**.
### Löschen von gestreamten Protokollen aus CloudWatch Protokollen
Nachdem Sie das Streaming von CloudWatch Protokollen aus OpsWorks Stacks deaktiviert haben, sind vorhandene Protokolle weiterhin in der CloudWatch Logs-Verwaltungskonsole verfügbar. Es fallen weiterhin Gebühren für gespeicherte Protokolle an, es sei denn, Sie exportieren die Protokolle nach Amazon S3 oder löschen sie. Weitere Informationen zum Exportieren von Protokollen nach S3 finden Sie unter [Exportieren von Protokolldaten nach Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3Export.html).
Sie können Protokollstreams und Protokollgruppen in der CloudWatch Logs-Verwaltungskonsole oder durch Ausführen der [https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-group.html](https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-group.html) AWS CLI Befehle [https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-stream.html](https://docs.aws.amazon.com/cli/latest/reference/logs/delete-log-stream.html)und löschen. Weitere Informationen zur Änderung der Aufbewahrungsfristen für Protokolle finden Sie unter [Ändern der Aufbewahrung von Protokolldaten in CloudWatch Protokollen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SettingLogRetention.html).
## Verwaltung Ihrer Logs in CloudWatch Logs
Die Logs, die Sie streamen, werden in der CloudWatch Logs-Konsole verwaltet.
![\[CloudWatch Protokollkonsole\]](http://docs.aws.amazon.com/de_de/opsworks/latest/userguide/images/cw_logs_dash.png)
OpsWorks erstellt automatisch Standard-Protokollgruppen und Protokollstreams. Die Namen von Protokollgruppen für OpsWorks Stacks-Daten werden nach folgendem Muster erstellt:
*stack\$1name*`/`*layer\$1name*`/`*chef\$1log\$1name*
Namen für benutzerdefinierte Protokolle werden nach folgendem Muster generiert:
*/stack\$1name/layer\$1short\$1name/file\$1path\$1name*. Der Pfadname wird durch das Entfernen von Sonderzeichen wie Sternchen (\$1) für Menschen lesbarer gemacht.
[Wenn Sie Ihre Logs in Logs gefunden haben, können Sie [die CloudWatch Logs in Gruppen organisieren, Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Create-Log-Group.html)[suchen und filtern, indem Sie Metrikfilter erstellen](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/MonitoringLogData.html), und benutzerdefinierte Alarme erstellen.](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)
## Konfiguration von Chef 12.2 Windows-Layern für die Verwendung von Protokollen CloudWatch
CloudWatch Die automatische Integration von Protokollen wird für Windows-basierte Instanzen nicht unterstützt. Die Registerkarte **CloudWatch Protokolle** ist für Ebenen in Chef 12.2-Stacks nicht verfügbar. Gehen Sie wie folgt vor, um das Streaming in CloudWatch Logs für Windows-basierte Instanzen manuell zu aktivieren.
+ Aktualisieren Sie das Instanzprofil für Windows-basierte Instanzen, sodass der CloudWatch Logs-Agent über die entsprechenden Berechtigungen verfügt. Der Richtlinienanweisung **AWSOpsWorksCloudWatchLogs** können Sie entnehmen, welche Berechtigungen erforderlich sind.
Normalerweise müssen Sie diese Aufgabe nur einmal ausführen. Sie können das aktualisierte Instance-Profil dann für alle Windows-Instances eines Layers verwenden.
+ Bearbeiten Sie die folgende JSON-Konfigurationsdatei auf jeder Instance. Diese Datei enthält Einstellungen für Protokoll-Streams, beispielsweise welche Protokolle überwacht werden sollen.
`%PROGRAMFILES%\Amazon\Ec2ConfigService\Settings\AWS.EC2.Windows.CloudWatch.json`
Sie können die beiden vorherigen Aufgaben auch automatisieren. Erstellen Sie dafür benutzerdefinierte Rezepte für die erforderlichen Aufgaben und weisen Sie sie den **Setup (Einrichtung)**-Ereignissen des Chef 12.2-Layers zu. Jedes Mal, wenn Sie eine neue Instanz auf diesen Layern starten, führt OpsWorks Stacks Ihre Rezepte automatisch aus, nachdem die Instanz gestartet ist, wodurch Logs aktiviert wird. CloudWatch
Um CloudWatch Logs auf Windows-basierten Instances zu deaktivieren, kehren Sie den Vorgang um. Deaktivieren Sie das Kontrollkästchen ** CloudWatch Protokollintegration aktivieren** im Dialogfeld **EC2 Diensteigenschaften**, löschen Sie die Log-Stream-Einstellungen aus der `AWS.EC2.Windows.CloudWatch.json` Datei und beenden Sie die Ausführung von Chef-Rezepten, die neuen Instanzen in Chef 12.2-Ebenen automatisch CloudWatch Logs-Berechtigungen zuweisen.
# Stacks mithilfe von Amazon CloudWatch Events überwachen
**Wichtig**
Der AWS OpsWorks Stacks Dienst hat am 26. Mai 2024 das Ende seiner Lebensdauer erreicht und wurde sowohl für neue als auch für bestehende Kunden deaktiviert. Wir empfehlen Kunden dringend, ihre Workloads so bald wie möglich auf andere Lösungen zu migrieren. Wenn Sie Fragen zur Migration haben, wenden Sie sich an das AWS Support Team auf [AWS re:POST](https://repost.aws/) oder über den [AWS Premium-Support](https://aws.amazon.com/support).
Sie können Regeln in Amazon CloudWatch Events konfigurieren, um Sie über Änderungen an den OpsWorks Stacks-Ressourcen zu informieren und CloudWatch Events anzuweisen, auf der Grundlage von Veranstaltungsinhalten Maßnahmen zu ergreifen. Weitere Informationen zu den ersten Schritten mit CloudWatch Events und zum Einrichten von Regeln finden Sie unter [Erste Schritte mit CloudWatch CloudWatch Events](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CWE_GettingStarted.html) *im Events-Benutzerhandbuch*.
Die folgenden OpsWorks Stacks-Ereignistypen werden in CloudWatch Events unterstützt.
**Instance-Zustandsänderungen**
Weist auf eine Änderung des Status einer OpsWorks Stacks-Instanz hin.
**Befehls-Zustandsänderung**
Zeigt an, dass der Status eines OpsWorks Stacks-Befehls geändert wurde.
**Bereitstellungs-Zustandsänderung**
Zeigt an, dass sich der Status einer OpsWorks Stacks-Bereitstellung geändert hat.
**Benachrichtigungen**
Zeigt an, dass ein OpsWorks Stacks-Dienstfehler ausgelöst wurde.
Weitere Informationen zu den OpsWorks Stacks-Ereignistypen, die von CloudWatch Events unterstützt werden, finden Sie unter [OpsWorks*CloudWatch Stacks-Ereignisse* im Events-Benutzerhandbuch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#opsworks_event_types).