Fehler mit Logs beheben

Hier erfahren Sie, wie Sie häufige Probleme mit OCI-Logging und -Logs in Ihren Deployment-Backups beheben und Diagnosen aus Ihrem OCI GoldenGate-Deployment erfassen.

Prozess- und Fehlerlogs

Sie können OCI Logging in OCI GoldenGate integrieren, um GoldenGate-Prozess- und Fehlerlogs zu aktivieren, zu verwalten und zu durchsuchen. Die Integration mit dem Logging-Service ist optional.

Fehlerlogs: Enthält Inhalt aus der Datei ggserr.log, in der Verarbeitungsereignisse, Nachrichten, Fehler und Warnungen protokolliert werden, die von GoldenGate generiert werden.
Prozesslogs: Enthält Inhalt aus mehreren Logdateien für Administration Service, Distribution Service, Performance Metrics Service, Receiver Service und Extract/Replicat-Ereignisse.

Bevor Sie mit OCI Logging beginnen:

Machen Sie sich mit den grundlegenden Konzepten und Terminologie vertraut, die im OCI Logging-Service verwendet werden. Siehe Loggingüberblick in der OCI Logging-Dokumentation.
Erstellen Sie eine Gruppe, um den Zugriff auf Loggruppen und Loginhalt zu verwalten. Siehe Mit Gruppen arbeiten in der OCI IAM-Dokumentation.
Fügen Sie Policys hinzu, um das öffentliche Logging für OCI GoldenGate zu aktivieren.

Hinweis: Sie verwalten den Lebenszyklus der Logs, einschließlich Logs, die automatisch von OCI GoldenGate für Sie erstellt werden. Logs werden nicht gelöscht, wenn Jobs und Jobläufe gelöscht werden. Weitere Informationen zu Beobachtbarkeits- und Managementpreisen.

Policys hinzufügen, um OCI Logging mit OCI GoldenGate zu verwenden

Um Servicelogs zu aktivieren, müssen Sie den Benutzerverwaltungszugriff auf die Loggruppe sowie Zugriff auf die Ressource erteilen. Logs und Loggruppen verwenden den Ressourcentyp log-group. Damit Sie den Inhalt von Logs durchsuchen können, müssen Sie jedoch den Ressourcentyp log-content verwenden. Fügen Sie die folgenden Policys hinzu:

allow group <group-name> to manage log-groups in compartment <compartment-name>
allow group <group-name> to manage log-content in compartment <compartment-name>

Weitere Informationen zu Policys.

Logging mit der Oracle Cloud-Konsole aktivieren

Wählen Sie auf der Seite Deployments das Deployment aus, für das Sie das Logging aktivieren möchten.
Wählen Sie auf der Seite Deployment-Details Monitoring aus.
Scrollen Sie auf der Seite {\b Monitoring} nach unten zu {\b Logs}.
Wählen Sie in der Tabelle Logs im Menü Aktionen eines der Logs die Option Log aktivieren aus.
Wählen Sie in der Dropdown-Liste "Compartment" im Bereich Log aktivieren ein Compartment.
Für die Loggruppe können Sie:
- Gruppe aus der Dropdown-Liste auswählen
- Erstellen Sie eine neue Gruppe
- Lassen Sie das Feld leer, und eine Standardgruppe wird automatisch zugewiesen
Geben Sie einen Namen als Lognamen ein.
Wählen Sie für die Logaufbewahrung die Anzahl der Monate aus der Dropdown-Liste aus.
Wählen Sie Log aktivieren aus.

Warten Sie, bis der Status "Aktiv" wird. Nachdem sie aktiv ist, wird das Feature "Diagnoselogs" für die Prozess- und Fehlerlogs aktiviert. Die Prozess- und Fehlerlogs sind technisch "Servicelogs", da sie von einem nativen Oracle Cloud Infrastructure-Service wie OCI GoldenGate stammen.

OCI-Logging mit CLI aktivieren

Loggruppe erstellen

Anforderung

oci --profile <profile_name> logging log-group create --compartment-id <compartment_ocid>  --display-name <display_name>

Antwort

{ "opc-work-request-id": "<log-workrequest-ocid>" }

Loggruppen-ID abrufen

Anforderung

oci --profile <profile_name> logging work-request get --work-request-id <log-workrequest-ocid>

Antwort

{
    "data": {
    "compartment-id": "<compartment_ocid>",
    "id": "<log-workrequest-ocid>",
    "operation-type": "CREATE_LOG_GROUP",
    "percent-complete": 100.0,
    "resources": [
        {
            "action-type": "CREATED",
            "entity-type": "loggroup",
            "entity-uri": "/logGroups/<log-group-ocid>",
            "identifier": "<log-group-ocid>"
        }
    ],    "
    status": "SUCCEEDED",
    "time-accepted": "2023-05-09T05:57:09.641000+00:00",
    "time-finished": "2023-05-09T05:57:09.641000+00:00",
    "time-started": "2023-05-09T05:57:09.641000+00:00"
    }
}

Logobjekt erstellen/aktivieren

Anforderung

oci --profile <profile-name> logging log create --display-name <display-name> --log-group-id  <log-group-ocid> --log-type SERVICE/CUSTOM --is-enabled true  --configuration file://path_to_json_file

JSON-Anforderungs-Payload

{
    "compartment-id": "<compartment-ocid>",
    "source":
        {
            "resource": "<GoldenGate-deployment-ocid>",
            "service": "goldengate",
            "source-type": "OCISERVICE",
            "category": "error_logs/process_logs"
        }
}

Antwort

Response
{
    "opc-work-request-id": "<log-workrequest-ocid>"
}

OCI-Logging deaktivieren

Anforderung

oci --profile <profile_name> logging log update --is-enabled false --log-group-id <log-group-ocid> --log-id <log-ocid>

Antwort

{
    "opc-work-request-id": "<log-workrequest-ocid>"
}

OCI-Logs durchsuchen

Anforderung

oci --profile <profile_name> logging-search search-logs --search-query "search "<compartment_ocid>/<log-group-ocid>/<log-ocid>"" --time-start '2023-05-09 09:54' --time-end '2023-05-09 09:55'

Antwort

{
    "data": {
        "fields": null,
        "results": [
            {
                "data": {
                "datetime": 1683626095205,
                "logContent": {
                    "data": {
                        "level": "INFO",
                        "message": "Executing command '{\n    "name": "report",\n    "reportType": "lag",\n    "thresholds": [\n        {\n            "type": "info",\n            "units": "seconds",\n           "value": 0\n        }\n    ]\n}'",
                        "processName": "adminsrvr",
                        "resourceId": "<GoldenGate-deployment-ocid>"
                    },
                    "id": "20230509095455.2051683626095",
                    "oracle": {
                        "compartmentid": "<compartment-ocid>",
                        "ingestedtime": "2023-05-09T09:55:05.889Z",
                        "loggroupid": "<log-group-ocid>",
                        "logid": "<log-ocid>",
                        "tenantid": "<tenant-ocid>"
                    },
                    "source": "<GoldenGate-deployment-ocid>",
                    "specversion": "1.0",
                    "time": "2023-05-09T09:54:55.205Z",
                    "type": "com.oraclecloud.goldengate.deployment.process_logs"
                }
            }
        } ],
        "summary": {
            "field-count": null,
            "result-count": 1
        }
    }
}

Logstatus abrufen

Anforderung

oci --profile <profile_name> logging log get --log-group-id <log-group-ocid> --log-id <log-ocid>

Antwort

{
    "data": {
        "compartment-id": "<compartment-ocid>",
        "configuration": {
            "archiving": {
                "is-enabled": false
            },
            "compartment-id": "<compartment-ocid>",
            "source": {
                "category": "process_logs",
                "parameters": {},
                "resource": "<GoldenGate-deployment-ocid>",
                "service": "goldengate",
                "source-type": "OCISERVICE"
            }
        },
        "defined-tags": {
            "Oracle-Tags": {
                "CreatedBy": "<creater_email_id>",
                "CreatedOn": "2023-05-09T06:24:30.279Z"
            }
        },
        "display-name": "<display_name>",
        "freeform-tags": {},
        "id": "<log-ocid>",
        "is-enabled": false,    "
        lifecycle-state": "INACTIVE",
        "log-group-id": "<log-group-ocid>",
        "log-type": "SERVICE",
        "retention-duration": 30,
        "tenancy-id": "<tenancy-ocid>",
        "time-created": "2023-05-09T06:24:30.452000+00:00",
        "time-last-modified": "2023-05-09T06:30:17.345000+00:00"
    },
    "etag": "cb5bb295-9954-4949-b33f-67d6da50f83f"
}

Log löschen

Anforderung

oci --profile <profile_name> logging log delete --log-group-id <log-group-ocid> --log-id <log-ocid>

Antwort

{
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Loggruppe löschen

Anforderung

oci --profile GGSTEST logging log-group delete --log-group-id <log-group-ocid>

Antwort

{
    "opc-work-request-id": "<log-workrequest-ocid>"
}

Logging für OCI GoldenGate im OCI Logging-Service aktivieren

Erstellen und konfigurieren Sie eine Loggruppe, und konfigurieren Sie ein Servicelog im Logging-Service, wenn noch keine vorhanden ist:

Öffnen Sie das Navigationsmenü, und wählen Sie Beobachtbarkeit und Management. Wählen Sie unter Logging Analytics die Option Administration aus.
Wählen Sie auf der Seite "Administration - Überblick" unter Ressourcen die Option Loggruppen aus.
Wählen Sie ein Compartment aus, zu dem Sie berechtigt sind, und wählen Sie Loggruppe erstellen aus.

Der Fensterbereich Loggruppe erstellen wird angezeigt.
Führen Sie die folgenden Schritte aus:
- Compartment: Das Compartment, in dem Sie die Loggruppe erstellen möchten. Dieses Feld ist je nach Compartment-Auswahl bereits ausgefüllt.
- Name: Ein Name für diese Loggruppe. Das erste Zeichen eines Loggruppennamens muss ein Buchstabe sein. Weitere Informationen finden Sie unter Namen von Logs und Loggruppen. Geben Sie dabei keine vertraulichen Informationen ein.
- Beschreibung: Eine benutzerfreundliche Beschreibung.
- (Optional) Geben Sie Tagging-Informationen ein.
Wählen Sie Erstellen.

Daraufhin wird die Detailseite der Loggruppe angezeigt.
Wählen Sie Logs aus.
Wählen Sie Servicelog aktivieren aus.
Gehen Sie unter Ressource auswählen wie folgt vor:
1. Wählen Sie unter Ressourcen-Compartment das Compartment der Ressource aus.
2. Wählen Sie unter Service in der Dropdown-Liste die Option GoldenGate aus.
3. Wählen Sie unter Ressource ein Deployment aus der Dropdown-Liste aus.
Gehen Sie unter Log konfigurieren wie folgt vor:
1. Wählen Sie unter Logkategorie einen Wert aus der Dropdown-Liste aus.
2. Geben Sie unter Logname einen Namen ein.
Wählen Sie unter Logverzeichnis die Option Erweiterte Optionen anzeigen aus:
1. Wählen Sie unter Compartment das Compartment aus, in dem das Log gespeichert werden soll.
2. Wählen Sie unter Loggruppe eine Loggruppe aus der Dropdown-Liste aus, oder erstellen Sie eine neue Gruppe.
Wählen Sie unter Logaufbewahrung die Anzahl der Monate aus, für die die Logs beibehalten werden sollen.
Wählen Sie Log aktivieren aus.

Deployment-Backuplogs

Sie können ein manuelles Backup von einem OCI GoldenGate-Deployment in Oracle Object Storage sichern und das Backup dann lokal herunterladen. Anschließend können Sie die Deployment-Logs suchen, um Zustandsprobleme zu beheben.

Wie Sie ein manuelles Backup erstellen, erfahren Sie unter Deployment-Backups verwalten.

Das manuelle Deployment-Backup enthält die vollständige GoldenGate-Deployment-Verzeichnisstruktur und alle Dateien, einschließlich Log- und Traildateien. Folgende Verzeichnisse und Dateien sind bei der Fehlerbehebung hilfreich:

/etc: Konfiguration
- /etc/ogg: Parameterdateien
/var: Logdateien, Checkpoint, Traildateien usw.
- /var/checkpt: Checkpoint
- /var/data: Traildateien
- /var/report: Berichtsdateien
- /var/log: Logdateien
  - ER-events.log
  - ggserr.log
  - restapi.log
  - adminsrvr.log
  - pmsrvr.log
  - distsrvr-stdout.log
  - recsrvr-stdout.log
  - distsrvr.log
  - recvsrvr.log
  - extract.log
  - replicat.log

Diagnose erfassen

Erfassen Sie Diagnosen zum Analysieren oder Teilen von Informationen zu Ihrem OCI GoldenGate-Deployment. Die erfassten Informationen können bei Problemen mit My Oracle Support geteilt werden.

Hinweis: Dieses Feature gilt nur für Datenreplikations-Deployments.

Bevor Sie eine Diagnose erfassen, stellen Sie sicher, dass Sie einen Oracle Object Storage-Bucket erstellen.

So erfassen Sie eine Deployment-Diagnose:

Wählen Sie auf der Seite "Deployments" das Deployment aus, für das eine Diagnose erfasst werden soll.
Wählen Sie im Menü "Aktionen" auf der Seite "Details" des Deployments die Option Diagnose erfassen aus.
Füllen Sie im Bereich "Diagnose erfassen" die folgenden Felder, und wählen Sie Diagnose erfassen aus:
1. Wählen Sie im Dropdown-Menü Bucket den Bucket aus, in dem die Diagnosedatei gespeichert werden soll. Wenn Sie einen Bucket in einem anderen Compartment auswählen möchten, wählen Sie Compartment ändern aus.
2. Geben Sie unter Diagnosenamenpräfix einen Kurznamen oder einige Zeichen als Präfix für den Diagnosedateinamen an.
3. (Optional) Wählen Sie das Startdatum aus, ab dem Systemprotokolle erfasst werden sollen.
4. (Optional) Wählen Sie das Enddatum aus, bis zu dem Systemprotokolle erfasst werden sollen.
  
  Hinweis: Die für das OCI GoldenGate-Deployment erfassten Diagnosen enthalten GoldenGate-Logs für den gesamten Lebenszyklus des Deployments und sind von dem ausgewählten Start- und Enddatum unabhängig.

Nachdem Sie "Diagnose erfassen" ausgewählt haben, wird auf die Karte "Deployment-Informationen" unter "GoldenGate" ein neues Feld mit dem Namen Diagnose angezeigt. Es kann einige Minuten dauern, bis die Diagnose-ZIP-Datei zum Download verfügbar ist. Sobald sie verfügbar ist, wird der Link Herunterladen angezeigt.

Nachdem der Download abgeschlossen ist, dekomprimieren Sie die Datei, und prüfen Sie ihren Inhalt:

/etc/ogg: enthält Parameterdateien
/var/report: enthält Berichts- und Discard-Dateien
/var/log: enthält Logdateien
ER-events.log: enthält Extract- und Replicat-Ereignisse
ggserr.log: enthält OCI GoldenGate-Fehler
restapi.log: enthält REST-API-Logs
adminsrvr.log: enthält die Administrationsservicelogs
pmsrvr.log: enthält die Performancemetrikservicelogs
distsrvr.log: enthält die Verteilungsservicelogs
recvsrvr.log: enthält die Receiver Service-Logs
extract.log: enthält die Extract-Prozesslogs
replicat.log: enthält die Replicat-Prozesslogs