Paramètres de configuration de l'intégration PostgreSQL

Cette intégration est un logiciel open source. Cela signifie que vous pouvez parcourir son code source et envoyer des améliorations, ou créer votre propre fork et le construire.

Paramètres de l'instance PostgreSQL

L'intégration PostgreSQL collecte à la fois les informations Métriques (M) et Inventaire (I). La colonne Applies To du tableau suivant indique les paramètres qui peuvent être utilisés pour chaque collection spécifique :

Paramètre	Description	S'applique à
`HOSTNAME`	Le nom d'hôte pour la connexion PostgreSQL. La valeur par défaut est localhost.	MI
`PORT`	Le port sur lequel PostgreSQL s'exécute. La valeur par défaut est 5432.	MI
`USERNAME`	Le nom d'utilisateur pour la connexion PostgreSQL. Required.	MI
`PASSWORD`	Le mot de passe pour la connexion PostgreSQL. Required.	MI
`COLLECTION_LIST`	Éventail JSON, un objet JSON ou la chaîne littérale `ALL` qui spécifie l'entité à collecter. L'utilisateur PostgreSQL ne peut collecter que les métriques de table et d'index des tables pour lesquelles il dispose des autorisations `SELECT` . Obligatoire, sauf pour `PgBouncer`. Important Ceci ne s'applique pas aux requêtes personnalisées configurées avec `CUSTOM_METRICS_QUERY` ou `CUSTOM_METRICS_CONFIG`. Pour obtenir de l’aide, consultez ces exemples.	M
`COLLECTION_IGNORE_DATABASE_LIST`	Éventail JSON de noms de bases de données qui seront ignorés pour la collecte des métriques. Généralement utile dans les cas où `COLLECTION_LIST` est défini sur `ALL` et certaines bases de données doivent être ignorées. La valeur par défaut est `[]`. Important Ceci ne s'applique pas aux requêtes personnalisées configurées avec `CUSTOM_METRICS_QUERY` ou `CUSTOM_METRICS_CONFIG`.	M
`PGBOUNCER`	Collectez `pgbouncer` métriques. La valeur par défaut est `false`.	M
`ENABLE_SSL`	Détermine si SSL est activé. Si `true`, `ssl_cert_location` et `ssl_key_location` sont obligatoires. La valeur par défaut est `false`.	MI
`TRUST_SERVER_CERTIFICATE`	Si `true`, le certificat du serveur n'est pas vérifié pour SSL. Si `false`, le certificat du serveur identifié dans `ssl_root_cert_location` est vérifié. La valeur par défaut est `false`.	MI
`SSL_ROOT_CERT_LOCATION`	Chemin absolu vers le fichier de certificat racine codé PEM. Obligatoire si `trust_server_certificate` est `false`.	MI
`SSL_CERT_LOCATION`	Chemin absolu vers le fichier de certificat client codé en PEM. Obligatoire si `enable_ssl` est `true`.	MI
`SSL_KEY_LOCATION`	Chemin absolu vers le fichier de clé client codé en PEM. Obligatoire si `enable_ssl` est `true`.	MI
`TIMEOUT`	Temps d'attente maximal pour la connexion, en secondes. Définissez sur `0` pour aucun délai d'expiration. La valeur par défaut est 10.	MI
`DATABASE`	La base de données PostgreSQL à laquelle se connecter. La valeur par défaut est `postgres`.	MI
`CUSTOM_METRICS_QUERY`	La requête SQL qui nécessite `columns metric_name`, `metric_type` et `metric_value.metric_type` peut être `gauge`, `rate`, `delta` ou `attribute`. Les colonnes supplémentaires collectées avec la requête sont ajoutées à l'ensemble métrique en tant qu'attribut.	M
`CUSTOM_METRICS_CONFIG`	Un chemin vers un fichier YAML avec une liste de requêtes personnalisées, ainsi que leur type métrique, leur base de données et leurs remplacements de nom d'échantillon. Voir les exemples pour plus de détails.	M
`COLLECT_DB_LOCK_METRICS`	Activez la collecte des métriques de verrouillage de la base de données, ce qui peut nécessiter beaucoup de performances. La valeur par défaut est `false`.	M
`COLLECT_BLOAT_METRICS`	Activez les métriques de gonflement de l'espace table, qui peuvent être gourmandes en performances. La valeur par défaut est `true`.	M
`METRICS`	Définissez sur `true` pour activer la collecte Métriques uniquement. La valeur par défaut est `false`.
`INVENTORY`	Définissez sur `true` pour activer la collecte d’inventaire uniquement. La valeur par défaut est `false`.

Les valeurs de ces paramètres peuvent être définies de plusieurs manières :

Ajout de la valeur directement dans le fichier de configuration. C'est la manière la plus courante.
Remplacement des valeurs des variables d’environnement à l’aide de la notation {{ }} . En savoir plus sur l'utilisation des passthroughs de variables d'environnement avec l'intégration sur hôte ou voir l'exemple de remplacement des variables d'environnement.
Important
Cela nécessite l'agent d'infrastructure v1.14.0+.
Utilisation de la gestion des secrets. Utilisez ceci pour protéger les informations sensibles, telles que les mots de passe qui seraient exposés en texte brut dans le fichier de configuration. Pour plus d'informations, voir gestion des secrets.

Libellés et attribut personnalisé

Les variables d'environnement peuvent être utilisées pour contrôler les paramètres de configuration, tels que votre , et sont ensuite transmises à l'agent d'infrastructure. Pour obtenir des instructions sur l’utilisation de cette fonctionnalité, consultez Configurer l’agent d’infrastructure.

Vous pouvez également décorer vos métriques à l’aide d’étiquettes. Les étiquettes vous permettent d'ajouter des paires valeur-clé à vos métriques que vous pouvez ensuite utiliser pour interroger, filtrer ou regrouper vos métriques.

Notre fichier de configuration par défaut inclut des exemples d'étiquettes mais, comme elles ne sont pas obligatoires, vous pouvez supprimer, modifier ou en ajouter de nouvelles de votre choix :

labels:
   env: production
   role: postgresql

Données d'inventaire

L'intégration PostgreSQL collecte chaque paramètre de pg_settings ainsi que ses boot_val et reset_val. Les données d’inventaire de l’infrastructure apparaissent sur la page Inventaire, sous la source config/postgresql .

Dépannage

Voici quelques conseils de dépannage pour l’intégration PostgreSQL :

Si vous rencontrez des problèmes de connexion, assurez-vous que vous pouvez vous connecter au cluster depuis la même box avec psql.
Si vous rencontrez des problèmes lors de la collecte des métriques PgBouncer , assurez-vous d'être connecté à l'instance via PgBouncer. Le port par défaut est 6432.
Si vous obtenez le message d'erreur Error creating list of entities to collect: pq: unsupported startup parameter: extra_float_digits, définissez ignore_startup_parameters = extra_float_digits dans le fichier de configuration PgBouncer .

Cette traduction automatique est fournie pour votre commodité.

Paramètres de configuration de l'intégration PostgreSQL

Paramètres de l'instance PostgreSQL .css-21sua1{background:none;border:none;width:0;padding:0;}

Important

Important

Important

Libellés et attribut personnalisé

Données d'inventaire

Dépannage

Paramètres de l'instance PostgreSQL