Utiliser le tableau de bord Cloud Monitoring

Cette page explique comment utiliser le tableau de bord Cloud Monitoring pour afficher les métriques disponibles, créer un tableau de bord personnalisé et définir des alertes.

Afficher les métriques Firestore en mode Datastore

Pour afficher les différentes métriques de Firestore en mode Datastore et créer des graphiques, utilisez l'explorateur de métriques dans Cloud Monitoring de la console Google Cloud. Pour en savoir plus sur la création de graphiques, consultez Créer des graphiques avec l'explorateur de métriques.

Configurer un tableau de bord Cloud Monitoring

Dans Cloud Monitoring, les tableaux de bord personnalisés vous permettent d'afficher les informations qui vous intéressent de manière organisée. Par exemple, vous pouvez créer un tableau de bord pour afficher les métriques de performances et les règles d'alerte de votre projet dans votre environnement de production.

Pour en savoir plus sur la configuration d'un tableau de bord personnalisé, consultez les pages Gérer un tableau de bord personnalisé et Ajouter des widgets au tableau de bord.

Surveiller les taux d'erreurs

Vous pouvez créer un tableau de bord de surveillance pour surveiller les taux d'erreur et assurer la disponibilité de votre base de données. La disponibilité correspond au taux auquel votre base de données répond dans un délai prévu avec un code d'état indiquant la réussite. Le Contrat de niveau de service Firestore en mode Datastore définit les détails spécifiques de ce qui est classé comme une requête valide.

Le taux d'erreur est déterminé en divisant le nombre de requêtes ayant entraîné une réponse d'erreur par le nombre total de requêtes envoyées.

Vous pouvez créer un exemple de tableau de bord pour calculer les taux d'erreur en calculant le ratio A/B pour api/request_count des requêtes valides avec des codes d'erreur 4xx ou 5xx par rapport à api/request_count de toutes les requêtes valides.

Comprendre la disponibilité avec le taux d'erreur
Figure 1. Comprendre la disponibilité avec le taux d'erreur

La figure 1 montre comment visualiser le ratio du taux d'erreur à l'aide des métriques api/request_count dans l'explorateur de métriques.

Créer une règle d'alerte

Cloud Monitoring vous permet de créer des alertes pour vous avertir lorsqu'une condition de métrique change. Vous pouvez utiliser ces alertes pour être informé des problèmes potentiels avant qu'ils n'affectent vos utilisateurs.

Pour en savoir plus sur la création d'alertes, consultez Créer des règles d'alerte basées sur un seuil de métrique.

Prenons l'exemple suivant, où nous créons une règle d'alerte de latence. La règle d'alerte vérifie la latence P99 sur une période glissante de cinq minutes. Si la latence p99 reste supérieure à 250 ms pendant cinq minutes, une alerte est déclenchée.

Console

  1. Dans la console Google Cloud, accédez à la page Monitoring (Surveillance), puis sélectionnez  Alerting (Alertes).

    Accéder à Monitoring

  2. Sélectionnez Créer une règle.

  3. Sélectionnez la métrique Latences des requêtes dans la ressource API consommée.

  4. Ajoutez un filtre de service pour datastore.googleapis.com. La métrique api/request_latencies est surveillée sur une période glissante de cinq minutes.

    Sélectionnez la métrique api/request_latencies pour créer un déclencheur.
    Figure 2 : Sélectionnez la métrique api/request_latencies pour créer un déclencheur.

  5. Cliquez sur Suivant pour configurer le déclencheur.

  6. Sélectionnez Seuil comme Type de condition.

    Une condition de seuil est définie sur une valeur de seuil de 250 ms. Une alerte est déclenchée lorsque la valeur de latence p99 reste la même pendant toute la période de la fenêtre glissante (5 minutes).

    Ajoutez le seuil de la métrique.
    Figure 3. Ajoutez le seuil de la métrique.

  7. Définissez la valeur du seuil sur 250.

  8. Cliquez sur Suivant pour configurer les notifications.

  9. Définissez le nom de la règle d'alerte, puis cliquez sur Suivant.

  10. Vérifiez les configurations des alertes, puis cliquez sur Créer une règle.

MQL

Vous pouvez implémenter la même règle d'alerte de latence à l'aide d'une requête MQL (Monitoring Query Language). Pour en savoir plus sur l'utilisation de MQL, consultez la section Exemples de requêtes MQL.

      fetch consumed_api
      | metric 'serviceruntime.googleapis.com/api/request_latencies'
      | filter (resource.service == 'firestore.googleapis.com')
      | group_by 5m,
          [value_request_latencies_percentile:
            percentile(value.request_latencies, 99)]
      | every 5m
      | condition val() > 0.25 's'