

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.

# Zonal Autoshift mit Amazon verwenden EventBridge
<a name="eventbridge-zonal-autoshift"></a>

Mit Amazon können Sie ereignisgesteuerte Regeln einrichten EventBridge, die Ihre zonalen Autoshift-Ressourcen überwachen, und gezielte Aktionen einleiten, die andere Dienste nutzen. AWS Sie können beispielsweise eine Regel für den Versand von E-Mail-Benachrichtigungen festlegen, indem Sie ein Amazon SNS-Thema angeben, wenn ein Testlauf für zonale Autoshift beginnt.

Sie können in Amazon Regeln erstellen, um bei zonaler EventBridge Autoshift zu reagieren. Ein Ereignis für die zonale automatische Verschiebung gibt Statusinformationen zu Übungsläufen oder automatischen Schichten an, z. B. wenn ein Testlauf gestartet wird. Sie können die zonale automatische Verschiebung so konfigurieren, dass Sie über zonale Autoshift-Ereignisse für Ressourcen informiert werden, die Sie für den Service aktivieren.

Sie können zusätzlich zu oder anstelle von anderen Benachrichtigungen auch die automatische Benachrichtigung für Beobachter aktivieren. Dabei wird ein Benachrichtigungsereignis ausgegeben, wenn eine automatische Schicht für eine potenziell beeinträchtigte AWS Availability Zone gestartet wird. Die Autoshift-Beobachterbenachrichtigung ist unabhängig von den Benachrichtigungen, die Sie erhalten, wenn der Verkehr für Ressourcen, die Sie für die zonale automatische Verschiebung aktiviert haben, von einer Availability Zone wegverlagert wird. Sie müssen keine Ressourcen mit zonaler Autoshift konfigurieren, um die Autoshift-Beobachter-Benachrichtigung zu aktivieren. Weitere Informationen finden Sie unter [Zonal Autoshift aktivieren und damit arbeiten](arc-zonal-autoshift.start-cancel.md). 

Um bestimmte zonale Autoshift-Ereignisse zu erfassen, an denen Sie interessiert sind, definieren Sie ereignisspezifische Muster, anhand derer die EventBridge Ereignisse erkannt werden können. Ereignismuster haben dieselbe Struktur wie die Ereignisse, denen sie entsprechen. Das Muster zitiert die Felder, die Sie abgleichen möchten, und liefert die Werte, nach denen Sie suchen. 

Ereignisse werden auf bestmögliche Weise ausgegeben. Sie werden unter normalen Betriebsbedingungen nahezu EventBridge in Echtzeit von ARC nach übertragen. Es können jedoch Situationen auftreten, die die Durchführung eines Ereignisses verzögern oder verhindern können.

Informationen zur Funktionsweise von EventBridge Regeln mit Ereignismustern finden Sie unter [ Ereignisse und Ereignismuster in EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eventbridge-and-event-patterns.html). 

## Überwachen Sie eine zonale Autoshift-Ressource mit EventBridge
<a name="arc-eventbridge-tasks-zonal-autoshift"></a>

Mit können Sie Regeln erstellen EventBridge, die Aktionen definieren, die zu ergreifen sind, wenn ARC Ereignisse für seine Ressourcen ausgibt. Sie können beispielsweise eine Regel erstellen, die eine E-Mail-Nachricht versendet, wenn ein Übungslauf für zonale automatische Verschiebungen beginnt. 

Um ein Ereignismuster einzugeben oder zu kopieren und in die EventBridge Konsole einzufügen, wählen Sie in der Konsole die ** Option Eigene ** eingeben aus. Um Ihnen bei der Bestimmung von Eventmustern zu helfen, die für Sie nützlich sein könnten, enthält dieses Thema Beispiele für Muster [ sowohl für ](#ZAEventBridgePatterns) zonale Autoshift-Ereignisse als auch für [ zonale Autoshift-Ereignisse, die Sie verwenden können. ](#ZAEventBridgeEventSamples) 

**So erstellen Sie eine Regel für ein Ressourcenereignis**

1. Öffnen Sie die Amazon-Konsole unter. EventBridge [ https://console.aws.amazon.com/events/ ](https://console.aws.amazon.com/events/)

1. Wählen Sie AWS-Region die Region aus, in der Sie die Regel erstellen möchten, d. h. die Region, für die Sie sich Ereignisse ansehen möchten.

1. Wählen Sie **Create rule (Regel erstellen)** aus.

1. Geben Sie für die Regel einen **Name (Namen)** und optional eine Beschreibung ein.

1. Belassen Sie für ** Event Bus ** den Standardwert ** default**.

1. Wählen Sie **Weiter** aus.

1. Belassen Sie für den ** Schritt ** Event-Muster ** erstellen für Event source ** den Standardwert **AWS events**.

1. Wählen Sie unter ** Beispielereignis ** die Option Eigenes ** eingeben aus**.

1. Geben Sie für ** Beispielereignisse ein Event-Muster ein**, oder kopieren Sie es und fügen Sie es ein.

## Beispiel für zonale Autoshift-Ereignismuster
<a name="arc-eventbridge-patterns-zonal-autoshift"></a>

Ereignismuster haben dieselbe Struktur wie die Ereignisse, denen sie entsprechen. Das Muster zitiert die Felder, die Sie abgleichen möchten, und liefert die Werte, nach denen Sie suchen.

Sie können Ereignismuster aus diesem Abschnitt kopieren und einfügen, um Regeln EventBridge zu erstellen, mit denen Sie zonale Autoshift-Aktionen und Ressourcen überwachen können.

Wenn Sie Ereignismuster für zonale Autoshift-Ereignisse erstellen, können Sie eine der folgenden Optionen für Folgendes angeben: `detail-type`
+ `Autoshift In Progress`
+ `Autoshift Completed`
+ `Practice Run Started`
+ `Practice Run Succeeded`
+ `Practice Run Interrupted`
+ `Practice Run Failed`
+ `FIS Experiment Autoshift In Progress`
+ `FIS Experiment Autoshift Completed`
+ `FIS Experiment Autoshift Canceled`
+ `Manual Shift Started`
+ `Manual Shift Updated`
+ `Manual Shift Canceled`

Wenn ein Übungslauf unterbrochen wird, finden Sie weitere Informationen darüber, was die Unterbrechung verursacht hat, in dem `additionalFailureInfo` Feld.

Sie können sich dafür entscheiden, alle AWS automatischen Schaltvorgänge zu überwachen, indem Sie die * automatische Schaltbeobachterbenachrichtigung aktivieren. * Nachdem Sie die Benachrichtigung für Beobachter der automatischen Schicht aktiviert haben, wählen Sie, ob Sie für den Zonen-Autoshift-Detailtyp benachrichtigt werden möchten, um die Benachrichtigungen zu erhalten. `Autoshift In Progress` Die Schritte zur Aktivierung der Benachrichtigung für Beobachter bei automatischer Verschiebung finden Sie unter. [Zonal Autoshift aktivieren und damit arbeiten](arc-zonal-autoshift.start-cancel.md)

Beispiele finden Sie im [ Abschnitt Beispiele für zonale Autoshift-Ereignisse. ](#ZAEventBridgeEventSamples)
+ *Wählen Sie alle Ereignisse aus der zonalen Autoshift aus, bei denen eine automatische Verschiebung begonnen hat. *

  Beachten Sie Folgendes:
  + Wenn Sie die Autoshift-Beobachter-Benachrichtigung aktiviert haben, gibt ARC alle Autoshift-Ereignisse zurück. 
  + Wenn Sie die Autoshift-Beobachter-Benachrichtigung nicht aktiviert haben, gibt ARC Autoshift-Ereignisse nur zurück, wenn eine Ressource, die Sie für die zonale automatische Verschiebung konfiguriert haben, in einer automatischen Verschiebung enthalten ist.

  ```
  {
      "source": [
          "aws.arc-zonal-shift"
      ],
      "detail-type": [
          "Autoshift In Progress"
      ]
  }
  ```
+ *Wählen Sie alle Ereignisse aus der zonalen Autoshift-Funktion aus, bei denen ein Übungslauf gestartet wurde. *

  ```
  {
      "source": [
          "aws.arc-zonal-shift"
      ],
      "detail-type": [
          "Practice Run Started"
      ]
  }
  ```
+ *Wählt alle Ereignisse aus der zonalen Autoshift aus, bei denen ein Übungslauf fehlgeschlagen ist. *

  ```
  {
      "source": [
          "aws.arc-zonal-shift"
      ],
      "detail-type": [
          "Practice Run Failed"
      ]
  }
  ```

## Beispiele für zonale Autoshift-Ereignisse
<a name="arc-eventbridge-examples-zonal-autoshift"></a>

Dieser Abschnitt enthält Beispielereignisse für * zonale Autoshift-Aktionen. *

Im Folgenden finden Sie ein Beispielereignis für die `Autoshift In Progress` Aktion, bei dem 1) die automatische Benachrichtigung für Beobachter * aktiviert ist * und 2) Sie keine Ressource mit zonaler Autoshift konfiguriert haben, die in einer automatischen Schicht enthalten ist:

```
{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":"AWS has started an autoshift for an impaired Availability Zone. This notification 
            is separate from autoshift notifications for resources, if any, that you have configured for 
            zonal autoshift. For details, see the Developer Guide."
        }
    }
}
```

Im Folgenden finden Sie ein Beispielereignis für die `Autoshift In Progress` Aktion, wenn 1) die Benachrichtigung für Beobachter mit automatischem Shift * deaktiviert ist * und 2) Sie eine Ressource mit zonaler Autoshift konfiguriert haben, die in einer automatischen Verschiebung enthalten ist:

```
{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}
```

Das Folgende ist ein Beispielereignis für die Aktion: `Practice Run Interrupted`

```
{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Practice Run Interrupted",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": {
            "additionalFailureInfo": "Practice run interrupted. The blocking alarm entered ALARM state."
        },
        "metadata": {
            "awayFrom": "use1-az2"
        }
    }
}
```

Das Folgende ist ein Beispielereignis für die `FIS Experiment Autoshift In Progress` Aktion:

```
{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "FIS Experiment Autoshift In Progress",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}
```

Das Folgende ist ein Beispielereignis für die `Manual Shift Started` Aktion. Es wird ausgegeben, wenn die `StartZonalShift` API für eine Ressource aufgerufen wird:

```
{
    "version": "0",
    "id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4",
    "detail-type": "Manual Shift Started",
    "source": "aws.arc-zonal-shift",
    "account": "111122223333",
    "time": "2023-11-16T23:38:14Z",
    "region": "us-east-1",
    "resources": [
        "TEST-EXAMPLE-2023-11-16-23-28-11-5"
    ],
    "detail": {
        "version": "0.0.1",
        "data": "",
        "metadata": {
            "awayFrom": "use1-az2",
            "notes":""
        }
    }
}
```

## Geben Sie eine CloudWatch Protokollgruppe an, die als Ziel verwendet werden soll
<a name="arc-eventbridge-cw-loggroup"></a>

Wenn Sie eine EventBridge Regel erstellen, müssen Sie das Ziel angeben, an das Ereignisse gesendet werden, die der Regel entsprechen. Eine Liste der verfügbaren Ziele für EventBridge finden Sie unter In der EventBridge Konsole verfügbare [ Ziele](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-console-targets). Eines der Ziele, die Sie einer EventBridge Regel hinzufügen können, ist eine CloudWatch Amazon-Protokollgruppe. In diesem Abschnitt werden die Anforderungen für das Hinzufügen von CloudWatch Protokollgruppen als Ziele beschrieben und ein Verfahren zum Hinzufügen einer Protokollgruppe beim Erstellen einer Regel beschrieben.

Um eine CloudWatch Protokollgruppe als Ziel hinzuzufügen, können Sie einen der folgenden Schritte ausführen:
+ Erstellen Sie eine neue Protokollgruppe 
+ Wählen Sie eine vorhandene Protokollgruppe

Wenn Sie beim Erstellen einer Regel mithilfe der Konsole eine neue Protokollgruppe angeben, EventBridge wird die Protokollgruppe automatisch für Sie erstellt. Stellen Sie sicher, dass die Protokollgruppe, die Sie als Ziel für die EventBridge Regel verwenden, mit beginnt`/aws/events`. Wenn Sie eine vorhandene Protokollgruppe auswählen möchten, beachten Sie, dass nur Protokollgruppen, die mit beginnen, als Optionen im Dropdownmenü `/aws/events` angezeigt werden. Weitere Informationen finden Sie [ im *CloudWatch Amazon-Benutzerhandbuch unter Eine neue Protokollgruppe*](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group) erstellen.

Wenn Sie mithilfe von CloudWatch Vorgängen außerhalb der Konsole eine CloudWatch Protokollgruppe erstellen oder verwenden, um sie als Ziel zu verwenden, stellen Sie sicher, dass Sie die Berechtigungen korrekt festgelegt haben. Wenn Sie die Konsole verwenden, um einer EventBridge Regel eine Protokollgruppe hinzuzufügen, wird die ressourcenbasierte Richtlinie für die Protokollgruppe automatisch aktualisiert. Wenn Sie jedoch das AWS Command Line Interface oder ein AWS SDK verwenden, um eine Protokollgruppe anzugeben, müssen Sie die ressourcenbasierte Richtlinie für die Protokollgruppe aktualisieren. Die folgende Beispielrichtlinie veranschaulicht die Berechtigungen, die Sie in einer ressourcenbasierten Richtlinie für die Protokollgruppe definieren müssen:

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 

    "Statement": [
        {
            "Action": [
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "events.amazonaws.com",
                    "delivery.logs.amazonaws.com"
                ]
            },
            "Resource": "arn:aws:logs:us-east-1:{{222222222222}}:log-group:/aws/events/*:*",
            "Sid": "TrustEventsToStoreLogEvent"
        }
    ]
}
```

------

Sie können keine ressourcenbasierte Richtlinie für eine Protokollgruppe mithilfe der Konsole konfigurieren. Verwenden Sie den API-Vorgang, um einer ressourcenbasierten Richtlinie die erforderlichen Berechtigungen hinzuzufügen. CloudWatch [ PutResourcePolicy ](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutResourcePolicy.html) Anschließend können Sie den CLI-Befehl [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-resource-policies.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-resource-policies.html) describe-resource-policies verwenden, um zu überprüfen, ob Ihre Richtlinie korrekt angewendet wurde.

**Um eine Regel für ein Ressourcenereignis zu erstellen und ein Protokollgruppenziel anzugeben CloudWatch**

1. Öffnen Sie die EventBridge Amazon-Konsole unter [ https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Wählen Sie AWS-Region die aus, in der Sie die Regel erstellen möchten.

1. Wählen Sie Regel ** erstellen ** und geben Sie dann alle Informationen zu dieser Regel ein, z. B. das Ereignismuster oder die Zeitplandetails.

   Weitere Informationen zum Erstellen von EventBridge Regeln für ARC finden Sie in den Abschnitten weiter oben in diesem Thema.

1. **Wählen Sie auf der ** Seite „Ziel auswählen ** CloudWatch**“ Ihr Ziel aus.

1. Wählen Sie eine CloudWatch Protokollgruppe aus dem Dropdownmenü aus.