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 envoyer des notifications en cas de changement de comportement.
Envoyer des journaux d'audit à Cloud Logging
Cloud Tasks envoie les types de données de journaux d'audit suivants à Cloud Logging :
- Journaux d'audit pour les activités d'administration
- Journaux d'audit pour l'accès aux données
- Journaux d'audit d'événements système
- Journaux d'audit des refus de règles
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 enregistrées :
- Opérations de tâche :
CreateTaskDeleteTask
- Opérations de tentative :
AttemptDispatchAttemptResponse
Activer la journalisation
Vous pouvez activer la journalisation à l'aide de la Google Cloud console ou de la Google Cloud CLI.
Console
Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).
Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez activer la journalisation.
Sur la page Queue details (Détails de la file d'attente), cliquez sur l'onglet Logs (Journaux).
Cliquez sur Enable logs (Activer les journaux), puis sur Enable (Activer) pour confirmer.
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'attenteLOG_SAMPLING_RATIO: fraction des opérations enregistrées. Toute valeur comprise entre1.0et0.0enregistre cette fraction d'opérations. Pour enregistrer toutes les opérations, définissez-la sur1.0. Pour n'enregistrer aucune opération, définissez-la sur0.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
Dans la Google Cloud console, accédez à la page Cloud Tasks > Queues (Files d'attente).
Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez désactiver la journalisation.
Sur la page Queue details (Détails de la file d'attente), cliquez sur l'onglet Logs (Journaux).
Cliquez sur l'icône en forme de points de suspension > Disable logs (Désactiver les journaux). Cliquez sur Disable (Désactiver) pour confirmer.
gcloud
Pour désactiver la journalisation, utilisez la
gcloud tasks queues update
commande et définissez l'indicateur 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 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 découvrir 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 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, 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 de libellés de ressources, qui sont des paires clé/valeur contenant 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âche |
|
DELTA, INT64, 1
cloud_tasks_queue |
Nombre de tentatives de tâche, 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 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 10/04/2026 à 19:48:34 UTC.
Pour afficher tous les types de ressources, consultez la page Types de ressources surveillées. Pour afficher tous les types de métriques, consultez la page 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 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 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.