Antes de Começar

Este tutorial de 20 minutos mostra como configurar o ambiente no Logging Analytics para coletar dados das tabelas ou views do Oracle Autonomous Database. O Logging Analytics coleta os dados das tabelas ou views conectando-se ao banco de dados e executando a consulta SQL que você fornece.

Histórico

Execute as etapas descritas neste tutorial para coletar dados das tabelas ou views da sua entidade de banco de dados autônomo, como criar a origem de log, criar a entidade de banco de dados autônomo, fazer download dos arquivos da wallet, registrar as credenciais, registrar as informações da wallet e, finalmente, associar a origem de log à entidade de banco de dados autônomo para começar a coletar os logs.

Do Que Você Precisa?

  • Configure políticas de serviço para o Oracle Cloud Logging Analytics. Consulte Ativar Acesso ao Logging Analytics e a Seus Recursos e Políticas de Pré-requisito do Serviço IAM na Documentação do Oracle Cloud Infrastructure.
  • Crie as políticas do serviço IAM para configurar a coleta contínua de logs. Consulte Permitir Coleta Contínua de Logs Usando Management Agents na Documentação do Oracle Cloud Infrastructure.
  • Use um grupo de logs existente ou crie pelo menos um grupo de logs para armazenar os logs coletados do seu banco de dados autônomo. Consulte Criar Grupos de Logs para Armazenar seus Logs na Documentação do Oracle Cloud Infrastructure.
  • Familiarize-se com as Diretrizes de Consulta SQL para gravar as consultas SQL para extrair dados de log. Consulte Diretrizes de Consulta SQL na Documentação do Oracle Cloud Infrastructure.
  • Certifique-se de ter acesso aos compartimentos nos quais seus bancos de dados autônomos residem no Oracle Cloud Infrastructure.
  • Opcionalmente, você pode configurar o Painel de Controle de Gerenciamento para criar e usar painéis de controle, que são ferramentas de visualização de dados que fornecem informações rápidas sobre a integridade e o desempenho da infraestrutura de TI e dos aplicativos, além de ajudar a identificar exceções e tomar ações corretivas. Consulte Configurar Painel de Controle de Gerenciamento na Documentação do Oracle Cloud Infrastructure.
  • Para que o agente de gerenciamento colete os logs da entidade do banco de dados autônomo, forneça as credenciais para acessar o banco de dados autônomo. Para saber mais sobre as credenciais que devem ser registradas no agente de gerenciamento, consulte Credenciais de Origem do Agente de Gerenciamento: DBTCPSCreds na Documentação do Oracle Cloud Infrastructure.
  • Você precisará fornecer o nome do serviço ao criar a entidade do banco de dados autônomo. Para obter informações sobre os nomes de serviço predefinidos para bancos de dados autônomos, consulte Nomes de Serviço de Banco de Dados Predefinidos para o Autonomous Database na Documentação do Oracle Database.
  • Instale agentes de gerenciamento em qualquer host que possa ter conectividade JDBC com o ATP-S ou ADW-W. Para obter etapas para estabelecer conectividade JDBC com ATP e ADW, consulte Conectividade Java com Autonomous Database (ATP ou ADW) usando 19c e 18.3 JDBC.

    Implante o plug-in do Logging Analytics ao instalar o agente. Certifique-se também de executar os pré-requisitos para implantar os agentes de gerenciamento. Consulte Management Agent: Introdução na Documentação do Oracle Cloud Infrastructure.

    Como parte do processo de instalação, você precisará criar um arquivo de resposta no qual deverá incluir a seguinte linha sobre como ativar o plug-in do Logging Analytics:

    Service.plugin.logan.download=true

    Se quiser ativar o plug-in do Management Agent no Oracle Cloud Agent, certifique-se de que o tamanho do heap da JVM seja de pelo menos 512 MB.

Download dos Arquivos da Wallet

O Agente de Gerenciamento requer o Java Key Store (JKS) ou wallets Oracle para estabelecer conexão com o ATP ou ADW. A conectividade do Management Agent com um Oracle Autonomous Database requer o uso de wallets Oracle. Certifique-se de que o usuário do agente tenha acesso de leitura aos arquivos da wallet.

Nos hosts baseados no Unix, o usuário do agente que instala o agente de gerenciamento é mgmt_agent para o agente de gerenciamento standalone instalado manualmente e oracle-cloud-agent quando o agente de gerenciamento é um plug-in ativado com o Oracle Cloud Agent.

  1. Acesse o Oracle Cloud com suas credenciais de nuvem > Navegue até a home page do seu banco de dados autônomo.

  2. Clique na guia Conexão do BD > Faça download do arquivo zip da wallet wallet_<dbname>.zip.

  3. Descompacte o zip em um diretório com segurança para que somente usuários autorizados tenham acesso a eles. O conteúdo do arquivo zip é descrito abaixo:

    • tnsnames.ora e sqlnet.ora: Arquivos de configuração de rede que armazenam descrições de conexão e configuração do cliente SQL*Net.
    • cwallet.ora e ewallet.p12: Abre automaticamente a wallet SSO e o arquivo PKCS12. O arquivo PKCS12 é protegido pela senha da wallet fornecida na interface do usuário.
    • keystore.jks e truststore.jks: Armazenamento Confiável e Armazenamento de Chaves JKS protegidos pelo passaporte da wallet fornecido durante o download da wallet.
    • ojdbc.properties: Contém a propriedade de conexão relacionada da wallet que é exigida para conexão JDBC. Isso deve estar no mesmo caminho que tnsnames.ora.

Os nomes de serviço predefinidos estão disponíveis no arquivo tnsnames.ora baixado. O valor da propriedade está no formato dbName_predefinedServiceName.

Criar a Entidade do Autonomous Database

Crie a entidade de banco de dados autônomo para fazer referência à instância de banco de dados e ativar a coleta de logs nela.

  1. Abra o menu de navegação e clique em Observação & Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

    Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Entidades.

    A página Entidades é aberta. Verifique se o seletor de compartimento à esquerda indica que você está no compartimento desejado para essa nova entidade. Clique em Criar.

  2. No menu Tipo de Entidade, selecione Autonomous Transaction Processing ou Autonomous Data Warehouse.
    Criar entidade de banco de dados autônomo
    Descrição da ilustração Create_Entity.png

    Forneça um Nome para a entidade e anote-o para referência futura. Você precisará dele para registrar os detalhes do banco de dados no agente de gerenciamento.

  3. Selecione o Compartimento do Agente de Gerenciamento no qual o agente está instalado.
  4. No menu Management Agent, selecione o agente de gerenciamento instalado em seu host que tem conectividade JDBC com o ATP-S ou ADW-W.
  5. Opcionalmente, na seção ID do Recurso da Nuvem, forneça o OCID da sua instância do banco de dados autônomo.
  6. Em Propriedades, especifique o valor da propriedade service_name.

    Nomes de serviço predefinidos estão disponíveis no arquivo tnsnames.ora que você baixou na etapa anterior. O valor da propriedade está no formato dbName_predefinedServiceName.

  7. Clique em Criar.

Registrar as Credenciais do Banco de Dados e os Detalhes da Wallet com o Management Agent

Para que o agente de gerenciamento colete os logs da entidade do banco de dados autônomo, forneça as credenciais para acessar o banco de dados autônomo. Use as etapas a seguir para adicionar as credenciais ou atualizar as credenciais existentes. Registre também os detalhes da wallet com o agente.

  1. Colete as seguintes informações sobre o banco de dados:
    • Database_Entity_Name: O nome da entidade que você especificou anteriormente ao criar a entidade ATP/ADW
    • Database_User_Name: Nome do usuário do banco de dados
    • Database_Password: Senha do banco de dados
    • Atribuição do usuário do banco de dados (opcional)
  2. Colete as seguintes informações sobre os arquivos da wallet:
    • SSL_Truststore_Location: Localização do armazenamento confiável de SSL
    • SSL_Truststore_Password: Senha do SSL Truststore
    • SSL_Keystore_Location: Localização do Armazenamento de Chaves de SSL
    • SSL_Keystore_Password: Senha do armazenamento de chaves SSL
  3. Crie um arquivo JSON com as informações do seu banco de dados: 
     { "source": "lacollector.la_database_sql", "name": "LCAgentDBCreds.<Database_Entity_Name>", "type": "DBTCPSCreds", "usage": "LOGANALYTICS", "disabled": "false", "properties":[ {"name":"DBUserName","value":"<Database_User_Name>"}, {"name":"DBPassword","value":"<Database_Password>"}, {"name":"ssl_trustStoreType","value":"JKS"}, {"name":"ssl_trustStoreLocation","value":"<SSL_Truststore_Location>"}, {"name":"ssl_trustStorePassword","value":"<SSL_Truststore_Password>"}, {"name":"ssl_keyStoreType","value":"JKS"}, {"name":"ssl_keyStoreLocation","value":"<SSL_Keystore_Location>"}, {"name":"ssl_keyStorePassword","value":"<SSL_Keystore_Password>"}, {"name":"ssl_server_cert_dn","value":"yes"}] }

    Atualize os campos ssl_trustStoreLocation e ssl_keyStoreLocation com caminhos de arquivo absolutos que incluem nomes de arquivo. Por exemplo: 

    {"name": "ssl_trustStoreLocation", "value": "/usr/local/wallet/truststore.jks"}, {"name": "ssl_keyStoreLocation", "value": "/usr/local/wallet/keystore.jks"}

    Para caminhos do Windows, use a barra invertida \ e, para caminhos semelhantes ao UNIX, use a barra / dentro do JSON.

  4. Para registrar as credenciais do banco de dados e os detalhes da wallet no agente de gerenciamento, faça log-in no host do agente de gerenciamento e execute o seguinte comando especificando o caminho para o arquivo JSON criado na etapa anterior:

    • No host semelhante ao UNIX:

      cat <path_to_JSON_file> | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Por exemplo:

      cat /net/example.com/scratch/imp/my_atp/Wallet_ATP/my_logan_creds.json | sh /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s logan

      Observação:

      Para Management Agents em execução em instâncias de computação usando o plug-in do Oracle Cloud Agent, a localização do script credential_mgmt.sh está em /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/bin.

    • No host do Windows:

      type <path_to_JSON_file> | <path_to_credential_mgmt.bat> -o upsertCredentials -s logan

      Por exemplo:

      type C:\Oracle\my_logan_creds.json | C:\Oracle\mgmt_agent\agent_inst\bin\credential_mgmt.bat -o upsertCredentials -s logan

Fornecer Privilégios ao Usuário do Agente de Gerenciamento para Ler Arquivos da Wallet

Certifique-se de que o usuário do agente de gerenciamento tenha os privilégios corretos para ler os arquivos da wallet. Forneça acesso READ e EXECUTE ao diretório da wallet e acesso READ aos arquivos da wallet. Por exemplo, comandos que você pode usar, consulte Conceder Acesso READ dos Logs ao Usuário do Agente no Host na Documentação do Logging Analytics.

Criar uma Origem para o Tipo de Entidade do Autonomous Database

  1. Abra o menu de navegação e clique em Observação & Gerenciamento. Em Logging Analytics, clique em Administração. A página Visão Geral da Administração é aberta.

    Os recursos de administração são listados no painel de navegação à esquerda em Recursos. Clique em Origens.

    A página Origens é aberta. Clique em Criar Origem.

  2. No campo Nome, digite o nome da origem.

    Se desejar, adicione uma descrição.

  3. Na lista Tipo de Origem, selecione Banco de Dados.
  4. No menu Tipo de Entidade, selecione Autonomous Transaction Processing ou Autonomous Data Warehouse.
    Criar origem de banco de dados autônomo
    Descrição da ilustração Create_Source.png
  5. Clique na guia Consultas de Banco de Dados e especifique as instruções SQL com base nas quais o Oracle Cloud Logging Analytics coleta logs de banco de dados autônomo:
    • Informe a instrução SQL no campo Consulta SQL.

      Talvez você queira executar as consultas SQL fora do Logging Analytics para verificar os resultados primeiro.

    • Clique em Configurar e mapeie as colunas da tabela SQL para os nomes de campo que seriam exibidos nos registros de log reais.
    • Especifique uma Coluna de Sequência. O valor desse campo deve determinar a sequência dos registros inseridos na tabela. Ele deve ter um valor incremental exclusivo.

    Observação:

    • O primeiro campo mapeado com um tipo de dados Timestamp é usado como timestamp do registro de log. Se nenhum campo estiver presente, a hora da coleta será usada como hora do registro de log.
    • Quando os logs são coletados pela primeira vez após a criação da origem de log (coleta de log histórico):

      Se qualquer campo da consulta SQL for mapeado para o campo Time, o valor desse campo será usado como referência para fazer upload dos registros de log dos 30 dias anteriores.

      Se nenhum dos campos da consulta SQL for mapeado para o campo Time, será feito o upload de no máximo 10.000.000 de registros.

    Clique em Pronto.

    Para adicionar várias consultas SQL, clique em Adicionar e repita esta etapa.

  6. Selecione Ativado para cada consulta SQL e clique em Salvar.

A página de listagem de origens é aberta e mostra todas as origens definidas pela Oracle e personalizadas, incluindo a que você acabou de criar.

Associar a Origem de Log à Entidade do Autonomous Database

  1. Na página de listagem de origens, identifique a origem que você criou na etapa anterior. Clique no nome da origem. A página de detalhes da origem é aberta.
  2. À esquerda da página de detalhes Origem, em Escopo do Recurso, selecione o compartimento. Isso limitará as entidades visíveis para você com base no compartimento selecionado.
  3. Em Recursos, clique em Entidades Não Associadas para exibir as entidades elegíveis para associação com essa origem. Selecione a entidade criada anteriormente para associar a esta origem e clique em Adicionar Associação.
    Entidade e origem do banco de dados autônomo do Assocaite
    Descrição da ilustração Associate_Source_Entity.png

    A caixa de diálogo Adicionar Associação é aberta.

  4. Selecione o compartimento que contém o grupo de logs no qual os dados de log devem estar localizados depois de serem coletados e indexados.
  5. Selecione o grupo de logs criado anteriormente durante a configuração.
  6. Clique em Submeter.

A entidade selecionada agora é movida para a seção Entidades Associadas em que o status da associação é exibido. Se a tarefa de associação entre entidade e origem falhar, clique em Repetir Associação.

As instruções de coleta serão enviadas ao agente que está monitorando essa entidade conforme definido anteriormente e a coleta de logs será iniciada. Vá para a seção Advertências de Coleta do Agente para exibir as advertências da coleta de logs. Observe que a lista de advertências corresponde a todas as entidades de associação dessa origem.

Se você tiver problemas com o agente de gerenciamento que coleta os dados, certifique-se de que o nome de usuário fornecido no armazenamento de credenciais tenha acesso READ às tabelas ou views que estão sendo consultadas. Aguarde alguns minutos para exibir os logs no Log Explorer. Depois que o agente tiver coletado os logs históricos, você começará a ver apenas os logs mais novos sendo coletados.

Saiba Mais

As seções a seguir na Documentação do Oracle Cloud Infrastructure: