Osservabilità in Cloud Tasks

Google Cloud Observability ti consente di monitorare e analizzare l'attività di Cloud Tasks, la crescita delle code e il comportamento di esecuzione. Puoi valutare l'integrità dell'applicazione, diagnosticare gli errori delle attività e risolvere i problemi di prestazioni utilizzando le metriche e i 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.

Invia gli audit log a Cloud Logging

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

Gli audit log di controllo dell'accesso ai dati sono disattivati per impostazione predefinita perché possono essere piuttosto grandi.

Per saperne di più, 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 di tentativo:
    • AttemptDispatch
    • AttemptResponse

Abilita il logging

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

Console

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

    Vai a Code

  2. Fai clic sul nome della coda per cui vuoi attivare 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 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 (questa è l'impostazione predefinita).

Disabilita logging

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

Console

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

    Vai a Code

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

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

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

    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

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 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.
  • Observability Analytics è progettato per eseguire query per analizzare i log e poi visualizzare o tracciare i risultati. Per scoprire come utilizzare Observability Analytics, segui le istruzioni riportate in Esegui query e analizza i log con Observability Analytics.

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

Per saperne di più su come eseguire query e analizzare i log, consulta Panoramica delle query e della visualizzazione dei log.

Invia 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, 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

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

Lettura dei 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 il linguaggio o la creazione di 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 in base a queste metriche.