Gérer les moniteurs synthétiques

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Console

Pour lister les moniteurs synthétiques de votre projet Google Cloud, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Surveillance synthétique:

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

3. Facultatif: Pour limiter les moniteurs synthétiques répertoriés, ajoutez des filtres.

   Chaque filtre est composé d'un nom et d'une valeur. Vous pouvez définir la valeur comme étant une correspondance exacte ou une correspondance partielle d'un nom de moniteur synthétique. Les correspondances ne sont pas sensibles à la casse. Par exemple, pour répertorier tous les moniteurs synthétiques dont le nom contient default, procédez comme suit:

   • Cliquez sur Filter table (Filtrer le tableau), puis sélectionnez Display name (Nom à afficher).
   • Saisissez default, puis appuyez sur la touche retour.

   Si vous avez plusieurs filtres, ils sont automatiquement reliés par un opérateur logique AND, sauf si vous insérez un filtre OR. L'exemple précédent utilise le filtre OR de sorte qu'un test de disponibilité soit répertorié si son nom correspond à default ou Testing check.

La page Surveillance synthétique affiche les éléments suivants pour chaque surveillance synthétique:

• État de l'exécution la plus récente.
• Lien vers des informations détaillées sur ce moniteur synthétique.
• Le taux de réussite et le temps d'exécution moyen.
• Nombre de règles d'alerte.
• Pour modifier, copier ou supprimer le moniteur synthétique, et pour créer une règle d'alerte, utilisez le menu more_vert Plus d'options.

gcloud

Pour lister vos tests de disponibilité et vos moniteurs synthétiques, exécutez la commande gcloud monitoring uptime list-configs:

gcloud monitoring uptime list-configs --project=PROJECT_ID

Avant d'exécuter la commande précédente, remplacez les éléments suivants:

• PROJECT_ID: identifiant du projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

Les données renvoyées incluent les éléments suivants:

• Nom et nom à afficher.
• Vérifier l'identifiant
• Ressource surveillée.
• Période entre les vérifications.

Vous pouvez configurer la commande Google Cloud CLI pour filtrer et trier les résultats.

REST

Pour répertorier les moniteurs synthétiques de votre projet Google Cloud, y compris les vérifications de l'état de fonctionnement, appelez la méthode projects.uptimeCheckConfigs.list:

1. Cliquez sur projects.uptimeCheckConfigs.list.

2. Utilisez APIs Explorer.

   Définissez le parent de la méthode sur le nom du projet. Veillez à utiliser le format suivant:

   projects/PROJECT_ID
   

   Dans l'expression précédente, PROJECT_ID correspond à l'ID de votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

Pour un moniteur synthétique, le résultat contient un champ intitulé syntheticMonitor.

Console

Pour afficher les détails d'une surveillance synthétique dans votre projet Google Cloud, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Surveillance synthétique:

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

3. Pour ouvrir la page Détails de la surveillance synthétique, recherchez la surveillance synthétique que vous souhaitez afficher, puis cliquez sur son nom.

   Si vous souhaitez afficher votre fonction Cloud Run depuis la page Informations sur les fonctions fournie par les fonctions Cloud Run, sélectionnez l'onglet Code, puis cliquez sur le nom de la fonction. La page Informations sur les fonctions s'ouvre dans une nouvelle fenêtre. Les onglets de cette page vous permettent d'afficher des métriques, des journaux et des informations de configuration.

gcloud

Pour afficher les détails d'une vérification de l'état de fonctionnement ou d'un moniteur synthétique, exécutez la commande gcloud monitoring uptime describe:

gcloud monitoring uptime describe CHECK_ID --project=PROJECT_ID

Avant d'exécuter la commande précédente, remplacez les éléments suivants:

• PROJECT_ID: identifiant du projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
• CHECK_ID: identifiant de la vérification de la disponibilité ou de la surveillance synthétique. Vous pouvez trouver l'identifiant en exécutant la commande gcloud monitoring uptime list-configs et en examinant le champ name. Pour en savoir plus, consultez la section Trouver l'identifiant unique d'un moniteur synthétique.

Les données renvoyées pour le contrôle de l'état de fonctionnement incluent les éléments suivants:

• Nom et nom à afficher.
• Vérifier l'identifiant
• Ressource surveillée.
• Période entre les vérifications.

REST

Pour afficher les détails d'un moniteur synthétique spécifique dans votre projet Google Cloud, appelez la méthode projects.uptimeCheckConfigs.get:

1. Cliquez sur projects.uptimeCheckConfigs.get.

2. Utilisez APIs Explorer.

   Définissez le parent de la méthode sur l'identifiant du moniteur synthétique. Veillez à utiliser le format suivant:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Dans l'expression précédente:

   • PROJECT_ID correspond à votre ID de projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
   • CHECK_ID est l'ID du moniteur synthétique.

   Par exemple, la valeur du champ parent peut être:

   projects/my-project/uptimeCheckConfigs/10863117100295372627
   

   Pour trouver la valeur de CHECK_ID, vous pouvez émettre la méthode projects.uptimeCheckConfigs.list. Pour réduire le nombre de résultats renvoyés, incluez un filtre. Par exemple, ajoutez le filtre displayName="MySyntheticMonitor".

Console

Pour modifier un moniteur synthétique ou sa fonction Cloud Run à l'aide de la page Détails du moniteur synthétique, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Surveillance synthétique:

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
3. Recherchez le moniteur synthétique que vous souhaitez modifier, cliquez sur more_vert Plus d'options, puis sélectionnez Modifier.

4. Facultatif: Pour modifier la fonction Cloud Run, cliquez sur Modifier la fonction, apportez les modifications souhaitées, puis cliquez sur Appliquer la fonction.

   Pour les outils de vérification des liens brisés, pour modifier l'URI d'origine ou les options qui définissent les liens à tester, modifiez la fonction Cloud Run, puis mettez à jour l'objet options dans le fichier index.js. Pour en savoir plus sur les champs et la syntaxe de cet objet, consultez broken-links-ok/index.js.

5. Pour conserver vos modifications, cliquez sur Enregistrer. Sinon, cliquez sur Annuler.

gcloud

Pour modifier un test de disponibilité ou un moniteur synthétique, exécutez la commande gcloud monitoring uptime update:

gcloud monitoring uptime update CHECK_ID OPTIONAL_FLAGS --project=PROJECT_ID

Avant d'exécuter la commande précédente, remplacez les éléments suivants:

• PROJECT_ID: identifiant du projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

• CHECK_ID: identifiant de la vérification de la disponibilité ou du moniteur synthétique. Pour trouver l'identifiant, exécutez la commande gcloud monitoring uptime list-configs et examinez le champ name. Pour en savoir plus, consultez la section Trouver l'identifiant unique d'un test de disponibilité.

• Définissez les champs que vous souhaitez modifier. Pour les moniteurs synthétiques, vous ne pouvez modifier que les champs suivants:

  • Période
  • Nom à afficher
  • Délai avant expiration
  • Étiquettes utilisateur

Par exemple, pour définir la période d'un moniteur synthétique sur 10 minutes, exécutez la commande suivante:

gcloud monitoring uptime update CHECK_ID --period=10 --project=PROJECT_ID

REST

Les règles et fonctions d'alerte ne sont pas contenues dans un moniteur synthétique. Par conséquent, elles ne peuvent pas être modifiées par la procédure décrite dans cette section:

• Pour modifier une règle d'alerte, utilisez la console Google Cloud ou appelez la méthode alertPolicies.patch. Pour en savoir plus, consultez la page Gérer des règles d'alerte à l'aide d'API.

• Pour modifier une fonction Cloud Run, vous devez la redéployer après avoir mis à jour sa source. Pour en savoir plus, consultez la section Déployer une fonction Cloud Run.

Pour modifier un moniteur synthétique, appelez la méthode projects.uptimeCheckConfigs.patch:

1. Cliquez sur projects.uptimeCheckConfigs.patch.

2. Utilisez APIs Explorer.

   1. Définissez le parent de la méthode sur l'identifiant du moniteur synthétique. L'identifiant se présente sous le format suivant:

      projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
      

      Dans l'expression précédente:

      • PROJECT_ID est l'ID de votre projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
      • CHECK_ID est l'ID du moniteur synthétique.

      Pour trouver la valeur de CHECK_ID, vous pouvez émettre la méthode projects.uptimeCheckConfigs.list. Pour réduire le nombre de résultats renvoyés, incluez un filtre. Par exemple, ajoutez le filtre displayName="MySyntheticMonitor".

   2. Définissez le paramètre de requête de la méthode, updateMask, pour identifier les champs de l'objet qui sont modifiés. Par exemple, pour mettre à jour la valeur de displayName, le paramètre de requête est le suivant:

      updateMask=displayName
      

Console

Pour copier un moniteur synthétique dans votre projet Google Cloud, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Surveillance synthétique:

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

3. Recherchez le moniteur synthétique que vous souhaitez modifier, cliquez sur more_vert Autres options, puis sélectionnez Copier.

   La boîte de dialogue Copier la vérification synthétique s'ouvre avec des champs préremplis, y compris une copie de la fonction Cloud Run.

4. Cliquez sur Créer une fonction, mettez à jour la fonction si nécessaire, puis cliquez sur Appliquer la fonction.

5. Pour conserver vos modifications, cliquez sur Créer. Sinon, cliquez sur Annuler.

   Lorsque vous cliquez sur Créer, votre fonction Cloud Run est créée et déployée, puis le moniteur synthétique est créé.

gcloud

Aucune méthode Google Cloud CLI ne vous permet de copier un moniteur synthétique.

REST

Aucune méthode d'API ne vous permet de copier un moniteur synthétique. Toutefois, vous pouvez en créer une en procédant comme suit:

1. Appelez la méthode projects.uptimeCheckConfigs.get et enregistrez la réponse. Pour en savoir plus, consultez la section Afficher les détails d'une surveillance synthétique.
2. Modifiez la réponse.
3. Appelez la méthode projects.uptimeCheckConfigs.create et transmettez-lui la réponse modifiée.

Console

Pour supprimer un moniteur synthétique et les règles d'alerte associées, procédez comme suit:

1. Dans la console Google Cloud, accédez à la page  Surveillance synthétique:

   Accéder à Surveillance synthétique

   Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

2. Dans la barre d'outils de la console Google Cloud, sélectionnez votre projet Google Cloud. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.

3. Recherchez le moniteur synthétique que vous souhaitez supprimer, puis cliquez sur son nom.

4. Facultatif: Si vous souhaitez supprimer la fonction Cloud Run, sélectionnez l'onglet Code, puis cliquez sur le nom de la fonction. La page Informations sur les fonctions s'ouvre dans une nouvelle fenêtre.

5. Sur la page Détails du moniteur synthétique, cliquez sur delete Supprimer, puis remplissez la boîte de dialogue.

   Vous avez maintenant supprimé la surveillance synthétique.

6. Pour supprimer la fonction Cloud Run, accédez à la page Informations sur les fonctions, cliquez sur delete Supprimer, puis remplissez la boîte de dialogue.

gcloud

Pour supprimer un test de disponibilité ou un moniteur synthétique, exécutez la commande gcloud monitoring uptime delete:

gcloud monitoring uptime delete CHECK_ID  --project=PROJECT_ID

Avant d'exécuter la commande précédente, remplacez les éléments suivants:

• PROJECT_ID: identifiant du projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
• CHECK_ID: identifiant de la vérification de la disponibilité ou de la surveillance synthétique. Vous pouvez trouver l'identifiant en exécutant la commande gcloud monitoring uptime list-configs et en examinant le champ name. Pour en savoir plus, consultez la section Trouver l'identifiant unique d'un moniteur synthétique.

REST

Pour supprimer un moniteur synthétique et les règles d'alerte associées, appelez la méthode projects.uptimeCheckConfigs.delete:

1. Cliquez sur projects.uptimeCheckConfigs.delete.

2. Utilisez APIs Explorer.

   Définissez le parent de la méthode sur l'identifiant du moniteur synthétique. Veillez à utiliser le format suivant:

   projects/PROJECT_ID/uptimeCheckConfigs/CHECK_ID
   

   Dans l'expression précédente:

   • PROJECT_ID est l'ID de votre projet. Pour les configurations App Hub, sélectionnez le projet hôte App Hub ou le projet de gestion du dossier compatible avec les applications.
   • CHECK_ID est l'ID du moniteur synthétique.

   Pour trouver la valeur de CHECK_ID, vous pouvez émettre la méthode projects.uptimeCheckConfigs.list. Pour réduire le nombre de résultats renvoyés, incluez un filtre. Par exemple, ajoutez le filtre displayName="MySyntheticMonitor".