L'observabilité de New Relic est construite autour du concept de entities. Ce document explique comment nous définissons les entités, ce que vous pouvez faire avec elles et comment vous pouvez créer votre propre entité ou groupement d'entités.
Conseil
Vous souhaitez une visite d'introduction de la plateforme New Relic ? Voir Découvrir la plateforme.
Qu'est-ce qu'une entité ?
Du point de vue de New Relic, entity est volontairement un concept large. Une entité est tout ce qui a) signale des données à New Relic ou qui contient des données auxquelles nous avons accès, et b) est quelque chose que nous avons identifié avec un identifiant d'entité unique. Pour la plupart des entités, l'ID est indiqué par l'attribut entityGuid.
Une entité peut être n'importe quel composant fondamental de reporting des données, comme une application, un hôte ou un service de bases de données, mais elle peut également faire référence à des regroupements plus larges de ces composants. Par exemple, pour monitorer un data center, vous pouvez regrouper ces hôtes dans New Relic pour former une workload (un regroupement personnalisé d'entités). Cette workload est, elle aussi, une entité. Nous vous donnons la possibilité de créer votre propre entité.
Les relations entre les entités sont également très importantes. Notre modélisation des relations en coulisses nous aide à comprendre comment les entités sont connectées, comment elles s'influencent mutuellement. Et cela nous permet de vous donner le pouvoir de configurer la manière dont les données que vous importez sont liées à l'entité existante, ou comment elles sont liées à une autre entité.
Notre concentration sur les entités et leurs relations est importante car notre objectif est de vous donner practical information about your business-important entities, par opposition à vous donner un flux de données inutilement énorme provenant d'une énorme liste de services de monitoring et de système. Avec plus d'informations détaillées au niveau de l'entité, vous pouvez mieux monitorer et dépanner un système complexe et moderne.
one.newrelic.com:Lorsque vous ouvrez New Relic, vous arrivez sur la page All entities , qui vous donne un aperçu de votre entité de monitoring. À partir de cette page, vous pouvez afficher les métadonnées d'une entité ou cliquer sur une entité pour voir les détails des performances.
Filtrez et explorez votre entité
La barre de filtre d'entité est disponible sur de nombreuses pages de l'interface utilisateur de New Relic, y compris la vue de liste d'entités principale, APM, l'interface utilisateur , l'interface utilisateur infrastructure , etc. Pour savoir comment utiliser la barre de filtre pour explorer l'entité et enregistrer des filtres utiles, consultez Filtre d'entité.
En savoir plus sur l'entité
Pour rechercher GUID d'une entité et d'autres métadonnées dans l'interface utilisateur : depuis n'importe quelle liste d'entités, cliquez sur le nom d'une entité. icône et cliquez sur See metadata & tags.
Chaque entité possède un numéro d'identification spécifique à New Relic, qui est signalé comme l'attribut entityGuid. Vous pouvez exécuter une requête NRQL d'entité en utilisant leur GUID.
En savoir plus sur les relations entre les entités
Voici quelques options pour comprendre les relations entre les entités de monitoring :
- Lorsque vous visualisez une entité dans l'interface utilisateur, utilisez l'interface utilisateurRelated entities .
- Utilisez les cartes de service pour voir une représentation visuelle des connexions.
- Utilisez le tracing distribué pour voir comment les entités s'appellent les unes les autres dans les transactions.
- Utilisez notre API NerdGraph pour afficher les informations sur les relations.
Apprenez les détails techniques sur l'entité
Pour en savoir plus sur les types d'entités, consultez notre référentiel GitHub (dépôt) pour nos types d'entités. Par exemple, pour plus de détails sur l'entité APM-monitorer, voir Application APM.
Chaque entité contient plusieurs fichiers qui régissent la manière dont elle rapporte les données. Par exemple, le fichier golden_metrics contient des informations sur ses métriques les plus importantes, qui sont généralement mises en évidence dans nos expériences d'interface utilisateur. Voici le fichier golden_metrics.yml pour l'entité APM-monitorer.
Le fichier definition d'une entité contient des informations telles que :
- Le
domain: par exemple,APM, ouInfra. - Son
type: par exemple,ApplicationouAWSECSCONTAINERINSTANCE. - Balise par défaut.
- Le
entityExpirationTime: pour en savoir plus, voir Expiration de l'entité.
Expiration de l'entité
Les différents types d'entité ont des périodes de durée de vie différentes, déterminées par le entityExpirationTime défini dans le fichier definition pour chaque type d'entité. Ce délai d'expiration régit la durée pendant laquelle l'enregistrement de cette entité existe dans New Relic après que l'entité cesse de signaler des données.
New Relic monitore un grand nombre d'entités, et beaucoup de ces entités sont de courte durée (par exemple, le conteneur Kubernetes ). Pour ces raisons, il est nécessaire de supprimer régulièrement les enregistrements d'entité qui ont cessé de signaler des données.
Ce délai d'expiration concerne l'enregistrement de l'entité elle-même et n'est pas lié aux données télémétriques. En d'autres termes : les données télémétriques signalées par votre entité de monitoring sont trouvables dans NRDB et disponibles via NRQL, en fonction de ses paramètres de rétention des données. Mais l'enregistrement de l'entité elle-même, une fois expiré, n'existera plus dans New Relic.
Les options pour le délai d'expiration de l'entité sont les suivantes :
FOUR_HOURSDAILY(24 heures)EIGHT_DAYS: Valeur par défaut appliquée si aucune date limite n'est définie dans le fichierdefinition.QUARTERLY(3 mois)MANUAL: Ce paramètre s'applique uniquement aux entités dont la création et la suppression sont contrôlées manuellement (par exemple, la charge de travail et les dashboards).
Grouper et organiser une entité
Vous pouvez placer des entités dans des groupes qui reflètent les relations commerciales importantes au sein de votre organisation. Par exemple, vous pouvez regrouper toutes les entités liées à une équipe ou à un département spécifique, ou liées à un service spécifique. Vous pouvez également regrouper plusieurs hôtes pour refléter leur regroupement dans un data center.
Pour regrouper votre entité, voir :
- balise entité.
- Créez une charge de travail qui vous permet de regrouper des ensembles d'entités importants pour l'entreprise.
- Créer une entité et personnaliser les données de l'entité
Créez et gérez votre propre entité avec Entité Synthèse
Si vous disposez d'une télémétrie provenant d'une source qui n'est pas prise en charge par New Relic, vous pouvez proposer une modélisation pour celle-ci. Une fois approuvée, toute télémétrie reçue par New Relic qui correspond à votre fichier de définition sera synthétisée en une entité.
Pour en savoir plus :
- Pour les attributs réservés et la manière dont les relations entre entités sont définies, continuez à lire ce document.
- Pour savoir comment effectuer le travail de modification des types d'entités existants ou d'en créer de nouveaux, consultez notre référentiel GitHub sur la synthèse d'entités.
Attribut réservé pour l'entité synthétisée
Ces attributs sont destinés à être synthétisés à partir de la télémétrie que nous recevons. Ne les définissez pas à moins d’être conscient des implications et des conséquences.
Attribut | Description |
|---|---|
| De manière générale, vous ne devez pas paramétrer ce champ attribut sur vos données télémétriques. New Relic peut ajouter ce champ aux données ingérées pour stocker un identifiant unique pour l'entité associée au point de données. Si la télémétrie arrive avec l'attribut Un cas d'utilisation pour passer cet attribut est d'associer la télémétrie ingérée à une entité que nous monitorons déjà. Lorsque l'attribut |
| Cet attribut ne doit pas être mis sur les données télémétriques ingérées, sauf si vous essayez de remplacer le nom de l'entité qui aurait été sélectionné par notre système d'identification d'entité. Bien que nous ne modifierons pas la valeur si elle est déjà présente dans les données, nous pouvons ajouter l'attribut à vos données. Par conséquent, des valeurs non valides ou inattendues peuvent entraîner un comportement indéfini tel qu'une entité manquante dans l'interface utilisateur ou une télémétrie ne s'associant pas à l'entité attendue. Si ce champ est présent dans la télémétrie ingérée, sa valeur sera utilisée pour nommer l'entité associée au point de données. Ce nom sera utilisé à la place du nom sélectionné par notre système d'identification d'entité (par exemple, les définitions de synthèse d'entité). Notez que de nombreuses entités utilisent le nom comme partie de leur identification, donc la modification de ce champ peut entraîner la génération d'une nouvelle entité. |
| Cet attribut ne doit pas être appliqué aux données télémétriques ingérées, sauf dans certains cas legacy où il est nécessaire de distinguer les types d'entités. Le passage de ce champ peut interférer avec la détection d'entité, en particulier si des valeurs non reconnues sont envoyées dans ce champ. Bien que New Relic ne modifie pas la valeur si elle est déjà présente dans les données, le champ ne garantit pas de fournir un filtrage sans ambiguïté de la télémétrie au moment de la requête. Les définitions d'entité existantes ont déjà des valeurs qui se chevauchent, et nous recommandons d'éviter Ce champ est utilisé par New Relic, ce qui signifie que des valeurs non valides ou inattendues peuvent provoquer un comportement indéfini tel qu'une entité manquante dans l'interface utilisateur ou une télémétrie ne s'associant pas à l'entité attendue. |
Pour savoir comment effectuer le travail de modification des types d'entités existants ou d'en créer de nouveaux, consultez notre référentiel GitHub sur la synthèse d'entités.
Entité non instrumentée
Grâce à votre télémétrie, nous pouvons détecter des entités qui ne sont pas instrumentées actuellement mais qui sont utilisées par votre application. Par exemple, l'une de vos entités instrumentées peut appeler une base de données Amazon RDS qui n'est pas actuellement instrumentée par New Relic, nous ne pouvons donc pas fournir d'outils tels que monitoring ou l'alerte pour cela.
Dans ce cas, nous créons une soi-disant « entité non instrumentée » ainsi qu'une relation avec l'entité instrumentée. Il est affiché dans la carte des services de l'entité instrumentée. Nous fournissons des instructions claires pour l' instrumenté , affichées en cliquant simplement sur l'entité.
relations entre entités
Les connexions entre entités sont automatiquement créées par New Relic en fonction de ce que nous pouvons déduire de votre télémétrie. Par exemple, lorsque deux services qui communiquent via HTTP sont instrumentés avec New Relic, nous en déduisons une relation « appels/appelé par » entre eux.
Lorsque vous visualisez une entité dans les vues Explorateur d'entités, Navigateur et Lookout, vous pouvez voir son Related entities dans le volet de droite. Cela donne une visualisation des différentes entités connectées directement à l'entité actuelle. Vous pouvez rapidement visualiser les métriques importantes pour ces entités liées et naviguer d'une entité à une autre, à travers toutes les parties connectées de votre stack.
Conseil
Découvrez comment approfondir les relations entre entités avec notre API NerdGraph.
Types de relations d'entité
Les entités peuvent être liées les unes aux autres de diverses manières. Le réplicateur ci-dessous répertorie les relations d’entité prises en charge. Une fois que vous avez compris les relations possibles, jetez un œil à la liste des relations créées automatiquement ou déterminez si vous souhaitez créer des relations d'entité personnalisées.
Quelles relations sont créées automatiquement ?
Des relations automatiques sont créées sur la base de la télémétrie rapportée par l'entité. Ces relations ont une durée de vie (TTL). Cela signifie qu'ils seront automatiquement supprimés si les mesures utilisées pour créer la relation ne sont pas signalées dans une période donnée. Le TTL par défaut pour une relation est de 75 minutes. Le TTL peut varier de 10 minutes à 3 jours selon le type de relation.
Voici les relations entre entités que nous créons automatiquement :
Gestion des exceptions d'entités externes et non instrumentées héritées dans les relations d'entité
Si un service est appelé par intermittence, avec des intervalles dépassant 10 minutes entre les appels, le DFM, l'utilisateur de l'interface des services externes et les détails trace peuvent l'afficher comme une entité externe legacy . Cela pourrait conduire à la duplication d’un service déjà instrumenté. Il s'agit du comportement actuel pour tous les appels externes.
Si un service est accessible via plusieurs noms d'hôte mais que le tracing n'est pas activé pour chaque instance, toutes les cartes représenteront à la fois un service instrumenté et un service non instrumenté pour l'application enfant correspondante. Pour résoudre ce problème, assurez-vous que le tracing est activé pour toutes les instances.
Créer des relations d'entité personnalisées
Lorsque les relations ne sont pas détectées automatiquement, vous pouvez les créer manuellement à l'aide de notre API NerdGraph, ou vous pouvez le faire dans l'interface utilisateur de New Relic avec le lien Add/edit related entities dans Related entities. Actuellement, vous ne pouvez créer manuellement que des appels/relations appelés entre les entités de service.
Conseil
Pour gérer les relations manuelles, vous devez disposer de capacités de modification et de suppression sur les relations d'entité. Si vous ne voyez pas le bouton Modifier les relations, contactez l'administrateur de votre compte.