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 de façon organisée les informations qui vous intéressent. 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 de Firestore en mode Datastore définit les détails spécifiques de ce qui est classé comme 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 permettant de calculer les taux d'erreur en calculant le ratio A/B pour api/request_count des requêtes valides avec les codes d'erreur 4xx ou 5xx, en comparaison avec le 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 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 afin d'être informé en cas de modification d'une condition de métrique. 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, dans lequel nous créons une règle d'alerte de latence. La La règle d'alerte vérifie la latence P99 sur une fenêtre glissante de 5 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 Request Latencies (Latences des requêtes) dans la ressource Consumed API (API Consumed).

  4. Ajoutez un filtre de service pour datastore.googleapis.com. La métrique api/request_latencies est surveillée sur la période glissante de 5 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 Types 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 min).

    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 plus d'exemples d'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'