Balise améliorée pour la base de données de l'entité New Relic

New Relic fournit désormais une balise plus riche et plus personnalisable pour votre moniteur d'entité de base de données via l'intégration sur hôte pour MySQL et Microsoft SQL Server. Cette amélioration vous permet d'obtenir des informations plus détaillées, d'améliorer le filtrage et de mieux organiser vos instances de base de données monitorées en fonction de vos besoins opérationnels spécifiques.

Auparavant, le moniteur d'entité de base de données via l'intégration sur hôte affichait généralement uniquement les balises de base telles que account, accountId et trustedAccountId. Vous pouvez désormais ajouter des balises contextuelles précieuses telles que environment, owning_team, region, cell et toute autre métadonnée personnalisée pertinente à votre configuration, directement à partir de votre configuration d'intégration.

Comment les balises sont appliquées à la base de données de l'entité

Les tags de votre base de données entité sont automatiquement générés à partir d'attributs spécifiques trouvés dans votre télémétrie. Vous pouvez influencer directement ces balises via vos fichiers configuration :

À partir de la configuration de l'intégration de la base de données

Tout attribut défini dans la section des étiquettes du fichier configuration de votre intégration de base de données (par exemple, mysql-config.yml et mssql-config.yml) deviendra automatiquement un tag sur l'entité de base de données correspondante.

Les modifications apportées à ces fichiers configuration sont automatiquement récupérées et ne nécessitent pas de redémarrage du service de l'agent New Relic Infrastructure ou du service de base de données.

Exemple snippet de fichier de configuration d'intégration de base de données (par exemple, mysql-config.yml) :

# /etc/newrelic-infra/integrations.d/mysql-config.yml
integrations:
  - name: nri-mysql
    config:
      # ... other configuration ...
      labels:
        environment: production
        owning_team: database-admins
        cell: us-east-1a
        app_version: v2.5.0

De l'attribut d'agent infrastructure personnalisé

L'attribut personnalisé défini dans la section custom_attributes de votre fichier newrelic-infra.yml peut également devenir une balise sur tous les moniteurs d'entités par cet agent infrastructure spécifique, y compris votre instance de base de données.

Pour qu'un attribut d'agent d'infrastructure personnalisé soit converti en tag sur une base de données d'entité, sa clé doit commencer par le préfixe label..

Les modifications apportées à newrelic-infra.yml nécessitent un redémarrage de l'agent d'infrastructure pour prendre effet.

Exemple snippet newrelic-infra.yml :

# /etc/newrelic-infra.yml
# ... other configuration ...
custom_attributes:
  region: 'APAC'
  host_type: 'production-server'
  label.data_center: 'Mumbai-DR'
  label.deployment_tier: 'backend'

Dans cet exemple, data_center et deployment_tier apparaîtraient comme balise sur votre base de données d'entité, tandis que region et host_type resteraient comme attribut personnalisé sur l'hôte lui-même.

Comprendre le comportement tag dans New Relic

Il est important de comprendre comment ces balises basées sur la télémétrie se comportent dans l'interface utilisateur de New Relic :

Latence de tag : les tags ne sont pas du temps réel télémétrie. En raison de la mise en cache dans le pipeline d'ingestion, l'apparition d'un tag nouvellement ajouté dans l'interface utilisateur peut prendre jusqu'à 5 minutes .
Mise à jour des valeurs tag : si vous modifiez la valeur d'un tag existant (par exemple, en remplaçant environment: staging par environment: production), la nouvelle valeur tag sera ajoutée. L'ancienne valeur tag persistera pendant un certain temps jusqu'à ce que sa durée de vie (TTL) de 4 heures expire. Cela peut temporairement créer l'apparence d'une balise en double dans l'interface utilisateur jusqu'à ce que l'ancienne soit supprimée. Cependant, au niveau de la télémétrie (par exemple, dans une requête NRQL ), la valeur tag mise à jour écrasera la précédente, ce qui signifie qu'il n'y aura qu'une seule valeur active pour cet tag.
Suppression de tag : si vous supprimez un tag de votre configuration, il continuera à s'afficher dans l'interface utilisateur jusqu'à 4 heures en raison de sa durée de vie.

Conseil

Si votre carte de service APM affiche une base de données non instrumentée, cela peut être dû au fait que votre application se connecte via un point de terminaison intermédiaire tel qu'un équilibreur de charge ou un proxy plutôt que directement à l'instance de base de données instrumentée. Pour résoudre ce problème, mappez manuellement le endpoint à votre instance instrumentée. Ajoutez un tag endpoint à chaque instance de base de données instrumentée, en utilisant l'adresse du point de terminaison non instrumenté comme valeur tag .

Par exemple, si l'entité non instrumentée est un équilibreur de charge à db-lb.internal.example.com, ajoutez le tag suivant à chaque instance de base de données de sauvegarde : endpoint:db-lb.internal.example.com

Impact sur votre configuration existante

Aucune modification de la facturation : Cette mise à jour n'a aucun impact sur votre facturation.
Aucune modification de la télémétrie existante : il n’y a aucune différence avec aucun autre comportement, et aucune modification de la télémétrie existante que vous collectez déjà. L'effet principal est d'enrichir les métadonnées associées à votre entité dans l'interface utilisateur.

En comprenant ces points, vous pouvez personnaliser et exploiter efficacement les balises améliorées pour créer une expérience monitoring plus organisée et plus perspicace pour votre instance de base de données dans New Relic.