• /
  • EnglishEspañolFrançais日本語한국어Português
  • Se connecterDémarrer

Cette traduction automatique est fournie pour votre commodité.

En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.

Créer un problème

Monitoring d'Oracle Database avec NRDOT

|View as Markdown (English)

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un aperçu conformément à nos politiques de pré-sortie.

New Relic permet désormais à votre équipe de monitorer les performances de votre base de données Oracle à l’aide de la distribution New Relic d’OpenTelemetry (NRDOT) et des fonctionnalités de monitoring de bases de données de New Relic. Cette intégration fournit des informations détaillées complètes sur les métriques de base de données, les performances des requêtes et la santé du système à l’aide du collecteur NRDOT.

Cette approche basée sur NRDOT complète notre On-Host Integration (OHI) existante en s'appuyant sur les standards OpenTelemetry pour le monitoring des bases de données, facilitant ainsi l'intégration avec votre pile d'observabilité existante.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

Configurer le NRDOT Collector pour le monitoring d'Oracle Database

Vous pouvez configurer le monitoring d'Oracle Database à l'aide du collecteur NRDOT dans des environnements sur l'hôte (multitenant) ou RDS. Vous pouvez configurer le NRDOT Collector en utilisant les méthodes suivantes :

  • Installation guidée: la méthode d’installation guidée fournit des instructions étape par étape sur la plateforme New Relic pour vous aider à installer et configurer le Collector NRDOT pour le monitoring de la base de données Oracle.

  • Installation manuelle: la méthode d’installation manuelle vous permet de configurer le NRDOT Collector vous-même en suivant les instructions de cette documentation. Vous pouvez configurer manuellement dans les environnements suivants :

    • Environnement sur l’hôte (multitenant): installez le Collector NRDOT sur le même hôte que votre instance de base de données Oracle pour collecter les données télémétriques de l’infrastructure et de la base de données.
    • Environnement RDS: installez le Collector NRDOT dans un environnement RDS pour monitorer vos instances de base de données Oracle exécutées dans Amazon RDS.

Conseil

Le NRDOT Collector collecte les données télémétriques liées à la fois à l'infrastructure et à la base de données, afin que vous puissiez disposer d'une solution d'observabilité unifiée pour votre environnement Oracle Database dans New Relic.

Pour installer le Collector NRDOT :

Installer le collecteur NRDOT

  1. Connectez-vous à votre compte New Relic.

  2. Allez à left navigation pane > + Integration & Agents > Oracle (OpenTelemetry).

  3. Sur l’écran Select an account, sélectionnez le compte sur lequel vous souhaitez installer l’intégration de la base de données Oracle, puis cliquez sur Continue.

  4. Sur l'écran Enter your credential, sélectionnez l'une des options suivantes, puis cliquez sur Continue:

    • Utilisez une clé existante: si vous avez déjà une clé de licence, fournissez la clé de licence. Pour plus d’informations, consultez Clés utilisateur.
    • Créer une nouvelle clé: si vous n’avez pas de clé de licence, cliquez sur Create a new key pour en créer une.

  5. Sur l’écran Compatibility and requirements, assurez-vous que toutes les exigences sont satisfaites, et cliquez sur Continue.

  6. Sur l'écran Database user configuration, sélectionnez votre type de déploiement pour installer l'intégration.

  7. Suivez les instructions à l’écran pour configurer l’intégration pour l’environnement sélectionné.

  8. Après l’installation, sur l’écran Test your integration, cliquez sur Test connection pour vérifier que le Collector NRDOT est capable de se connecter à votre instance de base de données Oracle et d’envoyer des données à New Relic. Si le test réussit, vous verrez un message de confirmation.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de bases de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de bases de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données Oracle via l’UI de New Relic.

Pour trouver votre entité de base de données Oracle dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Définissez les critères de recherche comme instrumentation.provider = opentelemetry.
  3. Sélectionnez votre base de données Oracle dans la liste des entités.

Vous pouvez configurer le monitoring d'Oracle Database à l'aide du NRDOT Collector dans des environnements sur l'hôte ou multitenant. Pour installer le NRDOT Collector dans des environnements sur l'hôte (multi-locataires), suivez ces étapes :

Remarque : tous les PDB sous ce CDB seront monitorés.

Méthode d'installation

Sélectionnez la méthode de distribution de l'installation appropriée pour votre environnement Linux :

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre base de données Oracle multitenant. Cela nécessite de créer un utilisateur commun avec le préfixe C##.

  1. Avant de créer l’utilisateur de base de données, ou d’exécuter des octrois d’affectation, vous devez exécuter l’instruction suivante en tant qu’utilisateur SYS pour définir votre contexte de conteneur actif actuel sur CDB$ROOT:

    ALTER SESSION SET CONTAINER = CDB$ROOT;

  2. Pour une base de données multitenant, connectez-vous à la base de données racine en tant qu’administrateur. Utilisez CREATE USER pour ajouter un nouvel utilisateur à la base de données. Le nom d’utilisateur spécifié sera un « utilisateur commun » et doit être préfixé par c## comme recommandé par Oracle.

    CREATE USER c##<YOUR_DB_USERNAME> IDENTIFIED BY "<USER_PASSWORD>" CONTAINER=ALL;
    GRANT CREATE SESSION TO c##<YOUR_DB_USERNAME> CONTAINER=ALL;

  3. Exécutez l’instruction suivante en tant que SYSDBA sur la racine CDB. Cela permet à l’utilisateur de monitoring de voir les lignes de chaque PDB dans les vues de données de conteneur, ce qui est requis pour les métriques et événements par PDB.

    ALTER USER c##<YOUR_DB_USERNAME> SET CONTAINER_DATA=ALL CONTAINER=CURRENT;

    Conseil

    Assurez-vous que votre USER_PASSWORD respecte les exigences d'Oracle en matière de mot de passe du nouvel utilisateur.

Accorder des privilèges de monitoring pour une base de données multitenant

Exécutez les GRANT instructions suivantes en tant que SYSDBA sur la racine CDB. Celles-ci couvrent la détection d’instance, la collecte de métriques, le monitoring par PDB, et la collecte d’événements. Vous pouvez les exécuter ensemble sous forme de script unique, ou exécuter chaque instruction individuellement.

GRANT SELECT ON V_$INSTANCE   TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$DATABASE   TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$CONTAINERS TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$DATAFILE   TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SYSSTAT                    TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$CON_SYSSTAT                TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SYSMETRIC                  TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$CON_SYSMETRIC              TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SESSION                    TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$OSSTAT                     TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SGAINFO                    TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$ROWCACHE                   TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$PARAMETER                  TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON CDB_TABLESPACE_USAGE_METRICS  TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON CDB_TABLESPACES               TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON DBA_DATA_FILES                TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON DBA_FREE_SPACE                TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON DBA_RECYCLEBIN                TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SQL            TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$LOCK           TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$SESSION_EVENT  TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON DBA_PROCEDURES    TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON DBA_OBJECTS       TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON V_$PDBS           TO c##<USER_NAME> CONTAINER=ALL;
GRANT SELECT ON CDB_SERVICES      TO c##<USER_NAME> CONTAINER=ALL;

Configurer le collecteur NRDOT

  1. Créez le fichier de configuration. Le nom du fichier doit être oracle-config.yaml.

    bash
    $
    sudo nano /etc/nrdot-collector/oracle-config.yaml

  2. Ajoutez le contenu de configuration ci-dessous au fichier oracle-config.yaml que vous avez créé à l'étape précédente.

  3. Mettez à jour la configuration du collecteur NRDOT pour utiliser votre fichier oracle-config.yaml.

    bash
    $
    sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/oracle-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

  4. Définissez les paramètres requis suivants dans le fichier de configuration :

    paramètres

    Description

    <YOUR_DB_HOST>

    Saisissez le nom d’hôte de votre base de données Oracle.

    <YOUR_DB_PORT>

    Saisissez le port de votre base de données Oracle.

    <USERNAME>

    Saisissez le nom d'utilisateur de votre base de données.

    <PASSWORD>

    Saisissez le mot de passe de votre base de données.

    <YOUR_SERVICE_NAME>

    Saisissez le nom de votre service Oracle.

    <YOUR_NEWRELIC_OTLP_ENDPOINT>

    Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.

    <YOUR_NEWRELIC_LICENSE_KEY>

    Saisissez votre clé API New Relic.

  5. Dans la section Événements, activez ces types d’événements pour collecter leurs métriques :

    Événement

    Description

    db.server.query_sample

    Échantillons de requêtes actives par session capturant le SQL actuel, l’état d’attente et les détails de blocage.

    db.server.top_query

    Top N des instructions SQL par CPU ou temps écoulé, y compris les statistiques d’exécution et les plans de requête.

    db.server.session.wait_sample

    Nombres et durées d’attente cumulés par session à partir de

    v$session_event

    .

  6. Configurez les paramètres de collecte pour chaque type d’événement :

    Section de configuration

    paramètres

    Valeur par défaut

    top_query_collection

    max_query_sample_count

    1000

    top_query_collection

    top_query_count

    200

    top_query_collection

    collection_interval

    60s

    query_sample_collection

    max_rows_per_query

    100

    session_wait_event_collection

    max_rows_per_query

    100

Conseil

Pour plus de détails sur la configuration du point de terminaison OTLP New Relic et les bonnes pratiques OpenTelemetry, consultez la documentation OpenTelemetry OTLP.

(Facultatif) Configurez le Récepteur de requêtes SQL

Vous pouvez configurer le Récepteur de requête SQL pour collecter des métriques personnalisées à partir de votre base de données Oracle. Pour plus d'informations, consultez la documentation du Récepteur de requête SQL.

Redémarrer le collecteur NRDOT

Après avoir mis à jour votre configuration, redémarrez le collecteur NRDOT :

bash
$
sudo systemctl restart nrdot-collector.service
$
sudo systemctl status nrdot-collector.service

Conseil

Redémarrez toujours le Collector NRDOT après avoir modifié la configuration pour que les nouveaux paramètres soient pris en compte.

(Facultatif) Configuration multi-récepteur

Le binaire nrdot-collector prend en charge une configuration multi-récepteur au sein d’un seul oracle-config.yaml pour monitorer plusieurs instances de base de données Oracle à l’aide d’identifiants uniques.

Conseil

  • Cette configuration vous permet de monitorer plusieurs instances de base de données Oracle simultanément. Chaque instance dispose de sa propre configuration de récepteur avec des identifiants uniques, tout en partageant des processeurs, et des exportateurs communs. Ajustez le collection_interval, et d’autres paramètres en fonction de vos besoins de monitoring.

  • Redémarrez le collecteur NRDOT après avoir mis à jour la configuration pour appliquer les modifications.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de bases de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de bases de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de monitoring en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données Oracle via l’UI de New Relic.

Pour trouver votre entité de base de données Oracle dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Définissez les critères de recherche comme instrumentation.provider = opentelemetry.
  3. Sélectionnez votre base de données Oracle dans la liste des entités.

Pour installer le Collector NRDOT pour les environnements PDB, suivez ces étapes :

Méthode d'installation

Sélectionnez la méthode de distribution de l'installation appropriée pour votre environnement Linux :

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre instance de base de données Oracle PDB.

  1. Exécutez l’instruction suivante en tant que SYS avant de créer l’utilisateur, ou d’exécuter des octrois :
    ALTER SESSION SET CONTAINER = "<YOUR_PDB>";
  2. Exécutez les instructions suivantes en tant que SYS dans votre PDB cible pour créer un utilisateur de monitoring local :
    CREATE USER <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
    GRANT CREATE SESSION TO <USER_NAME>;

Accorder des privilèges de monitoring pour une base de données multitenant

Exécutez ces commandes en tant qu’utilisateur SYS dans votre PDB. Cela donne à l’outil de monitoring l’accès de base dont il a besoin pour collecter des métriques, suivre des événements, et trouver vos instances de base de données.

GRANT SELECT ON V_$INSTANCE   TO <USER_NAME>;
GRANT SELECT ON V_$DATABASE   TO <USER_NAME>;
GRANT SELECT ON V_$CONTAINERS TO <USER_NAME>;
GRANT SELECT ON V_$DATAFILE   TO <USER_NAME>;
GRANT SELECT ON V_$SYSSTAT                    TO <USER_NAME>;
GRANT SELECT ON V_$SYSMETRIC                  TO <USER_NAME>;
GRANT SELECT ON V_$SESSION                    TO <USER_NAME>;
GRANT SELECT ON V_$RESOURCE_LIMIT             TO <USER_NAME>;
GRANT SELECT ON V_$OSSTAT                     TO <USER_NAME>;
GRANT SELECT ON V_$SGAINFO                    TO <USER_NAME>;
GRANT SELECT ON V_$ROWCACHE                   TO <USER_NAME>;
GRANT SELECT ON V_$PARAMETER                  TO <USER_NAME>;
GRANT SELECT ON DBA_TABLESPACE_USAGE_METRICS  TO <USER_NAME>;
GRANT SELECT ON DBA_TABLESPACES               TO <USER_NAME>;
GRANT SELECT ON DBA_DATA_FILES                TO <USER_NAME>;
GRANT SELECT ON DBA_FREE_SPACE                TO <USER_NAME>;
GRANT SELECT ON DBA_RECYCLEBIN                TO <USER_NAME>;
GRANT SELECT ON V_$SQL            TO <USER_NAME>;
GRANT SELECT ON V_$SQL_PLAN_STATISTICS_ALL       TO <USER_NAME>;
GRANT SELECT ON V_$LOCK           TO <USER_NAME>;
GRANT SELECT ON V_$SESSION_EVENT  TO <USER_NAME>;
GRANT SELECT ON DBA_PROCEDURES    TO <USER_NAME>;
GRANT SELECT ON DBA_OBJECTS       TO <USER_NAME>;
GRANT SELECT ON V_$PDBS      TO <USER_NAME>;
GRANT SELECT ON CDB_SERVICES TO <USER_NAME>;

Configurer le collecteur NRDOT

Configurez le Collector NRDOT avec vos paramètres spécifiques à la PDB.

  1. Créez le fichier de configuration. Le nom du fichier doit être oracle-config.yaml.

    bash
    $
    sudo nano /etc/nrdot-collector/oracle-config.yaml

  2. Ajoutez le contenu de configuration ci-dessous au fichier oracle-config.yaml que vous avez créé à l'étape précédente.

  3. Mettez à jour la configuration du collecteur NRDOT pour utiliser votre fichier oracle-config.yaml.

    bash
    $
    sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/oracle-config.yaml"|' /etc/nrdot-collector/nrdot-collector.conf

  4. Définissez les paramètres requis suivants dans le fichier de configuration :

    paramètres

    Description

    <YOUR_DB_HOST>

    Saisissez le nom d’hôte de votre base de données Oracle.

    <YOUR_DB_PORT>

    Saisissez le port de votre base de données Oracle.

    <USERNAME>

    Saisissez le nom d'utilisateur de votre base de données.

    <PASSWORD>

    Saisissez le mot de passe de votre base de données.

    <YOUR_SERVICE_NAME>

    Saisissez le nom de votre service Oracle.

    <YOUR_NEWRELIC_OTLP_ENDPOINT>

    Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.

    <YOUR_NEWRELIC_LICENSE_KEY>

    Saisissez votre clé API New Relic.

  5. Dans la section Événements, activez ces types d’événements pour collecter leurs métriques :

    Événement

    Description

    db.server.query_sample

    Échantillons de requêtes actives par session capturant le SQL actuel, l’état d’attente et les détails de blocage.

    db.server.top_query

    Top N des instructions SQL par CPU ou temps écoulé, y compris les statistiques d’exécution et les plans de requête.

    db.server.session.wait_sample

    Nombres et durées d’attente cumulés par session à partir de

    v$session_event

    .

  6. Configurez les paramètres de collecte pour chaque type d’événement :

    Section de configuration

    paramètres

    Valeur

    top_query_collection

    max_query_sample_count

    1000

    top_query_collection

    top_query_count

    200

    top_query_collection

    collection_interval

    60s

    query_sample_collection

    max_rows_per_query

    100

    session_wait_event_collection

    max_rows_per_query

    100

    Conseil

    Pour plus de détails sur la configuration du point de terminaison OTLP New Relic et les bonnes pratiques OpenTelemetry, consultez la documentation OpenTelemetry OTLP.

(Facultatif) Configurez le Récepteur de requêtes SQL

Vous pouvez configurer le Récepteur de requête SQL pour collecter des métriques personnalisées à partir de votre base de données Oracle. Pour plus d'informations, consultez la documentation du Récepteur de requête SQL.

Redémarrer le collecteur NRDOT

Après avoir mis à jour votre configuration, redémarrez le collecteur NRDOT :

bash
$
sudo systemctl restart nrdot-collector.service
$
sudo systemctl status nrdot-collector.service

Conseil

Redémarrez toujours le collecteur NRDOT après avoir modifié la configuration pour garantir la prise en compte des nouveaux paramètres.

(Facultatif) Configuration multi-récepteur

Le binaire nrdot-collector prend en charge une configuration multi-récepteur au sein d’un seul oracle-config.yaml pour monitorer plusieurs instances de base de données Oracle à l’aide d’identifiants uniques.

Conseil

  • Cette configuration vous permet de monitorer plusieurs instances de base de données Oracle simultanément. Chaque instance dispose de sa propre configuration de récepteur avec des identifiants uniques, tout en partageant des processeurs, et des exportateurs communs. Ajustez le collection_interval, et d’autres paramètres en fonction de vos besoins de monitoring.

  • Redémarrez le collecteur NRDOT après avoir mis à jour la configuration pour appliquer les modifications.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de bases de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de bases de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de monitoring en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données Oracle via l’UI de New Relic.

Pour trouver votre entité de base de données Oracle dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Définissez les critères de recherche comme instrumentation.provider = opentelemetry.
  3. Sélectionnez votre base de données Oracle dans la liste des entités.

Pour installer le collecteur NRDOT dans les environnements RDS, suivez ces étapes :

Méthode d'installation

Sélectionnez la méthode de distribution de l'installation appropriée pour votre environnement Linux :

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre base de données Oracle RDS.

  1. Connectez-vous à la base de données racine en tant qu'administrateur :

    CREATE USER <USERNAME> IDENTIFIED BY "<USER_PASSWORD>";

  2. Accorder les privilèges CONNECT à l'utilisateur nouvellement créé :

    GRANT CONNECT TO <USERNAME>;

Accorder des privilèges de monitoring pour la base de données RDS

Exécutez les instructions SQL suivantes pour accorder des privilèges de monitoring. Remplacez <USERNAME_IN_UPPERCASE> par votre nom d'utilisateur en majuscules :

EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSMETRIC',      '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSMETRIC',  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CONTAINERS',     '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SESSION_EVENT',  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SYSSTAT',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$CON_SYSSTAT',    '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$OSSTAT',         '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SGAINFO',        '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL',            '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQLSTATS',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$SQL_PLAN_STATISTICS_ALL',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PARAMETER',      '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$ROWCACHE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$RESOURCE_LIMIT', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$LOCK',           '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATABASE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$INSTANCE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$DATAFILE',       '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('V_$PDBS',           '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_DATA_FILES',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_FREE_SPACE',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_RECYCLEBIN',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACES',              '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_TABLESPACE_USAGE_METRICS', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_PROCEDURES',               '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS',                  '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACE_USAGE_METRICS', '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_TABLESPACES',              '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
EXEC rdsadmin.rdsadmin_util.grant_sys_object('CDB_SERVICES',                 '<USERNAME_IN_UPPERCASE>', 'SELECT', false);
GRANT CREATE SESSION TO <USERNAME_IN_UPPERCASE>;

Configurer le collecteur NRDOT

  1. Créez le fichier de configuration. Le nom du fichier doit être oracle-config.yaml.

    bash
    $
    sudo nano /etc/nrdot-collector/oracle-config.yaml

  2. Ajoutez le contenu de configuration ci-dessous au fichier oracle-config.yaml que vous avez créé à l'étape précédente.

  3. Définissez les paramètres requis suivants dans le fichier de configuration :

    paramètres

    Description

    <YOUR_DB_HOST>

    Saisissez le nom d’hôte de votre base de données Oracle.

    <YOUR_DB_PORT>

    Saisissez le port de votre base de données Oracle.

    <USERNAME>

    Saisissez le nom d'utilisateur de votre base de données.

    <PASSWORD>

    Saisissez le mot de passe de votre base de données.

    <YOUR_SERVICE_NAME>

    Saisissez le nom de votre service PDB.

    <YOUR_NEWRELIC_OTLP_ENDPOINT>

    Saisissez le point de terminaison OTLP New Relic. Pour plus d'informations, consultez la documentation sur les endpoints OTLP New Relic.

    <YOUR_NEWRELIC_LICENSE_KEY>

    Entrez votre clé de licence New Relic.

  4. Dans la section Événements, activez ces types d’événements pour collecter leurs métriques :

    Événement

    Description

    db.server.query_sample

    Échantillons de requêtes actives par session capturant le SQL actuel, l’état d’attente et les détails de blocage.

    db.server.top_query

    Top N des instructions SQL par CPU ou temps écoulé, y compris les statistiques d’exécution et les plans de requête.

    db.server.session.wait_sample

    Nombres et durées d’attente cumulés par session à partir de

    v$session_event

    .

  5. Configurez les paramètres de collecte pour chaque type d’événement :

    Section de configuration

    paramètres

    Valeur

    top_query_collection

    max_query_sample_count

    1000

    top_query_collection

    top_query_count

    200

    top_query_collection

    collection_interval

    60s

    query_sample_collection

    max_rows_per_query

    100

    session_wait_event_collection

    max_rows_per_query

    100

(Facultatif) Configurez le Récepteur de requêtes SQL

Vous pouvez configurer le Récepteur de requête SQL pour collecter des métriques personnalisées à partir de votre base de données Oracle. Pour plus d'informations, consultez la documentation du Récepteur de requête SQL.

(Facultatif) Configuration multi-récepteur

Le binaire nrdot-collector prend en charge une configuration multi-récepteur au sein d’un seul oracle-config.yaml pour monitorer plusieurs instances de base de données Oracle à l’aide d’identifiants uniques. L’exemple oracle-config.yaml ci-dessous montre comment configurer plusieurs récepteurs pour différentes instances RDS tout en partageant des processeurs et des exportateurs communs.

Conseil

  • Cette configuration vous permet de monitorer plusieurs instances Oracle RDS simultanément. Chaque instance dispose de sa propre configuration de récepteur avec des identifiants uniques, tout en partageant des processeurs et des exportateurs communs. Ajustez le collection_interval et d'autres paramètres en fonction de vos besoins de monitoring.

  • Redémarrez le collecteur NRDOT après avoir mis à jour la configuration pour appliquer les modifications.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de bases de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de bases de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

La fonctionnalité de gestion des secrets vous permet de gérer en toute sécurité des informations sensibles, telles que les identifiants de base de données. Cela permet de renforcer la sécurité de votre configuration de monitoring en évitant de coder en dur des données sensibles dans les fichiers de configuration. Pour plus d'informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Une fois vos données collectées, vous pouvez accéder à un monitoring complet de la base de données Oracle via l’UI de New Relic.

Pour trouver votre entité de base de données Oracle dans New Relic :

  1. Allez à https://one.newrelic.com > All Capabilities > Databases.
  2. Définissez les critères de recherche comme instrumentation.provider = opentelemetry.
  3. Sélectionnez votre base de données Oracle dans la liste des entités.

Pour installer le NRDOT Collector pour les environnements Oracle Autonomous Database (ADB), suivez ces étapes :

Méthode d'installation

Sélectionnez la méthode de distribution de l'installation appropriée pour votre environnement Linux :

Configurer l'utilisateur de la base de données

Créez un utilisateur de monitoring avec les privilèges nécessaires pour votre instance de base de données Oracle ADB. Exécutez les instructions suivantes en tant que SYS dans votre ADB cible pour créer un utilisateur de monitoring local :

CREATE USER <USER_NAME> IDENTIFIED BY "<YOUR_PASSWORD>";
GRANT CREATE SESSION TO <USER_NAME>;

Accorder des privilèges de monitoring pour Autonomous Database

Exécutez ces commandes en tant qu’administrateur dans votre ADB. Cela donne à l’outil de monitoring l’accès de base dont il a besoin pour collecter des métriques, suivre des événements, et trouver vos instances de base de données.

GRANT SELECT ON SYS.V_$INSTANCE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$DATABASE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$CONTAINERS TO <USER_NAME>;
GRANT SELECT ON SYS.V_$DATAFILE   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PDBS       TO <USER_NAME>; 
GRANT SELECT ON SYS.V_$SYSSTAT                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SYSMETRIC                  TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$RESOURCE_LIMIT             TO <USER_NAME>;
GRANT SELECT ON SYS.V_$OSSTAT                     TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SGAINFO                    TO <USER_NAME>;
GRANT SELECT ON SYS.V_$ROWCACHE                   TO <USER_NAME>;
GRANT SELECT ON SYS.V_$PARAMETER                  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACE_USAGE_METRICS  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_TABLESPACES               TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_DATA_FILES                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_FREE_SPACE                TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_RECYCLEBIN                TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL            TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SQL_PLAN_STATISTICS_ALL       TO <USER_NAME>;
GRANT SELECT ON SYS.V_$LOCK           TO <USER_NAME>;
GRANT SELECT ON SYS.V_$SESSION_EVENT  TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_PROCEDURES    TO <USER_NAME>;
GRANT SELECT ON SYS.DBA_OBJECTS       TO <USER_NAME>;

Configurer le collecteur NRDOT

Configurez le NRDOT Collector avec vos paramètres spécifiques à ADB. Créez un fichier de configuration (par exemple, adb-config.yaml) avec le contenu suivant :

receivers:
  nroracledb/adb:
    datasource: "oracle://<USERNAME>:<PASSWORD>@<YOUR_DB_HOST>:<YOUR_DB_PORT>/<YOUR_SERVICE_NAME>?ssl=true&ssl%20verify=true"
    collection_interval: 10s
    events:
      db.server.query_sample:
        enabled: true
      db.server.top_query:
        enabled: true
      db.server.session.wait_sample:
        enabled: true


    top_query_collection:
      max_query_sample_count: 1000
      top_query_count: 200
      collection_interval: 60s
      allowed_comment_keys:
        - nr_service_guid


    query_sample_collection:
      max_rows_per_query: 100
      allowed_comment_keys:
        - nr_service_guid


    session_wait_event_collection:
      max_rows_per_query: 100


    metrics:
      oracledb.cpu_time:
        enabled: true
      oracledb.executions:
        enabled: true
      oracledb.parse_calls:
        enabled: true
      oracledb.hard_parses:
        enabled: true
      oracledb.logical_reads:
        enabled: true
      oracledb.physical_reads:
        enabled: true
      oracledb.physical_reads_direct:
        enabled: true
      oracledb.physical_writes:
        enabled: true
      oracledb.physical_writes_direct:
        enabled: true
      oracledb.physical_read_io_requests:
        enabled: true
      oracledb.physical_write_io_requests:
        enabled: true
      oracledb.physical_io.cache_writes:
        enabled: true
      oracledb.physical_io.requests:
        enabled: true
        attributes:
          - disk.io.direction
          - disk.io.block_size
      oracledb.physical_io.transferred:
        enabled: true
        attributes:
          - disk.io.direction
          - disk.io.type
      oracledb.sqlnet.io.transferred:
        enabled: true
        attributes:
          - network.io.direction
          - destination.type
      oracledb.consistent_gets:
        enabled: true
      oracledb.db_block_gets:
        enabled: true
      oracledb.data_dictionary.hit_ratio:
        enabled: true
      oracledb.pga_memory:
        enabled: true
      oracledb.enqueue_deadlocks:
        enabled: true
      oracledb.exchange_deadlocks:
        enabled: true
      oracledb.sessions.usage:
        enabled: true
        attributes:
          - session_type
          - session_status
      oracledb.logons:
        enabled: true
      oracledb.user_commits:
        enabled: true
      oracledb.user_rollbacks:
        enabled: true
      oracledb.tablespace_size.limit:
        enabled: true
        attributes:
          - tablespace_name
      oracledb.tablespace_size.usage:
        enabled: true
        attributes:
          - tablespace_name
      oracledb.storage.usage:
        enabled: true
      oracledb.storage.utilization:
        enabled: true
      oracledb.recycle_bin.limit:
        enabled: true
      oracledb.queries_parallelized:
        enabled: true
      oracledb.ddl_statements_parallelized:
        enabled: true
      oracledb.dml_statements_parallelized:
        enabled: true
      oracledb.parallel_operations_not_downgraded:
        enabled: true
      oracledb.parallel_operations_downgraded_1_to_25_pct:
        enabled: true
      oracledb.parallel_operations_downgraded_25_to_50_pct:
        enabled: true
      oracledb.parallel_operations_downgraded_50_to_75_pct:
        enabled: true
      oracledb.parallel_operations_downgraded_75_to_99_pct:
        enabled: true
      oracledb.parallel_operations_downgraded_to_serial:
        enabled: true


processors:
  batch:
  resource/add_event_name:
    attributes:
      - key: host.address
        value: "<YOUR_DB_HOST>"
        action: upsert


exporters:
  otlphttp/newrelic:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: "<YOUR_NEWRELIC_LICENSE_KEY>"
    compression: gzip
    retry_on_failure:
      enabled: true
      initial_interval: 5s
      max_interval: 30s
      max_elapsed_time: 300s


service:
  telemetry:
    metrics:
      level: none
  pipelines:
    metrics/oracledb:
      receivers: [nroracledb/adb]
      processors: [resource/add_event_name, batch]
      exporters: [otlphttp/newrelic]
    logs/oracledb:
      receivers: [nroracledb/adb]
      processors: [resource/add_event_name, batch]
      exporters: [otlphttp/newrelic]

Important

Remarque: les métriques suivantes ne sont pas prises en charge dans ADB:

  • oracledb.database.cpu.utilization
  • oracledb.database.wait.utilization
  • oracledb.host.cpu.utilization
  • oracledb.execution.utilization
  • oracledb.parse.rate
  • oracledb.parse.utilization
  • oracledb.sort.ratio
  • oracledb.sql_service.response.duration
  • oracledb.buffer_cache.utilization
  • oracledb.library_cache.utilization
  • oracledb.shared_pool.utilization
  • oracledb.redo_allocation.utilization
  • oracledb.processes.limit
  • oracledb.processes.usage
  • oracledb.sessions.limit
  • oracledb.transactions.limit
  • oracledb.transactions.usage
  • oracledb.dml_locks.limit
  • oracledb.dml_locks.usage
  • oracledb.enqueue_locks.limit
  • oracledb.enqueue_locks.usage
  • oracledb.enqueue_resources.limit
  • oracledb.enqueue_resources.usage

(Facultatif) Configurez le Récepteur de requêtes SQL

Vous pouvez configurer le récepteur de requêtes SQL pour collecter des métriques personnalisées à partir de votre base de données Oracle. Pour plus d’informations, consultez la documentation du récepteur de requêtes SQL.

Redémarrer le collecteur NRDOT

Après avoir configuré le collecteur, redémarrez le service du collecteur NRDOT pour appliquer les modifications :

bash
$
sudo systemctl restart nrdot-collector

Pour vérifier que le collecteur fonctionne correctement, vérifiez l'état du service :

bash
$
sudo systemctl status nrdot-collector

Conseil

Redémarrez toujours le collecteur NRDOT après avoir modifié la configuration pour garantir la prise en compte des nouveaux paramètres.

(Facultatif) Configuration multi-récepteur

Si vous souhaitez monitorer plusieurs instances Oracle ADB à partir du même collecteur, vous pouvez configurer plusieurs récepteurs dans votre fichier de configuration en ajoutant des blocs de récepteur supplémentaires avec des noms, et des détails de connexion différents.

(Facultatif) Configurer la corrélation APM-base de données

Pour corréler les performances de votre application avec les opérations de base de données, vous pouvez configurer l'identification du service de bases de données. Cette fonctionnalité vous permet de voir exactement quelles applications génèrent des workloads de base de données spécifiques. Pour plus d'informations, reportez-vous à configurer l'identification du service de bases de données pour obtenir la corrélation APM-base de données dans New Relic.

Important

Pour afficher les données de performance de la base de données dans APM, les deux entités doivent se trouver dans le même compte New Relic. Si les entités se trouvent dans des comptes New Relic différents, vous devez avoir accès aux deux comptes pour visualiser les données.

(Facultatif) Configurer la gestion des secrets

Vous pouvez configurer le NRDOT Collector pour récupérer des informations sensibles, telles que des mots de passe, à partir de systèmes de gestion des secrets au lieu de les stocker en texte clair dans des fichiers de configuration. Pour plus d’informations, consultez la gestion des secrets.

Trouvez et utilisez vos données

Après avoir configuré l’intégration Oracle ADB, vous pouvez commencer à monitorer et à analyser les performances de votre base de données dans New Relic :

  1. Accédez à one.newrelic.com > All Entities.

  2. Filtrez par Oracle pour trouver les entités de votre base de données.

  3. Sélectionnez votre entité Oracle ADB pour afficher les dashboards, les métriques et les logs.

    Pour plus d’informations sur le monitoring des bases de données Oracle, consultez notre documentation sur le monitoring de base de données.

Commandes prises en charge par le collecteur NRDOT

Cette section fournit une liste de commandes courantes pour gérer le service NRDOT Collector sur votre système.

Métriques disponibles

Les métriques suivantes sont disponibles pour le monitoring de base de données Oracle avec NRDOT. Activez les scrapers pertinents dans votre configuration pour les collecter.

Dépannage

Si vous rencontrez des problèmes lors de l'installation, utilisez ce guide de dépannage pour diagnostiquer et résoudre les problèmes courants.

Et ensuite ?

Après avoir configuré le monitoring d'Oracle Database avec NRDOT :

Droits d'auteur © 2026 New Relic Inc.
RecrutementConditions de servicePolitique DMCAAvis de confidentialitéWebsite TermsAvis de brevetLoi sur l'esclavage moderne

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.