Documentazione di Oracle Cloud Infrastructure

Risolvere i problemi relativi all'uso dei log

Imparare a risolvere i problemi comuni utilizzando il log e i log OCI trovati nei backup della distribuzione e a raccogliere la diagnostica dalla distribuzione GoldenGate OCI.

Log dei processi e degli 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 di log è facoltativa.

  • Log degli errori: contengono il contenuto del file ggserr.log che registra gli eventi di elaborazione, i messaggi, gli errori e le avvertenze generate da GoldenGate.
  • Log dei processi: contiene 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 di estrazione/replica.

Prima di iniziare a utilizzare OCI Logging:

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

Puoi 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 dei job e dei job. Scopri di più su 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 al 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 seguenti criteri: 

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.

Abilitare il log utilizzando la console di Oracle Cloud

  1. Nella pagina Distribuzioni selezionare la distribuzione per la quale si desidera abilitare il log.
  2. Nella pagina Dettagli distribuzione selezionare Monitoraggio.
  3. Nella pagina Monitoraggio, scorrere fino a Log.
  4. Nella tabella Log, nel menu Azioni di uno dei log, selezionare Abilita log.
  5. Nel pannello Abilita log, selezionare un compartimento dall'elenco a discesa Compartimento.
  6. Per il gruppo di log è possibile effettuare le operazioni riportate di seguito.
    • Selezionare un gruppo dall'elenco a discesa
    • Creare un nuovo gruppo
    • Lasciare vuoto e viene assegnato automaticamente un gruppo predefinito
  7. Per Nome log, immettere un nome.
  8. Per la conservazione dei log, selezionare il numero di mesi dall'elenco a discesa.
  9. Fare clic su Abilita log.

Attendere che lo stato diventi Attivo. Dopo l'attivazione, la funzione Log di diagnostica viene attivata per i log dei processi e degli errori. I log dei processi e degli errori sono tecnicamente "log dei servizi" in quanto provengono da un servizio nativo Oracle Cloud Infrastructure come OCI GoldenGate.

Abilita OCI Logging mediante CLI

  1. Crea gruppo 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>" }
  2. 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"  
    }
}
  3. Crea/Abilita oggetto di 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 richieste 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>"
}
  4. 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>"
}
  5. Cerca 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    
        }  
    }
}
  6. 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"
}
  7. 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>"
}
  8. Elimina 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>"
}

Abilitare il 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:

  1. Aprire il menu di navigazione e fare clic su Observability & Management. In Logging Analytics, fare clic su Amministrazione.
  2. Nella pagina Panoramica amministrazione, in Risorse, fare clic su Gruppi di log.
  3. Scegliere un compartimento in cui si dispone dell'autorizzazione per lavorare e fare clic su Crea gruppo di log.

    Viene visualizzato il pannello Crea gruppo di log.

  4. Impostare le opzioni seguenti:
    • Compartimento: il compartimento in cui si desidera creare il gruppo di log. Questo campo viene 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 di log. Evitare di fornire informazioni riservate.
    • Descrizione: descrizione descrittiva.
    • (Facoltativo) Immettere le informazioni di applicazione tag.
  5. Fare clic su Crea.

    Viene quindi visualizzata la pagina dei dettagli del gruppo di log.

  6. Fare clic su Log.
  7. Fare clic su Abilita log servizio.
  8. In Seleziona risorsa:
    1. Per il compartimento delle 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.
  9. In Configura log:
    1. Per Categoria log, selezionare un valore dall'elenco a discesa.
    2. Per Nome log, immettere un nome.
  10. 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.
  11. Per Conservazione log, selezionare il numero di mesi per i quali conservare i log.
  12. Fare clic su Abilita log.

Log di backup della distribuzione

È possibile eseguire manualmente il backup di una distribuzione GoldenGate OCI nello storage degli oggetti Oracle, quindi scaricare il backup a livello locale. È 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 riportati i file e le directory 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
      • recrvr-stdout.log
      • distsrvr.log
      • recvsrvr.log
      • extract.log
      • replicat.log

Raccogli diagnostica

Raccogliere la diagnostica per analizzare o condividere le informazioni sulla distribuzione GoldenGate OCI. 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 OCI.
Per raccogliere la diagnostica della distribuzione:
  1. Nella pagina Distribuzioni, selezionare la distribuzione per la quale raccogliere la diagnostica.
  2. Nel menu Azioni della pagina Dettagli della distribuzione selezionare Raccogliere la diagnostica.
  3. Nel pannello Raccogli diagnostica, completare i campi riportati di seguito, quindi fare clic su Raccogli 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 altro compartimento, 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 alla quale raccogliere i log di sistema.
      Nota

      La diagnostica raccolta per la distribuzione GoldenGate OCI 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.