Surveiller SAP HANA à l'aide de l'agent Google Cloud pour SAP

Ce guide de planification se concentre uniquement sur la fonctionnalité de collecte des métriques de surveillance SAP HANA de l'agent Google Cloud pour SAP. Pour en savoir plus sur l'agent et toutes ses fonctionnalités, consultez le Guide de planification de l'agent Google Cloud pour SAP.

Sous Linux, l'agent Google Cloud pour SAP peut vous aider à surveiller vos instances SAP HANA et l'infrastructure sous-jacente. Cette opération est effectuée via la collecte de métriques de surveillance SAP HANA, que vous pouvez activer après avoir installé l'agent sur vos instances de VM Compute Engine ou vos serveurs de solution Bare Metal.

Lorsque vous activez la collecte des métriques de surveillance SAP HANA, l'agent interroge vos instances SAP HANA et envoie les métriques collectées à Cloud Monitoring. Vous pouvez visualiser les métriques collectées à l'aide des tableaux de bord dans Monitoring. Vous pouvez également configurer des alertes dans Monitoring en fonction de seuils de métriques. Pour en savoir plus sur la création de tableaux de bord et d'alertes, consultez la documentation sur Cloud Monitoring.

Pour en savoir plus sur la configuration de l'agent Google Cloud pour SAP afin de collecter les métriques de surveillance SAP HANA, consultez la page Configurer la collecte de métriques de surveillance SAP HANA.

Les métriques de surveillance SAP HANA que l'agent Google Cloud pour SAP collecte et envoie à Monitoring sont classées par Monitoring comme des métriques facturables dont les tarifs dépendent du volume ingéré.

L'intervalle d'échantillonnage de vos requêtes, qui définit la fréquence à laquelle l'agent interroge vos instances SAP HANA pour obtenir des métriques, affecte le volume de métriques envoyées à Monitoring. Les métriques de surveillance SAP HANA sont des métriques à changement lent qui, une fois activées, sont collectées par défaut toutes les cinq minutes.

Pour en savoir plus sur les tarifs de Monitoring, consultez la page Tarifs de Google Cloud Observability.

Pour plus d'informations sur les intervalles d'échantillonnage des requêtes, consultez la page Intervalle d'échantillonnage des requêtes.

Exemple d'estimation des coûts

Pour afficher un exemple d'estimation des coûts pour la collecte des métriques de surveillance SAP HANA à l'aide de l'agent Google Cloud pour SAP, consultez la section Exemple de tarification des métriques facturées par octets ingérés.

À propos des requêtes

Pour collecter les métriques de surveillance SAP HANA, l'agent Google Cloud pour SAP exécute des requêtes SQL sur les instances SAP HANA. La syntaxe de ces requêtes est définie par SAP dans la documentation SAP HANA SQL and System Views Reference.

L'agent Google Cloud pour SAP accepte les types de requêtes suivants :

Requêtes par défaut

Les requêtes par défaut sont des requêtes intégrées qui collectent les métriques SAP HANA les plus couramment utilisées.

La fréquence des requêtes par défaut est déterminée par le paramètre global sample_interval_sec défini au début de la section hana_monitoring_configuration du fichier de configuration de l'agent. Par défaut, cette valeur est définie sur 300 secondes (5 minutes). Vous pouvez modifier cette valeur globale par défaut. Contrairement aux requêtes personnalisées, les requêtes par défaut individuelles ne permettent pas de définir un intervalle d'échantillonnage.

Bien que vous ne puissiez pas modifier les requêtes par défaut, vous pouvez désactiver les requêtes par défaut dont vous n'avez pas besoin. Pour obtenir des instructions sur la désactivation d'une requête par défaut, consultez la page Désactiver une requête SQL.

Pour en savoir plus sur les requêtes par défaut, sur les métriques qu'elles collectent et sur les instructions SQL sous-jacentes qu'elles utilisent, consultez la documentation de référence des requêtes par défaut.

Requêtes personnalisées

Pour vous aider à obtenir des insights plus détaillés sur vos instances SAP HANA, l'agent Google Cloud pour SAP vous permet de définir et d'exécuter des requêtes personnalisées.

Vous définissez des requêtes personnalisées dans la section queries, qui est spécifiée sous la section hana_monitoring_configuration du fichier de configuration de l'agent.

Pour chaque requête personnalisée, vous pouvez spécifier un paramètre sample_interval_sec qui remplace le paramètre sample_interval_sec par défaut. Pour plus d'informations, consultez la section Intervalle d'échantillonnage des requêtes.

Les exemples de requêtes personnalisées présentés dans ce document peuvent vous aider à rédiger vos propres requêtes. Pour en savoir plus sur la création de requêtes personnalisées, consultez la section Définir des requêtes personnalisées.

Intervalle d'échantillonnage pour les requêtes

Pour la collecte de métriques de surveillance SAP HANA à l'aide de l'agent Google Cloud pour SAP, vous pouvez définir une valeur sample interval_sec globale pour toutes les requêtes et un intervalle d'échantillonnage individuel pour chaque requête personnalisée. Un intervalle d'échantillonnage détermine la fréquence à laquelle l'agent interroge les instances SAP HANA pour obtenir des métriques.

L'intervalle d'échantillonnage par défaut pour toutes les requêtes est de 300 secondes (5 minutes). Vous pouvez ajuster l'intervalle d'échantillonnage par défaut en spécifiant une valeur différente au niveau du paramètre sample_interval_sec au début de la section hana_monitoring_configuration du fichier de configuration de l'agent.

Vous pouvez remplacer l'intervalle d'échantillonnage par défaut pour une requête personnalisée individuelle en utilisant le paramètre sample_interval_sec dans la définition de la requête personnalisée.

Architecture d'installation

Vous pouvez installer l'agent Google Cloud pour SAP sur une instance Compute Engine ou sur un serveur de solution Bare Metal.

Vous pouvez installer l'agent Google Cloud pour SAP sur le même hôte que l'instance SAP HANA ou sur un hôte différent.

L'agent peut également surveiller les instances SAP HANA qui s'exécutent sur des hôtes sur site ou sur une autre plate-forme cloud, à condition que ces derniers aient accès aux API Google Cloud avec un compte de service configuré de manière appropriée.

Collecte à distance à partir d'une instance Compute Engine centrale

Le schéma suivant illustre l'architecture d'installation, dans laquelle l'agent est installé sur une instance Compute Engine différente de celle des instances Compute Engine ou des serveurs de solution Bare Metal exécutant les instances SAP HANA.

Surveillance SAP HANA : collecte à distance de métriques

Collecte locale sur l'instance Compute Engine et le serveur de solution Bare Metal

Si les règles de pare-feu limitent l'accès à votre environnement, vous pouvez installer l'agent avec l'instance SAP HANA sur la même instance Compute Engine ou sur le même serveur de solution Bare Metal.

Le schéma suivant illustre l'architecture d'installation dans laquelle l'agent est installé individuellement sur une instance Compute Engine et sur un serveur de solution Bare Metal.

Surveillance SAP HANA : collecte locale de métriques

Architecture hybride de collecte

Vous pouvez installer l'agent sur l'instance Compute Engine qui héberge votre instance SAP HANA et configurer l'agent pour surveiller également une instance SAP HANA qui s'exécute sur un serveur de solution Bare Metal.

Surveillance SAP HANA : collecte hybride de métriques

Si vous surveillez des instances SAP HANA dans plusieurs projets Google Cloud, vous devez installer au moins une instance de l'agent Google Cloud pour SAP dans chaque projet Google Cloud contenant une instance SAP HANA que vous surveillez.

Configuration de la haute disponibilité pour l'agent

Si vous surveillez des instances SAP HANA dans un cluster à haute disponibilité, vous devez installer l'agent Google Cloud pour SAP sur un hôte dont le nœud ne réside pas sur le cluster, afin que l'agent ne soit pas affecté par des événements de basculement.

Dans le fichier de configuration de l'agent, nous vous recommandons de configurer la surveillance sur l'adresse IP flottante. Avec cette configuration, l'agent ne collecte des métriques qu'à partir du nœud actuellement actif.

Surveillance SAP HANA : collecte de métriques dans un cluster à haute disponibilité

Compatibilité SSL/TLS

Si une instance SAP HANA utilise le protocole TLS (Transport Layer Secure) ou SSL (Secure Sockets Layer) pour sécuriser la communication entre la base de données SAP HANA et les clients qui utilisent l'interface SQL de SAP HANA, vous devez activer la compatibilité TLS/SSL dans l'agent Google Cloud pour SAP. Pour ce faire, vous devez spécifier les paramètres suivants pour toutes ces instances SAP HANA dans le fichier de configuration de l'agent Google Cloud pour SAP :

  • Spécifiez le paramètre enable_ssl et définissez sa valeur sur true.
  • Spécifiez le paramètre host_name_in_certificate et définissez le nom d'hôte, comme spécifié dans le certificat TLS/SSL, en tant que valeur.
  • Spécifiez la propriété tls_root_ca_file et définissez le chemin d'accès au certificat TLS/SSL en tant que valeur.

Si SAP HANA est également configuré pour valider les certificats, vous pouvez configurer l'agent pour qu'il accepte la validation des certificats et pour spécifier des chemins d'accès et des mots de passe associés à un keystore ainsi qu'à un trustore.

Pour obtenir une description des paramètres de configuration de l'agent liés à SSL, consultez la section Paramètres de configuration.

Définir des requêtes personnalisées

L'agent Google Cloud pour SAP vous permet de définir et d'exécuter des requêtes personnalisées.

Une requête personnalisée inclut les informations suivantes :

  • Paramètres décrivant la requête et leurs valeurs.
  • Une instruction SQL permettant d'extraire des données de vos instances SAP HANA.
  • Une ou plusieurs métriques renvoyées par l'instruction SQL.

Pour plus d'informations sur les paramètres de requête, consultez la section Paramètres de configuration.

Pour obtenir la liste complète des vues système mises à disposition par SAP HANA à des fins d'interrogation, consultez la page SAP HANA SQL and System Views Reference.

Lorsque vous créez une requête personnalisée, gardez à l'esprit que Monitoring fonctionne mieux avec des données récapitulatives ou agrégées et n'est pas conçu pour stocker des points de données à cardinalité élevée. Utilisez des fonctions d'agrégation SQL telles que SUM, AVG, COUNT, MIN ou MAX pour limiter le nombre d'enregistrements renvoyés.

Étant donné que l'agent Google Cloud pour SAP traite les colonnes d'une requête comme une liste ordonnée, vous devez veiller à respecter les consignes suivantes lors de la définition d'une requête personnalisée :

  • L'instruction SQL doit utiliser toutes les colonnes que vous avez incluses dans la définition de la requête.
  • L'ordre des colonnes dans l'instruction SQL doit correspondre à celui de la définition de requête.
  • Vous avez activé la requête personnalisée en spécifiant enabled: true dans un bloc de requête, comme indiqué dans l'exemple de requête personnalisée.

Vous pouvez par exemple voir la définition de requête de l'exemple de requête personnalisée nommé custom_memory_utilization. Sa définition de requête inclut les colonnes mem_used et resident_mem_used, dans cet ordre. Cet ordre de colonnes correspond à l'ordre des colonnes dans l'instruction SQL spécifiée pour le paramètre sql.

Pour afficher plus d'exemples de requêtes personnalisées, consultez la section Exemples de requêtes personnalisées.

Exemples de requêtes personnalisées

L'exemple suivant présente deux requêtes personnalisées. Les exemples de requêtes sont destinés à être utilisés comme modèles pour créer vos propres requêtes personnalisées.

{
  "name": "custom_memory_utilization",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(TOTAL_MEMORY_USED_SIZE), 0) AS mem_used, IFNULL(SUM(PHYSICAL_MEMORY_SIZE), 0) AS resident_mem_used FROM M_SERVICE_MEMORY;",
  "columns": [
    {
      "name": "mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    },
    {
      "name": "resident_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}
{
  "name": "custom_total_memory_usage",
  "enabled": true,
  "sql": "SELECT IFNULL(SUM(MEMORY_SIZE_IN_TOTAL), 0) AS table_mem_used FROM M_CS_TABLES;",
  "columns": [
    {
      "name": "table_mem_used",
      "metric_type": "METRIC_GAUGE",
      "value_type": "VALUE_INT64"
    }
  ]
}

Traitement des erreurs pour les requêtes personnalisées

L'agent Google Cloud pour SAP ne valide pas le SQL dans vos requêtes personnalisées avant de les envoyer à vos instances SAP HANA.

Si une requête personnalisée échoue avec une exception SQL ou si les colonnes configurées dans une requête ne correspondent pas aux résultats renvoyés par SAP HANA, l'agent écrit une erreur dans le journal. Dans les deux cas, l'agent continue à exécuter la requête personnalisée et à écrire les messages d'erreur dans le journal jusqu'à ce qu'il y ait deux échecs consécutifs, après quoi l'agent cesse d'exécuter cette requête. Pour reprendre l'exécution d'une telle requête personnalisée, vous devez redémarrer l'agent.

Pour plus d'informations sur la syntaxe SQL requise pour les requêtes personnalisées, consultez le document SAP HANA SQL and System Views Reference.

Métriques de surveillance SAP HANA

Le tableau suivant décrit les métriques de surveillance SAP HANA intégrées ou par défaut que l'agent Google Cloud pour SAP peut collecter. Les chaînes de métriques de ce tableau doivent être précédées du préfixe workload.googleapis.com/. Ce préfixe a été omis dans les entrées du tableau suivant.

Métrique Type de métrique Description
sap/hanamonitoring/column/memory/total_size METRIC_GAUGE

Spécifie la somme des colonnes MEMORY_SIZE_IN_MAIN et MEMORY_SIZE_IN_DELTA de SAP HANA.

Cette métrique est collectée par la requête par défaut column_queries, qui utilise la vue système M_CS_ALL_COLUMNS de SAP HANA.

sap/hanamonitoring/component/memory/total_used_size METRIC_GAUGE

Spécifie l'utilisation de mémoire spécifique au service pour chaque composant logique de SAP HANA.

Cette métrique est collectée par la requête par défaut component_queries, qui utilise la vue système M_SERVICE_COMPONENT_MEMORY de SAP HANA.

sap/hanamonitoring/system/connection/total METRIC_GAUGE

Spécifie le nombre de connexions inactives et en cours d'exécution du système.

Cette métrique est collectée par la requête par défaut connection_query, qui utilise la vue système M_CONNECTIONS de SAP HANA.

sap/hanamonitoring/host/cpu/usage_time METRIC_CUMULATIVE

Spécifie le temps CPU passé en millisecondes.

Cette métrique est collectée par la requête par défaut cpu_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/system/alert/total METRIC_GAUGE

Spécifie le nombre d'alertes actuelles provenant des statistiques système : "1", "2", "3", "4" ou "5".

Cette métrique est collectée par la requête par défaut alert_query, qui utilise la vue système STATISTICS_CURRENT_ALERTS de SAP HANA du schéma _SYS_STATISTICS.

sap/hanamonitoring/host/memory/total_size METRIC_GAUGE

Spécifie la mémoire physique sur l'hôte.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/memory/total_used_size METRIC_GAUGE

Spécifie la mémoire physique utilisée sur l'hôte.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/swap_space/total_size METRIC_GAUGE

Spécifie la mémoire d'échange totale sur l'hôte.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/swap_space/total_used_size METRIC_GAUGE

Spécifie la mémoire d'échange utilisée sur l'hôte.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/instance_memory/total_used_size METRIC_GAUGE

Spécifie la quantité de mémoire du pool de mémoire actuellement en cours d'utilisation par les processus SAP HANA.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/instance_memory/total_peak_used_size METRIC_GAUGE

Spécifie la mémoire maximale du pool de mémoire utilisé par les processus SAP HANA depuis le démarrage de l'instance (valeur basée sur un échantillonnage).

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/instance_memory/total_allocated_size METRIC_GAUGE

Spécifie la taille du pool de mémoire pour tous les processus SAP HANA.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/instance_code/total_size METRIC_GAUGE

Spécifie la taille du code, y compris les bibliothèques partagées des processus SAP HANA.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/host/instance_shared_memory/total_allocated_size METRIC_GAUGE

Spécifie la taille de la mémoire partagée des processus SAP HANA.

Cette métrique est collectée par la requête par défaut host_queries, qui utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

sap/hanamonitoring/system/replication_data_latency/total_time METRIC_GAUGE

Spécifie la latence de réplication des données du système à haute disponibilité SAP HANA. Cette métrique n'est pas récupérée si votre déploiement SAP HANA n'exécute qu'un seul nœud.

Cette métrique est collectée par la requête par défaut replication_query, qui utilise la vue système M_SERVICE_REPLICATION de SAP HANA.

sap/hanamonitoring/rowstore/memory/total_size METRIC_GAUGE

Spécifie la taille de la mémoire du rowstore, composée des parties fixes et variables.

Cette métrique est collectée par la requête par défaut rowstore_query, qui utilise la vue système M_RS_TABLES de SAP HANA.

sap/hanamonitoring/schema/memory/total_size METRIC_GAUGE

Spécifie la taille totale de la mémoire en tant que taille cumulée des mémoires principale, delta et historique.

Cette métrique est collectée par la requête par défaut schema_type_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/record/total METRIC_GAUGE

Indique le nombre d'enregistrements.

Cette métrique est collectée par la requête par défaut schema_type_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/memory/estimated_max_total_size METRIC_GAUGE

Spécifie la consommation de mémoire maximale estimée une fois la table entièrement chargée. Les données relatives aux transactions ouvertes ne sont pas incluses.

Cette métrique est collectée par la requête par défaut schema_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/record/last_compressed_total METRIC_GAUGE

Spécifie le nombre d'entrées dans la partie principale lors de la dernière compression optimisée.

Cette métrique est collectée par la requête par défaut schema_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/read/total_count METRIC_CUMULATIVE

Spécifie le nombre d'accès en lecture à la table ou à la partition. Il ne s'agit pas du nombre d'instructions SELECT sur cette table. Une instruction SELECT peut impliquer plusieurs accès en lecture.

Cette métrique est collectée par la requête par défaut schema_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/write/total_count METRIC_CUMULATIVE

Spécifie le nombre d'accès en écriture à la table ou à la partition. Il ne s'agit pas du nombre d'instructions LMD et LDD sur cette table. Une instruction LMD ou LDD peut impliquer plusieurs accès en écriture.

Cette métrique est collectée par la requête par défaut schema_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/schema/merge/total_count METRIC_CUMULATIVE

Spécifie le nombre de fusions delta effectuées sur la table ou la partition.

Cette métrique est collectée par la requête par défaut schema_queries, qui utilise la vue système M_CS_TABLES de SAP HANA.

sap/hanamonitoring/service/memory/total_used_size METRIC_GAUGE

Spécifie la quantité de mémoire utilisée par le pool de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/logical_memory/total_size METRIC_GAUGE

Spécifie la taille de la mémoire virtuelle du point de vue du système d'exploitation.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/physical_memory/total_size METRIC_GAUGE

Spécifie la taille de la mémoire physique résidente du point de vue du système d'exploitation.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/code/total_size METRIC_GAUGE

Spécifie la taille du code, y compris les bibliothèques partagées.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/stack/total_size METRIC_GAUGE

Spécifie la taille de la pile.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/heap_memory/total_allocated_size METRIC_GAUGE

Spécifie proportion du pool de mémoire représentée par le tas de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/heap_memory/total_used_size METRIC_GAUGE

Spécifie la quantité utilisée du pool de tas de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/shared_memory/total_allocated_size METRIC_GAUGE

Spécifie la proportion de mémoire partagée du pool de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/shared_memory/total_used_size METRIC_GAUGE

Spécifie la quantité de mémoire partagée du pool en cours d'utilisation.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/compactor/total_allocated_size METRIC_GAUGE

Spécifie la partie du pool de mémoire qui peut éventuellement (si elle n'est pas réservée) être libérée en cas de manque de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/compactors/total_freeable_size METRIC_GAUGE

Spécifie la mémoire pouvant être libérée en cas de manque de mémoire.

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/memory/allocation_limit METRIC_GAUGE

Spécifie la taille maximale du pool de mémoire (valeur configurable).

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/service/memory/effective_allocation_limit METRIC_GAUGE

Spécifie la taille maximale effective du pool de mémoire, en tenant compte de la taille de pool des autres processus (valeur calculée).

Cette métrique est collectée par la requête par défaut service_queries, qui utilise la vue système M_SERVICE_MEMORY de SAP HANA.

sap/hanamonitoring/system/transaction/total_count METRIC_CUMULATIVE

Spécifie le nombre de transactions de mise à jour, de commit et de rollback.

Cette métrique est collectée par la requête par défaut transaction_query, qui utilise la vue système M_WORKLOAD de SAP HANA.

sap/hanamonitoring/transactions/blocked METRIC_GAUGE

Indique le nombre de transactions bloquées dans la base de données, regroupées par nom de base de données, hôte, type de verrouillage et nom de service.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut blocked_transaction_query, qui utilise les vues système SAP HANA M_DATABASES, M_SERVICES et M_BLOCKED_TRANSACTIONS.

sap/hanamonitoring/backups/data METRIC_GAUGE

Code de réponse numérique indiquant l'état de la dernière sauvegarde de données complète.

  • 0: la sauvegarde des données a échoué.
  • 1: la sauvegarde des données a bien été effectuée.

Cette métrique comprend les libellés suivants:

  • backup_id, qui spécifie l'ID de la dernière sauvegarde complète des données.
  • entry_type_name, qui spécifie le type de dernière sauvegarde de données complète. Par exemple : entry_type_name: complete data backup.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut data_backup_state_query, qui utilise la vue système M_BACKUP_CATALOG de SAP HANA.

sap/hanamonitoring/backups/snapshot METRIC_GAUGE

Code de réponse numérique indiquant l'état de la dernière sauvegarde de données complète basée sur un instantané de disque.

  • 0: la sauvegarde des données a échoué.
  • 1: la sauvegarde des données a bien été effectuée.

Cette métrique est compatible avec la version 3.6 de l'agent.

Cette métrique comprend les libellés suivants:

  • backup_id, qui spécifie l'ID de la dernière sauvegarde de données basée sur un instantané de disque complet.
  • entry_type_name, qui spécifie le type de dernière sauvegarde de données basée sur un instantané de disque complet. Par exemple : entry_type_name: complete data snapshot.
sap/hanamonitoring/backups/log METRIC_GAUGE

Indique l'état des 20 dernières sauvegardes de journaux.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut log_backup_state_query, qui utilise la vue système M_BACKUP_CATALOG de SAP HANA.

sap/hanamonitoring/memory/unloads METRIC_GAUGE

Indique le nombre total de vidages de table dus à une faible quantité de mémoire.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut memory_unloads_query, qui utilise la vue système M_CS_UNLOADS de SAP HANA.

sap/hanamonitoring/disk/writetime METRIC_GAUGE

Spécifie le temps d'écriture moyen pour les volumes de données et de journaux SAP HANA.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut avg_write_time_queries, qui utilise les vues système SAP HANA M_VOLUMES et M_VOLUME_IO_DETAILED_STATISTICS.

sap/hanamonitoring/disk/readtime METRIC_GAUGE

Spécifie le temps de lecture moyen pour les volumes de données SAP HANA.

Cette métrique est compatible avec la version 3.5 de l'agent.

Cette métrique est collectée par la requête par défaut avg_read_time_queries, qui utilise les vues système SAP HANA M_VOLUMES et M_VOLUME_IO_DETAILED_STATISTICS.

Afficher les métriques dans Monitoring

Google Cloud fournit des tableaux de bord personnalisés qui vous aident à visualiser les métriques de surveillance SAP HANA collectées par l'agent Google Cloud pour SAP. Consultez le répertoire dashboards/google-cloud-agent-for-sap dans le dépôt GoogleCloudPlatform/monitoring-dashboard-samples sur GitHub.

Pour en savoir plus sur ces tableaux de bord et obtenir des instructions d'installation, consultez la section Afficher les métriques collectées.

Pour en savoir plus sur la recherche de données de métriques dans Monitoring et sur la configuration des notifications d'alerte, consultez la page Métriques dans Monitoring.

Documentation de référence sur les requêtes par défaut

Les requêtes par défaut intégrées de l'agent Google Cloud pour SAP renvoient les informations suivantes à partir de SAP HANA.

Si vous n'avez pas besoin des métriques fournies par une requête intégrée ou par défaut particulière, vous pouvez les désactiver. Pour obtenir des instructions, consultez le guide approprié :

column_queries

La requête intégrée column_queries renvoie des informations sur l'utilisation de la mémoire par des colonnes de la vue système M_CS_ALL_COLUMNS de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Taille de mémoire de la colonne column/memory/total_size Spécifie la somme des colonnes MEMORY_SIZE_IN_MAIN et MEMORY_SIZE_IN_DELTA.

component_queries

La requête intégrée component_queries renvoie l'utilisation de mémoire spécifique au service pour chaque composant logique de SAP HANA. La requête utilise la vue système M_SERVICE_COMPONENT_MEMORY de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Mémoire des composants utilisée component/memory/total_used_size Spécifie la quantité de mémoire actuellement utilisée pour le composant logique.

connection_query

La requête intégrée connection_query renvoie le nombre de connexions en cours d'exécution et inactives de SAP HANA à l'aide de la vue système M_CONNECTIONS de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Connexions système system/connection/total Spécifie le nombre de connexions inactives et en cours d'exécution du système.

cpu_queries

La requête intégrée cpu_queries renvoie les informations d'utilisation du processeur de SAP HANA à l'aide de la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Durée d'utilisation du processeur host/cpu/usage_time Spécifie le temps CPU utilisé.

alert_query

La requête intégrée alert_query renvoie le nombre et le score des alertes actuelles du serveur de statistiques SAP HANA à l'aide de la vue SAP HANA STATISTICS_CURRENT_ALERTS du schéma _SYS_STATISTICS.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Nombre d'alertes system/alert/total Spécifie le nombre d'alertes actuelles provenant des statistiques système : "1", "2", "3", "4" ou "5".

host_queries

La requête intégrée host_queries renvoie l'utilisation de mémoire par l'hôte depuis SAP HANA. La requête utilise la vue système M_HOST_RESOURCE_UTILIZATION de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Taille de la mémoire hôte host/memory/total_size Spécifie la mémoire physique totale sur l'hôte.
Mémoire hôte utilisée host/memory/total_used_size Spécifie la mémoire physique utilisée sur l'hôte.
Taille de l'espace d'échange host/swap_space/total_size Spécifie la mémoire d'échange totale sur l'hôte.
Espace d'échange utilisé host/swap_space/total_used_size Spécifie la mémoire d'échange utilisée sur l'hôte.
Mémoire d'instance utilisée host/instance_memory/total_used_size Spécifie la quantité de mémoire du pool de mémoire actuellement en cours d'utilisation par les processus SAP HANA.
Pic d'utilisation de mémoire host/instance_memory/total_peak_used_size Spécifie la mémoire maximale du pool de mémoire utilisé par les processus SAP HANA depuis le démarrage de l'instance (valeur basée sur un échantillonnage).
Mémoire d'instance allouée host/instance_memory/total_allocated_size Spécifie la taille du pool de mémoire pour tous les processus SAP HANA.
Taille du code de l'instance host/instance_code/total_size Spécifie la taille du code, y compris les bibliothèques partagées des processus SAP HANA.
Mémoire partagée d'instance allouée host/instance_shared_memory/total_allocated_size Spécifie la taille de la mémoire partagée des processus SAP HANA.

replication_query

La requête intégrée replication_query renvoie les informations de latence de réplication de SAP HANA exécutant un cluster à haute disponibilité. Cette requête utilise la vue système M_SERVICE_REPLICATION de SAP HANA. Si votre déploiement SAP HANA n'exécute qu'un seul nœud, cette requête ne renvoie aucune métrique.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Latence des données de réplication system/replication_data_latency/total_time Spécifie la latence de réplication des données du système.

rowstore_query

La requête intégrée rowstore_query renvoie la taille du rowstore de SAP HANA à l'aide de la vue système M_RS_TABLES de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Taille de mémoire du rowstore rowstore/memory/total_size Spécifie la taille de la mémoire du rowstore, composée des parties fixes et variables.

schema_type_queries

La requête intégrée schema_type_queries renvoie les informations sur l'utilisation de la mémoire ainsi que le nombre d'enregistrements de SAP HANA à l'aide de la vue système M_CS_TABLES de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Taille de mémoire du schéma schema/memory/total_size Spécifie la taille totale de la mémoire en tant que taille cumulée des mémoires principale, delta et historique.
Nombre d'enregistrements de schémas schema/record/total Indique le nombre d'enregistrements.

schema_queries

La requête intégrée schema_queries renvoie les informations d'utilisation du schéma de SAP HANA à l'aide de la vue système M_CS_TABLES de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Taille de mémoire maximale estimée du schéma schema/memory/estimated_max_total_size Spécifie la consommation de mémoire maximale estimée une fois la table entièrement chargée (les données relatives aux transactions ouvertes ne sont pas incluses).
Nombre de derniers enregistrements compressés du schéma schema/record/last_compressed_total Spécifie le nombre d'entrées dans la partie principale lors de la dernière compression optimisée.
Nombre de lectures du schéma schema/read/total_count Spécifie le nombre d'accès en lecture à la table ou à la partition. Il ne s'agit pas du nombre d'instructions SELECT sur cette table. Une instruction SELECT peut nécessiter plusieurs accès en lecture.
Nombre d'écritures du schéma schema/write/total_count Spécifie le nombre d'accès en écriture à la table ou à la partition. Il ne s'agit pas du nombre d'instructions LMD et LDD sur cette table. Une instruction LMD ou LDD peut impliquer plusieurs accès en écriture.
Nombre de fusions du schéma schema/merge/total_count Spécifie le nombre de fusions delta effectuées sur la table ou la partition.

service_queries

La requête intégrée service_queries renvoie les informations de SAP HANA concernant la mémoire utilisée par les services. La requête utilise la vue système M_SERVICE_MEMORY de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Mémoire du service utilisée service/memory/total_used_size Spécifie la quantité de mémoire utilisée par le pool de mémoire.
Taille de mémoire logique de service service/logical_memory/total_size Spécifie la taille de la mémoire virtuelle du point de vue du système d'exploitation.
Taille de mémoire physique du service service/physical_memory/total_size Spécifie la taille de la mémoire physique résidente du point de vue du système d'exploitation.
Taille du code de service service/code/total_size Spécifie la taille du code, y compris les bibliothèques partagées.
Taille de la pile de services service/stack/total_size Spécifie la taille de la pile.
Proportion du tas de mémoire de service allouée service/heap_memory/total_allocated_size Spécifie proportion du pool de mémoire représentée par le tas de mémoire.
Proportion du tas de mémoire de service utilisé service/heap_memory/total_used_size Spécifie la quantité utilisée du pool de tas de mémoire.
Mémoire partagée de service allouée service/shared_memory/total_allocated_size Spécifie la proportion de mémoire partagée du pool de mémoire.
Mémoire partagée de service utilisée service/shared_memory/total_used_size Spécifie la quantité de mémoire partagée du pool en cours d'utilisation.
Taille allouée aux compacteurs de service service/compactor/total_allocated_size Spécifie la partie du pool de mémoire qui peut éventuellement (si elle n'est pas réservée) être libérée en cas de manque de mémoire.
Taille libérable par les compacteurs de service service/compactors/total_freeable_size Spécifie la mémoire pouvant être libérée en cas de manque de mémoire.
Limite d'allocation de mémoire du service service/memory/allocation_limit Spécifie la taille maximale du pool de mémoire (valeur configurable).
Limite d'allocation effective de mémoire du service service/memory/effective_allocation_limit Spécifie la taille maximale effective du pool de mémoire, en tenant compte de la taille de pool des autres processus (valeur calculée).

transaction_query

La requête intégrée transaction_query renvoie le nombre total de transactions (mise à jour, commit et rollback) de SAP HANA à l'aide de la vue système M_WORKLOAD de SAP HANA.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Transactions système system/transaction/total_count Spécifie le nombre de transactions de mise à jour, de commit et de rollback.

blocked_transaction_query

La requête intégrée blocked_transaction_query renvoie le nombre total de transactions bloquées de SAP HANA à l'aide des vues système M_DATABASES, M_SERVICES et M_BLOCKED_TRANSACTIONS de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Transactions bloquées transactions/blocked Spécifie le nombre de transactions bloquées.

data_backup_state_query

La requête intégrée data_backup_state_query renvoie l'état récent de la dernière sauvegarde de données complète de SAP HANA à l'aide de la vue système M_BACKUP_CATALOG de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
État de la sauvegarde des données backups/data Indique l'état récent de la dernière sauvegarde de données complète.

log_backup_state_query

La requête intégrée log_backup_state_query renvoie le nombre total de transactions bloquées de SAP HANA à l'aide de la vue système M_BACKUP_CATALOG de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
État de la sauvegarde des journaux backups/log Indique l'état des 20 dernières sauvegardes de journaux.

memory_unloads_query

La requête intégrée memory_unloads_query renvoie le nombre total de déchargements de tables qui se produisent dans SAP HANA en raison d'une faible mémoire. Elle utilise la vue système M_CS_UNLOADS de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Vidages de mémoire memory/unloads Indique le nombre total de déchargements de tables qui se produisent en raison d'une faible mémoire.

avg_write_time_queries

La requête intégrée avg_write_time_queries renvoie le temps d'écriture moyen pour les volumes de données et de journaux de SAP HANA à l'aide des vues système M_VOLUMES et M_VOLUME_IO_DETAILED_STATISTICS de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Durée d'écriture moyenne disk/writetime Indique le temps d'écriture moyen pour les volumes de données et de journaux.

avg_read_time_queries

La requête intégrée avg_read_time_queries renvoie le temps de lecture moyen pour les volumes de données de SAP HANA à l'aide des vues système M_VOLUMES et M_VOLUME_IO_DETAILED_STATISTICS de SAP HANA.

Cette requête est compatible avec la version 3.5 de l'agent.

La requête envoie les métriques suivantes à Monitoring :

Nom de la métrique Métrique Description
Durée de lecture moyenne disk/readtime Indique le temps de lecture moyen pour les volumes de données.

data_snapshot_state_queries

La requête intégrée data_snapshot_state_queries renvoie l'état de la dernière sauvegarde de données complète basée sur un instantané de disque de SAP HANA à l'aide de la vue système M_BACKUP_CATALOG de SAP HANA.

Cette requête est compatible avec la version 3.6 de l'agent.

Cette requête envoie les métriques suivantes à Monitoring:

Nom de la métrique Métrique Description
État de la sauvegarde de l'instantané de données backups/snapshot Indique l'état de la dernière sauvegarde de données basée sur un instantané de disque complet.