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 Sie GoldenGate Oracle-Protokolle mithilfe von Amazon CloudWatch *Chithra Krishnamurthy, Amazon Web Services* ## Zusammenfassung Oracle GoldenGate bietet Echtzeitreplikation zwischen Amazon Relational Database Service (Amazon RDS) für Oracle-Datenbanken oder zwischen Oracle-Datenbanken, die auf Amazon Elastic Compute Cloud (Amazon EC2) gehostet werden. Es unterstützt sowohl unidirektionale als auch bidirektionale Replikation. Bei der Replikation ist die Überwachung von entscheidender Bedeutung, um sicherzustellen, dass der GoldenGate Prozess ordnungsgemäß ausgeführt wird und ob die Quell- und Zieldatenbanken synchron sind. GoldenGate Dieses Muster erklärt die Schritte zur Implementierung der CloudWatch Amazon-Überwachung für ein GoldenGate Fehlerprotokoll und wie Alarme eingerichtet werden, um Benachrichtigungen für bestimmte Ereignisse zu senden, z. B. `STOP` `ABEND` damit Sie geeignete Maßnahmen ergreifen können, um die Replikation schnell wieder aufzunehmen. ## Voraussetzungen und Einschränkungen **Voraussetzungen** + GoldenGate auf einer EC2-Instance installiert und konfiguriert, sodass Sie die CloudWatch Überwachung dieser EC2-Instances einrichten können. Wenn Sie die bidirektionale Replikation GoldenGate in allen AWS-Regionen überwachen möchten, müssen Sie den CloudWatch Agenten in jeder EC2-Instance installieren, auf der der GoldenGate Prozess ausgeführt wird. **Einschränkungen** + Dieses Muster erklärt, wie der GoldenGate Prozess mithilfe von überwacht wird CloudWatch. CloudWatch überwacht keine Verzögerungen bei der Replikation oder Probleme mit der Datensynchronisierung während der Replikation. Sie müssen separate SQL-Abfragen ausführen, um die Replikationsverzögerung oder datenbezogene Fehler zu überwachen, wie in der [GoldenGate Dokumentation](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html) beschrieben. **Produktversionen** + Dieses Dokument basiert auf der Implementierung von Oracle GoldenGate 19.1.0.0.4 für Oracle auf Linux x86-64. Diese Lösung gilt jedoch für alle Hauptversionen von. GoldenGate ## Architektur **Zieltechnologie-Stack** + GoldenGate Binärdateien für Oracle, die auf einer EC2-Instance installiert sind + Amazon CloudWatch + Amazon-Simple-Notification-Service (Amazon-SNS) **Zielarchitektur** ![Zielarchitektur für die Überwachung von GoldenGate Protokollen auf AWS](http://docs.aws.amazon.com/de_de/prescriptive-guidance/latest/patterns/images/pattern-img/973a71d5-b6b3-4a2b-813e-cb4d8fd51ba5/images/1781aa9b-77b3-40c4-bc54-3cb91400899c.png) ## Tools **AWS-Services** + [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) ist ein Überwachungsdienst, der in diesem Muster zur Überwachung von GoldenGate Fehlerprotokollen verwendet wird. + [Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) ist ein Benachrichtigungsservice, der in diesem Muster zum Senden von E-Mail-Benachrichtigungen verwendet wird. **Andere Tools** + [Oracle GoldenGate ](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html) ist ein Datenreplikationstool, das Sie für Amazon RDS for Oracle Oracle-Datenbanken oder Oracle-Datenbanken verwenden können, die auf Amazon EC2 gehostet werden. **Implementierungsschritte auf hoher Ebene** 1. Erstellen Sie eine AWS Identity and Access Management (IAM) -Rolle für den CloudWatch Agenten. 1. Ordnen Sie die IAM-Rolle der EC2-Instance zu, in der GoldenGate Fehlerprotokolle generiert werden. 1. Installieren Sie den CloudWatch Agenten auf der EC2-Instance. 1. Konfigurieren Sie die CloudWatch Agenten-Konfigurationsdateien: `awscli.conf` und`awslogs.conf`. 1. Starten Sie den CloudWatch Agenten. 1. Erstellen Sie Metrikfilter in der Protokollgruppe. 1. Richten Sie Amazon SNS ein. 1. Erstellen Sie einen Alarm für die metrischen Filter. Amazon SNS sendet E-Mail-Benachrichtigungen, wenn diese Filter Ereignisse erfassen. Eine ausführliche Anleitung finden Sie im nächsten Abschnitt. ## Epen ### Schritt 1. Erstellen Sie eine IAM-Rolle für den Agenten CloudWatch | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Erstellen Sie die IAM-Rolle. | Für den Zugriff auf AWS-Ressourcen sind Berechtigungen erforderlich. Daher erstellen Sie IAM-Rollen, die die Berechtigungen enthalten, die für jeden Server zur Ausführung des CloudWatch Agenten erforderlich sind.
So erstellen Sie die IAM-Rolle:1. Melden Sie sich in der AWS-Managementkonsole an und öffnen Sie die IAM-Konsole unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
2. Wählen Sie im Navigationsbereich **Rollen** und dann **Rolle erstellen**.
3. Wählen Sie für **Vertrauenswürdigen Entitätstyp** die Option **AWS-Service** aus.
4. Wählen Sie für **Allgemeine Anwendungsfälle** **EC2** und dann **Weiter** aus.
5. Aktivieren Sie in der Liste der Richtlinien das Kontrollkästchen neben **CloudWatchAgentServerPolicy**. Verwenden Sie ggf. das Suchfeld, um die Richtlinie zu finden.
6. Wählen Sie **Weiter** aus.
7. Geben Sie unter **Role name (Rollenname)** einen Namen für Ihre neue Rolle, wie z. B. `goldengate-cw-monitoring-role`, oder einen anderen von Ihnen bevorzugten Namen ein.
8. (Optional) Geben Sie im Feld **Role description (Rollenbeschreibung)** eine Beschreibung ein.
9. Vergewissern Sie sich, dass dies unter **Richtlinienname **CloudWatchAgentServerPolicy****angezeigt wird.
10. (Optional) Fügen Sie ein oder mehrere Tags (Schlüssel-Wert-Paare) hinzu, um den Zugriff für diese Rolle zu organisieren, nachzuverfolgen oder zu kontrollieren, und wählen Sie dann Rolle **erstellen** aus. | AWS allgemein | ### Schritt 2. Hängen Sie die IAM-Rolle an die GoldenGate EC2-Instance an | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Ordnen Sie die IAM-Rolle der EC2-Instance zu, in der GoldenGate Fehlerprotokolle generiert werden. | Die von generierten Fehlerprotokolle GoldenGate müssen mit Daten gefüllt CloudWatch und überwacht werden. Daher müssen Sie die in Schritt 1 erstellte IAM-Rolle der EC2-Instance zuordnen, auf der sie ausgeführt wird. GoldenGate
Um einer Instance eine IAM-Rolle zuzuweisen:1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
2. Wählen Sie im Navigationsbereich **Instances** aus und suchen Sie dann die Instance, auf der ausgeführt GoldenGate wird.
3. Wählen Sie die Instanz aus und wählen Sie dann **Aktionen**, **Sicherheit**, **IAM-Rolle ändern** aus.
4. **Wählen Sie die im ersten Schritt erstellte IAM-Rolle aus, um sie an Ihre Instance anzuhängen, und klicken Sie dann auf Speichern.** | AWS allgemein | ### Schritte 3—5. Installieren und konfigurieren Sie den CloudWatch Agenten auf der Goldengate EC2-Instanz | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Installieren Sie den CloudWatch Agenten auf der GoldenGate EC2-Instance. | Führen Sie den folgenden Befehl aus, um den Agenten zu installieren:
sudo yum install -y awslogs
| AWS allgemein | | Bearbeiten Sie die Agenten-Konfigurationsdateien. | 1. Führen Sie den folgenden Befehl aus.
sudo su -

2. Bearbeiten Sie diese Datei, um die AWS-Region nach Bedarf zu aktualisieren.
cat /etc/awslogs/conf
[plugins]
cwlogs = cwlogs
[default]
region = us-east-1

3. Bearbeiten Sie die `/etc/awslogs/awslogs.conf` Datei, um den Dateinamen, den Namen der Protokollgruppe und das date/time Format zu aktualisieren. Sie date/time müssen das Format angeben, das dem Datumsformat entspricht. `ggserror.log` Andernfalls fließt der Log-Stream nicht hinein CloudWatch. Beispiel:
datetime_format = %Y-%m-%dT%H:%M:%S%z
file = /u03/oracle/oragg/ggserr.log
log_group_name = goldengate_monitor
| AWS allgemein | | Starten Sie den CloudWatch Agenten. | Verwenden Sie den folgenden Befehl, um den Agenten zu starten.
$ sudo service awslogsd start

Nachdem Sie den Agenten gestartet haben, können Sie die Protokollgruppe in der CloudWatch Konsole anzeigen. Der Protokollstream wird den Inhalt der Datei enthalten. | AWS allgemein | ### Schritt 6: Erstellen Sie Metrikfilter für die Protokollgruppe | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Erstellen Sie metrische Filter für die Schlüsselwörter ABEND und STOPPED. | Wenn Sie Metrikfilter für die Protokollgruppe erstellen, wird jedes Mal, wenn die Filter im Fehlerprotokoll identifiziert werden, ein Alarm ausgelöst und eine E-Mail-Benachrichtigung gesendet, die auf der Amazon SNS SNS-Konfiguration basiert.
So erstellen Sie Metrikfilter:1. Öffnen Sie die CloudWatch Konsole unter [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
2. Wählen Sie den Namen der Protokollgruppe aus.
3. Wählen Sie **Aktionen** und dann **Metrikfilter erstellen**.
4. Geben Sie für das **Filtermuster** ein Muster an, z. `ABEND` B.
5. Wählen Sie **Next** (Weiter) aus und geben Sie einen Namen für Ihren Metrikfilter ein.
6. Geben Sie unter **Metrikdetails** für **Metrik-Namespace** einen Namen für den CloudWatch Namespace ein, in dem die Metrik veröffentlicht wird. Wenn der Namespace noch nicht vorhanden ist, stellen Sie sicher, dass **Create new** (Neu erstellen) ausgewählt ist.
7. Geben Sie für **Metrikwert** den Wert ein`1`, weil Ihr Metrikfilter das Vorkommen der Schlüsselwörter im Filter zählt.
8. Stellen Sie **Einheit** auf **Keine** ein.
9. Wählen Sie **Metrikfilter erstellen** aus. Sie finden den Metrikfilter, den Sie über den Navigationsbereich erstellt haben.
10. Erstellen Sie einen weiteren metrischen Filter für das `STOPPED` Muster. Innerhalb einer Protokollgruppe können Sie mehrere Metrikfilter erstellen und Alarme einzeln festlegen. | CloudWatch | ### Schritt 7. Einrichten von Amazon SNS | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Erstellen Sie ein SNS-Thema. | In diesem Schritt konfigurieren Sie Amazon SNS so, dass Alarme für die metrischen Filter erstellt werden.
So erstellen Sie ein SNS-Thema:1. Melden Sie sich zu [https://console.aws.amazon.com/sns/Hause](https://console.aws.amazon.com/sns/home) bei der Amazon SNS-Konsole an.
2. Geben **Sie im Feld Thema erstellen** einen Themennamen ein, z. B.`goldengate-alert`, und wählen Sie dann **Nächster Schritt** aus.
3. Wählen Sie unter **Type (Typ)** die Option **Standard** aus.
4. Scrollen Sie zum Ende des Formulars und wählen Sie **Create topic (Erstellen eines Themas)** aus. In der Konsole wird die Seite **Details** geöffnet. | Amazon SNS | | Erstellen Sie ein Abonnement. | Um ein Abonnement für das Thema zu erstellen:1. Wählen Sie im linken Navigationsbereich **Subscriptions** (Abonnements).
2. Wählen Sie auf der Seite **Subscriptions** (Abonnements) die Option **Create subscription (Abonnement erstellen)**aus.
3. Wählen Sie auf der Seite **Abonnement erstellen** das Feld **Themen-ARN** aus, um eine Liste der Themen in Ihrem AWS-Konto anzuzeigen.
4. Wählen Sie das Mesh aus, das Sie im vorherigen Schritt erstellt haben.
5. Wählen Sie unter **Protocol (Protokoll)** die Option **Email (E-Mail)** aus.
6. Geben Sie unter **Endpoint (Endpunkt)** eine E-Mail-Adresse ein, um die Benachrichtigungen zu empfangen.
7. Wählen Sie **Abonnement erstellen** aus. Die Konsole öffnet die **Detailseite** des neuen Abonnements.
8. Suchen Sie in Ihrem E-Mail-Posteingang nach einer Nachricht von AWS Notifications und wählen Sie dann in der E-Mail **Abonnement bestätigen** aus.
Amazon SNS öffnet Ihren Webbrowser und zeigt eine Abonnementbestätigung mit Ihrer Abonnement-ID an. | Amazon SNS | ### Schritt 8. Erstellen Sie einen Alarm, um Benachrichtigungen für die Metrikfilter zu senden | Aufgabe | Description | Erforderliche Fähigkeiten | | --- | --- | --- | | Erstellen Sie einen Alarm für das SNS-Thema. | So erstellen Sie einen Alarm auf der Grundlage eines Metrikfilters für Protokollgruppen:1. Öffnen Sie die CloudWatch Konsole unter. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
2. Wählen Sie ausgehend vom Navigationsbereich **Logs** (Protokolle) und dann **Log groups** (Protokollgruppen) aus.
3. Wählen Sie die Protokollgruppe aus, die Ihren Metrikfilter enthält.
4. Wählen Sie **Metric filters** (Metrikfilter) aus.
5. Aktivieren Sie auf der Registerkarte **Metrische Filter** das Kontrollkästchen für den metrischen Filter, auf dem Ihr Alarm basieren soll.
6. Wählen Sie **Alarm erstellen** aus.
7. Geben Sie **unter Bedingungen** in jedem Abschnitt Folgendes an:Wählen Sie für **Threshold type** (Schwellenwerttyp) die Option **Static** (Statisch) aus.Für **Wann immer es ist.** , wählen Sie **Größer**.Für **als.** , geben Sie **0** an.
8. Wählen Sie **Weiter** aus.
9. Unter **Benachrichtigung**:Wählen Sie für **Alarmstatusauslöser** die Option **Im Alarm** aus.Wählen **Sie unter Benachrichtigung an das folgende SNS-Thema senden** die Option **Bestehendes Thema auswählen aus**.Wählen Sie im E-Mail-Feld das Amazon SNS SNS-Thema aus, das Sie im vorherigen Schritt erstellt haben.
10. Wählen Sie **Weiter** aus.
11. Geben Sie unter **Name und Beschreibung** einen Namen und eine Beschreibung für Ihren Alarm ein.Für die Beschreibung können Sie den Instanznamen angeben, sodass die Benachrichtigungs-E-Mail beschreibend ist.
12. Überprüfen Sie bei **Vorschau und Erstellen**, ob Ihre Konfiguration korrekt ist, und wählen Sie dann **Alarm erstellen** aus.
Nach diesen Schritten erhalten Sie jedes Mal, wenn diese Muster in der GoldenGate Fehlerprotokolldatei (`ggserr.log`), die Sie überwachen, erkannt werden, eine E-Mail-Benachrichtigung. | CloudWatch | ## Fehlerbehebung | Problem | Lösung | | --- | --- | | Der Protokollstream aus dem GoldenGate Fehlerprotokoll fließt nicht hinein CloudWatch. | Überprüfen Sie die `/etc/awslogs/awslogs.conf` Datei, um den Dateinamen, den Namen der Protokollgruppe und das date/time Format zu überprüfen. Sie müssen das Format angeben date/time , das dem Datumsformat entspricht`ggserror.log`. Andernfalls fließt der Protokollstream nicht in CloudWatch. | ## Zugehörige Ressourcen + [ CloudWatch Amazon-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) + [Erfassung von Metriken und Protokollen mit dem CloudWatch Agenten](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) + [Amazon SNS SNS-Dokumentation](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)