SAP HANA

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 .