Instalar & configurar o NRDOT para monitoramento do Oracle com Ansible

É possível instalar e configurar o NRDOT Collector para o monitoramento do Oracle Database usando a função newrelic.newrelic_install do Ansible. A função instala o coletor, cria o usuário do banco de dados de monitoramento e configura o coletor em um único play.

Instalação guiada

Para instalar pela interface da New Relic, acesse one.newrelic.com > Integrations & Agents > Oracle (Database 360). Esta página aborda apenas a instalação manual.

Pré-requisitos

Uma conta New Relic com uma chave de licença válida.
Um ID de conta da New Relic.
Oracle Database 19c ou posterior.
Ansible Core 2.13 ou 2.14, Python 3.10 e as coleções ansible.windows e ansible.utils.
Para Oracle auto-hospedado: Oracle Linux 7, 8 ou 9, com acesso SSH (com encaminhamento de agente) ao host do Oracle Database onde o usuário SSH pode executar sudo su - oracle sem um prompt de senha.
Para Oracle no AWS RDS: um host do coletor executando Debian/Ubuntu ou CentOS/RHEL/OEL.
Para Oracle Autonomous Database (ADB): um host do coletor executando Debian/Ubuntu ou CentOS/RHEL/OEL, com o Oracle Instant Client (sqlplus) instalado e em PATH; o IP de saída de cada instância permitido em sua lista de controle de acesso do ADB; e a Oracle Wallet de cada instância baixada e descompactada em seu próprio diretório no host de destino.

Instale a função

bash

$ansible-galaxy install newrelic.newrelic_install

Configure o playbook

Esta função monitora uma ou mais instâncias do Oracle Database (cada uma acessível via SSH) a partir de um único coletor. Em vez de um único conjunto de host/contêiner/credencial, ele lê um arquivo de instâncias (YAML) que já deve existir no host de destino, listando cada instância a ser monitorada, e, opcionalmente, um arquivo de segredos para fixar as senhas do usuário de monitoramento em vez de gerá-las automaticamente. Consulte a instalação da CLI para obter os formatos exatos dos arquivos.

Crie um arquivo chamado playbook.yml e copie o seguinte conteúdo para ele. Defina targets como oracle-otel e substitua os valores de espaço reservado pelos seus:

- name: Install New Relic NRDOT for Oracle Database
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <optional path to a secrets file pinning monitoring passwords, on the target host>
    NR_CLI_ORACLE_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>

Dica

Para habilitar o logging de depuração, adicione verbosity: "debug" em vars no playbook.

Variável	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino.	Nenhum
`NR_CLI_ORACLE_SECRETS_FILE`	Opcional. Caminho para um arquivo de segredos ( `KEY=VALUE` ) fixando `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` por instância, já presente no host de destino. Deixe 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`

Variável

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino.

Nenhum

NR_CLI_ORACLE_SECRETS_FILE

Opcional. Caminho para um arquivo de segredos (

KEY=VALUE

) fixando

NR_CLI_ORACLE_LOGIN_PASSWORD_<i>

por instância, já presente no host de destino. Deixe 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 vez de anular toda a instalação.

Esta função monitora um ou mais endpoints do RDS Oracle a partir de um único coletor, usando o mesmo padrão de arquivo de instâncias/arquivo de segredos que o auto-hospedado (ambos os arquivos já devem existir no host de destino). Crie um arquivo chamado playbook.yml e copie o seguinte conteúdo para ele. Defina targets como oracle-otel-rds e substitua os valores de espaço reservado pelos seus:

- name: Install New Relic NRDOT for Oracle Database on RDS
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel-rds
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>
    NR_CLI_ORACLE_CONFIG_PRESET: <1 Basic, 2 Advanced, default 1>

Dica

Para habilitar o logging de depuração, adicione verbosity: "debug" em vars no playbook.

Variável	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino.	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 fixar uma senha de monitoramento), já presente no host de destino.	Nenhum
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuração do NRDOT: `1` para Basic `2` para Advanced	`1`

Variável

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino.

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 fixar uma senha de monitoramento), já presente no host de destino.

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 função monitora uma ou mais instâncias do Oracle Autonomous Database (ADB) a partir de um único coletor, usando o mesmo padrão de arquivo de instâncias/arquivo de segredos do RDS (ambos os arquivos já devem existir no host de destino, e cada instância também precisa de sua própria Oracle Wallet baixada e descompactada nesse host). Consulte a instalação da CLI para obter os formatos exatos dos arquivos. Crie um arquivo chamado playbook.yml e copie o seguinte conteúdo para ele. Defina targets como oracle-otel-adb e substitua os valores de espaço reservado pelos seus:

- name: Install New Relic NRDOT for Oracle Autonomous Database
  hosts: all
  roles:
    - role: newrelic.newrelic_install
  vars:
    targets:
      - oracle-otel-adb
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NR_CLI_ORACLE_INSTANCES_FILE: <path to the instances YAML file on the target host>
    NR_CLI_ORACLE_SECRETS_FILE: <path to the secrets file (KEY=VALUE per instance) on the target host>

Dica

Para habilitar o logging de depuração, adicione verbosity: "debug" em vars no playbook.

Variável	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino. Cada entrada de instância também precisa de `wallet_dir` : o caminho para a Oracle Wallet descompactada dessa instância.	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 fixar uma senha de monitoramento), já presente no host de destino.	Nenhum

Variável

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no host de destino. Cada entrada de instância também precisa de

wallet_dir

: o caminho para a Oracle Wallet descompactada dessa instância.

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 fixar uma senha de monitoramento), já presente no host de destino.

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.

Execute o playbook

bash

$ansible-playbook -i <inventory_file> <playbook_file>.yml

Para encontrar sua entidade de banco de dados Oracle no New Relic, consulte Encontrar e usar seus dados.

Esta tradução de máquina é fornecida para sua comodidade.

Instalar & configurar o NRDOT para monitoramento do Oracle com Ansible

Instalação guiada

Pré-requisitos

Instale a função

Configure o playbook

Oracle Database auto-hospedado

Dica

Dica

Oracle Database no AWS RDS

Dica

Dica

Banco de dados autônomo Oracle (ADB)

Dica

Dica

Dica

Execute o playbook

Esta tradução de máquina é fornecida para sua comodidade.

Instalar & configurar o NRDOT para monitoramento do Oracle com Ansible

Instalação guiada

Pré-requisitos .css-21sua1{background:none;border:none;width:0;padding:0;}

Instale a função

Configure o playbook

Oracle Database no AWS RDS

Banco de dados autônomo Oracle (ADB)

Execute o playbook

Pré-requisitos