Instalar y configurar NRDOT para el monitoreo de Oracle con CLI

Esta receta monitorea una o más instancias de Oracle Database (cada una accesible a través de SSH) desde un solo recolector. En lugar de solicitar un solo conjunto de host/contenedor/credenciales, lee un archivo de instancias (YAML) que enumera cada instancia a monitorear y, opcionalmente, un archivo de secretos para fijar contraseñas específicas del usuario de monitoreo en lugar de generarlas automáticamente.

Antes de ejecutar este comando, tenga preparado:

• Acceso SSH (con reenvío de agente) a cada host de la base de datos de Oracle enumerado, donde cada ssh_user pueda ejecutar sudo su - oracle sin un símbolo de contraseña
• Tipo de contenedor por instancia (CDB para todas las PDB o un único nombre de PDB)
• Nombre del servicio de CDB o PDB por instancia
• Si desea métricas básicas o avanzadas

1. Cree el archivo de instancias. Agregue una entrada por cada instancia de base de datos de Oracle que desee que este recolector monitoree; solo una entrada si únicamente realiza el monitoreo de una sola instancia:

   bash

   Copia

   $
   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 es 1 para CDB (monitorea todas las PDB, crea un usuario c##<login_name> común) o 2 para una única PDB (solo entonces se requiere pdb_name). Ingrese login_name sin el prefijo c##: la receta lo agrega en el modo CDB.

2. (Opcional) Cree un archivo de secretos para establecer una contraseña de usuario de monitoreo fija por instancia en lugar de dejar que la receta genere una automáticamente. Oracle autohospedado no necesita credenciales de administrador aquí. El usuario de monitoreo se crea a través de SSH y acceso SYSDBA autenticado por el sistema operativo:

   bash

   Copia

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

   Deje en blanco la ruta del archivo de secretos (o apúntela a un archivo que no exista) para generar automáticamente una contraseña aleatoria para cada instancia en su lugar.

   Ejecute esto desde un host con acceso SSH (con reenvío de agente) a cada host de Oracle Database enumerado en el archivo de instancias:

   bash

   Copia

   $
   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

   La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

   Variable	Descripción	Por defecto
   NR_CLI_ORACLE_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias.	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. 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 pasa sus comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación. Volver a ejecutar contra una instancia que ya tiene un usuario de monitoreo muestra un símbolo de forma interactiva para reutilizarlo o crear uno nuevo (este único paso no es completamente programable).

Esta receta monitorea uno o más extremos de RDS Oracle desde un solo recolector, usando un archivo de instancias y un archivo de secretos.

Antes de ejecutar este comando, tenga preparado:

• Extremo de Oracle RDS, puerto de escucha y nombre del servicio de base de datos para cada instancia
• Nombre de usuario maestro y contraseña de RDS para cada instancia
• Si desea métricas básicas o avanzadas

1. Cree el archivo de instancia (una entrada por cada extremo de RDS Oracle que desee que este recolector monitoree, sigue siendo solo una entrada si solo monitorea una única instancia):

   bash

   Copia

   $
   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. Cree el archivo de secretos con el nombre de usuario y la contraseña maestros de RDS para cada instancia, indexado para que coincida con el orden del archivo de instancias. También puede establecer opcionalmente una contraseña fija de usuario de monitoreo por instancia. Omítalo para generar una automáticamente:

   bash

   Copia

   $
   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

   Copia

   $
   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

   La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

   Variable	Descripción	Por defecto
   NR_CLI_ORACLE_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias.	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 establecer una contraseña de monitoreo en lugar de generar una automáticamente).	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.

Esta receta monitorea una o más instancias de Oracle Autonomous Database (ADB) desde un único recolector, utilizando un archivo de instancias y un archivo de secretos. Cada instancia se conecta a través de TLS mutuo (el valor predeterminado de ADB) utilizando su propia wallet descargada. No comparta un directorio de wallet entre instancias.

Antes de ejecutar este comando, tenga preparado:

• Para cada instancia: la cadena de conexión (host, port, service, desde Database connection > Connection strings de la consola de ADB)
• Para cada instancia: la Oracle Wallet descargada (Database connection > Download wallet de la consola de ADB), descomprimida en su propio directorio en el host del recolector
• Nombre de usuario y contraseña del administrador de ADB (ADMIN) para cada instancia

1. Cree el archivo de instancias. Agregue una entrada por cada instancia de ADB que desee que este recolector monitoree; solo una entrada si solo está monitoreando una sola instancia:

   bash

   Copia

   $
   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 es el directorio donde se descomprimió la billetera de esa instancia (debe contener cwallet.sso y sqlnet.ora); una instancia con un directorio de billetera faltante o no válido se omite en lugar de hacer que falle toda la instalación.

2. Cree el archivo de secretos con el nombre de usuario y la contraseña de administrador de ADB para cada instancia, indexado para que coincida con el orden del archivo de instancias. Opcionalmente, también puede fijar una contraseña fija para el usuario de monitoreo por instancia. Omítalo para generar una automáticamente:

   bash

   Copia

   $
   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

   Ejecute esto desde un host que tenga sqlplus (Oracle Instant Client) en PATH y conectividad de red (mTLS) a cada instancia de ADB enumerada:

   bash

   Copia

   $
   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

   La CLI solicita de forma interactiva las siguientes variables. También puede configurarlas con anticipación como variables de entorno para ejecutar de forma no interactiva.

   Variable	Descripción	Por defecto
   NR_CLI_ORACLE_INSTANCES_FILE	Obligatorio. Ruta al archivo YAML de instancias.	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 en lugar de generar una automáticamente: ADB requiere 12-30 caracteres con al menos una letra mayúscula, una letra minúscula y un dígito).	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.