Instalar y configurar NRDOT para el monitoreo de Oracle con Chef

Puede instalar y configurar el Collector de NRDOT para el monitoreo de la base de datos de Oracle mediante el libro de recetas de Chef newrelic-install. El libro de recetas instala el recolector, crea el usuario de la base de datos de monitoreo y configura el recolector cuando ejecuta la receta newrelic-install::default.

Instalación guiada

Para instalar a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > Oracle (Database 360). Esta página solo cubre la instalación manual.

Requisitos previos

Una cuenta de New Relic con una clave de licencia válida.
Un ID de cuenta de New Relic.
Oracle Database 19c o posterior.
Chef 15 o posterior.
Para Oracle autohospedado: Oracle Linux 7, 8 o 9, con acceso SSH (con reenvío de agente) al host de la base de datos de Oracle donde el usuario de SSH puede ejecutar sudo su - oracle sin un símbolo de contraseña.
Para Oracle en AWS RDS: un host del recolector que ejecute Debian/Ubuntu o CentOS/RHEL/OEL.
Para la base de datos autónoma de Oracle (ADB): un host del recolector que ejecute Debian/Ubuntu o CentOS/RHEL/OEL, con Oracle Instant Client (sqlplus) instalado y en PATH; la IP de salida de cada instancia permitida en su lista de control de acceso de ADB; y la Oracle Wallet de cada instancia descargada y descomprimida en su propio directorio en el nodo.

Descargar el cookbook de Chef

Descargue el cookbook de Chef newrelic-install desde Chef Supermarket al directorio del repositorio de Chef:

bash

$knife supermarket install newrelic-install

Reemplace los atributos predeterminados

Reemplace los atributos predeterminados en attributes/default.rb con los detalles de la cuenta:

Este libro de recetas monitorea una o más instancias de base de datos de Oracle (cada una accesible a través de SSH) desde un único recolector. En lugar de un único conjunto de host/contenedor/credenciales, lee un archivo de instancias (YAML) que ya debe existir en el nodo, que enumera cada instancia a monitorear, y, opcionalmente, un archivo de secretos para fijar las contraseñas del usuario de monitoreo en lugar de generarlas automáticamente. Consulte la instalación de la CLI para conocer los formatos de archivo exactos.

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 (bajo `env` )	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancia, ya presente en el nodo.	Ninguno
`NR_CLI_ORACLE_SECRETS_FILE`	Opcional. Ruta a un archivo de secretos ( `KEY=VALUE` ) que fija `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` por instancia, que ya está presente en el nodo. Déjelo sin configurar para generar automáticamente una contraseña aleatoria para cada instancia.	Ninguno
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`

Atributo (bajo

env

)

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancia, ya presente en el nodo.

Ninguno

NR_CLI_ORACLE_SECRETS_FILE

Opcional. Ruta a un archivo de secretos (

KEY=VALUE

) que fija

NR_CLI_ORACLE_LOGIN_PASSWORD_<i>

por instancia, que ya está presente en el nodo. Déjelo sin configurar para generar automáticamente una contraseña aleatoria para cada instancia.

Ninguno

NR_CLI_ORACLE_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de una instancia de la base de datos Oracle desde este recolector, agregue más entradas al archivo de instancias. Una instancia que no supera sus comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este libro de recetas monitorea uno o más extremos de RDS Oracle desde un único recolector, utilizando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado (ambos archivos ya deben existir en el nodo).

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 (bajo `env` )	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancia, ya presente en el nodo.	Ninguno
`NR_CLI_ORACLE_SECRETS_FILE`	Obligatorio. Ruta al archivo de secretos ( `KEY=VALUE` , un par de nombre de usuario/contraseña maestros de RDS por instancia; opcionalmente `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` para fijar una contraseña de monitoreo), que ya está presente en el nodo.	Ninguno
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`

Atributo (bajo

env

)

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancia, ya presente en el nodo.

Ninguno

NR_CLI_ORACLE_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

, un par de nombre de usuario/contraseña maestros de RDS por instancia; opcionalmente

NR_CLI_ORACLE_LOGIN_PASSWORD_<i>

para fijar una contraseña de monitoreo), que ya está presente en el nodo.

Ninguno

NR_CLI_ORACLE_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de un extremo de RDS Oracle desde este recolector, agregue más entradas al archivo de instancias y las credenciales numeradas correspondientes al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este cookbook monitorea una o más instancias de Oracle Autonomous Database (ADB) desde un solo recolector, usando el mismo patrón de archivo de instancias/archivo de secretos que RDS (ambos archivos ya deben existir en el nodo, y cada instancia también necesita su propia Oracle Wallet descargada y descomprimida en ese nodo).

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 (bajo `env` )	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancias, que ya está presente en el nodo. Cada entrada de instancia también necesita `wallet_dir` : la ruta a la Oracle Wallet descomprimida de esa instancia.	Ninguno
`NR_CLI_ORACLE_SECRETS_FILE`	Requerido. Ruta al archivo de secretos ( `KEY=VALUE` , un par de nombre de usuario/contraseña de administrador de ADB por instancia; opcionalmente `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` para fijar una contraseña de monitoreo), ya presente en el nodo.	Ninguno

Atributo (bajo

env

)

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancias, que ya está presente en el nodo. Cada entrada de instancia también necesita

wallet_dir

: la ruta a la Oracle Wallet descomprimida de esa instancia.

Ninguno

NR_CLI_ORACLE_SECRETS_FILE

Requerido. Ruta al archivo de secretos (

KEY=VALUE

, un par de nombre de usuario/contraseña de administrador de ADB por instancia; opcionalmente

NR_CLI_ORACLE_LOGIN_PASSWORD_<i>

para fijar una contraseña de monitoreo), ya presente en el nodo.

Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

No hay NR_CLI_ORACLE_CONFIG_PRESET para ADB: es un servicio completamente administrado sin host del cual recopilar métricas a nivel de host.

Sugerencia

Para monitorear más de una instancia de ADB desde este recolector, agregue más entradas al archivo de instancia y las credenciales numeradas correspondientes al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Cargue el cookbook de Chef

Cargue el cookbook de Chef newrelic-install en su servidor de Chef:

bash

$knife cookbook upload newrelic-install

Actualice la lista de ejecución

Agregue la receta newrelic-install a la lista de ejecución de un nodo:

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

Para encontrar su entidad de base de datos Oracle en New Relic, consulte Buscar y usar sus datos.

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de Oracle con Chef

Instalación guiada

Requisitos previos

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

Base de datos Oracle autohospedada

Sugerencia

Sugerencia

Oracle Database en AWS RDS

Sugerencia

Sugerencia

Base de datos autónoma de Oracle (ADB)

Sugerencia

Sugerencia

Sugerencia

Cargue el cookbook de Chef

Actualice la lista de ejecución

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de Oracle con Chef

Instalación guiada

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

Oracle Database en AWS RDS

Base de datos autónoma de Oracle (ADB)

Cargue el cookbook de Chef

Actualice la lista de ejecución

Requisitos previos