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 sua implantação do OCI GoldenGate.

Logs de processos e erros

Você pode integrar o OCI Logging ao OCI GoldenGate para ativar, gerenciar e pesquisar logs de processo e erro do 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 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 as execuções de job e job são excluídas. 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.

Usando a console do Oracle Cloud, Ative Registro em Log

Na página Implantações, selecione a implantação para a qual deseja ativar o registro em log.
Na página Detalhes da implantação, selecione Monitoramento.
Na página Monitoramento, role para baixo até Logs.
Na tabela Logs, no menu Ações de um dos logs, selecione Ativar log.
No painel Ativar log, na lista drop-down Compartimento, selecione um compartimento.
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
Para o nome do Log, informe um nome.
Para retenção de Log, selecione o número de meses no menu suspenso.
Selecione 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

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

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

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

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

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

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

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

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 se você ainda não tiver um:

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

O painel Criar Grupo de Logs é exibido.
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.
Selecione Criar.

A página de detalhes do grupo de logs é exibida.
Selecione Logs.
Selecione Ativar log de serviço.
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 na lista drop-down.
Em Configurar log:
1. Para Categoria de Log, selecione um valor no menu suspenso.
2. Para Nome do Log, informe um nome.
Selecione Mostrar Opções Avançadas e, em Local do Log:
1. Para Compartimento, selecione o compartimento onde salvar o log.
2. Para Grupo de Logs, selecione um grupo de logs na lista drop-down ou crie um novo grupo.
Em Retenção de Logs, selecione o número de meses para os quais os logs serão retidos.
Selecione 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: Este recurso só se aplica a implantações de replicação de Dados.

Antes que você colete diagnósticos, certifique-se de que crie um bucket do Oracle Object Storage.

Para coletar diagnósticos de implantação

Na página Implantações, selecione a implantação para a qual coletar diagnósticos.
Na página Detalhes da implantação, no menu Ações, selecione Coletar diagnósticos.
No painel Coletar diagnósticos, preencha os seguintes campos e selecione 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, selecione Alterar 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 de GoldenGate para toda a vida útil da implantação e são independentes das datas inicial e final selecionadas.

Depois que você seleciona Coletar diagnósticos, um novo campo chamado Diagnóstico é exibido sob a seção do GoldenGate do cartão de informações da 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.

Após a conclusão do download, descompacte o arquivo e verifique seu conteúdo:

/etc/ogg: contém arquivos de parâmetros
/var/report: contém arquivos de relatório e descarte
/var/log: contém arquivos de log
ER-events.log: contém eventos Extract e Replicat
ggserr.log: contém erros do OCI GoldenGate
restapi.log: contém logs da API REST
adminsrvr.log: contém os logs do Serviço de Administração
pmsrvr.log: contém os logs do Serviço de Métricas de Desempenho
distsrvr.log: contém os logs do Serviço de Distribuição
recvsrvr.log: contém os logs do Serviço do Receptor
extract.log: contém os logs do processo Extract
replicat.log: contém os logs do processo Replicat