Osservabilità in Cloud Tasks

Google Cloud Observability consente di monitorare e analizzare l'attività di Cloud Tasks , la crescita della coda e il comportamento di esecuzione. Puoi valutare l'integrità dell'applicazione, diagnosticare gli errori delle attività e risolvere i problemi di prestazioni utilizzando metriche e log raccolti.

Per impostazione predefinita, Cloud Tasks invia le metriche di sistema e delle risorse a Cloud Monitoring ed esporta gli audit log delle attività di amministrazione in Cloud Logging. I log di controllo dell'accesso ai dati sono disattivati per impostazione predefinita e richiedono una configurazione esplicita.

Inviare gli audit log a Cloud Logging

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

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

Per ulteriori informazioni, consulta Audit logging di Cloud Tasks.

Utilizzare 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

Abilitare 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 (impostazione predefinita).

Disabilitare 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.

Eseguire query e visualizzare i log

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

  • Esplora log è progettato per aiutarti a risolvere i problemi e analizzare le prestazioni dei servizi e delle applicazioni. Per scoprire come visualizzare i log in Esplora log, segui le istruzioni riportate in Visualizzare i log utilizzando Esplora log.
  • Observability Analytics è progettato per eseguire query per analizzare i log, quindi visualizzare o rappresentare graficamente i risultati. Per scoprire come utilizzare Observability Analytics, segui le istruzioni riportate in Eseguire query e analizzare i log con Observability Analytics.

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 Panoramica delle query e della visualizzazione dei log.

Inviare le metriche a 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 ed 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, 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: la chiamata al metodo API (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 14/10/2026 alle 20:24:33 UTC.

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

Leggere i dati delle metriche

Puoi leggere i dati delle metriche, chiamati anche dati delle serie temporali, utilizzando il metodo timeSeries.list nell'API Cloud Monitoring. Esistono diversi modi per chiamare il metodo, tra cui l'utilizzo di una libreria client specifica per la lingua o per creare 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 Recuperare i dati delle serie temporali.

Utilizzare 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 in base a queste metriche.