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, et à 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 des 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:
- 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 pour l'accès aux données sont désactivés par défaut, car ils peuvent être volumineux.
Pour en savoir plus, consultez la section Journalisation d'audit Cloud Tasks.
Utiliser Cloud Logging avec les 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 :
CreateTaskDeleteTask
- Opérations de tentative :
AttemptDispatchAttemptResponse
Activer la journalisation
Vous pouvez activer la journalisation à l'aide de la console Google Cloud ou de Google Cloud CLI.
Console
Dans la console Google Cloud, accédez à la page Cloud Tasks > Files d'attente.
Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez activer la journalisation.
Sur la page Détails de la file d'attente, cliquez sur l'onglet Journaux.
Cliquez sur Activer les journaux, puis sur 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 consignées. Toute valeur comprise entre1.0et0.0journalise cette fraction d'opérations. Pour journaliser toutes les opérations, définissez-le sur1.0. Pour ne consigner 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 console Google Cloud ou de Google Cloud CLI.
Console
Dans la console Google Cloud, accédez à la page Cloud Tasks > Files d'attente.
Cliquez sur le nom de la file d'attente pour laquelle vous souhaitez désactiver la journalisation.
Sur la page Détails de la file d'attente, cliquez sur l'onglet Journaux.
Cliquez sur l'icône des points de suspension > Désactiver les journaux. Pour confirmer, cliquez sur Désactiver.
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.
- Log Analytics est conçu pour exécuter des requêtes afin d'analyser vos journaux, puis d'afficher ou de représenter les résultats sous forme de graphiques. 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 les données de métriques des ressources surveillées à Google Cloud Observability. Dans Monitoring, une ressource surveillée 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 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
(project)
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
(project)
Nombre d'essais de tâche |
|
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
(project)
Délais d'exécution 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 24/01/2025 à 16:56:52 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 section 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 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 à la langue ou en créant un graphique avec l'explorateur de métriques. Pour obtenir 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étrique, 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.