Cette traduction automatique est fournie pour votre commodité.
En cas d'incohérence entre la version anglaise et la version traduite, la version anglaise prévaudra. Veuillez visiter cette page pour plus d'informations.
Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !
Cette fonctionnalité est actuellement fournie dans le cadre d'un aperçu conformément à nos politiques de pré-sortie.
La fonctionnalité de suivi des changements vous permet de capturer, de visualiser et d'analyser les changements dans vos applications et infrastructure. Cette fonctionnalité est conçue pour vous aider à comprendre comment les changements impactent à la fois votre système et vos clients.
Capturez toutes les modifications impactant votre système : envoyez un événement de modification pour tout type de modification, y compris les modifications des indicateurs de fonctionnalités, les modifications configuration et les événements commerciaux. Vous pouvez également créer des événements de changement personnalisés adaptés à vos besoins spécifiques. Utilisez la mutation NerdGraph changeTrackingCreateEvent pour envoyer facilement différents types d'événements de changement.
Bénéficiez d'une vue complète pour gérer les modifications à l'échelle du système : visualisez et filtrez de manière transparente les événements de modification sur l'ensemble de votre entité et de vos comptes à partir d'une interface unifiée. Identifiez sans effort les changements en filtrant par équipe, type, attribut personnalisé et tout autre critère.
Corrélez rapidement les changements avec la télémétrie pour accélérer la découverte des causes profondes : améliorez votre compréhension de l'impact du changement en visualisant l'événement de changement aux côtés de vos données de séries chronologiques. Pour trouver la cause première plus rapidement, ajoutez une requête de série chronologique pour afficher l'événement de changement avec des métriques pertinentes, permettant une corrélation claire.
Enrichissez votre événement de changement avec des métadonnées complètes : suivez toutes les informations nécessaires sur vos changements à l'aide des attributs personnalisés, des catégories et des types. Adaptez votre événement de changement pour inclure tous les détails nécessaires à une clarté complète du système.
Accéder à la page suivi des changements dans New Relic
Vous pouvez accéder à la page Change Tracking des manières suivantes :
suivi des changements dans toutes les pages de l'entité
La page Change Tracking sur toutes les entités affiche une vue consolidée de l'événement de changement pour tous les comptes et entités sur une seule page. Il vous permet de :
Examinez les modifications sur tous les comptes et entités accessibles.
Filtrez les changements d'événements par compte, entité, type de déploiement et autres attributs pour affiner les résultats.
Ajoutez une requête de série temporelle pour visualiser un événement de changement par rapport aux données de série temporelle dans diverses entités et comptes.
Pour accéder au suivi des changements dans toutes les entités :
Pour ajouter la page Change Tracking à votre navigation de gauche, cliquez sur l'icône en forme d'épingle.
La page Change Tracking sur toutes les entités affiche l'événement de changement pour toutes les entités et tous les comptes auxquels vous avez accès. Vous pouvez visualiser ces événements dans les deux volets :
Tableau des changements d'événements : Ce tableau répertorie les changements d'événements de vos comptes accessibles. Chaque événement du tableau est également marqué sur le graphique des séries chronologiques.
Pour affiner la liste, utilisez la barre de filtre avec l'attribut événement et la balise entité.
Ajustez la plage de temps affichée à l'aide du sélecteur d'intervalle de temps, ou en cliquant et en faisant glisser une sélection directement sur le graphique.
Graphique de séries chronologiques d'événements de changement : exécutez une requête NRQL et affichez les résultats sur ce graphique avec l'événement de changement superposé. Cette visualisation vous aide à corréler les tendances des données (telles que les pics ou les creux) avec des changements système spécifiques sur vos comptes.
CONSEIL
Le graphique et le tableau peuvent chacun afficher un maximum de 1 000 événements. Si vos filtres actuels et votre plage horaire génèrent plus de 1 000 événements, seuls les 1 000 événements les plus récents sont affichés. Pour visualiser un ensemble d'événements plus spécifique (moins de 1 000), appliquez un filtre plus restrictif ou sélectionnez une plage horaire plus courte.
/* <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>Tableau des événements de changement</td> <td> Le tableau des événements de changement sur la page Change Tracking affiche les changements pour tous vos comptes accessibles. Chaque événement est marqué sur le graphique de la série chronologique. Utilisez la barre de filtre pour affiner la liste par attribut d'événement et balise d'entité. Ajustez la plage horaire avec le sélecteur d'intervalle de temps pour modifier le nombre d'événement affiché.</td> </tr> <tr> <td>Graphique de séries chronologiques d'événements de changement</td> <td>Le graphique de séries chronologiques vous permet d'exécuter une requête <DNT>NRQL</DNT> valide et de superposer l'événement de changement sur les résultats. Cette fonctionnalité permet de corréler les pics dans les données du graphique avec les événements de changement sur tous les comptes.</td> </tr> </tbody> </table> */
suivi des changements vue à l'échelle de l'entité
La vue Change Tracking à l'échelle de l'entité affiche les événements de changement pour une entité spécifique, telle qu'APM, navigateur ou mobile. Il propose également des informations supplémentaires liées aux signaux dorés pour chaque événement de changement.
Pour accéder à la vue Change Tracking pour l'entité :
Sélectionnez l’entité requise puis cliquez sur Change Tracking.
Suivre les modifications à l'aide de NerdGraph
La fonctionnalité de suivi des changements de New Relic vous permet de surveiller l'impact de diverses modifications sur votre système. Par instance, vous pouvez enregistrer une campagne marketing comme un événement de changement, puis utiliser l'interface utilisateur de suivi des changements pour analyser son effet sur les performances du système via des graphiques.
Pour enregistrer le déploiement et d'autres types d'événements de changement, utilisez la mutation NerdGraph changeTrackingCreateEvent. Pour plus d'informations sur l'utilisation de NerdGraph, reportez-vous à Introduction à NerdGraph.
Tous les types de New Relic utilisateur peuvent utiliser NerdGraph pour créer un événement de changement, mais seule la plateforme utilisateur complète peut accéder aux expériences d'interface utilisateur de suivi des changements organisées.
suivi des changements événement mutation
Utilisez la mutation changeTrackingCreateEvent pour créer un événement de changement en fournissant son attribut obligatoire et facultatif.
Important
Les événements de modification créés à l'aide de la mutation changeTrackingCreateEvent ne sont actuellement pas affichés dans la mosaïque de déploiement du résumé APM et dans la fonctionnalité Transaction 360 lors de sa préversion publique. Ces événements sont prévus pour apparaître dans les deux GA.
Attributs
Type de données
Description
category
Chaîne
Un attribut category vous permet de catégoriser les modifications à l'aide de divers categories et types. Vous pouvez soit utiliser nos catégories et types standards prédéfinis, soit définir vos propres catégories et types personnalisés.
Vous devez définir l'attribut categoryFields sur Deployment.
Ce champ deployment doit inclure un version.
Si vous définissez category sur Feature flag:
Vous devez définir l'attribut categoryFields sur Feature flag.
Ce champ featureFlag doit inclure un featureFlagId.
Pour utiliser les catégories personnalisées :
Dans l'attribut dataHandlingRules, définissez le champ validationFlags sur ALLOW_CUSTOM_CATEGORY_OR_TYPE.
type
Chaîne
L'attribut type fournit une distinction supplémentaire pour un événement de changement, souvent utilisé en conjonction avec category. Par exemple, si category d'un événement est Deployment, son type peut être Rolling.
Vous pouvez utiliser une norme prédéfinie type généralement associée à une norme category ou définir une norme type personnalisée. Si vous définissez un type personnalisé, vous devez également :
Configurez l'attribut dataHandlingRules.
Définissez l'attribut validationFlags sur ALLOW_CUSTOM_CATEGORY_OR_TYPE.
version
Chaîne
Si l'attribut
category
est défini sur
Deployment
, alors dans l'attribut
categoryFields
, vous devez définir un champ
deployment
et vous assurer que ce champ
deployment
inclut un
version
.
featureFlagId
Chaîne
Si vous sélectionnez
Feature flag
comme catégorie, sous l'attribut
categoryFields
, vous devez également sélectionner
featureFlag
et inclure un
featureFlagId
. Ce
id
peut être n’importe quelle chaîne par laquelle vous souhaitez identifier votre indicateur de fonctionnalité.
dataHandlingRules
Chaîne
Lorsque vous définissez un category personnalisé, type ou une combinaison non standard de category et type, vous devez configurer l'attribut dataHandlingRules. Cette action est couplée à la définition de l'attribut validationFlags sur ALLOW_CUSTOM_CATEGORY_OR_TYPE.
Si validationFlags n'est pas défini sur ALLOW_CUSTOM_CATEGORY_OR_TYPE lors de l'utilisation de telles valeurs personnalisées ou non standard, New Relic renverra une erreur si une valeur category ou type ne correspond pas exactement à une valeur standard prédéfinie. Par exemple, même si vous utilisez un category standard tel que Deployment, l'associer à un type custom tel que Rainbow qui n'est pas une combinaison standard New Relic nécessite de définir validationFlags sur ALLOW_CUSTOM_CATEGORY_OR_TYPE et de configurer dataHandlingRules.
Conseil
Lorsque validationFlags est défini sur ALLOW_CUSTOM_CATEGORY_OR_TYPE, assurez-vous que les valeurs de chaîne que vous fournissez pour votre attribut personnalisé category ou type utilisent la casse exacte que vous souhaitez voir dans l'interface utilisateur de New Relic.
entitySearchquery
Chaîne
L'attribut de recherche d'entité vous permet de trouver une entité spécifique dans New Relic. Vous pouvez effectuer une recherche en utilisant son entité spécifique GUID ou en fournissant d'autres informations d'identification si le entityGuid est inconnu. Un entityGuid est un identifiant unique que New Relic attribue à vos composants système tels que des applications ou des microservices lors de leur instrumentation ou de leur configuration. Pour plus d'informations sur l'entité, reportez-vous à Entité New Relic.
requête d'entité spécifique : vous pouvez rechercher une correspondance exacte ou floue sur divers attributs, notamment id et name, mais votre requête doit être suffisamment spécifique pour se résoudre à une seule entité.
Opérateurs pris en charge : =, AND, IN et LIKE sont des opérateurs pris en charge pour la requête de recherche d'entité.
Utilisation de caractères spéciaux : les caractères spéciaux tels que (, .,, ;, :, *,-, _ et ) sont traités comme des espaces dans la chaîne de requête. Par exemple, une requête comme name LIKE ':aws:' correspondra aux noms d'entités contenant -aws ou foo.aws.
tag : vous pouvez référencer un tag avec ou sans guillemets inversés. Vous pouvez filtrer l'entité en fonction des entités par défaut properties et tags.
Entité par défaut properties:
id
accountId
name
domainId
alertSeverity
reporting
indexedAt
firstIndexedAt
lastReportingChangeAt
Tags: les balises sont des métadonnées généralement liées à un domainType ou à un groupe de domainTypes plus spécifique. Par exemple:
language: Spécifie la langue de l'agent pour les applications APM
clusterAgentId: Pour les applications Browser, cette tag est liée à l'agent cluster de l'application APM associée.
aws.accountId: Le AWS account ID pour le moniteur d'entité infrastructure d'AWS.
Exemples :
Pour trouver une entité par son GUID : "id = '<entity guid>'"
Pour rechercher une entité à l'aide de son identifiant d'application API REST v2 : "domainId = '<app id>' AND domain = 'APM'"
Pour trouver un service OpenTelemetry : "name = '<service name>' AND domain = 'EXT' AND type = 'SERVICE' AND accountId = '<account id>'"
Vous pouvez définir des attributs facultatifs et utiles pour ajouter du contexte au changement que vous suivez. Ces attributs peuvent également permettre certaines fonctionnalités de suivi des changements.
Paramètres
Type de données
Description
description
Chaîne
Une description du suivi des changements événement. Par exemple:
A change event to track the marketing campaign impact.
groupId
Chaîne
Un attribut groupId vous permet d'organiser les modifications associées sur une ou plusieurs entités. En utilisant le même groupId pour chaque modification associée, vous pouvez facilement visualiser ces modifications ensemble dans les interfaces New Relic ou affiner les résultats de la requête. Vous pouvez également utiliser le même groupId pour ajouter des modifications à un groupe existant.
CONSEIL
New Relic recommande d'utiliser l'attribut groupId lors de la réalisation de plusieurs mises à jour sur une ou plusieurs entités ou de la mise en œuvre de diverses modifications sur votre système.
shortDescription
Chaîne
Une brève description pour chaque changement vous permet d'identifier rapidement l'événement de changement envoyé à New Relic. Si ce champ est laissé vide, une description générée automatiquement est créée, incluant l'entité, l'utilisateur et la version. La brève description apparaît dans les zones suivantes :
Dans le marqueur indicateur sous forme d'info-bulle, lorsque vous survolez un marqueur de changement sur le graphique.
Dans les panneaux Activity stream.
user
Chaîne
Identification de l'utilisateur ou adresse email valide. Par exemple, utilisateur :
datanerd@example.com
.
changelog
Chaîne
Si
category
est défini sur
Deployment
, vous pouvez éventuellement inclure des informations
changelog
.
commit
Chaîne
Si
category
est défini sur
Deployment
, vous pouvez éventuellement inclure des informations
commit
telles qu'un
commit SHA
.
deepLink
Chaîne
Si
category
est défini sur
Deployment
, vous pouvez éventuellement inclure
deepLink
comme URL.
New Relic définit automatiquement les attributs timestamp et changeTrackingId. Vous pouvez modifier la valeur timestamp. cependant, le changeTrackingId doit être unique et est toujours généré par New Relic.
Paramètres
Type de données
Description
horodatage
EpochMilliseconds
L'attribut timestamp indique quand un appel NerdGraph a été reçu. Vous pouvez le modifier en spécifiant le nombre de millisecondes depuis l'époque Unix. Par exemple : timestamp: 1032480000000.
Important
L'horodatage doit être appliqué dans les +/- 24 heures suivant l'heure actuelle à laquelle l'appel NerdGraph est effectué, sinon les frais seront rejetés.
changeTrackingId
Chaîne
Le changeTrackingId est un identifiant unique généré lorsqu'une modification est enregistrée. Vous pouvez utiliser cet ID dans les requêtes NerdGraph et NRQL pour identifier des modifications spécifiques. Par exemple : changeTrackingId: "8a3a594c-e726-4bc2-8078-26dffec9a3d8".
Vous pouvez définir votre attribut personnalisé sous forme de paires valeur clé pour ajouter des métadonnées supplémentaires pour modifier l'événement.
Paramètres
Type de données
Description
customAttributes
Objet
Un champ customAttributes est spécifié sous forme de paires key-value au format d'objet JavaScript, où les valeurs peuvent être de type string, boolean ou number. Les nombres JavaScript sont stockés sous forme de valeurs Java long ou double. Contrairement à .JSON, les clés des objets JavaScript ne sont pas entre guillemets. Pour ajouter un attribut personnalisé, structurez-le comme suit :
customAttributes: {key_name : "value_name"}
Pour éviter les conflits de noms avec les noms d'attributs par défaut et les mots-clés NRQL, les noms d'attributs personnalisés suivants sont restreints :
accountId
ago
and
appID
as
auto
begin
begintime
category
categoryType
changeTrackingId
compare
customAttributes
customType
day
days
description
end
endtime
entity.domain
entity.guid
entity.name
entity.type
entityGuid
entityName
explain
eventType
facet
from
fb.input
groupId
hostname
hour
hours
in
is
like
limit
log
minute
minutes
month
months
not
null
offset
or
plugin.type
raw
second
seconds
select
since
timeseries
timestamp
type
until
user
week
weeks
where
with
Exemples de mutations
Les exemples suivants montrent les mutations NerdGraph, avec leurs attributs obligatoires et facultatifs, pour créer des marqueurs de suivi :
Comment visualiser et analyser vos modifications dans New Relic
La page Détails fournit des fonctionnalités similaires pour les modifications non liées au déploiement comme pour les modifications de type déploiement. Pour plus d'informations, reportez-vous à Afficher et analyser vos modifications.
changement de requête événement en utilisant NRQL
Vous pouvez interroger l'événement de modification en utilisant NRQL et NerdGraph pour analyser et visualiser les modifications. Voici quelques exemples de requêtes que vous pouvez utiliser :
But
NRQL/NerdGraph
Qequête
Pour obtenir le changement d'événement de la semaine dernière
NRQL
SELECT*FROM ChangeTrackingEvent SINCE 1 week ago
Pour comparer les erreurs de transaction aux marqueurs de modification d'une application pour le mois dernier
NRQL
SELECTcount(*)
FROM TransactionError
WHERE appName ='INSERT_YOUR_APP_NAME'AND http.statusCode >300
SINCE 1month ago TIMESERIES
Pour répertorier un ensemble d'événements sur tous les comptes au cours de la dernière heure
NerdGraph
{
actor{
changeTracking{
changeTrackingSearch{
changeEvents{
shortDescription
category
type
changeTrackingId
customAttributes
description
groupId
timestamp
type
user
}
}
}
}
}
Pour filtrer les données d'événement de modification par