Diagnosticar e solucionar problemas usando logs

Aprenda a diagnosticar e solucionar problemas comuns usando o registro em log e os logs do OCI encontrados em seus backups de implantação e coletar diagnósticos da implantação do OCI GoldenGate.

Tópicos Relacionados

Logs de processos e erros

Você pode integrar o OCI Logging ao OCI GoldenGate para ativar, gerenciar e pesquisar logs de processo e erro GoldenGate. A integração com o serviço Logging é opcional.

  • Logs de erros: Contém conteúdo do arquivo ggserr.log que registra eventos de processamento, mensagens, erros e avisos gerados pelo GoldenGate.
  • Logs de processo: Contém conteúdo de vários arquivos de log para Serviço de Administração, Serviço de Distribuição, Serviço de Métricas de Desempenho, Serviço do Receptor e Eventos de Extração/Replicação.

Antes de começar a usar o OCI Logging:

  • Familiarize-se com conceitos e terminologia básicos usados no serviço OCI Logging. Consulte Visão Geral do Serviço Logging na documentação do OCI Logging.
  • Crie um grupo para gerenciar o acesso aos grupos de logs e ao conteúdo do log. Consulte Como Trabalhar com Grupos na documentação do OCI IAM.
  • Adicione políticas para ativar o registro em log público do OCI GoldenGate.

Observação:

Você gerencia o ciclo de vida dos logs, incluindo logs criados automaticamente para você pelo OCI GoldenGate. Os logs não são excluídos quando o job e as execuções de jobs são excluídos. Saiba mais sobre Preços de observabilidade e gerenciamento.

Adicionar políticas para usar o OCI Logging com o OCI GoldenGate

Para ativar logs de serviço, você deve conceder ao usuário acesso de gerenciamento no grupo de log e acesso ao recurso. Os logs e grupos de logs usam o resource-type log-group, mas para pesquisar o conteúdo de logs, você deve usar o resource-type log-content. Adicione as seguintes políticas: 

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

Saiba mais sobre políticas.

Ativar Registro em Log usando a console do Oracle Cloud

  1. Na página Implantações, selecione a implantação para a qual deseja ativar o registro.
  2. Na página Detalhes da implantação, selecione Monitoramento.
  3. Na página Monitoramento, role para baixo até Logs.
  4. Na tabela Logs, no menu Ações de um dos logs, selecione Ativar log.
  5. No painel Ativar log, na lista drop-down Compartimento, selecione um compartimento.
  6. Para o grupo Log, você pode:
    • Selecione um grupo no drop-down
    • Criar um novo grupo
    • Deixe-o em branco e um grupo padrão será atribuído automaticamente
  7. Para o nome do Log, informe um nome.
  8. Para retenção de Log, selecione o número de meses no menu suspenso.
  9. Clique em Ativar log.

Aguarde o status se tornar Ativo. Depois de ativado, o recurso Logs de Diagnóstico é ativado para os logs de processo e erro. Os logs de processo e erro são tecnicamente "Logs de serviço", pois são provenientes de um serviço nativo do Oracle Cloud Infrastructure como o OCI GoldenGate.

Ativar o OCI Logging usando a CLI

  1. Criar grupo do Log

    Solicitação

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

    Resposta 

    { "opc-work-request-id": "<log-workrequest-ocid>" }
  2. Obter ID do Grupo de Logs

    Solicitação

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

    Resposta 

    {  
    "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. Criar/Ativar objeto de Log

    Solicitação

    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 da solicitação JSON

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

    Resposta 

    Response 
{  
    "opc-work-request-id": "<log-workrequest-ocid>"
}
  4. Desativar log do OCI

    Solicitação

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

    Resposta 

    {  
    "opc-work-request-id": "<log-workrequest-ocid>"
}
  5. Pesquisar Logs do OCI

    Solicitação

    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'

    Resposta 

    {  
    "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. Obter Status do Log

    Solicitação

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

    Resposta 

    {  
    "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. Excluir Log

    Solicitação

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

    Resposta 

    {  
    "opc-work-request-id": "<log-workrequest-ocid>"
}
  8. Excluir grupo de Log

    Solicitação

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

    Resposta 

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

Ativar o Logging para o OCI GoldenGate no serviço OCI Logging

Crie um grupo de log e configure um log de serviço no serviço Logging, caso você ainda não tenha um:

  1. Abra o menu de navegação e clique em Observabilidade & Gerenciamento. Em Logging Analytics, clique em Administração.
  2. Na página Visão Geral da Administração, em Recursos, clique em Grupos de Logs.
  3. Escolha um compartimento para o qual você tenha permissão para trabalhar e clique em Criar Grupo de Log.

    O painel Criar Grupo de Logs é exibido.

  4. Preencha as seguintes informações:
    • Compartimento: O compartimento no qual você deseja criar o grupo de logs. Este campo é pré-preenchido com base na sua escolha de compartimento.
    • Nome: Um nome para este grupo de logs. O primeiro caractere de um nome de grupo de logs deve ser uma letra. Para obter mais informações, consulte Nomes de Logs e Grupos de Logs. Evite digitar informações confidenciais.
    • Descrição: uma descrição amigável.
    • (Opcional) Especifique informações sobre a marcação.
  5. Clique em Criar.

    A página de detalhes do grupo de logs é exibida.

  6. Clique em Logs.
  7. Clique em Habilitar log de serviço.
  8. Em Selecionar Recurso:
    1. Para Compartimento de Recursos, selecione o compartimento do recurso.
    2. Para Serviço, selecione GoldenGate no menu suspenso.
    3. Para Recurso, selecione uma implantação no menu suspenso.
  9. Em Configurar log:
    1. Para Categoria de Log, selecione um valor no menu suspenso.
    2. Em Nome do Log, informe um nome.
  10. Selecione Mostrar Opções Avançadas e, em Local do Log:
    1. Para Compartimento, selecione o compartimento no Qual salvar o log.
    2. Para Grupo de Logs, selecione um grupo de logs na lista drop-down ou crie um novo grupo.
  11. Para Retenção de Logs, selecione o número de meses para os quais os logs serão retidos.
  12. Clique em Ativar log.

Logs de backup de implantação

Você pode fazer backup manualmente de uma implantação do OCI GoldenGate para o Oracle Object Storage e, em seguida, fazer download do backup no local. Em seguida, você pode localizar os logs de implantação para solucionar problemas de integridade.

Para saber como criar um backup manual, consulte gerenciando backups de implantação.

O backup de implantação manual contém a estrutura e os arquivos completos do diretório de implantação do GoldenGate, incluindo arquivos de log e trilha. Os diretórios e arquivos que são úteis para o diagnóstico e a solução de problemas incluem:

  • /etc: configuração
    • /etc/ogg: arquivos de parâmetros
  • /var: arquivos de log, checkpoint, arquivos de trilha etc.
    • /var/checkpt: checkpoint
    • /var/data: arquivos de trilha
    • /var/report: arquivos de relatório
    • /var/log: arquivos de log
      • ER-events.log
      • ggserr.log
      • reinicipi.log
      • adminsrvr.log
      • pmsrvr.log
      • distsrvr-stdout.log
      • recsrvr-stdout.log
      • distsrvr.log
      • recvsrvr.log
      • extract.log
      • replicat.log

Coletar diagnósticos

Colete diagnósticos para analisar ou compartilhar informações sobre a implantação do OCI GoldenGate. As informações coletadas poderão ser compartilhadas com o My Oracle Support se você encontrar algum problema.

Observação:

Esse recurso só se aplica a implantações de replicação de Dados.
Antes de coletar diagnósticos, certifique-se de criar um bucket do OCI Object Storage.
Para coletar diagnósticos de implantação
  1. Na página Implantações, selecione a implantação para a qual coletar diagnósticos.
  2. Na página Detalhes da implantação, no menu Ações, selecione Coletar diagnósticos.
  3. No painel Coletar diagnósticos, preencha os seguintes campos e clique em Coletar diagnósticos:
    1. Na lista drop-down Bucket, selecione o bucket no qual o arquivo de diagnóstico será salvo. Se quiser selecionar um bucket em outro compartimento, clique emAlterar Compartimento.
    2. Para Prefixo de nome de diagnóstico, informe um nome curto ou alguns caracteres para prefixar o nome de arquivo de diagnóstico.
    3. (Opcional) Selecione a data Inicial a partir da qual coletar logs do sistema.
    4. (Opcional) Selecione a data Final na qual coletar logs do sistema.

      Observação:

      Os diagnósticos coletados para a implantação do OCI GoldenGate contêm logs GoldenGate para toda a vida útil da implantação e são independentes das datas inicial e final selecionadas.
Depois que você clica em Coletar diagnósticos, um novo campo chamado Diagnóstico é exibido sob a seção GoldenGate do cartão de informações de Implantação. O arquivo zip de diagnóstico pode levar alguns minutos para ser disponibilizado para download. Quando ele estiver disponível, um link Fazer Download será exibido.