Métriques AlloyDB Omni

Sélectionnez une version de la documentation :

AlloyDB Omni fournit des métriques pour surveiller l'état et les performances de la base de données. Ces métriques sont exposées dans un format adapté au scraping par Prometheus.

Étiquettes

AlloyDB Omni expose les types d'étiquettes suivants.

Étiquettes de ressource

AlloyDB Omni expose les libellés de ressources suivants qui identifient de manière unique le conteneur de base de données auquel appartiennent les métriques. Ces libellés de ressources correspondent aux noms de la ressource Kubernetes qui possède le conteneur de base de données :

Clé de l'étiquette Valeur de l'étiquette
dbnamespace Espace de noms de la ressource personnalisée dbcluster
dbcluster Nom de la CR dbcluster
dbinstance Nom de la RS dbinstance. Seule l'instance de base de données de type ReadPool est acceptée. Si le conteneur de base de données n'appartient pas à une instance de base de données ReadPool, cette valeur est n/a.
dbnode Nom de la RS de l'instance. Chaque CR d'instance est mappé de manière univoque à un conteneur de base de données.

Étiquettes de métadonnées système

Les libellés des métadonnées système changent de manière dynamique lorsque l'roles de l'instance de base de données change. Par exemple, lorsque votre cluster de base de données passe de secondaire à principal, dbcluster_type passe de Secondary à Primary.

Clé de l'étiquette Valeur de l'étiquette
dbcluster_type Rôle de reprise après sinistre (DR) de la ressource personnalisée dbcluster. Il peut s'agir de Primary ou Secondary.
dbinstance_type Type de la ressource personnalisée dbinstance. Si le conteneur appartient à une instance de base de données ReadPool, cette valeur est ReadPool. Sinon, elle est n/a.
dbnode_type Rôle HA du dbnode, qui peut être Primary ou Standby

Étiquettes de métriques

Les étiquettes spécifiques de chaque métrique sont listées dans les tableaux suivants. Par exemple, database désigne le nom d'une base de données Postgres hébergée dans le conteneur de base de données AlloyDB Omni.

Métriques

AlloyDB Omni expose les métriques suivantes. La liste des métriques ne mentionne que les étiquettes des métriques. Toutes les métriques commencent par alloydb_omni. Pour en savoir plus sur les types de métriques, consultez Types de métriques.

Métriques au niveau du conteneur de base de données

Les métriques au niveau du conteneur de base de données sont collectées par conteneur de base de données AlloyDB Omni. Chaque métrique au niveau du conteneur de base de données comporte des étiquettes de métadonnées de ressource et de système.

Nom Description Libellé Unité Type
alloydb_omni_database_postgresql_backends Nombre de connexions actives et inactives à l'instance AlloyDB Omni. jauge
alloydb_omni_database_postgresql_chill_cache_get_entry_calls_total Nombre total d'appels pour récupérer des entrées de données à partir du cache du disque ultrarapide. compteur
alloydb_omni_database_postgresql_chill_cache_num_hits_total Nombre total de récupérations réussies d'entrées de données à partir du cache du disque ultrarapide. prewarm : les hits qui se produisent pendant la phase de préchauffe compteur
alloydb_omni_database_postgresql_max_connections Valeur actuelle du paramètre d'exécution max_connections de Postgres. jauge
alloydb_omni_database_postgresql_up Indique si le processus principal de Postgres est en cours d'exécution (1) ou non (0). jauge
alloydb_omni_database_postgresql_uptime_second Temps écoulé depuis le démarrage du processus principal Postgres. seconde jauge
alloydb_omni_database_postgresql_vacuum_oldest_transaction_age Âge actuel de la transaction non validée la plus ancienne qui bloque l'opération VACUUM. Il est mesuré en nombre de transactions démarrées après la transaction la plus ancienne. type : l'un des éléments suivants : [running, prepared, replication_slot, replica] jauge
alloydb_omni_database_postgresql_vacuum_transaction_id_utilization_percentage Ratio d'espace d'ID de transaction utilisé. 1 correspond à 100%. jauge
alloydb_omni_instance_postgresql_backends_by_state Nombre actuel de connexions. state : état des connexions (idle, active, idle_in_transaction, idle_in_transaction_aborted, disabled ou fastpath_function_call) jauge
alloydb_omni_instance_postgresql_backends_for_top_applications Nombre actuel de connexions par application. application_name : nom de l'application jauge
alloydb_omni_instance_postgresql_blks_hit_count_total Nombre total de fois où Postgres a trouvé le bloc demandé dans le cache du tampon. compteur
alloydb_omni_instance_postgresql_blks_read_count_total Nombre total de blocs lus par Postgres qui ne se trouvaient pas dans le cache du tampon Postgres. compteur
alloydb_omni_instance_postgresql_committed_transactions_count_total Nombre total de transactions validées. compteur
alloydb_omni_instance_postgresql_deadlock_count_total Nombre d'interblocages détectés. compteur
alloydb_omni_instance_postgresql_new_connections_count_total Nombre total de nouvelles connexions. compteur
alloydb_omni_instance_postgresql_rolledback_transactions_count_total Nombre total de transactions annulées. compteur
alloydb_omni_instance_postgresql_temp_bytes_written_count_total Volume total de données écrites dans des fichiers temporaires par les requêtes. octet compteur
alloydb_omni_instance_postgresql_temp_files_written_count_total Nombre total de fichiers temporaires utilisés pour écrire des données lors de l'exécution d'algorithmes internes. compteur
alloydb_omni_instance_postgresql_tuples_deleted_count_total Nombre total de lignes supprimées. compteur
alloydb_omni_instance_postgresql_tuples_fetched_count_total Nombre total de lignes récupérées. compteur
alloydb_omni_instance_postgresql_tuples_inserted_count_total Nombre total de lignes insérées. compteur
alloydb_omni_instance_postgresql_tuples_returned_count_total Nombre total de lignes renvoyées. compteur
alloydb_omni_instance_postgresql_tuples_updated_count_total Nombre total de lignes mises à jour. compteur
alloydb_omni_instance_postgresql_version Version de la base de données PostgreSQL. Au format MAJOR.MINOR, par exemple 16.3 jauge
alloydb_omni_instance_postgresql_wait_count_total Nombre total d'attentes pour un événement d'attente.
  • wait_event_name : nom de l'événement d'attente
  • wait_event_type : type de l'événement d'attente
 compteur
alloydb_omni_instance_postgresql_wait_time_us_total Temps total écoulé pour un événement d'attente.
  • wait_event_name : nom de l'événement d'attente
  • wait_event_type : type de l'événement d'attente
 fr compteur
alloydb_omni_instance_postgresql_replication_flush_lag_ms Temps écoulé entre le vidage local du WAL récent et la réception d'une notification indiquant que le serveur d'instance répliquée l'a écrit et vidé (mais pas encore appliqué).
  • application_name : application_name dans la chaîne de connexion de l'instance répliquée à l'instance principale qui correspond au nom de la ressource personnalisée de l'instance répliquée.
  • client_addr : adresse IP de l'instance répliquée.
 ms jauge
alloydb_omni_instance_postgresql_replication_replay_lag_ms Temps écoulé entre le vidage local du WAL récent et la réception d'une notification indiquant que le serveur d'instance répliquée l'a écrit, vidé et appliqué.
  • application_name : application_name dans la chaîne de connexion de l'instance répliquée à l'instance principale. Il correspond au nom de la RS de l'instance répliquée.
  • client_addr : adresse IP de l'instance répliquée.
 ms jauge
alloydb_omni_instance_postgresql_replication_state État de chaque instance répliquée connectée à l'instance principale. Sa valeur est toujours 1.
  • application_name : application_name dans la chaîne de connexion de l'instance répliquée à l'instance principale. Il correspond au nom de la RS de l'instance répliquée.
  • client_addr : adresse IP de l'instance répliquée.
  • state : l'une des valeurs suivantes : [startup, catchup, streaming, backup, stopping]
 jauge
alloydb_omni_instance_postgresql_replication_write_lag_ms Temps écoulé entre le vidage du WAL récent en local et la réception de la notification indiquant que le serveur répliqué l'a écrit (mais pas encore vidé ni appliqué).
  • application_name : application_name dans la chaîne de connexion de l'instance répliquée à l'instance principale. Il correspond au nom de la ressource personnalisée de l'instance répliquée.
  • client_addr : adresse IP de l'instance répliquée.
 ms jauge
alloydb_omni_memory_available_byte Estimation de la quantité de mémoire disponible pour l'allocation. octet jauge
alloydb_omni_memory_limit_byte Limite de mémoire du conteneur de base de données spécifiée dans la section primarySpec de la partie spec du fichier manifeste du cluster de bases de données. octet jauge
alloydb_omni_memory_postgresql_shared_buffers_active_byte Taille actuelle des tampons partagés PostgreSQL, en octets. Le module de gestion automatique de la mémoire ajuste automatiquement cette valeur en fonction de la pression exercée sur la mémoire. octet jauge
alloydb_omni_memory_postgresql_shared_buffers_byte Limite supérieure de la taille des tampons partagés PostgreSQL, telle qu'elle est configurée avec le paramètre shared_buffers, en octets. octet jauge
alloydb_omni_memory_postgresql_shared_buffers_min_byte Limite inférieure de la taille des tampons partagés PostgreSQL, en octets. octet jauge
alloydb_omni_memory_postgresql_terminated_backends_count_total Nombre total de backends PostgreSQL arrêtés par le module de gestion automatique de la mémoire en raison d'une pression sur la mémoire. compteur
alloydb_omni_memory_used_byte Estimation de la mémoire du conteneur de base de données utilisée et qui ne peut pas être libérée. octet jauge
alloydb_omni_node_cpu_mcpu Nombre de mCPU alloués. 1 000 mCPU = 1 CPU mCPU jauge
alloydb_omni_node_cpu_usage_second_total Nombre total de secondes de CPU utilisées. seconde compteur
alloydb_omni_node_network_received_bytes_count_total Nombre d'octets reçus sur le réseau sur l'instance AlloyDB Omni. octet compteur
alloydb_omni_node_network_sent_bytes_count_total Nombre d'octets envoyés sur le réseau sur l'instance AlloyDB Omni. octet compteur
alloydb_omni_node_storage_limit_per_disk_byte Limite de stockage en octets. disk : nom du disque octet jauge
alloydb_omni_node_storage_read_bytes_count_total Nombre d'octets lus sur le disque. octet compteur
alloydb_omni_node_storage_read_ops_count_total Nombre d'opérations d'E/S de lecture sur le disque. compteur
alloydb_omni_node_storage_usage_per_disk_byte Espace de stockage utilisé, en octets, par disque. disk : nom du disque. octet jauge
alloydb_omni_node_storage_write_bytes_count_total Nombre d'octets écrits sur le disque. octet compteur
alloydb_omni_node_storage_write_ops_count_total Nombre d'opérations d'E/S d'écriture sur le disque. compteur

Métriques au niveau de la base de données

Ces métriques sont collectées par conteneur de base de données AlloyDB Omni et par base de données Postgres. Vous pouvez créer plusieurs bases de données Postgres dans un même conteneur de base de données. Toutes ces métriques comportent des étiquettes de ressource, de métadonnées système et de "base de données". L'étiquette de base de données est le nom de la base de données Postgres à laquelle appartient la métrique.

La présence de certaines étiquettes et métriques est conditionnelle :

  • Le libellé de métrique client_addr commençant par alloydb_omni_database_postgresql_insights n'est présent que lorsque vous définissez google_insights.track_client_address sur on dans les paramètres de votre cluster de bases de données.

  • Les métriques commençant par alloydb_omni_database_postgresql_insights_pertag ne sont activées que si les conditions suivantes sont remplies :

Nom Description Libellé Unité Type
alloydb_omni_database_postgresql_backends_for_top_databases Nombre actuel de connexions par base de données. jauge
alloydb_omni_database_postgresql_blks_hit_for_top_databases_count_total Nombre total de fois où Postgres a trouvé le bloc demandé dans le cache du tampon (par base de données). compteur
alloydb_omni_database_postgresql_blks_read_for_top_databases_count_total Nombre total de blocs lus par Postgres qui ne se trouvaient pas dans le cache des tampons Postgres (par base de données). compteur
alloydb_omni_database_postgresql_committed_transactions_for_top_databases_count_total Nombre total de transactions validées par base de données. compteur
alloydb_omni_database_postgresql_deadlock_for_top_databases_count_total Nombre d'interblocages par base de données. compteur
alloydb_omni_database_postgresql_insights_aggregate_execution_time_us_total Temps d'exécution de la requête cumulé par utilisateur et par base de données. Il s'agit de la somme du temps CPU, du temps d'attente E/S, du temps de verrouillage, ainsi que du temps consacré au changement de contexte de traitement et à la planification de tous les processus impliqués dans l'exécution de la requête.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
 fr compteur
alloydb_omni_database_postgresql_insights_aggregate_io_time_us_total Temps d'E/S cumulé par utilisateur et par base de données.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • io_type : read ou write
 fr compteur
alloydb_omni_database_postgresql_insights_aggregate_lock_time_us_total Temps d'attente cumulé lié au verrouillage par utilisateur et par base de données.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • lock_type : lw, hw ou buffer_pin
 fr compteur
alloydb_omni_database_postgresql_insights_aggregate_row_count_total Nombre total de lignes affectées lors de l'exécution de la requête.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
 compteur
alloydb_omni_database_postgresql_insights_aggregate_shared_blk_access_count_total Blocs partagés (tables standards et indexées) auxquels l'exécution d'instructions accède.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • access_type : hit ou miss
 compteur
alloydb_omni_database_postgresql_insights_perquery_execution_time_us_total Temps d'exécution cumulés par utilisateur, par base de données et par requête. Il s'agit de la somme du temps CPU, du temps d'attente E/S, du temps de verrouillage, ainsi que du temps consacré au changement de contexte de traitement et à la planification de tous les processus impliqués dans l'exécution de la requête.
  • querystring : requête normalisée.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • query_hash : hachage unique de la chaîne de requête.
 fr compteur
alloydb_omni_database_postgresql_insights_perquery_io_time_us_total Temps d'E/S cumulé par utilisateur, par base de données et par requête.
  • querystring : requête normalisée.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • io_type : read ou write
  • query_hash : hachage unique de la chaîne de requête.
 fr compteur
alloydb_omni_database_postgresql_insights_perquery_lock_time_us_total Temps d'attente cumulé lié au verrouillage par utilisateur, par base de données et par requête.
  • querystring : requête normalisée.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • lock_type : lw, hw ou buffer_pin
  • query_hash : hachage unique de la chaîne de requête.
 fr compteur
alloydb_omni_database_postgresql_insights_perquery_row_count_total Nombre total de lignes affectées lors de l'exécution de la requête.
  • querystring : requête normalisée.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • query_hash : hachage unique de la chaîne de requête.
 compteur
alloydb_omni_database_postgresql_insights_perquery_shared_blk_access_count_total Blocs partagés (tables standards et indexées) auxquels l'exécution d'instructions accède par requête.
  • querystring : requête normalisée.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • access_type : hit ou miss
  • query_hash : hachage unique de la chaîne de requête.
 compteur
alloydb_omni_database_postgresql_insights_pertag_execution_time_us_total Temps d'exécution cumulés par utilisateur, par base de données et par tag. Il s'agit de la somme du temps CPU, du temps d'attente E/S, du temps de verrouillage, ainsi que du temps consacré au changement de contexte de traitement et à la planification de tous les processus impliqués dans l'exécution de la requête.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • action : nom de l'action.
  • application : nom de l'application.
  • controller : nom du contrôleur.
  • db_driver : nom du db_driver.
  • framework : nom du framework.
  • route : nom de la route.
  • tag_hash : hachage unique de la chaîne de tag.
 fr compteur
alloydb_omni_database_postgresql_insights_pertag_io_time_us_total Temps d'E/S cumulé par utilisateur, par base de données et par tag.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • action : nom de l'action.
  • application : nom de l'application.
  • controller : nom du contrôleur.
  • db_driver : nom du db_driver.
  • framework : nom du framework.
  • route : nom de la route.
  • io_type : read ou write
  • tag_hash : hachage unique de la chaîne de tag.
 fr compteur
alloydb_omni_database_postgresql_insights_pertag_lock_time_us_total Temps d'attente cumulé lié au verrouillage par utilisateur, par base de données et par tag.
  • user : utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • action : nom de l'action.
  • application : nom de l'application.
  • controller : nom du contrôleur.
  • db_driver : nom du db_driver.
  • framework : nom du framework.
  • route : nom de la route.
  • lock_type : lw, hw ou buffer_pin
  • tag_hash : hachage unique de la chaîne de tag.
 fr compteur
alloydb_omni_database_postgresql_insights_pertag_row_count_total Nombre total de lignes affectées lors de l'exécution de la requête.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • action : nom de l'action.
  • application : nom de l'application.
  • controller : nom du contrôleur.
  • db_driver : nom du db_driver.
  • framework : nom du framework.
  • route : nom de la route.
  • tag_hash : hachage unique de la chaîne de tag.
 compteur
alloydb_omni_database_postgresql_insights_pertag_shared_blk_access_count_total Blocs partagés (tables standards et indexées) auxquels l'exécution d'instructions accède par tag.
  • user : l'utilisateur de la base de données.
  • client_addr : adresse IP du client de base de données.
  • action : nom de l'action.
  • application : nom de l'application.
  • controller : nom du contrôleur.
  • db_driver : nom du db_driver.
  • framework : nom du framework.
  • route : nom de la route.
  • access_type : hit ou miss
  • tag_hash : hachage unique de la chaîne de tag.
 compteur
alloydb_omni_database_postgresql_new_connections_for_top_databases_count_total Nombre de nouvelles connexions par base de données. compteur
alloydb_omni_database_postgresql_rolledback_transactions_for_top_databases_count_total Nombre total de transactions annulées par base de données. compteur
alloydb_omni_database_postgresql_size_byte Taille de la base de données. octet jauge
alloydb_omni_database_postgresql_statements_executed_count_total Nombre total d'instructions exécutées par base de données. operation_type : nom de l'opération (SELECT, UPDATE, INSERT, DELETE, MERGE, UTILITY, NOTHING ou UNKNOWN) compteur
alloydb_omni_database_postgresql_temp_bytes_written_for_top_databases_count_total Volume total de données écrites dans des fichiers temporaires par les requêtes (par base de données). octet compteur
alloydb_omni_database_postgresql_temp_files_written_for_top_databases_count_total Nombre total de fichiers temporaires utilisés pour écrire des données lors de l'exécution d'algorithmes internes (par base de données). compteur
alloydb_omni_database_postgresql_tuples Nombre de lignes dans la base de données. state : l'une des valeurs suivantes : [live, dead] jauge
alloydb_omni_database_postgresql_tuples_deleted_for_top_databases_count_total Nombre total de lignes supprimées par base de données. compteur
alloydb_omni_database_postgresql_tuples_fetched_for_top_databases_count_total Nombre total de lignes récupérées par base de données. compteur
alloydb_omni_database_postgresql_tuples_inserted_for_top_databases_count_total Nombre total de lignes insérées par base de données. compteur
alloydb_omni_database_postgresql_tuples_returned_for_top_databases_count_total Nombre total de lignes renvoyées par base de données. compteur
alloydb_omni_database_postgresql_tuples_updated_for_top_databases_count_total Nombre total de lignes mises à jour par base de données. compteur

Métriques de collecte de métriques

Ces métriques indiquent l'état de chaque cycle de collecte de métriques. Elles possèdent les libellés de ressources mentionnés dans Libellés.

Nom Description Unité Type
alloydb_omni_monitor_collect_ms Nombre de millisecondes passées à collecter les métriques. ms jauge
alloydb_omni_monitor_error_count Nombre d'erreurs rencontrées lors de la tentative de collecte des métriques au cours de ce cycle. jauge
alloydb_omni_monitor_metric_count Nombre de métriques collectées au cours de ce cycle. jauge

Métriques du gestionnaire de métriques Prometheus

Ces métriques sont générées automatiquement par Prometheus pour chaque cycle de collecte.

Nom Description Cause Type
promhttp_metric_handler_errors_total Nombre total d'erreurs internes rencontrées par le gestionnaire de métriques promhttp. Cause de l'erreur compteur

Métriques controller-runtime

Ces métriques sont exposées par AlloyDB Omni pour surveiller son état et ses performances. Pour en savoir plus, consultez la documentation de référence sur les métriques controller-runtime.

Nom Description Libellé Unité Type
workqueue_depth Profondeur actuelle de la file d'attente de tâches. nom Jauge
workqueue_adds_total Nombre total d'ajouts gérés par la file d'attente de travail. nom Compteur
workqueue_queue_duration_seconds Durée (en secondes) pendant laquelle un élément reste dans la file d'attente avant d'être demandé. nom seconds Histogramme
workqueue_work_duration_seconds Durée de traitement d'un élément de la file d'attente de travail, en secondes. nom seconds Histogramme
workqueue_unfinished_work_seconds Nombre de secondes de travail en cours qui n'ont pas été observées par work_duration. Des valeurs élevées indiquent des threads bloqués. Vous pouvez déduire le nombre de threads bloqués en observant la vitesse à laquelle ce nombre augmente. nom seconds Jauge
workqueue_longest_running_processor_seconds Nombre de secondes pendant lesquelles le processeur le plus long pour la file d'attente de tâches s'est exécuté. nom seconds Jauge
workqueue_retries_total Nombre total de nouvelles tentatives gérées par la file d'attente de travail. nom Compteur
rest_client_requests_total Nombre de requêtes HTTP, partitionnées par code d'état, méthode et hôte. code, méthode, hôte Compteur
controller_runtime_reconcile_total Nombre total de rapprochements par contrôleur. contrôleur, résultat Compteur
controller_runtime_reconcile_errors_total Nombre total d'erreurs de rapprochement par contrôleur. controller Compteur
controller_runtime_terminal_reconcile_errors_total Nombre total d'erreurs fatales du rapprochement. controller Compteur
controller_runtime_reconcile_time_seconds Durée par rapprochement et par contrôleur. controller seconds Histogramme
controller_runtime_max_concurrent_reconciles Nombre maximal de réconciliations simultanées par contrôleur. controller Jauge
controller_runtime_active_workers Nombre de nœuds de calcul utilisés par contrôleur. controller controller Jauge
controller_runtime_webhook_latency_seconds Histogramme de la latence de traitement des requêtes d'admission. webhook seconds Histogramme
controller_runtime_webhook_requests_total Nombre total de requêtes d'admission par code d'état HTTP. webhook, code Compteur
controller_runtime_webhook_requests_in_flight Nombre actuel de requêtes d'admission traitées. webhook Jauge

Étapes suivantes