Osservabilità in Cloud Tasks

Google Cloud Observability fornisce strumenti di monitoraggio, logging e diagnostica. Questi strumenti possono aiutarti a monitorare e analizzare l'attività e la crescita di Cloud Tasks , nonché a comprendere il comportamento, l'integrità e il rendimento delle tue applicazioni.

Per impostazione predefinita, Cloud Tasks è configurato per eseguire le seguenti operazioni:

  • Invia i log di controllo dei dati e del sistema a Cloud Logging. Puoi utilizzare i log raccolti per eseguire il debug, risolvere i problemi e ottenere informazioni sulle tue applicazioni.
  • Invia le metriche di sistema e delle risorse a Cloud Monitoring. Puoi utilizzare le metriche raccolte per monitorare l'integrità e il rendimento, identificare tendenze e problemi, e ricevere notifiche in caso di modifiche del comportamento.

Invia audit log a Cloud Logging

Cloud Tasks invia i seguenti tipi di dati di audit log a Cloud Logging:

Gli audit log di accesso ai dati sono disabilitati per impostazione predefinita perché questi audit log possono essere abbastanza grandi.

Per ulteriori informazioni, consulta Audit logging di Cloud Tasks.

Utilizza Cloud Logging con le code

Puoi utilizzare Cloud Logging con le code di Cloud Tasks. Vengono registrate le seguenti operazioni:

  • Operazioni sulle attività:
    • CreateTask
    • DeleteTask
  • Operazioni sui tentativi:
    • AttemptDispatch
    • AttemptResponse

Abilita il logging

Puoi abilitare il logging utilizzando la Google Cloud console o Google Cloud CLI.

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Tasks > Code.

    Vai a Code

  2. Fai clic sul nome della coda per cui vuoi abilitare il logging.

  3. Nella pagina Dettagli coda, fai clic sulla scheda Log.

  4. Fai clic su Abilita log e, per confermare, fai clic su Abilita.

    screenshot

gcloud

Per abilitare il logging, puoi utilizzare il gcloud tasks queues create o il gcloud tasks queues update comando.

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

o

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

Sostituisci quanto segue:

  • QUEUE_ID: l'ID della coda
  • LOG_SAMPLING_RATIO: la frazione delle operazioni registrate. Qualsiasi valore compreso tra 1.0 e 0.0 registra la frazione di operazioni. Per registrare tutte le operazioni, impostalo su 1.0. Per non registrare alcuna operazione, impostalo su 0.0 (valore predefinito).

Disabilita il logging

Puoi disabilitare il logging utilizzando la Google Cloud console o Google Cloud CLI.

Console

  1. Nella Google Cloud console, vai alla pagina Cloud Tasks > Code.

    Vai a Code

  2. Fai clic sul nome della coda per cui vuoi disabilitare il logging.

  3. Nella pagina Dettagli coda, fai clic sulla scheda Log.

  4. Fai clic sull'icona con i puntini di sospensione > Disabilita log. Per confermare, fai clic su Disabilita.

    screenshot

gcloud

Per disabilitare il logging, utilizza il gcloud tasks queues update comando e imposta il log-sampling-ratio flag su 0.0.

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

Sostituisci QUEUE_ID con l'ID della coda.

Esegui query e visualizza i log

Puoi utilizzare i seguenti strumenti per visualizzare e analizzare i log:

  • Esplora log è progettato per aiutarti a risolvere i problemi e analizzare il rendimento dei tuoi servizi e delle tue applicazioni. Per scoprire come visualizzare i log in Esplora log, segui le istruzioni riportate in Visualizza i log utilizzando Esplora log.
  • Analisi dei log è progettato per eseguire query per analizzare i log, quindi visualizzare o rappresentare graficamente i risultati. Per scoprire come utilizzare Analisi dei log, segui le istruzioni riportate in Esegui query e analizza i log con Analisi dei log.

Puoi filtrare i log di Cloud Tasks in Esplora log cercando cloudtasks nel campo di ricerca.

Per ulteriori informazioni sull'esecuzione di query e sull'analisi dei log, consulta la panoramica Esegui query e visualizza i log.

Invia metriche a Cloud Monitoring

Cloud Tasks invia i dati delle metriche dalle risorse monitorate a Google Cloud Observability. Una risorsa monitorata in Monitoring rappresenta un' entità logica o fisica, ad esempio una macchina virtuale, un database o un' applicazione. Le risorse monitorate contengono un insieme univoco di metriche che possono essere esplorate, segnalate tramite una dashboard o utilizzate per creare avvisi.

Cloud Tasks invia i dati delle metriche dalla seguente risorsa monitorata a Google Cloud Observability:

Ogni risorsa ha anche un insieme di etichette delle risorse, ovvero coppie chiave-valore che contengono informazioni aggiuntive sulla risorsa. Le etichette delle risorse sono disponibili per tutte le metriche associate alla risorsa e sono descritte in dettaglio nella tabella seguente.

Metriche e etichette delle risorse

Le stringhe "tipo di metrica" in questa tabella devono essere precedute dal prefisso con cloudtasks.googleapis.com/. Questo prefisso è stato omesso dalle voci della tabella. Quando esegui una query su un'etichetta, utilizza il metric.labels. prefisso; per esempio, metric.labels.LABEL="VALUE".

Tipo di metrica Fase di lancio (livelli della gerarchia delle risorse)
Nome visualizzato
Tipo, Unità
Risorse monitorate		 Descrizione
Etichette
api/request_count GA  (progetto)
Richieste API
DELTA, INT64, 1
cloud_tasks_queue 		Conteggio delle chiamate API Cloud Tasks. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 240 secondi.
api_method: il metodo API chiamato (ad es. CreateTask).
response_code: codice di risposta canonico come stringa (ad es. "ok").
queue/depth GA  (progetto)
Profondità coda
GAUGE, INT64, 1
cloud_tasks_queue 		Il numero di attività nella coda. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.
queue/task_attempt_count GA  (progetto)
Conteggio tentativi di attività
DELTA, INT64, 1
cloud_tasks_queue 		Conteggio dei tentativi di attività suddivisi per codice di risposta. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 180 secondi.
response_code: codice di risposta canonico come stringa (ad es. "ok").
queue/task_attempt_delays GA  (progetto)
Ritardi nei tentativi di attività
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Ritardo tra l'ora di ogni tentativo pianificato e l'ora effettiva del tentativo. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.

Tabella generata il 26/02/2026 alle 23:38:29 UTC.

Per visualizzare tutti i tipi di risorse, consulta Tipi di risorse monitorate. Per visualizzare tutti i tipi di metriche, consulta Google Cloud metriche.

Lettura dei dati delle metriche

Puoi leggere i dati delle metriche, chiamati anche dati delle serie temporali, utilizzando il timeSeries.list metodo nell'API Cloud Monitoring. Esistono diversi modi per chiamare il metodo, ad esempio utilizzando una libreria client specifica per il linguaggio o creando un grafico con Esplora metriche. Per un'introduzione alle metriche e alle serie temporali, consulta Metriche, serie temporali e risorse. Per scoprire come leggere i dati delle metriche, consulta Recupera i dati delle serie temporali.

Utilizza le dashboard e gli avvisi di Monitoring

Puoi utilizzare le dashboard di Monitoring e i relativi grafici per visualizzare i dati delle metriche di Cloud Tasks.

Per monitorare queste metriche in Monitoring, puoi creare dashboard personalizzate. Puoi anche aggiungere avvisi basati su queste metriche.