Identification du service de base de données avec NRDOT

Obtenez une corrélation transparente entre vos applications et les performances de votre base de données grâce aux commentaires de requête SQL. Ce mécanisme permet au récepteur de base de données de la distribution New Relic d'OpenTelemetry (NRDOT) d'identifier exactement quel service est responsable d'une charge spécifique de la base de données, de requêtes lentes, ou d'événements bloquants.

Important

New Relic associe le monitoring des performances des applications New Relic (New Relic APM) et les entités de base de données en faisant correspondre l’adresse et le port de connexion à la base de données de votre application avec l’adresse et le port de connexion de l’agent de monitoring de la base de données. Cette association fonctionne de manière fiable lorsque les deux parties indiquent exactement la même adresse et le même port. Cependant, l’association automatique peut échouer si votre application achemine le trafic via un équilibreur de charge ou un proxy, ou si les deux composants utilisent des formats d’adresse différents (comme une adresse IP par opposition à un nom de domaine).

Prérequis

Agent Java : version 9.1.0 ou ultérieure.
Agent .NET : version 10.52.0 ou ultérieure.

Activer la corrélation APM-base de données pour l'agent Java

Pour activer cette corrélation, ajoutez la propriété sql_metadata_comments à la section transaction_tracer de votre fichier de configuration de l'agent Java (newrelic.yml). Pour plus d'informations, consultez la documentation de configuration de l'agent Java.

transaction_tracer:
  sql_metadata_comments: nr_service_guid

Activer la corrélation APM-base de données pour l'agent .NET

Pour activer cette corrélation, ajoutez la propriété sqlMetadataComments à la section transactionTracer de votre fichier de configuration de l’agent .NET (newrelic.config). Pour plus d’informations, consultez la documentation de configuration de l’agent .NET.

Si vous utilisez un script de démarrage ou un script wrapper pour lancer votre exécutable, définissez la variable NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLED sur 1.

# Add this environment variable alongside your other CoreCLR / New Relic variables
$env:NEW_RELIC_TRANSACTION_TRACER_SQL_METADATA_COMMENTS_ENABLED = "1"

Comment ça marche

Lorsque votre application envoie une requête à la base de données, l'agent APM ajoute automatiquement un GUID d'entité APM au début du texte SQL sous forme de commentaire. Cette pratique courante du secteur n'affecte pas la logique d'exécution de vos instructions SQL.

Préfixage de commentaires: l'agent APM ajoute une chaîne de commentaire au début du SQL sortant (par exemple, /* nr_service_guid="MTE2MDAzMTl8QVBNfEFQUExJ" */ SELECT * FROM orders...).
Exécution: La base de données exécute la requête comme d'habitude. Le commentaire est stocké dans les schémas de performance internes de la base de données (comme sys.dm_exec_requests ou v$session).
Extraction: Le récepteur de base de données récupère ces requêtes (actives, lentes ou bloquantes).
Enrichissement: Le récepteur analyse le commentaire, extrait le nr_service_guid et l'ajoute en tant que dimension à vos métriques de base de données.

Avantages de l'étiquetage des services

L'ajout de métadonnées de service en préfixe vous offre une visibilité haute fidélité sur votre écosystème de bases de données :

Attribution au niveau du service: visualisez instantanément quel microservice est responsable d'un pic de CPU ou de mémoire de la base de données
Analyse affinée des requêtes lentes: filtrez les logs de requêtes lentes par client_name pour comprendre si un goulot d’étranglement de la base de données est isolé sur une version spécifique de l’application
Résolution des blocages et des interblocages: Identifiez rapidement le "propriétaire" d'une requête bloquante pour accélérer le dépannage inter-équipes

Impact sur la sécurité et les performances

Nous avons conçu ce mécanisme pour qu’il soit invisible aux opérations de votre base de données :

Fonctionnalité	Détail de l'impact
Logique d'exécution	L’optimiseur du moteur de base de données ignore les commentaires SQL
Frais généraux de la base de données	L'ajout d'une courte chaîne (généralement moins de 50 caractères) a un impact négligeable sur la bande passante réseau ou la mémoire
Confidentialité des données	Seul le GUID du service est inséré. Aucune donnée d'application sensible ou contexte utilisateur n'est inclus dans le commentaire

Gestion des secrets

Vous pouvez utiliser deux méthodes sécurisées pour gérer les identifiants sensibles (tels que les mots de passe de base de données) dans la configuration du NRDOT Collector. Choisissez la méthode qui correspond le mieux à votre infrastructure et à vos politiques de sécurité.

Chiffrement AES (indépendant de la plateforme)

Cette méthode vous permet de stocker des identifiants chiffrés directement dans vos fichiers de configuration, prenant en charge les workflows de gestion de version (GitOps).

Fonctionnement: Les chaînes sensibles sont chiffrées hors ligne avec AES-256 (mode GCM). Le collecteur les déchiffre lors de l'exécution à l'aide d'une clé principale stockée dans les variables d'environnement du serveur
Avantage en matière de sécurité: Les fichiers de configuration peuvent être partagés ou versés dans des dépôts en toute sécurité sans exposer de mots de passe en clair

Idéal pour: environnements hybrides/multi-cloud, développement local ou serveurs Windows où l'intégration d'OCI Vault n'est pas possible

Exemple de configuration

receivers:
  newrelicoracledb/cdb:
    endpoint: "10.x.x.36:1521"
    # Credentials are encrypted using the offline helper tool
    username: "${aes:YOUR_ENCRYPTED_USERNAME_STRING}"
    password: "${aes:YOUR_ENCRYPTED_PASSWORD_STRING}"
    service: "DB1104.privatesubnet.oracledb.oraclevcn.com"
    collection_interval: 15s

Gestionnaire de secrets AWS

Cette méthode vous permet de récupérer des identifiants en toute sécurité directement depuis AWS Secrets Manager lors de l'exécution, éliminant ainsi complètement le besoin de stocker des mots de passe dans vos fichiers de configuration.

Fonctionnement: Le NRDOT Collector utilise un rôle AWS IAM pour s'authentifier automatiquement et récupérer les secrets requis depuis AWS Secrets Manager lors du démarrage.
Avantage de sécurité: Aucune donnée sensible n'est jamais stockée sur disque ou dans le contrôle de version. L'accès est strictement régi par les stratégies AWS IAM, et les identifiants de base de données peuvent être renouvelés de manière centralisée sans avoir besoin de mettre à jour ou de déployer de nouveaux fichiers de configuration
Idéal pour: les environnements de production fonctionnant nativement sur AWS où la gestion centralisée des secrets, l'audit de conformité et la rotation automatisée sont requis
Exemple de configuration
```
receivers:
  newrelicoracledb/pdb:
    endpoint: "10.x.x.36:1521"
    # Syntax: ${secretsmanager:SecretName#JSONKey}
    username: "${secretsmanager:oracle/credentials#username}"
    password: "${secretsmanager:oracle/credentials#password}"
    service: "PDBTEST"
```
Remarque: Définissez la région AWS :
bash
```
$export AWS_REGION=your-aws-region
```

Cette traduction automatique est fournie pour votre commodité.

Identification du service de base de données avec NRDOT

Important

Prérequis

Activer la corrélation APM-base de données pour l'agent Java

Activer la corrélation APM-base de données pour l'agent .NET

Option 1 : via des variables d'environnement (script)

Option 2 : via newrelic.config

Comment ça marche

Avantages de l'étiquetage des services

Impact sur la sécurité et les performances

Gestion des secrets

Chiffrement AES (indépendant de la plateforme)

Chiffrement AES (indépendant de la plateforme)

Exemple de configuration

Gestionnaire de secrets AWS

Gestionnaire de secrets AWS

Exemple de configuration

Cette traduction automatique est fournie pour votre commodité.

Identification du service de base de données avec NRDOT

Important

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

Activer la corrélation APM-base de données pour l'agent Java

Activer la corrélation APM-base de données pour l'agent .NET

Option 2 : via newrelic.config

Comment ça marche

Avantages de l'étiquetage des services

Impact sur la sécurité et les performances

Gestion des secrets

Chiffrement AES (indépendant de la plateforme)

Gestionnaire de secrets AWS

Prérequis