Installez & configurez NRDOT pour le monitoring Oracle avec Chef

Vous pouvez installer et configurer le Collector NRDOT pour le monitoring de la base de données Oracle à l'aide du cookbook Chef newrelic-install. Le cookbook installe le collecteur, crée l'utilisateur de la base de données de monitoring, et configure le collecteur lorsque vous exécutez la recette newrelic-install::default.

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.
Chef 15 ou version ultérieure.
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 la base de données Oracle Autonomous (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 le nœud.

Télécharger le cookbook Chef

Téléchargez le newrelic-install livre de recettes Chef depuis le Chef Supermarket dans votre répertoire chef-repo :

bash

$knife supermarket install newrelic-install

Remplacez les attributs par défaut

Remplacez les attributs par défaut dans attributes/default.rb par les détails de votre compte :

Ce cookbook monitore une ou plusieurs instances de base de données Oracle (chacune accessible via SSH) depuis un seul collecteur. Au lieu d’un seul ensemble hôte/conteneur/identifiants, il lit un fichier d’instances (YAML) qui doit déjà exister sur le nœud, listant 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.

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

Attribut (sous `env`)	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin d’accès au fichier YAML d’instance, déjà présent sur le nœud.	Aucun
`NR_CLI_ORACLE_SECRETS_FILE`	Facultatif. Chemin d’accès à un fichier de secrets (`KEY=VALUE`) épinglant `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` par instance, déjà présent sur le nœud. 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`

Attribut (sous env)

Description

Défaut

NR_CLI_ORACLE_INSTANCES_FILE

Requis. Chemin d’accès au fichier YAML d’instance, déjà présent sur le nœud.

Aucun

NR_CLI_ORACLE_SECRETS_FILE

Facultatif. Chemin d’accès à un fichier de secrets (KEY=VALUE) épinglant NR_CLI_ORACLE_LOGIN_PASSWORD_<i> par instance, déjà présent sur le nœud. 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

Aucune valeur d’attribut par défaut n’est fournie pour ces variables. Définissez explicitement celles pertinentes pour votre cible via default['newrelic_install']['env'][...].

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 cookbook 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 que la version auto-hébergée (les deux fichiers doivent déjà exister sur le nœud).

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

Attribut (sous `env`)	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin d’accès au fichier YAML d’instance, déjà présent sur le nœud.	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 le nœud.	Aucun
`NR_CLI_ORACLE_CONFIG_PRESET`	Configuration NRDOT : `1` pour Basic `2` pour Advanced	`1`

Attribut (sous env)

Description

Défaut

NR_CLI_ORACLE_INSTANCES_FILE

Requis. Chemin d’accès au fichier YAML d’instance, déjà présent sur le nœud.

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 le nœud.

Aucun

NR_CLI_ORACLE_CONFIG_PRESET

Configuration NRDOT :

1 pour Basic
2 pour Advanced

1

Conseil

Aucune valeur d’attribut par défaut n’est fournie pour ces variables. Définissez explicitement celles pertinentes pour votre cible via default['newrelic_install']['env'][...].

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 cookbook monitore une ou plusieurs instances de base de données Oracle Autonomous (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 le nœud, et chaque instance nécessite également son propre Oracle Wallet téléchargé et décompressé sur ce nœud).

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

Attribut (sous `env`)	Description	Défaut
`NR_CLI_ORACLE_INSTANCES_FILE`	Requis. Chemin vers le fichier YAML d’instances, déjà présent sur le nœud. 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 ; éventuellement `NR_CLI_ORACLE_LOGIN_PASSWORD_<i>` pour épingler un mot de passe de monitoring), déjà présent sur le nœud.	Aucun

Conseil

Aucune valeur d’attribut par défaut n’est fournie pour ces variables. Définissez explicitement celles pertinentes pour votre cible via default['newrelic_install']['env'][...].

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.

Téléversez le cookbook Chef

Téléversez le cookbook Chef newrelic-install sur votre serveur Chef :

bash

$knife cookbook upload newrelic-install

Mettez à jour la liste d’exécution

Ajoutez la recette newrelic-install à la run list d'un nœud :

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

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 & configurez NRDOT pour le monitoring Oracle avec Chef

Installation guidée

Prérequis

Télécharger le cookbook Chef

Remplacez les attributs par défaut

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

Téléversez le cookbook Chef

Mettez à jour la liste d’exécution

Cette traduction automatique est fournie pour votre commodité.

Installez & configurez NRDOT pour le monitoring Oracle avec Chef

Installation guidée

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

Télécharger le cookbook Chef

Remplacez les attributs par défaut

Oracle Database sur AWS RDS

Oracle Autonomous Database (ADB)

Téléversez le cookbook Chef

Mettez à jour la liste d’exécution

Prérequis