Toutes les données d'OpenTelemetry sont associées à une ressource. Une ressource est une représentation de l'entité produisant de la télémétrie comme attribut de ressource. Les attributs de ressource sont utilisés pour adapter une ressource à la notion d'entité de New Relic.
Les données reçues sont associées à une entité via un processus appelé synthèse d'entité , par lequel les attributs de ressource présents sont mis en correspondance avec des règles qui déterminent le type d'entité auquel les données seront associées. Pour les données provenant d'OpenTelemetry , les règles de synthèse d'entité sont conçues pour respecter les OpenTelemetry conventions sémantiques des ressources .
Les conventions sémantiques des ressources définissent différents corps de conventions pour décrire différents types d'entités. Par exemple, les conventions service et hôte définissent l'attribut ressource qui décrit respectivement une instance de service ou d'hôte.
Types d'entités pris en charge
Sont décrits ici les types d'entités de New Relic qui sont pris en charge lors de l'utilisation OpenTelemetry instrumentation. Pour chaque type d’entité pris en charge, les éléments suivants sont inclus :
- L'attribut de ressource requis pour la synthèse d'entité.
- Attribut recommandé qui pilote certains aspects de l'UI de New Relic.
- attribut qui devient entité tag, lorsqu'il est présent.
Services
Une entité de service est synthétisée en adhérant aux conventions sémantiques des ressources OpenTelemetry décrivant une instance de service.
Consultez notre documentation et nos exemples pour monitoring l'entité de service à l'aide d'OpenTelemetry.
Attribut obligatoire
service.name: Le nom du service que vous voyez dans l’ UI provient de cette valeur.
Attribut recommandé
service.instance.id: Active le facettage entre plusieurs instances du même service.telemetry.sdk.language: lorsqu'elle est présente, cette valeur pilote l'affichage de toute UI spécifique à l'exécution, telle que la page d'exécution JVM pour les applications Java .
balise d'entité
service.namespacetelemetry.sdk.language(ajouté comme tag de langue)telemetry.sdk.versionk8s.cluster.namek8s.namespace.namek8s.deployment.name
Hôtes
Une entité hôte est synthétisée en adhérant aux conventions sémantiques des ressources OpenTelemetry décrivant un hôte.
Reportez-vous à l'exemple monitoring d'hôte dans le collecteur pour monitoring d'infrastructure pour plus de détails.
Attribut obligatoire
balise d'entité
cloud.providercloud.account.idcloud.regioncloud.availability_zonecloud.platformhost.idhost.namehost.typehost.archhost.image.namehost.image.idhost.image.version
Instance Redis
Une redis instance est synthétisée à Collector l'aide des données Redis Émettretre du Récepteur . Malheureusement, il n'existe actuellement aucune convention sémantique pour l'instance Redis , ni d'attribut d'identification dans les métriques du récepteur Redis . Par conséquent, l’utilisateur doit inclure manuellement l’attribut décrit ci-dessous.
Reportez-vous à l'exemple Redis dans le collecteur de monitoring d'infrastructure pour plus de détails.
Attribut obligatoire
server.address: Le redis instance nom que vous voyez dans l'UI provient de cette valeur.server.port
balise d'entité
redis.versionredis.rolehost.typecloud.providercloud.account.idcloud.regioninstrumenation.nameserver.addressserver.port
Relations entre entités prises en charge
New Relic prend en charge les relations entre les entités provenant de OpenTelemetry instrumentation. Ces relations sont synthétisées automatiquement lorsque les critères de relation appropriés sont remplis. Vous trouverez ci-dessous les relations actuellement prises en charge et leurs critères requis.
Relations entre services et à l'aide du infrastructure OpenTelemetry Collector
Le OpenTelemetry Collector peut être utilisé pour monitorer votre infrastructure. Les relations d'entité sont prises en charge entre les services instrumentés OpenTelemetry et les entités d'infrastructure créées à partir du collecteur OpenTelemetry.
Les relations suivantes avec vos services sont prises en charge :
Hôtes
Les relations entre un service et une entité hôte nécessitent que le service inclue l'attribut de ressource host.id et qu'il corresponde au host.id de l'hôte sur lequel il s'exécute.
conteneur
Les relations entre un service et une entité conteneur nécessitent que le service inclue l'attribut de ressource container.id et qu'il corresponde au container.id du conteneur dans lequel il s'exécute.
Relations de service aux infrastructure à l'aide de l'agent Infrastructure de New Relic
L'agent Infrastructure de New Relic peut être utilisé pour monitorer votre infrastructure. Les relations d'entité sont prises en charge entre les services instrumentés OpenTelemetry et l'entité infrastructure créée à partir de l'agent Infrastructure de New Relic.
Pour que ces relations fonctionnent, l'émetteur de télémétrie de votre service doit être configuré pour pouvoir être corrélé avec l'émetteur de télémétrie par l'agent infrastructure . Cela nécessite que la télémétrie de votre service inclue un attribut de ressource qui identifie l'hôte, le conteneur, etc. sur lequel le service s'exécute. Cela est généralement aussi simple que de configurer les détecteurs de ressources fournis par le OpenTelemetry SDK pour votre langue ou d'utiliser le OpenTelemetry Collector processeur de détection de ressources du .
Les relations suivantes avec vos services sont prises en charge :
Hôtes monitorés avec l'agent Infrastructure de New Relic
Les relations d'hôte entre les services instrumentés OpenTelemetry et l'entité hôte générée à partir de l'agent Infrastructure de New Relic nécessitent deux choses :
- L'attribut de ressource
host.iddoit être présent dans la télémétrie du service. - Le
host.iddoit correspondre à l’identité de l’hôte dérivée par l’agent d’infrastructure.
Dérivation de l'identité de l'hôte
Important
L'identité de l'hôte dérivée par l'agent Infrastructure de New Relic ne correspond pas exactement à la sémantique de l'attribut de ressource host.id d'OpenTelemetry dans toutes les circonstances. Cela peut entraîner des difficultés dans la corrélation des services du moniteur hôte avec l'agent infrastructure . Lisez attentivement cette section pour comprendre les défis potentiels.
L'identité de l'hôte dérivée par l'agent Infrastructure de New Relic dépend de l'environnement d'hébergement et configuration de l'agent.f
Pour que les services soient correctement corrélés aux hôtes monitorés par l'agent Infrastructure de New Relic, l'attribut de ressource host.id émis par le service doit correspondre à l'identité de l'hôte calculée par l'agent. Les sections suivantes décrivent, par ordre de priorité, comment l'agent infrastructure calcule l'identité d'un hôte afin que vous puissiez comprendre comment définir correctement le host.id du service.
Agent d'infrastructure configuré avec un display_name
Si l'agent d'infrastructure est configuré pour utiliser un display_name , il l'utilisera comme identité de l'hôte. Votre service instrumenté OpenTelemetry doit être configuré pour émettre un host.id égal à display_name.
Hôte fonctionnant dans un environnement cloud
Si l'hôte s'exécute dans un environnement cloud (par exemple, AWS ou Azure), l'agent utilisera l'ID d'instance attribué par le fournisseur cloud . Votre service instrumenté OpenTelemetry doit être configuré pour utiliser un détecteur de ressources adapté à votre environnement cloud.
Hôte fonctionnant dans un environnement non cloud
Dans les environnements non conteneurisés, l'agent infrastructure calcule un nom de domaine complet (FQDN) de l'hôte. La manière dont l'agent détermine le FQDN diffère en fonction de divers facteurs tels que le système d'exploitation. On ne peut pas compter sur les détecteurs de ressources pour calculer la même valeur que le nom de domaine complet résolu par l'agent d'infrastructure. Il est recommandé de configurer explicitement un display_name pour l'agent d'infrastructure et le host.id de votre service afin qu'ils correspondent.
Service de monitoring de conteneur avec l'agent Infrastructure de New Relic
Les relations entre un service et une entité conteneur nécessitent que le service soit configuré avec un détecteur de ressources approprié qui inclut l'attribut de ressource container.id .
Amazon flux de métriques CloudWatch
Votre infrastructure hébergée dans AWS peut être monitorée grâce à l'intégration de New Relic avec Amazon flux de métriques CloudWatch. Il ne s'agit pas d'une solution OpenTelemetry pour monitoring votre infrastructure. Cependant, New Relic prend en charge un certain nombre de relations entre les services instrumentés OpenTelemetry et le moniteur infrastructure à l'aide d'Amazon CloudWatch. Les relations prises en charge sont répertoriées ci-dessous.
Important
Certaines relations sont automatiquement prises en charge par l’instrumentation. Ces relations utilisent les conventions sémantiques OpenTelemetry pour corréler la télémétrie des services instrumentés avec OpenTelemetry au moniteur de ressources AWS par flux de métriques CloudWatch. Cependant, sachez que beaucoup de ces conventions ne sont pas encore stables et sont encore en évolution. Les instruments qui produisent la télémétrie pour les frameworks ci-dessous varient dans leur niveau de maturité et de conformité aux conventions sémantiques. Ainsi, l'instrumentation que vous utilisez peut ne pas émettre l'attribut requis pour que ces relations fonctionnent. Veuillez contacter les responsables de l'instrumentation que vous utilisez pour toute question sur la maturité de l'instrumentation par rapport aux conventions sémantiques d'OpenTelemetry.
Si une relation n'est pas automatiquement prise en charge par l'instrumentation, ou si l'instrumentation existante ne suit pas les conventions standard, vous devez transmettre manuellement la télémétrie à New Relic pour établir la relation. Pour ce faire, transmettez un log ou un span avec l’attribut newrelic.aws_metric_streams.arn qui inclut l’ ARN de la ressource. Il est recommandé de transmettre le log sur des intervalles car ceux-ci peuvent être échantillonnés. Gardez à l’esprit que ces relations ont une durée de vie (TTL) de 75 minutes, vous devez donc émettre périodiquement des données de télémétrie pour maintenir la relation.
Soutenu par l'instrumentation | Produit AWS |
|---|---|
✅ | |
✅ | |
✅ | |
✅ | |
Ajout d'une balise personnalisée à une entité
Vous pouvez utiliser des balises pour organiser et filtrer votre entité dans l'UI. Les balises sont des paires valeur-clé, par exemple team: operations, ajoutées à divers ensembles de données, comme les applications de monitoring et les hôtes. Certains attributs importants sont automatiquement disponibles sous forme de balise, tels que l'ID de compte ; vous pouvez également ajouter votre propre balise personnalisée directement dans l'UI ou avec l'une des méthodes ci-dessous.
L'ajout d'un attribut de ressource préfixé par tags entraînera une tag sur votre entité dans New Relic. Par exemple, l’ajout de l’attribut tags.mytag=myvalue donnera la tag d’entité mytag=myvalue.