Cloud Logging per pratica

Puoi accedere ai log degli eventi per le tue integrazioni da Google Cloud Logging. Utilizza Cloud Logging per esplorare i log, creare metriche e avvisi o esportare i log in altre applicazioni utilizzando Google Cloud Pub/Sub.

Access Logging

Per accedere a Cloud Logging da Google Cloud Console, fai clic su Visualizza tutti i prodotti, quindi vai a Operazioni > Logging.

Vai a Cloud Logging

L'accesso ai dati di logging viene gestito tramite Identity and Access Management (IAM) per gli utenti del tuo progetto Azioni. Per maggiori dettagli su ruoli e autorizzazioni per i dati di logging, consulta controllo dell'accesso di Cloud Logging.

Le voci di log vengono conservate per 30 giorni in base ai criteri di conservazione di Cloud Logging, dopodiché vengono programmate per l'eliminazione. Puoi anche eliminare le voci on demand utilizzando l'interfaccia di Logs Explorer.

Puoi scoprire di più su come utilizzare i log in modo efficace nella sezione Ricerca nei log della Guida alla risoluzione dei problemi.

Cloud Logging fornisce i seguenti tipi di risorse:

Tipo di risorsa Nome visualizzato Descrizione Etichette
assistant_action_project Progetto di azione dell'Assistente Google Un contenitore per il progetto Google Cloud associato a un'azione dell'assistente.
  • project_id: l'identificatore del tuo progetto attuale associato a questa risorsa, ad esempio my-project.

Log di esecuzione

La tabella seguente elenca lo schema di una voce executionLog:

Proprietà Descrizione
requestId ID richiesta univoco, ad esempio 5325511189174727525.
latencyMsec Tempo trascorso prima della ricezione di una risposta, ad esempio, 6000.
executionType Trasporto utilizzato per la richiesta, ad esempio CLOUD o MATTER, a seconda dell'integrazione.
actionType Indicatore facoltativo dell'azione utente intrapresa, ad esempio QUERY o EXECUTE. Per le azioni EXECUTE, include il comando emesso per l'evasione per le caratteristiche supportate, ad esempio ONOFF_OFF
trait Tratto facoltativo associato a questa azione dell'utente.
deviceTypes Elenco dei tipi di dispositivi interessati dall'evento, ad esempio LIGHT.
isSuccess Se la richiesta ha ricevuto una risposta positiva.
fallbackToCloud Indica se la richiesta è stata instradata all'evasione sul cloud in seguito a un errore dell'evasione locale.
statusType Indica lo stato della risposta all'intent, ad esempio SUCCESS, PENDING o OFFLINE. Per le risposte ERROR, questa proprietà contiene l'errorCode fornito dall'evasione.
externalDebugString Messaggio di debug dettagliato facoltativo associato a questa azione dell'utente.
locale Codice lingua associato alla richiesta.

Esclusioni dei log

Gli sviluppatori possono creare esclusioni dei log utilizzando il linguaggio di query di Logging per personalizzare ulteriormente i log in modo più flessibile. Il linguaggio di query di Logging viene utilizzato anche da Esplora log, quindi puoi utilizzare Esplora log per creare query.

Puoi seguire i passaggi per creare filtri di esclusione in questa guida (configura il filtro di esclusione per il sink _Default).

Metriche basate su log

Gli sviluppatori possono utilizzare le metriche basate sui log per monitorare e analizzare i pattern all'interno dei log. È anche possibile creare grafici personalizzati e configurare avvisi per le metriche basate su log.

Per iniziare a utilizzare le metriche basate su log per la smart home, consulta la guida alla creazione di una metrica basata su log di tipo contatore.

Per saperne di più sull'utilizzo di Cloud Logging nel tuo progetto, consulta la seguente documentazione:

  • Prezzi: Dettagli su quote e costi per superamento.
  • Quote e limiti: Dettagli sui limiti e sulle norme di conservazione per l'utilizzo di Logging.
  • Query avanzate sui log: Guida all'utilizzo di espressioni avanzate per eseguire query e analizzare i dati dei log.