Agregar, cambiar el nombre o copiar el atributo Prometheus

La integración New Relic Prometheus OpenMetrics proporciona controles para transformar la métrica de Prometheus para docker antes de enviarlos a New Relic. Después de definir las transformaciones en el archivo de configuración de integración, se realizan para todos los extremos.

Jerarquía

El archivo de manifiesto nri-prometheus-latest.yaml incluye el mapa de configuración nri-prometheus-cfg que muestra una configuración de ejemplo. Las transformaciones se ejecutan en el siguiente orden:

Ignorar métrica.
Agregue o incluya atributo.
Cambiar el nombre del atributo.
Copiar atributo.

Importante

Evite enviar datos de integración de Prometheus OpenMetrics que no sean relevantes para sus necesidades de monitoreo. En su lugar, utilice filtros para ignorar o incluir métricas específicas. Esto le ayudará a controlar la cantidad y los tipos de datos que envía a New Relic. Esto también le ayudará a evitar cargos de facturación adicionales. Para obtener más información, consulte Ignorar o incluir Prometheus métrica.

Configuración de ejemplo

Para utilizar estas opciones, configure el archivo de configuración del contenedor scraper (config.yaml en el directorio actual):

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

Aquí hay un archivo de configuración de ejemplo que contiene todos estos ejemplos:

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_"

Agregar atributo

Esta transformación permite incluir un conjunto de atributos definidos estáticamente a un conjunto de objetivo métrico.

Configuration:

Para incluir el atributo owningTeam a todas las métricas que comienzan con mysql_:

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

Para incluir el atributo datacenter a toda la métrica:

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

Input:

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

Output:

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

Cambiar nombre de atributo

No todos los Prometheus extremo tienen nombres consistentes. Puede cambiar el nombre del atributo según sea necesario.

Configuration:

Para cambiar el nombre del atributo table a tableName para métricas que comienzan con mysql_:

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

Input:

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

Output:

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

Copiar atributo

Algunos extremos de Prometheus proporcionan una métrica _info o _static que contiene metadatos sobre el servicio, como la versión. Puede resultar útil tener este atributo en todas las métricas para ese servicio. Esta transformación le permite copiar un atributo de una fuente métrica a un conjunto de objetivo métrico.

Importante

Sólo puedes copiar atributo entre métricas en el mismo extremo.

Configuration:

Para copiar el atributo innodb_version y version de la métrica mysql_version_info a todas las métricas que comienzan con 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

Te ofrecemos esta traducción automática para facilitar la lectura.

Agregar, cambiar el nombre o copiar el atributo Prometheus

Jerarquía.css-21sua1{background:none;border:none;width:0;padding:0;}

Importante

Configuración de ejemplo

Agregar atributo

Cambiar nombre de atributo

Cambiar nombre de atributo

Copiar atributo

Importante

Copiar atributo

Jerarquía