Risolvere i problemi utilizzando i log

Ottenere informazioni per risolvere i problemi comuni utilizzando i log e i log OCI presenti nei backup di distribuzione e raccogliere la diagnostica dalla distribuzione OCI GoldenGate.

Log processi ed errori

Puoi integrare OCI Logging con OCI GoldenGate per abilitare, gestire e cercare i log dei processi e degli errori di GoldenGate. L'integrazione con il servizio Log è facoltativa.

Log degli errori: contiene il contenuto del file ggserr.log che registra gli eventi di elaborazione, i messaggi, gli errori e le avvertenze generati da GoldenGate.
Log dei processi: contengono il contenuto di diversi file di log per il servizio di amministrazione, il servizio di distribuzione, il servizio metriche delle prestazioni, il servizio ricevente e gli eventi Extract/Replicat.

Prima di iniziare a utilizzare OCI Logging:

Acquisisci familiarità con i concetti e la terminologia di base utilizzati nel servizio OCI Logging. Vedere Logging Overview nella documentazione OCI Logging.
Creare un gruppo per gestire l'accesso ai gruppi di log e registrare il contenuto. Vedere Utilizzo dei gruppi nella documentazione di OCI IAM.
Aggiungere criteri per abilitare il log pubblico per OCI GoldenGate.

Nota: è possibile gestire il ciclo di vita dei log, inclusi i log creati automaticamente da OCI GoldenGate. I log non vengono eliminati quando vengono eliminate le esecuzioni del job e del job. Ulteriori informazioni sui prezzi di osservabilità e gestione.

Aggiungere criteri per utilizzare il log OCI con OCI GoldenGate

Per abilitare i log del servizio, è necessario concedere all'utente l'accesso di gestione sul gruppo di log e l'accesso alla risorsa. I log e i gruppi di log utilizzano il tipo di risorsa log-group, ma per cercare il contenuto dei log è necessario utilizzare il tipo di risorsa log-content. Aggiungere i criteri seguenti:

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

Ulteriori informazioni sui criteri.

Abilita log utilizzando la console di Oracle Cloud

Nella pagina Distribuzioni selezionare la distribuzione per la quale si desidera abilitare il log.
Nella pagina Dettagli distribuzione, selezionare Monitoraggio.
Nella pagina Monitoraggio, scorrere fino a Log.
Nella tabella Log, nel menu Azioni di uno dei log, selezionare Abilita log.
Nel pannello Abilita log, selezionare un compartimento nell'elenco a discesa Compartimento.
Per il gruppo Log è possibile effettuare le operazioni riportate di seguito.
- Selezionare un gruppo dall'elenco a discesa
- Creare un nuovo gruppo
- Lasciarlo vuoto e viene assegnato automaticamente un gruppo predefinito
Per il nome del log, immettere un nome.
Per Conservazione log, selezionare il numero di mesi dall'elenco a discesa.
Selezionare Abilita log

Attendere che lo stato diventi Attivo. Dopo che è attiva, la funzione Log di diagnostica viene attivata per i log del processo e degli errori. I log dei processi e degli errori sono tecnicamente 'log dei servizi' poiché provengono da un servizio nativo di Oracle Cloud Infrastructure come OCI GoldenGate.

Abilita log OCI mediante CLI

Crea gruppi di log

Richiesta

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

Risposta

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

Recupera ID gruppo di log

Richiesta

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

Risposta

{
    "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"
    }
}

Crea/abilita oggetto log

Richiesta

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

Payload richiesta JSON

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

Risposta

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

Disabilita log OCI

Richiesta

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

Risposta

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

Cerca in Log OCI

Richiesta

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'

Risposta

{
    "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
        }
    }
}

Recupera stato log

Richiesta

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

Risposta

{
    "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"
}

Elimina log

Richiesta

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

Risposta

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

Elimina il gruppo di log

Richiesta

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

Risposta

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

Abilita log per GoldenGate OCI nel servizio di log OCI

Creare un gruppo di log e configurare un log servizio nel servizio di log se non si dispone già di uno dei seguenti elementi:

Aprire il menu di navigazione e selezionare Observability & Management. In Logging Analytics selezionare Amministrazione.
Nella pagina Panoramica amministrazione, in Risorse, selezionare Gruppi di log.
Scegliere un compartimento in cui si è autorizzati a lavorare e selezionare Crea gruppo di log.

Viene visualizzato il pannello Crea gruppo di log.
Impostare le opzioni seguenti:
- Compartimento: il compartimento in cui si desidera creare il gruppo di log. Questo campo è precompilato in base alla scelta del compartimento.
- Nome: un nome per questo gruppo di log. Il primo carattere del nome di un gruppo di log deve essere una lettera. Per ulteriori informazioni, vedere Nomi dei gruppi di log e log. Evitare di fornire informazioni riservate.
- Descrizione: descrizione descrittiva.
- (Facoltativo) Immettere le informazioni sull'applicazione di tag.
Selezionare Crea.

Viene quindi visualizzata la pagina dei dettagli del gruppo di log.
Selezionare Log.
Selezionare Abilita log servizio.
In Seleziona risorsa:
1. In Compartimento risorse, selezionare il compartimento della risorsa.
2. Per Servizio, selezionare GoldenGate dall'elenco a discesa.
3. Per Risorsa, selezionare una distribuzione dall'elenco a discesa.
In Configura log:
1. In Categoria log, selezionare un valore dall'elenco a discesa.
2. In Nome log, immettere un nome.
Selezionare Mostra opzioni avanzate e in Posizione log:
1. In Compartimento selezionare il compartimento in cui salvare il log.
2. Per Gruppo di log, selezionare un gruppo di log dall'elenco a discesa o crearne uno nuovo.
Per Conservazione log, selezionare il numero di mesi per i quali conservare i log.
Selezionare Abilita log

Log di backup della distribuzione

È possibile eseguire manualmente il backup di una distribuzione OCI GoldenGate nello storage degli oggetti Oracle, quindi scaricare il backup localmente. È quindi possibile individuare i log di distribuzione per risolvere i problemi di integrità.

Per informazioni su come creare un backup manuale, vedere Gestione dei backup della distribuzione.

Il backup manuale della distribuzione contiene la struttura e i file completi della directory di distribuzione GoldenGate, inclusi i file di log e trail. Di seguito sono riportate le directory e i file utili per la risoluzione dei problemi.

/etc: configurazione
- /etc/ogg: file dei parametri
/var: file di log, checkpoint, file trail e così via
- /var/checkpt: checkpoint
- /var/data: file trail
- /var/report: file di report
- /var/log: file di log
  - ER-events.log
  - ggserr.log
  - ristoranti.log
  - adminsrvr.log
  - pmsrvr.log
  - distsrvr-stdout.log
  - recsrvr-stdout.log
  - distsrvr.log
  - rocco siffredi
  - estrazione.log
  - replicat.log

Raccogli diagnostica

Raccoglie la diagnostica per analizzare o condividere informazioni sulla distribuzione di OCI GoldenGate. In caso di problemi, le informazioni raccolte possono essere condivise con My Oracle Support.

Nota: questa funzione si applica solo alle distribuzioni di replica dei dati.

Prima di raccogliere la diagnostica, assicurati di creare un bucket di storage degli oggetti Oracle.

Per raccogliere la diagnostica della distribuzione:

Nella pagina Distribuzioni selezionare la distribuzione per la quale raccogliere la diagnostica.
Nel menu Azioni della pagina Dettagli della distribuzione selezionare Raccolta diagnostica.
Nel pannello Raccogli diagnostica, completare i campi riportati di seguito, quindi selezionare Raccolta diagnostica.
1. Nell'elenco a discesa Bucket selezionare il bucket in cui salvare il file di diagnostica. Se si desidera selezionare un bucket in un compartimento diverso, selezionare Modifica compartimento.
2. In Prefisso nome diagnostica, immettere un nome breve o alcuni caratteri prima del nome del file di diagnostica.
3. (Facoltativo) Selezionare la data di inizio dalla quale raccogliere i log di sistema.
4. (Facoltativo) Selezionare la data di fine per la raccolta dei log di sistema.
  
  Nota: la diagnostica raccolta per la distribuzione GoldenGate OCI contiene i log GoldenGate per l'intera durata della distribuzione e sono indipendenti dalle date di inizio e fine selezionate.

Dopo aver selezionato Raccogli diagnostica, nella sezione GoldenGate della scheda informativa sulla distribuzione viene visualizzato un nuovo campo denominato Diagnostica. Il download del file zip di diagnostica può richiedere alcuni minuti. Quando è disponibile, viene visualizzato un collegamento Download.

Al termine del download, estrarre il file ed esaminarne il contenuto:

/etc/ogg: contiene i file dei parametri
/var/report: contiene i file dei report ed eliminati
/var/log: contiene file di log
ER-events.log: contiene gli eventi Extract e Replicat
ggserr.log: contiene errori OCI GoldenGate
restapi.log: contiene i log API REST
adminsrvr.log: contiene i log del servizio di amministrazione
pmsrvr.log: contiene i log del servizio Metriche prestazioni.
distsrvr.log: contiene i log del servizio di distribuzione
recvsrvr.log: contiene i log del servizio ricevente
extract.log: contiene i log del processo Extract
replicat.log: contiene i log del processo Replicat