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 le prestazioni delle tue applicazioni.

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

  • Invia i dati e gli audit log di 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 per le variazioni di comportamento.

Inviare gli audit log a Cloud Logging

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

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

Per ulteriori informazioni, consulta Log di controllo di Cloud Tasks.

Utilizzare Cloud Logging con le code

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

  • Operazioni sulle attività:
    • CreateTask
    • DeleteTask
  • Tentativi di operazione:
    • AttemptDispatch
    • AttemptResponse

Abilita il logging

Puoi attivare la registrazione utilizzando la console Google Cloud o Google Cloud CLI.

Console

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

    Vai a Code di attesa

  2. Fai clic sul nome della coda per cui vuoi attivare la registrazione.

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

  4. Fai clic su Attiva i log e, per confermare, fai clic su Attiva.

    screenshot

gcloud

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

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 quella frazione di operazioni. Per registrare tutte le operazioni, impostalo su 1.0. Per non registrare alcuna operazione, impostalo su 0.0 (l'impostazione predefinita).

Disattivare il logging

Puoi disattivare la registrazione utilizzando la console Google Cloud o Google Cloud CLI.

Console

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

    Vai a Code di attesa

  2. Fai clic sul nome della coda per cui vuoi disattivare la registrazione.

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

  4. Fai clic sull'icona dei tre puntini > Disattiva log. Per confermare, fai clic su Disattiva.

    screenshot

gcloud

Per disattivare il logging, utilizza il comando gcloud tasks queues update e imposta il flag log-sampling-ratio 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

Per visualizzare e analizzare i log, puoi utilizzare i seguenti strumenti:

  • 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 e visualizzare o rappresentare i risultati in un grafico. Per scoprire come utilizzare Analisi dei log, segui le istruzioni riportate in Eseguire query e analizzare 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 su come eseguire query e analizzare i log, consulta Panoramica delle query e della visualizzazione dei log.

Inviare metriche a Cloud Monitoring

Cloud Tasks invia i dati delle metriche dalle risorse monitorate a Google Cloud Observability. Una risorsa monitorata in Monitoraggio rappresenta un'entità logica o fisica, ad esempio una macchina virtuale, un database o un'applicazione. Le risorse monitorate contengono un insieme unico di metriche che possono essere esplorate, registrate 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, 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 nella tabella seguente.

Metriche ed etichette delle risorse

Le stringhe "tipo metrica" in questa tabella devono essere precedute dal prefisso cloudtasks.googleapis.com/. Questo prefisso è stato omesso dalle voci della tabella. Quando esegui una query su un'etichetta, utilizza il prefisso metric.labels., ad 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  (project)
Richieste API
DELTA, INT64, 1
cloud_tasks_queue 		Numero di chiamate all'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 sotto forma di stringa (ad es. "ok").
queue/depth GA  (project)
Profondità coda
GAUGE, INT64, 1
cloud_tasks_queue 		Il numero di attività in 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  (project)
Numero di tentativi di attività
DELTA, INT64, 1
cloud_tasks_queue 		Numero di 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 sotto forma di stringa (ad es. "ok").
queue/task_attempt_delays GA  (project)
Ritardi dei tentativi di esecuzione dell'attività
DELTA, DISTRIBUTION, ms
cloud_tasks_queue 		Ritardo tra ogni ora di tentativo pianificata e l'ora di tentativo effettiva. Campionamento eseguito ogni 60 secondi. Dopo il campionamento, i dati non sono visibili per un massimo di 120 secondi.

Tabella generata il 24-01-2025 alle ore 16:56:52 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 metodotimeSeries.list 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 Metrics Explorer. Per un'introduzione alle metriche e alle serie temporali, consulta Metriche, serie temporali e risorse. Per scoprire come leggere i dati delle metriche, consulta Recupero dei dati delle serie temporali.

Utilizzare le dashboard e gli avvisi di monitoraggio

Puoi utilizzare le dashboard di monitoraggio e i relativi grafici associati per visualizzare i dati relativi alle metriche di Cloud Tasks.

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