Gérer un simple moniteur de navigateur

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
`accountId`	Entier	Oui	Votre identifiant de compte New Relic sur lequel le moniteur sera créé.
`monitor.browsers`	Array	Oui	Browser(s) que le moniteur utilisera pour exécuter les tâches. Navigateurs pris en charge : `CHROME` , `EDGE` , `FIREFOX` .
`monitor.devices`	Array	Oui	Dispositifs que le système de monitoring utilisera pour exécuter les tâches. Appareils pris en charge : `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`monitor.locations.public`	Array	Oui	éventail d'identifiants publics d'emplacement où le moniteur effectuera des vérifications (par exemple, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Chaîne	Oui	Nom d'affichage de votre simple moniteur de navigateur.
`monitor.period`	Énumération	Oui	Fréquence d'exécution du moniteur. Options : `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Chaîne	Oui	Le type d'exécution utilisé par votre moniteur. `CHROME_BROWSER` est la seule valeur acceptée.
`monitor.runtime.runtimeTypeVersion`	Chaîne	Oui	La version du type d'exécution utilisée par votre moniteur. `100` est la seule valeur acceptée.
`monitor.runtime.scriptLanguage`	Chaîne	Oui	La langue utilisée par votre moniteur. `JAVASCRIPT` est la seule valeur acceptée.
`monitor.status`	Énumération	Oui	État du moniteur. Options : `ENABLED` (le moniteur est actif et effectue des vérifications), `DISABLED` (le moniteur est inactif).
`monitor.uri`	Chaîne	Oui	L'URL à monitorer (par exemple, `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objet	Non	En-têtes HTTP personnalisés à inclure dans la requête. Chaque en-tête possède une propriété `name` et `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	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é.
`monitor.advancedOptions.responseValidationText`	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.
`monitor.advancedOptions.useTlsValidation`	Booléen	Non	Faut-il valider le protocole TLS/certificat SSL ? Définissez la valeur à `true` pour vérifier la validité de la chaîne SSL du certificat.
`monitor.apdexTarget`	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
`guid`	Chaîne	Oui	L'identifiant unique GUID de l'entité du moniteur que vous souhaitez mettre à jour.
`monitor.browsers`	Array	Non	Browser(s) que le moniteur utilisera pour exécuter les tâches. Navigateurs pris en charge : `CHROME` , `EDGE` , `FIREFOX` .
`monitor.devices`	Array	Non	Dispositifs que le système de monitoring utilisera pour exécuter les tâches. Appareils pris en charge : `DESKTOP` , `MOBILE_LANDSCAPE` , `MOBILE_PORTRAIT` , `TABLET_LANDSCAPE` , `TABLET_PORTRAIT` .
`monitor.locations.public`	Array	Non	éventail d'identifiants publics d'emplacement où le moniteur effectuera des vérifications (par exemple, `["US_EAST_1", "US_WEST_1"]` ).
`monitor.name`	Chaîne	Non	Le nom d'affichage mis à jour pour votre simple moniteur de navigateur.
`monitor.period`	Énumération	Non	Fréquence d'exécution du moniteur. Options : `EVERY_MINUTE` , `EVERY_5_MINUTES` , `EVERY_10_MINUTES` , `EVERY_15_MINUTES` , `EVERY_30_MINUTES` , `EVERY_HOUR` , `EVERY_6_HOURS` , `EVERY_12_HOURS` , `EVERY_DAY` .
`monitor.runtime.runtimeType`	Chaîne	Non	Le type d'exécution utilisé par votre moniteur. `CHROME_BROWSER` est la seule valeur acceptée.
`monitor.runtime.runtimeTypeVersion`	Chaîne	Non	La version du type d'exécution utilisée par votre moniteur. `100` est la seule valeur acceptée.
`monitor.runtime.scriptLanguage`	Chaîne	Non	La langue utilisée par votre moniteur. `JAVASCRIPT` est la seule valeur acceptée.
`monitor.status`	Énumération	Non	État du moniteur. Options : `ENABLED` (le moniteur est actif et effectue des vérifications), `DISABLED` (le moniteur est inactif).
`monitor.uri`	Chaîne	Non	L'URL à monitorer (par exemple, `https://example.com` ).
`monitor.advancedOptions.customHeaders`	Objet	Non	En-têtes HTTP personnalisés à inclure dans la requête. Chaque en-tête possède une propriété `name` et `value` .
`monitor.advancedOptions.enableScreenshotOnFailureAndScript`	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é.
`monitor.advancedOptions.responseValidationText`	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.
`monitor.advancedOptions.useTlsValidation`	Booléen	Non	Faut-il valider le protocole TLS/certificat SSL ? Définissez la valeur à `true` pour vérifier la validité de la chaîne SSL du certificat.
`monitor.apdexTarget`	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 moniteur de navigateur pour utiliser le nouvel environnement d'exécution Chrome 100+. Cela garantit que votre moniteur utilise les dernières fonctionnalités du navigateur et les mises à jour de sécurité.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`guid`	Chaîne	Oui	L'identifiant unique GUID de l'entité du moniteur que vous souhaitez mettre à niveau.
`monitor.runtime.runtimeType`	Chaîne	Oui	Le type d'exécution. `CHROME_BROWSER` est la seule valeur acceptée.
`monitor.runtime.runtimeTypeVersion`	Chaîne	Oui	La version d'exécution. `100` est la seule valeur acceptée.
`monitor.runtime.scriptLanguage`	Chaîne	Oui	Le langage de script. `JAVASCRIPT` est la seule valeur acceptée.

Demande d'échantillon

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: {
        runtimeType: "CHROME_BROWSER"
        runtimeTypeVersion: "100"
        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é.

Rétrograder la durée d'exécution d'un simple moniteur de navigateur

Vous pouvez rétrograder un simple moniteur de navigateur pour utiliser un environnement d'exécution legacy. Cela peut s'avérer nécessaire pour des raisons de compatibilité, mais veuillez noter que legacy environnements d'exécution ne seront plus pris en charge le 22 octobre 2024.

Important

Les environnements d'exécution hérités sont obsolètes et leur fin de vie est prévue pour le 22 octobre 2024. Le retour à des environnements d' legacy n'est pas recommandé, sauf pour des besoins de compatibilité temporaires.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`guid`	Chaîne	Oui	L'identifiant unique GUID de l'entité du moniteur que vous souhaitez rétrograder.
`monitor.runtime.runtimeType`	Chaîne	Oui	Définissez la valeur sur une chaîne vide `""` pour utiliser l'ancien environnement d' legacy.
`monitor.runtime.runtimeTypeVersion`	Chaîne	Oui	Définissez la valeur sur une chaîne vide `""` pour utiliser l'ancien environnement d' legacy.
`monitor.runtime.scriptLanguage`	Chaîne	Oui	Définissez la valeur sur une chaîne vide `""` pour utiliser l'ancien environnement d' legacy.

Demande d'échantillon

mutation {
  syntheticsUpdateSimpleBrowserMonitor(
    guid: "ENTITY_GUID"
    monitor: {
      runtime: { runtimeType: "", runtimeTypeVersion: "", scriptLanguage: "" }
    }
  ) {
    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 rétrogradation 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.

Cette traduction automatique est fournie pour votre commodité.

Gérer un simple moniteur de navigateur

Créer un simple moniteur de navigateur .css-21sua1{background:none;border:none;width:0;padding:0;}

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Mettre à jour un simple moniteur de navigateur

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Mettre à niveau le runtime d'un simple moniteur de navigateur

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Rétrograder la durée d'exécution d'un simple moniteur de navigateur

Important

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Supprimer un simple moniteur de navigateur

Créer un simple moniteur de navigateur