Instalar y configurar NRDOT para el monitoreo de Oracle con Ansible

Puede instalar y configurar el Collector de NRDOT para el monitoreo de la base de datos de Oracle mediante el rol de Ansible newrelic.newrelic_install. El rol instala el recolector, crea el usuario de la base de datos de monitoreo y configura el recolector en un solo play.

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.
Ansible Core 2.13 o 2.14, Python 3.10 y las colecciones ansible.windows y ansible.utils.
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 Oracle Autonomous Database (ADB): un host 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 la lista de control de acceso de ADB; y la Oracle Wallet de cada instancia descargada y descomprimida en un directorio propio en el host objetivo.

Instale el rol

bash

$ansible-galaxy install newrelic.newrelic_install

Configure el playbook

Este rol monitorea una o más instancias de la base de datos 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 host objetivo, 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.

Cree un archivo denominado playbook.yml y copie el siguiente contenido en él. Establezca targets en oracle-otel y reemplace los valores del marcador de posición por los suyos:

- 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>

Sugerencia

Para habilitar el logging de depuración, agregue verbosity: "debug" debajo de vars en el playbook.

Variable	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.	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, ya presente en el host objetivo. 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`

Variable

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.

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, ya presente en el host objetivo. 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

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 rol monitorea uno o más extremos de RDS Oracle desde un solo recolector, usando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado (ambos archivos ya deben existir en el host objetivo). Cree un archivo denominado playbook.yml y copie el siguiente contenido en él. Establezca targets en oracle-otel-rds y reemplace los valores de los marcadores de posición por los suyos:

- 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>

Sugerencia

Para habilitar el logging de depuración, agregue verbosity: "debug" debajo de vars en el playbook.

Variable	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.	Ninguno
`NR_CLI_ORACLE_SECRETS_FILE`	Obligatorio. Ruta al archivo de secretos ( `KEY=VALUE` , un par de nombre de usuario/contraseña maestro de RDS por instancia; opcionalmente `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` para fijar una contraseña de monitoreo), ya presente en el host objetivo.	Ninguno
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`

Variable

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancias, ya presente en el host objetivo.

Ninguno

NR_CLI_ORACLE_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

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

NR_CLI_ORACLE_LOGIN_PASSWORD_<i>

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

Ninguno

NR_CLI_ORACLE_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

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 rol monitorea una o más instancias de Oracle Autonomous Database (ADB) desde un solo recolector, mediante el mismo patrón de archivo de instancia/archivo de secretos que RDS (ambos archivos ya deben existir en el host objetivo y cada instancia también necesita su propia Oracle Wallet descargada y descomprimida en ese host). Consulte la instalación de la CLI para conocer los formatos de archivo exactos. Cree un archivo denominado playbook.yml y copie el siguiente contenido en él. Establezca targets en oracle-otel-adb y reemplace los valores de los marcadores de posición por los suyos:

- 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>

Sugerencia

Para habilitar el logging de depuración, agregue verbosity: "debug" debajo de vars en el playbook.

Variable	Descripción	Por defecto
`NR_CLI_ORACLE_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancia, que ya está presente en el host objetivo. 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`	Obligatorio. 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 host objetivo.	Ninguno

Variable

Descripción

Por defecto

NR_CLI_ORACLE_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancia, que ya está presente en el host objetivo. 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

Obligatorio. 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 host objetivo.

Ninguno

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.

Ejecute el playbook

bash

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

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 Ansible

Instalación guiada

Requisitos previos

Instale el rol

Configure el playbook

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

Ejecute el playbook

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

Instalar y configurar NRDOT para el monitoreo de Oracle con Ansible

Instalación guiada

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

Instale el rol

Configure el playbook

Oracle Database en AWS RDS

Base de datos autónoma de Oracle (ADB)

Ejecute el playbook

Requisitos previos