L'interface utilisateur OpenTelemetry APM est une expérience organisée disponible pour l'entité de service. Si vous n'avez pas configuré votre service avec New Relic et OpenTelemetry, consultez Monitoring APM OpenTelemetry.
Les pages de l'interface utilisateur OpenTelemetry APM sont conçues pour aider à identifier et à diagnostiquer rapidement les problèmes. Beaucoup exigent que les données soient conformes à diverses conventions sémantiques d'OpenTelemetry, mais certaines sont à usage général.
Les concepts New Relic suivants se répètent ou se chevauchent sur plusieurs pages :
Trouver les services APM d'OpenTelemetry
Pour trouver les services OpenTelemetry APM, accédez à All entities > Services > OpenTelemetry ou APM & Services. Cliquez sur un service pour accéder à la Summary page du service.
Dans l'explorateur d'entités, vous pouvez filtrer par balise d'entité. Pour plus de détails sur la façon dont les balises d'entité sont calculées, consultez les ressources OpenTelemetry dans New Relic.
Page : Sommaire
La page récapitulative fournit un aperçu de l'état de votre service, notamment :
- Signaux dorés: temps de réponse, débit, et taux d'erreur. Voir signaux dorés pour plus de détails sur la façon dont ils sont calculés.
- Entité liée: autres services communiquant avec ce service et infrastructure liées. Consultez la carte des services pour une vue détaillée.
- Activité: état de toutes les alertes actives pour ce service.
- Informations détaillées du tracing distribué: découvrez si une entité en aval ou en amont peut contribuer à une dégradation des performances. Voir Signaux d’entité de trace associés pour plus de détails.
- Instances: répartition des signaux dorés par instance lorsqu'un service est mis à l'échelle horizontalement. Dépend de l'attribut de ressource
service.instance.id(voir Services pour plus de détails).
Page : tracing distribué
La page de tracing distribué fournit des informations détaillées sur les OpenTelemetry trace données . Voir le tracing distribué pour les informations sur l'utilisation des pages. Consultez OpenTelemetry la trace dans New Relic pour plus de détails sur la manière dont OpenTelemetry trace les données sont ingérées dans New Relic.
Comme pour les signaux dorés, les intervalles sont classés comme des erreurs si l'état de l'intervalle est défini sur ERROR (par exemple, otel.status_code = ERROR). Si l'étendue est une erreur, la description de l'état de l'étendue (par exemple, otel.status_description) s'affiche dans error details.
OpenTelemetry span événement attache des informations de contexte d'événement supplémentaires à un span particulier. Ils sont le plus souvent utilisés pour capturer des informations sur les exceptions. Si disponible, vous pouvez afficher l'événement d'un span dans les détails de trace.
Conseil
La présence d'un événement d'exception d'étendue ne qualifie pas l'étendue comme une erreur à elle seule. Seules les étendues dont le statut d'étendue est défini sur ERROR sont classées comme des erreurs.
Page : Plan de service
La page de cartographie des services fournit une représentation visuelle de l’ensemble de votre architecture. Consultez les cartes de service pour plus d'informations.
Page : Transactions
La page des transactions fournit des outils permettant d'identifier les problèmes et d'analyser les transactions d'un service.
Pour les métriques, la requête suppose que les données sont conformes aux conventions sémantiques HTTP métrique ou RPC métrique . Les attributs http.route et rpc.method sont utilisés pour répertorier et filtrer par transaction.
Pour les étendues, les requêtes sont génériques et utilisent uniquement le modèle de données d'étendue de niveau supérieur. Les délais sont pris en compte dans le débit de transaction et le temps de réponse comme décrit dans les signaux dorés. Le champ Nom de l'étendue est utilisé pour répertorier et filtrer par transaction.
Page : base de données
La page base de données fournit des outils permettant d'identifier les problèmes et d'analyser les opérations client de base de données d'un service.
Il n'existe pas de vue métrique de la base de données car il n'existe actuellement aucune convention sémantique disponible.
Pour les étendues, la requête suppose que les données sont conformes aux conventions sémantiques d'étendue de la base de données . Le nom span et les attributs db.system, db.sql.table et db.operation sont utilisés pour répertorier et filtrer les opérations de base de données.
Page : Services externes
La page des externes fournit des outils permettant d'identifier les problèmes et d'analyser les appels externes d'un service, notamment l'entité appelante (services en amont) et l'entité appelée (services en aval).
Il n'existe pas de vue basée sur des métriques de la page des services externes.
Pour les étendues, les requêtes sont génériques et utilisent uniquement le modèle de données d'étendue de niveau supérieur. Les intervalles sont comptabilisés dans le débit du service externe et les temps de réponse s'ils sortent d'un service, calculés à l'aide d'une heuristique de WHERE span.kind = client OR span.kind = producer. base de données span client sont filtrées à l'aide de WHERE db.system is null (voir Page : base de données). Comme pour les signaux dorés, les spans sont des erreurs s'ils ont un code d'état de ERROR (par exemple, otel.status_code = ERROR). Si disponibles, les données des conventions sémantiques HTTP SPAN et RPC SPAN sont utilisées pour classer les appels de service externes.
Page : Environnement d'exécution de la JVM
La page d'exécution JVM fournit des outils permettant d'identifier les problèmes et d'analyser la JVM d'un service Java. La page s'affiche uniquement pour les services utilisant OpenTelemetry java. Afin de différencier les différentes instances de service, la page nécessite que l'attribut de ressource service.instance.id soit défini (voir Services pour plus de détails).
La page d'exécution JVM affiche les signaux dorés ainsi que les mesures d'exécution JVM pour corréler les problèmes d'exécution avec l'utilisation du service. La bascule métriques ou spans détermine si les signaux dorés sont pilotés par des données span ou métriques. Il n’existe pas de vue basée sur les étendues pour les métriques d’exécution JVM.
Pour les métriques, la requête suppose que les données sont conformes aux conventions sémantiques métriquesJVM . Notez que ces conventions sont intégrées dans la bibliothèque d'instrumentation d'exécution Java OpenTelemetry, qui est automatiquement incluse avec l'agent Java OpenTelemetry.
Page : environnement d'exécution Go
La page d'exécution Go fournit des outils permettant d'identifier les problèmes et d'analyser l'exécution d'un service Go. La page s'affiche uniquement pour les services utilisant OpenTelemetry Go. Afin de différencier les différentes instances de service, la page nécessite que l'attribut de ressource service.instance.id soit défini (voir Services pour plus de détails).
La page d'exécution Go affiche les signaux dorés ainsi que les métriques d'exécution Go pour corréler les problèmes d'exécution avec l'utilisation du service. La bascule métriques ou spans détermine si les signaux dorés sont pilotés par des données span ou métriques. Il n’existe pas de vue basée sur les étendues pour les métriques d’exécution Go.
Pour les métriques, la requête suppose que les données sont produites par la bibliothèque d'instrumentation d'exécution OpenTelemetry Go. Notez qu’il n’existe actuellement aucune convention sémantique pour les métriques d’exécution Go.
Page : logs
La page des logs fournit des outils permettant d'identifier les problèmes et d'analyser les logs d'un service. Voir Utiliser l'interface utilisateur des logs pour plus d'informations.
Page : Boîte de réception des erreurs
La page Boîte de réception des erreurs fournit des outils permettant de détecter et de trier les erreurs d'un service. Pour plus de détails, consultez Prise en main de la boîte de réception des erreurs .
La page Boîte de réception des erreurs est pilotée par les détails trace . Comme pour les signaux dorés, les intervalles sont classés comme des erreurs si l'état de l'intervalle est défini sur ERROR (par exemple, otel.status_code = ERROR).
Les plages d'erreur sont regroupées par leur empreinte d'erreur, calculée en normalisant les valeurs d'identification telles que les UUID, les valeurs hexadécimales, les adresses e-mail, etc. Chaque plage d’erreur distincte est une instance individuelle au sein du groupe d’erreurs. Le message du groupe d'erreur est déterminé comme suit :
- Description de l'état de l'étendue (par exemple,
otel.status_description) rpc.grpc.status_codeà partir des conventions sémantiques RPC spanhttp.status_codeà partir des conventions sémantiques HTTP spanhttp.response.status_codeà partir des conventions sémantiques HTTP spanundefinedsi aucun des éléments ci-dessus n'est présent
Page : Explorateur de métriques
L'explorateur Métriques fournit des outils permettant d'explorer les métriques d'un service de manière générique. Consultez Explorer vos données pour plus d’informations.
Signaux dorés
Les signaux dorés de débit, de temps de réponse et de taux d'erreur apparaissent à plusieurs endroits dans l'interface utilisateur d'OpenTelemetry APM. Lorsqu'ils sont utilisés, ils sont calculés comme suit :
Pour les métriques, la requête suppose que les données sont conformes aux conventions sémantiques HTTP métrique ou RPC métrique .
Pour les étendues, les requêtes sont génériques et utilisent uniquement le modèle de données d'étendue de niveau supérieur. Les spans sont comptabilisés dans le débit et le temps de réponse s'ils sont des spans d'entrée racine dans un service, calculés à l'aide d'une heuristique de WHERE span.kind = server OR span.kind = consumer. Les étendues sont des erreurs si elles ont un code d'état de ERROR (par exemple, otel.status_code = ERROR).
Affiner les données avec des filtres
Plusieurs pages incluent une barre de filtre, avec des options telles que Narrow data to.... Cela vous permet de filtrer les requêtes sur la page pour correspondre aux critères. Par exemple, vous pouvez restreindre votre recherche à un déploiement Canary particulier en filtrant sur service.version='1.2.3-canary'. Les filtres sont conservés lors de la navigation entre les pages.
Basculer entre les métriques ou les portées
Différentes pages incluent une fonction bascule de métriques ou d'étendues. Cela vous permet de choisir si les requêtes sont pilotées par des données span ou métriques en fonction des exigences d'analyse et de la disponibilité des données.
Les métriques ne sont pas soumises à l'échantillonnage et sont donc plus précises, notamment lors du calcul de débits comme le débit. Cependant, les métriques sont soumises à des contraintes de cardinalité et peuvent manquer de certains attributs importants pour l'analyse. En revanche, les étendues sont échantillonnées et donc sujettes à des problèmes de précision, mais ont des attributs plus riches car elles ne sont pas soumises à des contraintes de cardinalité.
Historiquement, les API, les SDK et l'instrumentation du langage OpenTelemetry ont donné la priorité à l'instrumentation de trace. Cependant, le projet a parcouru un long chemin et les métriques sont disponibles dans presque toutes les langues. Consultez la documentation de la langue et de l'instrumentation concernées pour plus de détails.
métriques dorées
Les métriques dorées sont des versions à faible cardinalité des données de signaux dorés, telles que les métriques HTTP/RPC. Ils peuplent diverses expériences de plateforme, notamment l'entité Explorer, la page d'activité de la charge de travail et la page Détails du suivi des changements. Ces métriques utilisent des noms tels que newrelic.goldenmetrics.ext.service.*.
Important
Historiquement, les métriques dorées OpenTelemetry étaient calculées à partir des travées. Les portées sont généralement échantillonnées, elles ne fournissent donc qu'une image partielle. Maintenant que les métriques sont largement disponibles, les métriques dorées sont calculées à l'aide de données métriques plutôt que de données span.