Instale e configure o NRDOT para o monitoramento do Oracle com a CLI

Esta receita monitora uma ou mais instâncias de banco de dados Oracle (cada uma acessível via SSH) a partir de um único coletor. Em vez de solicitar um único conjunto de host/contêiner/credencial, ela lê um arquivo de instâncias (YAML) que lista cada instância a ser monitorada e, opcionalmente, um arquivo de segredos para fixar senhas específicas de usuário de monitoramento em vez de gerá-las automaticamente.

Antes de executar este comando, tenha em mãos:

• Acesso SSH (com encaminhamento de agente) a cada host do banco de dados Oracle listado, onde cada ssh_user pode executar sudo su - oracle sem um prompt de senha
• Tipo de contêiner por instância (CDB para todos os PDBs ou um único nome de PDB)
• Nome do serviço CDB ou PDB por instância
• Se deseja métricas Básicas ou Avançadas

1. Crie o arquivo de instâncias. Adicione uma entrada por instância do banco de dados Oracle que você deseja que este coletor monitore; apenas uma entrada se você estiver monitorando apenas uma única instância:

   bash

   Copiar

   $
   cat > ~/oracle-instances.yml << 'EOF'
   $
   instances:
   $
     - host: dbhost1.example.com
   $
       port: 1521
   $
       ssh_user: opc
   $
       container_type: 1
   $
       pdb_name:
   $
       service: ORCLCDB
   $
       login_name: newrelic
   $
   EOF

   container_type é 1 para CDB (monitora todos os PDBs, cria um usuário c##<login_name> comum) ou 2 para um único PDB (pdb_name necessário apenas nesse caso). Insira login_name sem o prefixo c##: a receita o adiciona para você no modo CDB.

2. (Opcional) Crie um arquivo de segredos para definir uma senha fixa de usuário de monitoramento por instância em vez de permitir que a receita gere uma automaticamente. O Oracle auto-hospedado não precisa de credenciais de administrador aqui. O usuário de monitoramento é criado via SSH e acesso SYSDBA autenticado pelo sistema operacional:

   bash

   Copiar

   $
   umask 077
   $
   cat > ~/oracle-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_LOGIN_PASSWORD_1=SomeFixedPassword1
   $
   EOF
   $
   chmod 600 ~/oracle-secrets.env

   Deixe o caminho do arquivo de segredos em branco (ou aponte-o para um arquivo que não existe) para gerar automaticamente uma senha aleatória para cada instância.

   Execute isso a partir de um host com acesso SSH (com encaminhamento de agente) para cada host do banco de dados Oracle listado em seu arquivo de instância:

   bash

   Copiar

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle

   A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

   Variável	Descrição	Padrão
   NR_CLI_ORACLE_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instâncias.	Nenhum
   NR_CLI_ORACLE_SECRETS_FILE	Opcional. Caminho para um arquivo de segredos ( KEY=VALUE ) que fixa NR_CLI_ORACLE_LOGIN_PASSWORD_<i> por instância. Deixar sem definição para gerar automaticamente uma senha aleatória para cada instância.	Nenhum
   NR_CLI_ORACLE_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1

   Dica

   Para monitorar mais de uma instância do banco de dados Oracle a partir deste coletor, adicione mais entradas ao arquivo de instâncias. Uma instância que falha em suas verificações é ignorada com um motivo registrado em log, em vez de abortar toda a instalação. A reexecução em uma instância que já possui um usuário de monitoramento exibe um prompt interativo para reutilizá-lo ou criar um novo (esta única etapa não é totalmente programável).

Esta receita monitora um ou mais endpoints do RDS Oracle a partir de um único coletor, usando um arquivo de instâncias e um arquivo de segredos.

Antes de executar este comando, tenha em mãos:

• Endpoint do RDS Oracle, porta do listener e nome do serviço de banco de dados para cada instância
• Nome de usuário e senha mestre do RDS para cada instância
• Se deseja métricas Básicas ou Avançadas

1. Criar o arquivo de instâncias (uma entrada por endpoint do RDS Oracle a ser monitorado por este coletor; ainda assim, apenas uma entrada caso seja monitorada apenas uma única instância):

   bash

   Copiar

   $
   cat > ~/oracle-instances.yml << 'EOF'
   $
   instances:
   $
     - host: rds-orders.abcdef123.us-east-1.rds.amazonaws.com
   $
       port: 1521
   $
       service: ORDERSDB
   $
       login_name: newrelic
   $
   EOF

2. Crie o arquivo de segredos com o nome de usuário e a senha mestre do RDS para cada instância, indexado para corresponder à ordem do arquivo de instâncias. Você também pode, opcionalmente, definir uma senha fixa de usuário de monitoramento por instância. Omita para gerar uma automaticamente:

   bash

   Copiar

   $
   umask 077
   $
   cat > ~/oracle-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_ADMIN_USER_1=admin
   $
   NR_CLI_ORACLE_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/oracle-secrets.env

   bash

   Copiar

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle-rds

   A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

   Variável	Descrição	Padrão
   NR_CLI_ORACLE_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instâncias.	Nenhum
   NR_CLI_ORACLE_SECRETS_FILE	Obrigatório. Caminho para o arquivo de segredos ( KEY=VALUE , um par de nome de usuário/senha mestre do RDS por instância; opcionalmente NR_CLI_ORACLE_LOGIN_PASSWORD_<i> para definir uma senha de monitoramento em vez de gerar uma automaticamente).	Nenhum
   NR_CLI_ORACLE_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1

   Dica

   Para monitorar mais de um endpoint do RDS Oracle a partir deste coletor, adicione mais entradas ao arquivo de instâncias e credenciais numeradas correspondentes ao arquivo de segredos. Uma instância que falha em suas verificações é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Esta receita monitora uma ou mais instâncias do Oracle Autonomous Database (ADB) a partir de um único coletor, usando um arquivo de instâncias e um arquivo de segredos. Cada instância se conecta por meio de TLS mútuo (padrão do ADB) usando sua própria carteira baixada. Não compartilhar um diretório de carteira entre instâncias.

Antes de executar este comando, tenha em mãos:

• Para cada instância: sua string de conexão (host, port, service, em Database connection > Connection strings do console do ADB)
• Para cada instância: sua Oracle Wallet baixada (Database connection > Download wallet do console do ADB), descompactada em seu próprio diretório no host do coletor
• Nome de usuário e senha do administrador do ADB (ADMIN) para cada instância

1. Crie o arquivo de instâncias. Adicione uma entrada por instância do ADB que você deseja que este coletor monitore; apenas uma entrada se você estiver monitorando apenas uma única instância:

   bash

   Copiar

   $
   cat > ~/adb-instances.yml << 'EOF'
   $
   instances:
   $
     - host: adb1.adb.us-ashburn-1.oraclecloud.com
   $
       port: 1522
   $
       service: myadb1_high
   $
       login_name: newrelic
   $
       wallet_dir: /home/opc/wallet1
   $
   EOF

   wallet_dir é o diretório onde a carteira dessa instância foi descompactada (deve conter cwallet.sso e sqlnet.ora); uma instância com um diretório de carteira ausente ou inválido é ignorada em vez de falhar toda a instalação.

2. Crie o arquivo de segredos com o nome de usuário e a senha do administrador do ADB para cada instância, indexado para corresponder à ordem do arquivo de instâncias. Opcionalmente, você também pode definir uma senha fixa de usuário de monitoramento por instância. Omita para gerar uma automaticamente:

   bash

   Copiar

   $
   umask 077
   $
   cat > ~/adb-secrets.env << 'EOF'
   $
   NR_CLI_ORACLE_ADMIN_USER_1=ADMIN
   $
   NR_CLI_ORACLE_ADMIN_PASSWORD_1=YourAdminPassword1
   $
   EOF
   $
   chmod 600 ~/adb-secrets.env

   Executar a partir de um host que tenha o sqlplus (Oracle Instant Client) no PATH e conectividade de rede (mTLS) com cada instância do ADB listada:

   bash

   Copiar

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-oracle-adb

   A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

   Variável	Descrição	Padrão
   NR_CLI_ORACLE_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instâncias.	Nenhum
   NR_CLI_ORACLE_SECRETS_FILE	Obrigatório. Caminho para o arquivo de segredos ( KEY=VALUE , um par de nome de usuário/senha de administrador do ADB por instância; opcionalmente NR_CLI_ORACLE_LOGIN_PASSWORD_<i> para definir uma senha de monitoramento em vez de gerar uma automaticamente: o ADB requer 12–30 caracteres com pelo menos uma letra maiúscula, uma letra minúscula e um dígito).	Nenhum

   Dica

   Não há NR_CLI_ORACLE_CONFIG_PRESET para o ADB: é um serviço totalmente gerenciado sem host para coletar métricas no nível do host.

   Dica

   Para monitorar mais de uma instância do ADB a partir deste coletor, adicione mais entradas ao arquivo de instâncias e credenciais numeradas correspondentes ao arquivo de segredos. Uma instância que falha em suas verificações é ignorada com um motivo registrado em vez de anular toda a instalação.