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, poi vai a Operazioni > Logging.
L'accesso ai dati di logging viene gestito tramite Identity and Access Management (IAM) per gli utenti del progetto Actions. Per ulteriori dettagli su ruoli e autorizzazioni per la registrazione dei dati, consulta il controllo dell'accesso di Cloud Logging.
Le voci dei log vengono conservate per 30 giorni in base ai criteri di conservazione di Cloud Logging, dopodiché viene pianificata la loro eliminazione. Puoi anche eliminare le voci su richiesta utilizzando l'interfaccia di Explorer dei log.
Puoi scoprire di più su come utilizzare i log in modo efficace nella 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 contenitore per il progetto Google Cloud associato a un'azione dell'assistente. |
|
Log eventi
I progetti Cloud-to-cloud supportano i seguenti eventi in Cloud logging:
| Risorsa Cloud Logging | Evento |
|---|---|
| Progetto di azione dell'Assistente Google | Errori di intent SYNC |
| Errori relativi all'intent QUERY | |
| Errori dell'intent EXECUTE | |
| Errori relativi alle notifiche | |
| Errori di collegamento dell'account | |
| SDK Local Home HandlerError |
Log di sincronizzazione
La tabella seguente elenca lo schema di una voce syncLog:
| Proprietà | Descrizione |
|---|---|
requestId |
ID richiesta di intent per la smart home. |
httpLatencyMsec |
Tempo trascorso prima della ricezione di una risposta. |
status |
Indica lo stato della risposta all'intent. |
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 |
Il protocollo di 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 utente. |
deviceTypes |
Elenco dei tipi di dispositivi interessati dall'evento, ad esempio
LIGHT. |
isSuccess |
Indica se la richiesta ha ricevuto una risposta positiva. |
fallbackToCloud |
Indica se la richiesta è stata instradata all'evasione in cloud a seguito di 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 il errorCode fornito dall'erogazione.
|
externalDebugString |
Messaggio di debug dettagliato facoltativo associato a questa azione utente. |
locale |
Codice lingua associato alla richiesta. |
Log delle notifiche
La tabella seguente elenca lo schema di una voce notificationLog:
| Proprietà | Descrizione |
|---|---|
requestId |
ID richiesta di notifica. |
structName |
Nome della struttura di notifica, ad esempio "ObjectDetection". |
status |
Indica lo stato della notifica. |
Impostazione del livello di log
Per impostazione predefinita, i progetti Cloud-to-cloud sono impostati per ricevere i log di errore e gli sviluppatori possono attivare la ricezione anche dei log di successo. Questa opzione è particolarmente utile durante la fase di sviluppo quando prevedi di acquisire tutti i log di alcuni agenti. Potrebbero essere applicati costi aggiuntivi al tuo progetto se superi la quota di logging.
Puoi controllare il livello di log per il tuo progetto:
In Actions on Google Console, vai alla pagina Progetti.
Seleziona il tuo progetto per la smart home.
Scegli la scheda Sviluppa e fai clic su Azioni nella barra laterale.
Seleziona Tutti nell'elenco a discesa Importazione del controllo log.
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, pertanto puoi utilizzare questo strumento per creare query.
Puoi seguire i passaggi per creare filtri di esclusione riportati in questa guida
(configura il filtro di esclusione per il sink _Default).
Metriche basate su log
Gli sviluppatori possono utilizzare Metriche basate sui log per monitorare e analizzare i pattern all'interno dei log. È anche possibile creare grafici personalizzati e impostare avvisi in base alle 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 del contatore.
Risorse correlate
Per scoprire di più sull'utilizzo di Cloud Logging nel tuo progetto, consulta la seguente documentazione:
- Prezzi: dettagli su quote e costi per eccedenza.
- Quote e limiti: dettagli su limiti e criteri di conservazione per l'utilizzo dei log.
- Query sui log avanzate: guida all'utilizzo di espressioni avanzate per eseguire query e analizzare i dati dei log.