Risolvere i problemi utilizzando i log

Acquisire 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.

Argomenti correlati

Risolvere i problemi utilizzando la console di Oracle Cloud

Log processi ed errori

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

Log degli errori: contiene il contenuto del file ggserr.log che registra eventi di elaborazione, messaggi, errori e 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 OCI Logging 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 dall'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.
Fare clic su Abilita log.

Attendere che lo stato diventi Attivo. Dopo l'attivazione, 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 OCI GoldenGate 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 fare clic su Observability & Management. In Logging Analytics fare clic su Amministrazione.
Nella pagina Panoramica amministrazione, in Risorse, fare clic su Gruppi di log.
Scegliere un compartimento in cui si è autorizzati a lavorare e fare clic su 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.
Fare clic su Crea.

Viene quindi visualizzata la pagina dei dettagli del gruppo di log.
Fare clic su Log.
Fare clic su Abilita log servizio.
In Seleziona risorsa:
1. Per 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. Per Categoria di log, selezionare un valore dall'elenco a discesa.
2. Per Nome log, immettere un nome.
Selezionare Mostra opzioni avanzate e in Posizione log:
1. Per 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.
Fare clic su 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
  - restapi.log
  - adminsrvr.log
  - pmsrvr.log
  - distsrvr-stdout.log
  - recsrvr-stdout.log
  - distsrvr.log
  - recvsrvr.log
  - extract.log
  - replicat.log

Raccogli diagnostica

Raccogliere informazioni di diagnostica per analizzare o condividere informazioni sulla distribuzione di OCI GoldenGate. Le informazioni raccolte possono essere condivise con My Oracle Support in caso di problemi.

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 OCI.

Per raccogliere la diagnostica della distribuzione:

Nella pagina Distribuzioni selezionare la distribuzione per la quale raccogliere la diagnostica.
Nella pagina Dettagli della distribuzione, dal menu Azioni selezionare Raccogliere la diagnostica.
Nel pannello Raccogli diagnostica, completare i campi riportati di seguito, quindi fare clic su Raccolta diagnostica.
1. Dall'elenco a discesa Bucket selezionare il bucket in cui salvare il file di diagnostica. Se si desidera selezionare un bucket in un compartimento diverso, fare clic su Modifica compartimento.
2. Per 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 OCI GoldenGate contiene log GoldenGate per l'intera durata della distribuzione e sono indipendenti dalle date di inizio e fine selezionate.

Dopo aver fatto clic su Raccogli diagnostica, nella sezione GoldenGate della scheda informazioni 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 Scarica.

Titolo e informazioni sul copyright

Oracle e/o relative consociate.