Configurer Database Monitoring pour Oracle Autonomous Database

Database Monitoring provides deep visibility into your Oracle databases by exposing query samples to profile your different workloads and diagnose issues.

L’Agent recueille les données de télémétrie directement depuis la base de données, en se connectant en tant qu’utilisateur en lecture seule.

Avant de commencer

Supported Oracle versions
11g, 12c, 18c, 19c, 21c
Supported Agent version
7.53.0+
Incidence sur les performances
La configuration par défaut de l’Agent pour Database Monitoring est relativement souple. Néanmoins, vous pouvez ajuster certains paramètres comme l’intervalle de collecte et le taux d’échantillonnage des requêtes pour mieux répondre à vos besoins. Pour la plupart des workloads, l’Agent monopolise moins d’un pour cent du temps d’exécution des requêtes sur la base de données, et moins d’un pour cent du CPU.

La solution Database Monitoring de Datadog fonctionne comme une intégration et vient compléter l’Agent de base (voir les benchmarks).
Proxies, répartiteurs de charge et poolers de connexion
L’Agent doit se connecter directement au host surveillé. L’Agent ne doit pas se connecter à la base de données via un proxy, un répartiteur de charge ou un pooler de connexion. Chaque Agent doit connaître le nom d’hôte sous-jacent et doit rester associé à un seul host pendant toute sa durée de vie, même en cas de basculement. Si l’Agent Datadog se connecte à différents hosts pendant son exécution, les valeurs des métriques seront incorrectes.
Considérations relatives à la sécurité des données
Consultez la rubrique Informations sensibles pour découvrir les données recueillies par l’Agent à partir de vos bases de données et la méthode à suivre pour garantir leur sécurité.

Configuration

Effectuez les opérations suivantes pour activer Database Monitoring avec votre base de données Oracle :

  1. Créer l’utilisateur Datadog
  2. Accorder à l’utilisateur l’accès à la base de données
  3. Installer l’Agent
  4. Configurer l’Agent
  5. Installer ou vérifier l’intégration Oracle
  6. Valider la configuration

Créer l’utilisateur Datadog

If you already have the legacy Oracle integration installed, the user already exists, and you can skip this step.

Create a read-only login to connect to your server and grant the required permissions:

CREATE USER datadog IDENTIFIED BY <YOUR_PASSWORD>;

Accorder à l’utilisateur l’accès à la base de données

grant create session to datadog ;
grant select on v$session to datadog ;
grant select on v$database to datadog ;
grant select on v$containers to datadog;
grant select on v$sqlstats to datadog ;
grant select on v$instance to datadog ;
grant select on dba_feature_usage_statistics to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$PROCESS to datadog ;
grant select on V$SESSION to datadog ;
grant select on V$CON_SYSMETRIC to datadog ;
grant select on CDB_TABLESPACE_USAGE_METRICS to datadog ;
grant select on CDB_TABLESPACES to datadog ;
grant select on V$SQLCOMMAND to datadog ;
grant select on V$DATAFILE to datadog ;
grant select on V$SYSMETRIC to datadog ;
grant select on V$SGAINFO to datadog ;
grant select on V$PDBS to datadog ;
grant select on CDB_SERVICES to datadog ;
grant select on V$OSSTAT to datadog ;
grant select on V$PARAMETER to datadog ;
grant select on V$SQLSTATS to datadog ;
grant select on V$CONTAINERS to datadog ;
grant select on V$SQL_PLAN_STATISTICS_ALL to datadog ;
grant select on V$SQL to datadog ;
grant select on V$PGASTAT to datadog ;
grant select on v$asm_diskgroup to datadog ;
grant select on v$rsrcmgrmetric to datadog ;
grant select on v$dataguard_config to datadog ;
grant select on v$dataguard_stats to datadog ;
grant select on v$transaction to datadog;
grant select on v$locked_object to datadog;
grant select on dba_objects to datadog;
grant select on cdb_data_files to datadog;
grant select on dba_data_files to datadog;

Stocker votre mot de passe de manière sécurisée

Store your password using secret management software such as Vault. You can then reference this password as ENC[<SECRET_NAME>] in your Agent configuration files: for example, ENC[datadog_user_database_password]. See Secrets Management for more information.

The examples on this page use datadog_user_database_password to refer to the name of the secret where your password is stored. It is possible to reference your password in plain text, but this is not recommended.

Installer l’Agent

Consultez la documentation Architecture de configuration DBM pour déterminer où installer l’Agent. L’Agent ne nécessite aucun client Oracle externe.

Pour les étapes d’installation, consultez les instructions d’installation de l’Agent.

Configurer l’Agent

Téléchargez le fichier zip du wallet depuis Oracle Cloud et décompressez-le.

Créez le fichier de configuration Oracle de l’Agent /etc/datadog-agent/conf.d/oracle.d/conf.yaml. Consultez l’exemple de fichier de configuration pour toutes les options de configuration disponibles.

Remarque : le sous-répertoire de configuration pour les versions de l’Agent comprises entre 7.50.1 et 7.53.0 est oracle-dbm.d. Consultez la section Configurer l’intégration Oracle sur l’Agent 7.50.1+ pour en savoir plus.

Définissez les paramètres de configuration protocol et wallet.

init_config:
instances:
  - server: '<HOST_1>:<PORT>'
    service_name: "<SERVICE_NAME>" # The Oracle CDB service name
    username: 'datadog'
    password: 'ENC[datadog_user_database_password]'
    protocol: TCPS
    wallet: <YOUR_WALLET_DIRECTORY>
    dbm: true
    tags:  # Optional
      - 'service:<CUSTOM_SERVICE>'
      - 'env:<CUSTOM_ENV>'
  - server: '<HOST_2>:<PORT>'
    service_name: "<SERVICE_NAME>" # The Oracle CDB service name
    username: 'datadog'
    password: 'ENC[datadog_user_database_password]'
    protocol: TCPS
    wallet: <YOUR_WALLET_DIRECTORY>
    dbm: true
    tags:  # Optional
      - 'service:<CUSTOM_SERVICE>'
      - 'env:<CUSTOM_ENV>'

Une fois toute la configuration de l’Agent terminée, redémarrez l’Agent Datadog.

Valider la configuration

Exécutez la sous-commande status de l’Agent et recherchez oracle dans la section Checks. Accédez au dashboard DBM Oracle Database Overview et à la page Databases dans Datadog pour commencer.

Requêtes personnalisées

Database Monitoring prend en charge les requêtes custom pour les bases de données Oracle. Consultez le fichier conf.yaml.example pour en savoir plus sur les options de configuration disponibles.

L'exécution de requêtes custom peut entraîner des coûts ou des frais supplémentaires facturés par Oracle.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Intégration Oracle de baseDOCUMENTATION more more