Ajouter, renommer ou copier l'attribut Prometheus

L'intégration New Relic Prometheus OpenMetrics fournit des contrôles pour transformer les métriques Prometheus pour Docker avant de les envoyer à New Relic. Après avoir défini les transformations dans le fichier de configuration d'intégration, elles sont effectuées pour tous les points de terminaison.

Hiérarchie

Le fichier manifeste nri-prometheus-latest.yaml inclut la carte de configuration nri-prometheus-cfg montrant un exemple de configuration. Les transformations sont exécutées dans l'ordre suivant :

Ignorer les métriques.
Ajouter ou inclure un attribut.
Renommer l'attribut.
Copier l'attribut.

Important

Évitez d’envoyer des données d’intégration Prometheus OpenMetrics qui ne sont pas pertinentes pour vos besoins monitoring . Utilisez plutôt des filtres pour ignorer ou inclure des métriques spécifiques. Cela vous aidera à contrôler la quantité et les types de données que vous envoyez à New Relic. Cela vous aidera également à éviter des frais de facturation supplémentaires. Pour plus d'informations, voir Ignorer ou inclure les métriques Prometheus.

Exemple de configuration

Pour utiliser ces options, configurez le fichier de configuration du conteneur de scraper (config.yaml dans le répertoire actuel) :

docker run -d --restart unless-stopped \
    --name nri-prometheus \
    -e CLUSTER_NAME="YOUR_CLUSTER_NAME"
    -e LICENSE_KEY="YOUR_LICENSE_KEY" \
    -v "$(pwd)/config.yaml:/config.yaml" \
    newrelic/nri-prometheus:latest --configfile=/config.yaml

Voici un exemple de fichier de configuration contenant tous ces exemples :

transformations:
 - description: "Transformation for MySQL exporter"
   add_attributes:
     - metric_prefix: "mysql_"
       attributes:
         owningTeam: "database-team"
   rename_attributes:
     - metric_prefix: "mysql_"
       attributes:
         table: "tableName"
         under_score: "CamelCase"
   copy_attributes:
     - from_metric: "mysql_version_info"
       to_metrics:
         - "mysql_"
       attributes:
         - "innodb_version"
         - "version"
   ignore_metrics:
     - prefixes:
       - "go_"
       - "process_"

Ajouter un attribut

Cette transformation permet d'inclure un ensemble d'attributs définis statiquement à un ensemble de métriques cibles.

configuration:

Pour inclure l'attribut owningTeam à toutes les métriques commençant par mysql_:

add_attributes:
  - prefix: "mysql_"
    attributes: 
      owningTeam: "database-team"

Pour inclure l’attribut datacenter à toutes les métriques :

add_attributes:
  - prefix: ""
    attributes: 
      datacenter: "europe"

Saisir:

mysql_info_schema_table_rows{schema="sys",table="host_summary"} 123 another_metric{table="first"} 800

Sortir:

mysql_info_schema_table_rows{schema="sys",table="host_summary","owningTeam":"database-team","datacenter":"europe"} 123 another_metric{table="first","datacenter":"europe"} 800

Renommer l'attribut

Tous les points de terminaison Prometheus n'ont pas de dénomination cohérente. Vous pouvez renommer l'attribut selon vos besoins.

configuration:

Pour renommer l'attribut table en tableName pour les métriques commençant par mysql_:

rename_attributes:
  - metric_prefix: "mysql_" 
    attributes:
      table: "tableName"

Saisir:

mysql_info_schema_table_rows{schema="sys",table="host_summary"} 123 another_metric{table="first"} 800

Sortir:

mysql_info_schema_table_rows{schema="sys",tableName="host_summary"} 123 another_metric{table="first"} 800

Copier l'attribut

Certains points de terminaison Prometheus fournissent une métrique _info ou _static contenant des métadonnées sur le service, comme la version. Il peut être utile d’avoir cet attribut sur toutes les métriques pour ce service. Cette transformation permet de copier l'attribut d'une métrique source vers un ensemble de métriques cibles.

Important

Vous ne pouvez copier des attributs qu'entre métriques dans le même point de terminaison.

Configuration:

Pour copier les attributs innodb_version et version de la métrique mysql_version_info vers toutes les métriques commençant par mysql_:

copy_attributes:
  - from_metric: "mysql_version_info"
    to_metrics:
      - "mysql_" 
    attributes: 
      - "innodb_version"
      - "version"

Input:

# HELP mysql_version_info MySQL version and distribution. mysql_version_info{innodb_version="5.7.14",version="5.7.14",version_comment="MySQL Community Server (GPL)"} 1

# HELP mysql_global_variables_slave_transaction_retries Generic gauge metric from SHOW GLOBAL VARIABLES. mysql_global_variables_slave_transaction_retries 10

Output:

mysql_global_variables_slave_transaction_retries{innodb_version="5.7.14",version="5.7.14"} 10

Cette traduction automatique est fournie pour votre commodité.

Ajouter, renommer ou copier l'attribut Prometheus

Hiérarchie.css-21sua1{background:none;border:none;width:0;padding:0;}

Important

Exemple de configuration

Ajouter un attribut

Renommer l'attribut

Renommer l'attribut

Copier l'attribut

Important

Copier l'attribut

Hiérarchie