Utiliser les expressions régulières Bean pour filtrer vos métriques JMX et spécifier des tags supplémentaires

Datadog prend en charge les expressions régulières pour faire correspondre les noms et les noms de domaine JMX Mbean afin de configurer vos filtres include et exclude. Les expressions régulières doivent être conformes au format d’expression régulière de Java. Notez que ces filtres ont été ajoutés dans la version 5.5.0.

Les groupes de capture des expressions regex fournies peuvent être utilisés pour fournir des valeurs de tags supplémentaires pour vos métriques.

Cet article fournit un exemple d’utilisation de bean_regex à partir de lʼintégration Java, et de référencement de ces groupes de capture pour définir des tags supplémentaires.

Supposons que vous ayez le nom Mbean suivant : domain.example.com:name=my.metric.name.env.dev.region.eu-central-1.method.GET.status.200. Vous pouvez utiliser certaines informations en tant que tags une fois que lʼAgent a collecté la métrique. Par exemple, vous pouvez exporter une métrique avec les tags suivants :

  • env : dev
  • region : eu-central-1
  • method : GET
  • status : 200

Les expressions régulières Bean peuvent être fournies sous la forme d’une seule expression régulière ou sous forme de liste. Dans ce dernier cas, seule la première entrée de la liste qui correspond sera prise en compte. Voici un exemple de fichier de configuration pour exporter vos métriques personnalisées avec quelques tags supplémentaires :

init_config:
  is_jmx: true

instances:
  - host: "<JMX_ENDPOINT>"
    port: "<JMX_PORT>"

    conf:
      - include:
          domain: domain.example.com
          bean_regex:
            - "domain.example.com:name=my.metric.name.*(?:\\.env\\.)([a-z]+)(?:.*\\.region\\.)([a-z-]+[0-9])(?:.*\\.method\\.)([A-Z]+)(?:.*\\.status\\.)([0-9]+)(?:.*)"
          attribute:
            attribute1:
              metric_type: gauge
              alias: "my.jmx.metric"
          tags:
              env: $1
              region: $2
              method: $3
              status_code: $4
              optional: tag

Chaque groupe de capture est stocké dans une carte Java. Le premier groupe de capture commence à la position 0. Après avoir déterminé le groupe de capture que vous souhaitez exporter en tant que tag, vous devez y faire référence dans la section tags de votre filtre include ou exclude, ainsi qu’au numéro du groupe (par exemple, la position à l’intérieur de la carte).

Pour l’exemple fourni à l’adresse bean_regex, les groupes de capture sont les suivants :

  • $0 : domain.example.com:name=my.metric.name.env.dev.region.eu-central-1.method.GET.status.200
  • $1 : dev
  • $2 : eu-central-1
  • $3 : GET
  • $4 : 200

Le Metrics Explorer vous permet dʼinterroger vos métriques et de les filtrer en fonction des tags que vous venez de créer.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

Intégration de JavaDOCUMENTATION more more Afficher les données JMX dans jConsole et configurer votre jmx.yaml pour les recueillirDOCUMENTATION more more