New Relic vous permet d'utiliser NerdGraph pour créer un simple outil de monitoring de navigateur. Un simple moniteur de navigateur effectue des vérifications automatisées de vos applications Web, simulant une véritable interaction utilisateur en chargeant les pages dans un environnement de navigateur complet. Ce tutoriel fournit des exemples d'utilisation de l'API NerdGraph pour automatiser la création d'un simple outil de monitoring de navigateur.
Créer un simple moniteur de navigateur
Vous pouvez créer un simple moniteur de navigateur en utilisant la mutation syntheticsCreateSimpleBrowserMonitor.
Paramètres d'entrée
paramètres | Type de données | Est-ce obligatoire ? | Description |
|---|---|---|---|
| Entier | Oui | Votre New Relic sur lequel le moniteur sera créé. |
| Array | Oui | Navigateur(s) que le moniteur utilisera pour exécuter des tâches. Navigateurs pris en charge :
,
. |
| Array | Oui | Dispositifs que le système de monitoring utilisera pour exécuter les tâches. Appareils pris en charge :
,
,
,
,
. |
| Array | Oui | éventail d'identifiants où le moniteur effectuera des vérifications (par exemple,
). |
| Chaîne | Oui | Nom d'affichage de votre simple moniteur de navigateur. |
| Énumération | Oui | Fréquence d'exécution du moniteur. Options :
,
,
,
,
,
,
,
,
. |
| Chaîne | Oui | Le type d'exécution utilisé par votre moniteur.
est la seule valeur acceptée. |
| Chaîne | Oui | La version du type de runtime utilisée par votre monitor. Utilisez
pour utiliser automatiquement la version la plus récente de Chrome (recommandé). Des versions spécifiques plus anciennes comme
ou
sont également acceptées mais seront dépréciées. |
| Chaîne | Oui | La langue utilisée par votre moniteur.
est la seule valeur acceptée. |
| Énumération | Oui | État du moniteur. Options :
(le moniteur est actif et effectue des vérifications),
(le moniteur est inactif). |
| Chaîne | Oui | L'URL à monitorer (par exemple,
). |
| Objet | Non | En-têtes HTTP personnalisés à inclure dans la requête. Chaque en-tête possède une propriété
et
. |
| Booléen | Non | Capture une capture d'écran pendant l'exécution d'une tâche lorsqu'une panne survient ou qu'un script est exécuté. |
| Chaîne | Non | Texte qui doit figurer dans la réponse pour que le contrôle soit réussi. Si cette option est spécifiée, le moniteur échouera si ce texte est introuvable dans le corps de la réponse. |
| Booléen | Non | Faut-il valider le protocole TLS/certificat SSL ? Définissez la valeur à
pour vérifier la validité de la chaîne SSL du certificat. |
| Virgule flottante | Non | L'Apdex cible du moniteur en secondes, utilisé pour alimenter les rapports SLA. Par défaut, 7,0 secondes. |
Demande d'échantillon
mutation { syntheticsCreateSimpleBrowserMonitor( accountId: ACCOUNT_ID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } status: STATUS uri: "MONITORED_URI" advancedOptions: { customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" } enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT responseValidationText: "VALIDATION_TEXT" useTlsValidation: TLS_VALIDATION } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Exemple de réponse
Une réponse positive renvoie null en cas d'erreur :
{ "data": { "syntheticsCreateSimpleBrowserMonitor": { "errors": null } }}En cas de problème lors de la création du moniteur, le éventail errors contiendra des objets avec des champs description et type expliquant ce qui s'est mal passé.
Mettre à jour un simple moniteur de navigateur
Vous pouvez mettre à jour un moniteur de navigateur simple existant en utilisant la mutation syntheticsUpdateSimpleBrowserMonitor. Cela vous permet de modifier la configuration d'un simple moniteur de navigateur déjà créé.
Paramètres d'entrée
paramètres | Type de données | Est-ce obligatoire ? | Description |
|---|---|---|---|
| Chaîne | Oui | L'identifiant unique de l'entité du moniteur que vous souhaitez mettre à jour. |
| Array | Non | Navigateur(s) que le moniteur utilisera pour exécuter des tâches. Navigateurs pris en charge :
,
. |
| Array | Non | Dispositifs que le système de monitoring utilisera pour exécuter les tâches. Appareils pris en charge :
,
,
,
,
. |
| Array | Non | éventail d'identifiants où le moniteur effectuera des vérifications (par exemple,
). |
| Chaîne | Non | Le nom d'affichage mis à jour pour votre simple moniteur de navigateur. |
| Énumération | Non | Fréquence d'exécution du moniteur. Options :
,
,
,
,
,
,
,
,
. |
| Chaîne | Non | Le type d'exécution utilisé par votre moniteur.
est la seule valeur acceptée. |
| Chaîne | Non | La version du type de runtime utilisée par votre monitor. Utilisez
pour utiliser automatiquement la version la plus récente de Chrome (recommandé). Des versions spécifiques plus anciennes comme
ou
sont également acceptées mais seront dépréciées. |
| Chaîne | Non | La langue utilisée par votre moniteur.
est la seule valeur acceptée. |
| Énumération | Non | État du moniteur. Options :
(le moniteur est actif et effectue des vérifications),
(le moniteur est inactif). |
| Chaîne | Non | L'URL à monitorer (par exemple,
). |
| Objet | Non | En-têtes HTTP personnalisés à inclure dans la requête. Chaque en-tête possède une propriété
et
. |
| Booléen | Non | Capture une capture d'écran pendant l'exécution d'une tâche lorsqu'une panne survient ou qu'un script est exécuté. |
| Chaîne | Non | Texte qui doit figurer dans la réponse pour que le contrôle soit réussi. Si cette option est spécifiée, le moniteur échouera si ce texte est introuvable dans le corps de la réponse. |
| Booléen | Non | Faut-il valider le protocole TLS/certificat SSL ? Définissez la valeur à
pour vérifier la validité de la chaîne SSL du certificat. |
| Virgule flottante | Non | L'Apdex cible du moniteur en secondes, utilisé pour alimenter les rapports SLA. Par défaut, 7,0 secondes. |
Demande d'échantillon
mutation { syntheticsUpdateSimpleBrowserMonitor( guid: ENTITY_GUID monitor: { browsers: [BROWSERS] devices: [DEVICES] locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" period: PERIOD runtime: { runtimeType: "RUNTIME_TYPE" runtimeTypeVersion: "RUNTIME_TYPE_VERSION" scriptLanguage: "SCRIPT_LANGUAGE" } status: STATUS uri: "MONITORED_URI" advancedOptions: { customHeaders: { name: "HEADER_NAME", value: "HEADER_VALUE" } enableScreenshotOnFailureAndScript: ENABLE_SCREENSHOT responseValidationText: "VALIDATION_TEXT" useTlsValidation: TLS_VALIDATION } apdexTarget: APDEX_TARGET } ) { errors { description type } }}Exemple de réponse
Une réponse positive renvoie null en cas d'erreur :
{ "data": { "syntheticsUpdateSimpleBrowserMonitor": { "errors": null } }}En cas de problème lors de la mise à jour du moniteur, le éventail errors contiendra des objets avec des champs description et type expliquant ce qui s'est mal passé.
Mettre à niveau le runtime d'un simple moniteur de navigateur
Vous pouvez mettre à niveau un simple monitorer de navigateur pour utiliser le nouvel environnement d'exécution Chrome. Nous vous recommandons d'utiliser la version LATEST pour vous assurer que votre monitor reste automatiquement à jour avec les sorties de Chrome les plus récentes.
Important
Gestion des versions de Chrome: New Relic passe à un modèle de version LATEST pour les runtimes Chrome. Certaines versions spécifiques de Chrome (telles que 134 et 140) arriveront en fin de vie et seul LATEST sera maintenu à l'avenir. Le 18 août 2026, les outils pour monitorer qui sont encore sur d'anciennes versions de Chrome seront mis à jour de force vers la dernière version stable (Chrome 147 ou supérieure). Lors de la sortie d'une nouvelle version de Chrome, celle-ci sera disponible dans les moniteurs de navigateur simples en tant que LATEST dans un délai d'une semaine. Pour vous assurer que vos monitorer reçoivent automatiquement les dernières mises à jour et fonctionnalités de Chrome, mettez à niveau vers runtimeTypeVersion: "LATEST" avant cette date.
Paramètres d'entrée
paramètres | Type de données | Est-ce obligatoire ? | Description |
|---|---|---|---|
| Chaîne | Oui | L'identifiant unique de l'entité du moniteur que vous souhaitez mettre à niveau. |
| Chaîne | Oui | Le type d'exécution.
est la seule valeur acceptée. |
| Chaîne | Oui | La version du runtime. Utilisez
pour utiliser automatiquement la version la plus récente de Chrome (recommandé). Des versions spécifiques plus anciennes comme
ou
sont également acceptées mais seront dépréciées. |
| Chaîne | Oui | Le langage de script.
est la seule valeur acceptée. |
Demande d'échantillon
Mettez à niveau vers la DERNIÈRE version de Chrome (recommandé) :
mutation { syntheticsUpdateSimpleBrowserMonitor( guid: "ENTITY_GUID" monitor: { runtime: { runtimeType: "CHROME_BROWSER" runtimeTypeVersion: "LATEST" scriptLanguage: "JAVASCRIPT" } } ) { errors { description type } }}Exemple de réponse
Une réponse positive renvoie null en cas d'erreur :
{ "data": { "syntheticsUpdateSimpleBrowserMonitor": { "errors": null } }}En cas de problème lors de la mise à niveau de l'environnement d'exécution du moniteur, le éventail errors contiendra des objets avec des champs description et type expliquant ce qui s'est mal passé.
Supprimer un simple moniteur de navigateur
Lorsqu'un simple moniteur de navigateur n'est plus nécessaire, vous pouvez le supprimer définitivement à l'aide de la mutation syntheticsDeleteMonitor.
Pour supprimer un moniteur, référez-vous à la section Supprimer un moniteur Synthétique.