Instalar e configurar o NRDOT para monitoramento do Oracle com Chef

É possível instalar e configurar o NRDOT Collector para o monitoramento do banco de dados Oracle usando o cookbook newrelic-install do Chef. O cookbook instala o coletor, cria o usuário de monitoramento do banco de dados e configura o coletor quando a receita newrelic-install::default é executada.

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.
Chef 15 ou posterior.
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 o banco de dados Oracle Autonomous (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 nó.

Baixar o cookbook do Chef

Faça o download do newrelic-install cookbook do Chef do Chef Supermarket para o seu diretório de repositório (chef-repo):

bash

$knife supermarket install newrelic-install

Substituir os atributos padrão

Substitua os atributos padrão em attributes/default.rb pelos detalhes da sua conta:

Este cookbook monitora uma ou mais instâncias do banco de dados Oracle (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 nó, 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.

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-oracle'
]
default['newrelic_install']['env']['NR_CLI_ORACLE_INSTANCES_FILE'] = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_ORACLE_SECRETS_FILE']   = <optional path to a secrets file pinning monitoring passwords, on the node>
default['newrelic_install']['env']['NR_CLI_ORACLE_CONFIG_PRESET']  = <1 Basic, 2 Advanced, default 1>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (em `env` )	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.	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 nó. Deixe sem definir 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`

Atributo (em

env

)

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

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

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 nó. Deixe sem definir 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

Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

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.

Este cookbook 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 como no auto-hospedado (ambos os arquivos já devem existir no nó).

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-oracle-rds'
]
default['newrelic_install']['env']['NR_CLI_ORACLE_INSTANCES_FILE'] = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_ORACLE_SECRETS_FILE']   = <path to the secrets file (KEY=VALUE per instance) on the node>
default['newrelic_install']['env']['NR_CLI_ORACLE_CONFIG_PRESET']  = <1 Basic, 2 Advanced, default 1>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (em `env` )	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.	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 nó.	Nenhum
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuração do NRDOT: `1` para Basic `2` para Advanced	`1`

Atributo (em

env

)

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

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

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 nó.

Nenhum

NR_CLI_ORACLE_CONFIG_PRESET

Configuração do NRDOT:

1 para Basic
2 para Advanced

1

Dica

Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

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.

Este cookbook monitora uma ou mais instância do banco de dados Oracle Autonomous (ADB) a partir de um único coletor, usando o mesmo padrão de arquivo de instância/arquivo de segredos do RDS (ambos os arquivos já devem existir no nó, e cada instância também precisa de sua própria Oracle Wallet baixada e descompactada nesse nó).

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-oracle-adb'
]
default['newrelic_install']['env']['NR_CLI_ORACLE_INSTANCES_FILE'] = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_ORACLE_SECRETS_FILE']   = <path to the secrets file (KEY=VALUE per instance) on the node>
# See all available targets at: https://github.com/newrelic/chef-install

Atributo (em `env` )	Descrição	Padrão
`NR_CLI_ORACLE_INSTANCES_FILE`	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó. 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 nó.	Nenhum

Atributo (em

env

)

Descrição

Padrão

NR_CLI_ORACLE_INSTANCES_FILE

Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó. 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 nó.

Nenhum

Dica

Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

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.

Faça o upload do cookbook do Chef

Faça o upload do cookbook newrelic-install do Chef para o seu servidor Chef:

bash

$knife cookbook upload newrelic-install

Atualizar a run list

Adicione a receita newrelic-install à run list de um nó:

"run_list": [
  "recipe[newrelic-install]"
]

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 e configurar o NRDOT para monitoramento do Oracle com Chef

Instalação guiada

Pré-requisitos

Baixar o cookbook do Chef

Substituir os atributos padrão

Oracle Database auto-hospedado

Dica

Dica

Oracle Database no AWS RDS

Dica

Dica

Banco de dados autônomo Oracle (ADB)

Dica

Dica

Dica

Faça o upload do cookbook do Chef

Atualizar a run list

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

Instalar e configurar o NRDOT para monitoramento do Oracle com Chef

Instalação guiada

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

Baixar o cookbook do Chef

Substituir os atributos padrão

Oracle Database no AWS RDS

Banco de dados autônomo Oracle (ADB)

Faça o upload do cookbook do Chef

Atualizar a run list

Pré-requisitos