Créez un utilisateur datadog en lecture seule avec un accès approprié à votre serveur Oracle Database. Connectez-vous à votre base de données Oracle avec un utilisateur bénéficiant des droits administrateur, comme SYSDBA ou SYSOPER, et exécutez ce qui suit :

-- Activez le script Oracle.
ALTER SESSION SET "_ORACLE_SCRIPT"=true;

-- Créez l'utilisateur Datadog. Remplacez le placeholder du mot de passe par un mot de passe sécurisé.
CREATE USER datadog IDENTIFIED BY <MOTDEPASSE>;

-- Accordez les droits d'accès à l'utilisateur Datadog.
GRANT CONNECT TO datadog;
GRANT SELECT ON GV_$PROCESS TO datadog;
GRANT SELECT ON gv_$sysmetric TO datadog;
GRANT SELECT ON sys.dba_data_files TO datadog;
GRANT SELECT ON sys.dba_tablespaces TO datadog;
GRANT SELECT ON sys.dba_tablespace_usage_metrics TO datadog;

Remarque : si vous utilisez Oracle 11g, vous n’avez pas besoin d’exécuter la ligne suivante :

ALTER SESSION SET "_ORACLE_SCRIPT"=true;

Oracle 12c ou 19c

Connectez-vous à la base de données root en tant qu’administrateur pour créer un utilisateur datadog et accorder les autorisations nécessaires :

alter session set container = cdb$root;
CREATE USER c##datadog IDENTIFIED BY password CONTAINER=ALL;
GRANT CREATE SESSION TO c##datadog CONTAINER=ALL;
Grant select any dictionary to c##datadog container=all;
GRANT SELECT ON GV_$PROCESS TO c##datadog CONTAINER=ALL;
GRANT SELECT ON gv_$sysmetric TO c##datadog CONTAINER=ALL;

Host

Pour configurer ce check lorsque l’Agent est exécuté sur un host :

1. Modifiez le fichier oracle.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Mettez à jour les paramètres server et port pour définir les masters à surveiller. Consultez le fichier d’exemple oracle.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

   init_config:
   
   instances:
      ## @param server - string - required
      ## The IP address or hostname of the Oracle Database Server.
      #
      - server: localhost:1521
   
        ## @param service_name - string - required
        ## The Oracle Database service name. To view the services available on your server,
        ## run the following query: `SELECT value FROM v$parameter WHERE name='service_names'`
        #
        service_name: <SERVICE_NAME>
   
        ## @param username - string - required
        ## The username for the Datadog user account.
        #
        username: <USERNAME>
   
        ## @param password - string - required
        ## The password for the Datadog user account.
        #
        password: <PASSWORD>
   

2. Redémarrez l’Agent.

Requêtes personnalisées uniquement

Pour ignorer les checks de métrique par défaut pour une instance et exécuter uniquement des requêtes personnalisées avec un utilisateur qui recueille les métriques existantes, insérez le tag only_custom_queries avec la valeur true. Les métriques de système, de processus et de tablespace ne seront alors pas exécutées par les instances configurées de l’intégration Oracle, et les requêtes personnalisées pourront être exécutées sans que l’utilisateur ne dispose des autorisations décrites dans la rubrique Création d’un utilisateur Datadog. Si vous omettez ce paramètre de configuration, l’utilisateur que vous spécifiez devra disposer de ces autorisations sur les tables pour exécuter une requête personnalisée.

init_config:

instances:
  ## @param server - chaîne - obligatoire
  ## L'adresse IP ou le hostname du serveur Oracle Database.
  #
  - server: localhost:1521

    ## @param service_name - chaîne - obligatoire
    ## Le nom du service Oracle Database. Pour afficher les services disponibles sur votre serveur,
    ## exécutez la requête suivante :
    ## `SELECT value FROM v$parameter WHERE name='service_names'`
    #
    service_name: "<NOM_SERVICE>"

    ## @param user - chaîne - obligatoire
    ## Le nom d'utilisateur du compte utilisateur.
    #
    user: <UTILISATEUR>

    ## @param password - chaîne - obligatoire
    ## Le mot de passe du compte utilisateur.
    #
    password: "<MOTDEPASSE>"

    ## @param only_custom_queries - chaîne - facultatif
    ## Définissez ce paramètre sur n'importe quelle valeur pour exécuter uniquement des
    ## requêtes personnalisées pour cette instance.
    #
    only_custom_queries: true

Connexion à Oracle via TCPS

1. Pour vous connecter à Oracle via TCPS (TCP avec SSL), supprimez la mise en commentaire de l’option de configuration protocol et sélectionnez TCPS. Modifiez l’option server en la définissant sur le serveur TCPS à surveiller.

   init_config:
   
   instances:
     ## @param server - string - required
     ## The IP address or hostname of the Oracle Database Server.
     #
     - server: localhost:1522
   
       ## @param service_name - string - required
       ## The Oracle Database service name. To view the services available on your server,
       ## run the following query:
       ## `SELECT value FROM v$parameter WHERE name='service_names'`
       #
       service_name: "<SERVICE_NAME>"
   
       ## @param user - string - required
       ## The username for the user account.
       #
       user: <USER>
   
       ## @param password - string - required
       ## The password for the user account.
       #
       password: "<PASSWORD>"
   
       ## @param protocol - string - optional - default: TCP
       ## The protocol to connect to the Oracle Database Server. Valid protocols include TCP and TCPS.
       ##
       ## When connecting to Oracle Database via JDBC, `jdbc_truststore` and `jdbc_truststore_type` are required.
       ## More information can be found from Oracle Database's whitepaper:
       ##
       ## https://www.oracle.com/technetwork/topics/wp-oracle-jdbc-thin-ssl-130128.pdf
       #
       protocol: TCPS
   

2. Modifiez les options sqlnet.ora, listener.ora et tnsnames.ora de façon à autoriser les connexions TCPS sur votre instance Oracle Database.

Connexions TCPS via Oracle sans JDBC

Si vous n’utilisez pas la méthode JDBC, vérifiez que l’Agent Datadog parvient à se connecter à votre base de données. Utilisez l’outil de ligne de commande sqlplus en précisant les informations que vous avez indiquées dans vos options de configuration :

sqlplus <UTILISATEUR>/<MOTDEPASSE>@(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCPS)(HOST=<HOST>)(PORT=<PORT>))(SERVICE_NAME=<NOM_SERVICE>)))

Connexions TCPS via JDBC

Si vous vous connectez à Oracle Database à l’aide de JDBC, vous devez également spécifier les paramètres jdbc_truststore_path et jdbc_truststore_type, ainsi que le paramètre jdbc_truststore_password (facultatif) si le truststore possède un mot de passe.

Remarque : les truststores SSO ne nécessitent pas de mot de passe.

    # Dans la section `instances:`
    ...

    ## @param jdbc_truststore_path - chaîne, facultatif
    ## Le chemin du fichier truststore JDBC.
    #
    jdbc_truststore_path: /chemin/vers/truststore

    ## @param jdbc_truststore_type - chaîne, facultatif
    ## Le type de fichier truststore JDBC. Valeurs autorisées : JKS, SSO et PKCS12.
    #
    jdbc_truststore_type: SSO

    ## @param jdbc_truststore_password - chaîne, facultatif
    ## Le mot de passe du truststore utilisé lors de la connexion via JDBC.
    #
    # jdbc_truststore_password: <MOTDEPASSE_TRUSTSTORE_JDBC>

Pour en savoir plus sur la connexion à Oracle Database via TCPS sur JDBC, consultez le livre blanc officiel d’Oracle (en anglais).

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.