Cloud Logging per pratica

Puoi accedere ai log eventi per le 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.

Logging degli accessi

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

Vai a Cloud Logging

L'accesso ai dati di logging è gestito tramite Identity and Access Management (IAM) per gli utenti del tuo progetto Actions. Per ulteriori dettagli sui ruoli e sulle autorizzazioni per il logging dei dati, consulta il controllo dell'accesso di Cloud Logging.

Le voci di log vengono conservate per 30 giorni in base al criterio di conservazione di Cloud Logging, quindi ne vengono pianificate l'eliminazione. Puoi anche eliminare le voci on demand utilizzando l'interfaccia Esplora log.

Per saperne di più su come utilizzare in modo efficace i log, consulta la sezione Ricerca dei 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 container per il progetto Google Cloud associato a un'azione dell'assistente.
  • project_id: l'identificatore del 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 intrapresa dall'utente, ad esempio QUERY o EXECUTE. Per le azioni EXECUTE, include il comando inviato al fulfillment per i trait supportati, ad esempio ONOFF_OFF
trait Trait facoltativo associato a questa azione utente.
deviceTypes Elenco dei tipi di dispositivi interessati dall'evento, ad esempio LIGHT.
isSuccess Indica se la richiesta ha ricevuto una risposta corretta.
fallbackToCloud Indica se la richiesta è instradata a Cloud fulfillment in seguito a un errore del fulfillment locale.
statusType Indica lo stato della risposta dell'intent, ad esempio SUCCESS, PENDING o OFFLINE. Per le risposte ERROR, questa proprietà contiene il valore errorCode fornito dal fulfillment.
externalDebugString Messaggio facoltativo di debug dettagliato associato a questa azione dell'utente.
locale Codice lingua associato alla richiesta.

Esclusioni dei log

Gli sviluppatori possono creare esclusioni di 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 in modo da poter utilizzare Esplora log per creare query.

Puoi seguire i passaggi per creare i 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 su log per monitorare e analizzare i pattern all'interno dei loro log. È anche possibile creare grafici personalizzati e configurare avvisi sulle metriche basate su log.

Per iniziare a utilizzare le metriche basate su log per la smart home, consulta la guida alla creazione di una guida alle metriche dei contatori basate su log.

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

  • Prezzi: dettagli su allocazioni e costi per il superamento della soglia.
  • Quote e limiti: dettagli sui limiti e sui criteri di conservazione per l'utilizzo del logging.
  • Query avanzate dei log: guida all'utilizzo delle espressioni avanzate per eseguire query e analizzare i dati dei log.