Observabilité dans Cloud Tasks

Google Cloud Observability fournit des outils de surveillance, de journalisation et de diagnostic Ces outils peuvent vous aider à surveiller et à analyser l'activité et la croissance de Cloud Tasks , ainsi qu'à comprendre le comportement, l'état et les performances de vos applications.

Par défaut, Cloud Tasks est configuré pour effectuer les opérations suivantes :

  • Envoyer des données et des journaux d'audit système à Cloud Logging. Vous pouvez utiliser les journaux collectés pour déboguer, résoudre les problèmes et obtenir des insights sur vos applications.
  • Envoyer des métriques système et de ressources à Cloud Monitoring. Vous pouvez utiliser les métriques collectées pour surveiller l'état et les performances, identifier les tendances et les problèmes, et signaler les changements de comportement.

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 relatifs à l'accès aux données sont désactivés par défaut, car ces journaux d'audit peuvent être assez conséquents.

Pour en savoir plus, consultez la section Journalisation d'audit de 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 journalisées :

  • Opérations de tâche :
    • CreateTask
    • DeleteTask
  • Opérations de tentative :
    • 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 journalisées. La définition d'une valeur comprise entre 1.0 et 0.0 journalise cette fraction d' opérations. Pour journaliser toutes les opérations, définissez la valeur sur 1.0. Pour ne journaliser aucune opération, définissez la valeur 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 découvrir 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 journaux 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 découvrir comment utiliser l'analyse de journaux, suivez les instructions de la section Interroger et analyser les journaux avec l'analyse de journaux.

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 à Cloud Monitoring

Cloud Tasks envoie des données de métriques provenant de 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, présentées dans 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 possède également un ensemble de libellés de ressources, qui sont des paires clé/valeur qui contiennent des informations supplémentaires sur la ressource. Les libellés de ressources sont disponibles pour toutes les métriques associées à la ressource et sont détaillés dans le tableau suivant.

Métriques et libellés de ressources

Les chaînes "Type de métrique" de ce tableau doivent être précédées du préfixe cloudtasks.googleapis.com/. Ce préfixe a été omis dans les entrées du tableau. Lorsque vous interrogez une étiquette, utilisez le préfixe metric.labels. (par exemple, metric.labels.LABEL="VALUE").

Type de métrique Étape de lancement (Niveaux de la hiérarchie des ressources)
Nom à afficher
Genre, type, unité
Ressources surveillées		 Description
Libellés
api/request_count GA  (projet)
Requêtes API
DELTA, INT64, 1
cloud_tasks_queue 		Nombre d'appels d'API Cloud Tasks. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 240 secondes.
api_method : méthode API appelée (par exemple, "CreateTask").
response_code : code de réponse canonique sous forme de chaîne (par exemple, « ok »).
queue/depth GA  (projet)
Profondeur de la file d'attente
GAUGE, INT64, 1
cloud_tasks_queue 		Nombre de tâches dans la file d'attente. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 120 secondes.
queue/task_attempt_count GA  (projet)
Nombre de tentatives de tâches
DELTA, INT64, 1
cloud_tasks_queue 		Nombre de tentatives de tâches divisé par code de réponse. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 180 secondes.
response_code : code de réponse canonique sous forme de chaîne (par exemple, « ok »).
queue/task_attempt_delays GA  (projet)
Délai de tentative de tâche
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Délai entre chaque heure de tentative planifiée et l'heure de tentative réelle. Échantillonné toutes les 60 secondes. Après échantillonnage, les données ne sont pas visibles pendant un délai pouvant atteindre 120 secondes.

Tableau généré le 2026-02-26 23:38:29 UTC.

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 timeSeries.list méthode dans 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 lire une présentation des métriques et des séries temporelles, consultez la section Métriques, séries temporelles et ressources. Pour découvrir 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.