Présentation

Ce check permet de surveiller SAP HANA 2.0 SPS 2 avec l’Agent Datadog.

Implémentation

Installation

Le check SAP HANA est inclus avec le package de l’Agent Datadog. Pour utiliser cette intégration, vous devez installer manuellement la bibliothèque hdbcli.

Pour Unix :

sudo -Hu dd-agent /opt/datadog-agent/embedded/bin/pip install hdbcli==2.10.15

Pour Windows :

"C:\Program Files\Datadog\Datadog Agent\embedded<VERSION_MAJEURE_PYTHON>\python.exe" -m pip install hdbcli==2.10.15

Préparer HANA

Pour interroger certaines vues, vous devez accorder des autorisations spécifiques à l’utilisateur de surveillance HANA de votre choix. Pour en savoir plus, consultez la section Accorder des autorisations.

Pour découvrir comment configurer le numéro de port pour les bases de données locataire, multi-locataires et système HANA, consultez la section de la documentation SAP relative aux connexions (en anglais).

Création des utilisateurs

1. Pour créer un utilisateur, connectez-vous à la base de données système et exécutez la commande suivante :

   CREATE RESTRICTED USER <USER> PASSWORD <PASSWORD>;
   

2. Exécutez la commande suivante pour autoriser l’utilisateur à se connecter au système :

   ALTER USER <USER> ENABLE CLIENT CONNECT;
   

3. (facultatif) Pour éviter toute interruption de service, vous pouvez définir un mot de passe à long terme :

   ALTER USER <USER> DISABLE PASSWORD LIFETIME;
   

Accorder des autorisations

1. Exécutez la commande suivante pour créer un rôle de surveillance (du nom de DD_MONITOR pour les exemples ci-dessous) :

   CREATE ROLE DD_MONITOR;
   

2. Exécutez la commande suivante pour accorder un accès en lecture seule à l’ensemble des vues système :

   GRANT CATALOG READ TO DD_MONITOR;
   

3. Exécutez les commandes suivantes afin d’accorder certaines autorisations pour chaque vue du système :

   GRANT SELECT ON SYS.M_DATABASE TO DD_MONITOR;
   GRANT SELECT ON SYS.M_DATABASES TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_BACKUP_PROGRESS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_CONNECTIONS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_DISK_USAGE TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_LICENSES TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_RS_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_COMPONENT_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_MEMORY TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_SERVICE_STATISTICS TO DD_MONITOR;
   GRANT SELECT ON SYS_DATABASES.M_VOLUME_IO_TOTAL_STATISTICS TO DD_MONITOR;
   

4. Enfin, exécutez la commande suivante pour attribuer le rôle de surveillance à l’utilisateur de votre choix :

   GRANT DD_MONITOR TO <USER>;
   

Configuration

1. Modifiez le fichier sap_hana.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance sap_hana. Consultez le fichier d’exemple sap_hana.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

2. Redémarrez l’Agent.

Validation

Lancez la sous-commande status de l’Agent et cherchez sap_hana dans la section Checks.

Données collectées

Métriques

Événements

SAP HANA n’inclut aucun événement.

Checks de service

sap_hana.can_connect
Returns CRITICAL if the Agent is unable to connect to the monitored SAP HANA system, or OK otherwise.
Statuses: ok, critical

sap_hana.status
Returns OK if the monitored SAP HANA database is up, or CRITICAL otherwise.
Statuses: ok, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.