Observabilité dans Cloud Tasks

Google Cloud Observability vous permet de surveiller et d'analyser l'activité de Cloud Tasks, la croissance des files d'attente et le comportement d'exécution. 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 les 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 ils peuvent être volumineux.

Pour en savoir plus, consultez Journaux 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 consignées :

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

Activer la journalisation

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

Console

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

    Accéder à la page "Files d'attente"

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

  3. Sur la page Détails de la file d'attente, cliquez sur l'onglet Journaux.

  4. Cliquez sur Activer les journaux, puis sur 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 consignées. Toute valeur comprise entre 1.0 et 0.0 consigne cette fraction d'opérations. Pour consigner toutes les opérations, définissez-le sur 1.0. Pour ne consigner aucune opération, définissez-le sur 0.0 (valeur par défaut).

Désactiver la journalisation

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

Console

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

    Accéder à la page "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 Détails de la file d'attente, cliquez sur l'onglet Journaux.

  4. Cliquez sur l'icône de points de suspension > Désactiver les journaux. Pour confirmer, cliquez sur Désactiver.

    capture d'écran

gcloud

Pour désactiver la journalisation, utilisez la commande gcloud tasks queues update 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 d'afficher les résultats ou de les représenter sous forme de graphique. Pour apprendre à utiliser l'Analyse de l'observabilité, suivez les instructions de la page Interroger et analyser des 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 Présentation de l'interrogation et de l'affichage des journaux.

Envoyer des métriques à Monitoring

Cloud Tasks envoie les données de métriques 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 les données de métriques de la ressource surveillée suivante à Google Cloud Observability :

Chaque ressource possède également un ensemble d'étiquettes de ressource, 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 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 : appel de méthode d'API (par exemple, CreateTask).
response_code : code de réponse canonique sous forme de chaîne (par exemple, "ok").
queue/depth GA(projet)
Profondeur de 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âche
DELTA, INT64, 1
cloud_tasks_queue 		Nombre de tentatives de tâches, ventilé 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élais des tentatives 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 22-10-2026 à 02:44:18 UTC.

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

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, par exemple en utilisant une bibliothèque cliente spécifique à un langage ou en créant un graphique avec l'explorateur de métriques. Pour en savoir plus sur les métriques et les séries temporelles, consultez Métriques, séries temporelles et ressources. Pour savoir comment lire vos données de métriques, consultez 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.