Installez et configurez NRDOT pour le monitoring d’Oracle avec Ansible

Vous pouvez installer et configurer le Collector NRDOT pour le monitoring de la base de données Oracle en utilisant le rôle Ansible newrelic.newrelic_install. Le rôle installe le collecteur, crée l'utilisateur de base de données de monitoring, et configure le collecteur en une seule exécution.

Installation guidée

Pour installer plutôt via l’UI de New Relic, accédez à one.newrelic.com > Integrations & Agents > Oracle (Database 360). Cette page traite uniquement de l’installation manuelle.

Prérequis

Un compte New Relic avec une clé de licence valide.
Un ID de compte New Relic.
Oracle Database 19c ou version ultérieure.
Ansible Core 2.13 ou 2.14, Python 3.10, et les collections ansible.windows et ansible.utils.
Pour Oracle auto-hébergé : Oracle Linux 7, 8, ou 9, avec un accès SSH (avec transfert d’agent) à l’hôte Oracle Database où l’utilisateur SSH peut exécuter sudo su - oracle sans prompt de mot de passe.
Pour Oracle sur AWS RDS : un hôte collecteur exécutant Debian/Ubuntu ou CentOS/RHEL/OEL.
Pour Oracle Autonomous Database (ADB) : un hôte collecteur exécutant Debian/Ubuntu ou CentOS/RHEL/OEL, avec Oracle Instant Client (sqlplus) installé et sur PATH; l’adresse IP de sortie de chaque instance autorisée dans sa liste de contrôle d’accès ADB ; et l’Oracle Wallet de chaque instance téléchargé et décompressé dans son propre répertoire sur l’hôte cible.

Installez le rôle

bash

$ansible-galaxy install newrelic.newrelic_install

Configurez le playbook

Ce rôle monitore une ou plusieurs instances Oracle Database (chacune accessible via SSH) à partir d’un seul collecteur. Au lieu d’un seul ensemble hôte/conteneur/identifiant, il lit un fichier d’instances (YAML) qui doit déjà exister sur l’hôte cible, répertoriant chaque instance à monitorer, et facultativement un fichier de secrets pour épingler les mots de passe de l’utilisateur de monitoring au lieu de les générer automatiquement. Consultez l’ installation de la CLI pour les formats de fichiers exacts.

Créez un fichier nommé playbook.yml et copiez-y le contenu suivant. Définissez targets sur oracle-otel et remplacez les valeurs des espaces réservés par les vôtres :

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

Conseil

Pour activer le logging de débogage, ajoutez verbosity: "debug" sous vars dans le playbook.

Variable	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin d'accès au fichier YAML de l'instance, déjà présent sur l'hôte cible.	Aucun
`NR_CLI_ORACLE_SECRETS_FILE`	Facultatif. Chemin vers un fichier de secrets (`KEY=VALUE`) fixant `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` par instance, déjà présent sur l’hôte cible. Laissez non défini pour générer automatiquement un mot de passe aléatoire pour chaque instance.	Aucun
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuration NRDOT : `1` pour Basic `2` pour Advanced	`1`

Variable

Description

Défaut

NR_CLI_ORACLE_INSTANCES_FILE

Requis. Chemin d'accès au fichier YAML de l'instance, déjà présent sur l'hôte cible.

Aucun

NR_CLI_ORACLE_SECRETS_FILE

Facultatif. Chemin vers un fichier de secrets (KEY=VALUE) fixant NR_CLI_ORACLE_LOGIN_PASSWORD_<i> par instance, déjà présent sur l’hôte cible. Laissez non défini pour générer automatiquement un mot de passe aléatoire pour chaque instance.

Aucun

NR_CLI_ORACLE_CONFIG_PRESET

Configuration NRDOT :

1 pour Basic
2 pour Advanced

1

Conseil

Pour monitorer plus d’une instance de base de données Oracle depuis ce collecteur, ajoutez plus d’entrées au fichier d’instance. Une instance qui échoue à ses vérifications est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Ce rôle monitore un ou plusieurs points de terminaison RDS Oracle depuis un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets qu’en auto-hébergé (les deux fichiers doivent déjà exister sur l’hôte cible). Créez un fichier nommé playbook.yml et copiez-y le contenu suivant. Définissez targets sur oracle-otel-rds et remplacez les valeurs d’espace réservé par les vôtres :

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

Conseil

Pour activer le logging de débogage, ajoutez verbosity: "debug" sous vars dans le playbook.

Variable	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin d'accès au fichier YAML de l'instance, déjà présent sur l'hôte cible.	Aucun
`NR_CLI_ORACLE_SECRETS_FILE`	Requis. Chemin d’accès au fichier de secrets (`KEY=VALUE`, une paire nom d’utilisateur / mot de passe maître RDS par instance ; facultativement `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` pour épingler un mot de passe de monitoring), déjà présent sur l’hôte cible.	Aucun
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuration NRDOT : `1` pour Basic `2` pour Advanced	`1`

Variable

Description

Défaut

NR_CLI_ORACLE_INSTANCES_FILE

Requis. Chemin d'accès au fichier YAML de l'instance, déjà présent sur l'hôte cible.

Aucun

NR_CLI_ORACLE_SECRETS_FILE

Requis. Chemin d’accès au fichier de secrets (KEY=VALUE, une paire nom d’utilisateur / mot de passe maître RDS par instance ; facultativement NR_CLI_ORACLE_LOGIN_PASSWORD_<i> pour épingler un mot de passe de monitoring), déjà présent sur l’hôte cible.

Aucun

NR_CLI_ORACLE_CONFIG_PRESET

Configuration NRDOT :

1 pour Basic
2 pour Advanced

1

Conseil

Pour monitorer plus d’un point de terminaison RDS Oracle depuis ce collecteur, ajoutez plus d’entrées au fichier des instances, et les identifiants numérotés correspondants au fichier des secrets. Une instance qui échoue à ses vérifications est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Ce rôle monitore une ou plusieurs instances Oracle Autonomous Database (ADB) à partir d’un seul collecteur, en utilisant le même modèle de fichier d’instances / fichier de secrets que RDS (les deux fichiers doivent déjà exister sur l’hôte cible, et chaque instance a également besoin de son propre Oracle Wallet téléchargé et décompressé sur cet hôte). Consultez l'installation de la CLI pour les formats de fichiers exacts. Créez un fichier nommé playbook.yml et copiez-y le contenu suivant. Définissez targets sur oracle-otel-adb et remplacez les valeurs des espaces réservés par les vôtres :

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

Conseil

Pour activer le logging de débogage, ajoutez verbosity: "debug" sous vars dans le playbook.

Variable	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin vers le fichier YAML d'instance, déjà présent sur l'hôte cible. Chaque entrée d’instance nécessite également `wallet_dir`: le chemin vers l’Oracle Wallet décompressé de cette instance.	Aucun
`NR_CLI_ORACLE_SECRETS_FILE`	Requis. Chemin vers le fichier de secrets (`KEY=VALUE`, une paire nom d’utilisateur / mot de passe administrateur ADB par instance ; facultativement `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` pour fixer un mot de passe de monitoring), déjà présent sur l’hôte cible.	Aucun

Conseil

Il n’y a pas de NR_CLI_ORACLE_CONFIG_PRESET pour ADB : il s’agit d’un service entièrement géré sans hôte à partir duquel collecter des métriques au niveau de l’hôte.

Conseil

Pour monitorer plus d'une instance ADB à partir de ce collecteur, ajoutez des entrées supplémentaires au fichier d'instance et des identifiants numérotés correspondants au fichier de secrets. Une instance qui échoue à ses vérifications est ignorée avec une raison dans le log plutôt que d’annuler toute l’installation.

Exécutez le playbook

bash

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

Pour trouver votre entité de base de données Oracle dans New Relic, consultez Trouver et utiliser vos données.

Cette traduction automatique est fournie pour votre commodité.

Installez et configurez NRDOT pour le monitoring d’Oracle avec Ansible

Installation guidée

Prérequis

Installez le rôle

Configurez le playbook

Base de données Oracle auto-hébergée

Conseil

Conseil

Oracle Database sur AWS RDS

Conseil

Conseil

Oracle Autonomous Database (ADB)

Conseil

Conseil

Conseil

Exécutez le playbook

Cette traduction automatique est fournie pour votre commodité.

Installez et configurez NRDOT pour le monitoring d’Oracle avec Ansible

Installation guidée

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

Installez le rôle

Configurez le playbook

Oracle Database sur AWS RDS

Oracle Autonomous Database (ADB)

Exécutez le playbook

Prérequis