Observabilité dans Cloud Tasks

Google Cloud Observability vous permet de surveiller et d'analyser l' activité, la croissance des files d'attente et le comportement d'exécution de Cloud Tasks. Vous pouvez évaluer l'état de l'application, diagnostiquer les échecs de tâches et résoudre les problèmes de performances à l'aide des métriques et des journaux collectés.

Par défaut, Cloud Tasks envoie des métriques système et de ressources à Cloud Monitoring et exporte les journaux d'audit des activités d'administration vers Cloud Logging. Les journaux d'audit des accès aux données sont désactivés par défaut et nécessitent une configuration explicite.

Envoyer des journaux d'audit à Cloud Logging

Cloud Tasks envoie les types de données de journaux d'audit suivants à Cloud Logging :

Les journaux d'audit des accès aux données sont désactivés par défaut, car ces journaux d'audit peuvent être volumineux.

Pour en savoir plus, consultez la section Journalisation d'audit Cloud Tasks.

Utiliser Cloud Logging avec des files d'attente

Vous pouvez utiliser Cloud Logging avec les files d'attente Cloud Tasks. Les opérations suivantes sont enregistrées :

  • Opérations sur les tâches :
    • CreateTask
    • DeleteTask
  • Opérations sur les tentatives :
    • AttemptDispatch
    • AttemptResponse

Activer la journalisation

Vous pouvez activer la journalisation à l'aide de la Google Cloud console ou de la Google Cloud CLI.

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).

    Accéder aux files d'attente

  2. Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez activer la journalisation.

  3. Sur la page Queue details (Détails de la file d'attente), cliquez sur l'onglet Logs (Journaux).

  4. Cliquez sur Enable logs (Activer les journaux), puis sur Enable (Activer) pour confirmer.

    capture d'écran

gcloud

Pour activer la journalisation, vous pouvez utiliser la commande gcloud tasks queues create ou gcloud tasks queues update.

gcloud tasks queues create QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATION

ou

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=LOG_SAMPLING_RATIO

Remplacez les éléments suivants :

  • QUEUE_ID : ID de votre file d'attente
  • LOG_SAMPLING_RATIO: fraction des opérations enregistrées. Toute valeur comprise entre 1.0 et 0.0 enregistre cette fraction d'opérations. Pour enregistrer toutes les opérations, définissez-la sur 1.0. Pour n'enregistrer aucune opération, définissez-la sur 0.0 (valeur par défaut).

Désactiver la journalisation

Vous pouvez désactiver la journalisation à l'aide de la Google Cloud console ou de la Google Cloud CLI.

Console

  1. Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).

    Accéder aux files d'attente

  2. Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez désactiver la journalisation.

  3. Sur la page Queue details (Détails de la file d'attente), cliquez sur l'onglet Logs (Journaux).

  4. Cliquez sur l'icône en forme de points de suspension > Disable logs (Désactiver les journaux). Pour confirmer, cliquez sur Disable (Désactiver).

    capture d'écran

gcloud

Pour désactiver la journalisation, utilisez la gcloud tasks queues update commande et définissez l'option log-sampling-ratio sur 0.0.

gcloud tasks queues update QUEUE_ID \
    --log-sampling-ratio=0.0

Remplacez QUEUE_ID par l'ID de votre file d'attente.

Interrogation et affichage des journaux

Vous pouvez utiliser les outils suivants pour afficher et analyser vos journaux :

  • L'explorateur de journaux est conçu pour vous aider à résoudre les problèmes et à analyser les performances de vos services et applications. Pour savoir comment afficher les journaux dans l'explorateur de journaux, suivez les instructions de la section Afficher les journaux à l'aide de l'explorateur de journaux.
  • L'analyse de l'observabilité est conçue pour exécuter des requêtes afin d'analyser vos journaux, puis afficher les résultats ou les représenter sous forme de graphique. Pour savoir comment utiliser l'analyse de l'observabilité, suivez les instructions de la section Interroger et analyser les journaux avec l'analyse de l'observabilité.

Vous pouvez filtrer les journaux Cloud Tasks dans l'explorateur de journaux en recherchant cloudtasks dans le champ de recherche.

Pour en savoir plus sur l'interrogation et l'analyse des journaux, consultez la section Présentation de l'interrogation et de l'affichage des journaux.

Envoyer des métriques à Monitoring

Cloud Tasks envoie des données de métriques provenant des ressources surveillées à Google Cloud Observability. Une ressource surveillée dans Monitoring représente une entité logique ou physique, telle qu'une machine virtuelle, une base de données ou une application. Les ressources surveillées contiennent un ensemble unique de métriques qui peuvent être explorées, signalées via un tableau de bord ou utilisées pour créer des alertes.

Cloud Tasks envoie des données de métriques provenant de la ressource surveillée suivante à Google Cloud Observability :

Chaque ressource comporte également un ensemble d'étiquettes de ressources, qui sont des paires clé/valeur contenant des informations supplémentaires sur la ressource. Les étiquettes de ressources sont disponibles pour toutes les métriques associées à la ressource et sont détaillées dans le tableau suivant.

Métriques et étiquettes de ressources

Pour afficher tous les types de ressources, consultez la section Types de ressources surveillées. Pour afficher tous les types de métriques, consultez la section Google Cloud Métriques.

Lire les données de métrique

Vous pouvez lire les données de métriques, également appelées données de séries temporelles, à l'aide de la méthode timeSeries.list de l'API Cloud Monitoring. Il existe plusieurs façons d'appeler la méthode, y compris en utilisant une bibliothèque cliente spécifique à un langage ou en créant un graphique avec l'explorateur de métriques. Pour une présentation des métriques et des séries temporelles, consultez la section Métriques, séries temporelles et ressources. Pour savoir comment lire vos données de métriques, consultez la section Récupérer des données de séries temporelles.

Utiliser les tableaux de bord et les alertes Monitoring

Les tableaux de bord Monitoring et les graphiques associés vous permettent de visualiser les données des métriques Cloud Tasks.

Pour surveiller ces métriques dans Monitoring, vous pouvez créer des tableaux de bord personnalisés. Vous pouvez également ajouter des alertes en fonction de ces métriques.