Puoi accedere ai log 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.
Logging degli accessi
Per accedere a Cloud Logging da Google Cloud Console, fai clic su Visualizza tutti i prodotti, quindi vai a Operazioni > Logging.
L'accesso ai dati di logging è gestito tramite Identity and Access Management (IAM) per gli utenti del 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 vengono pianificate per l'eliminazione. Puoi anche eliminare le voci on demand utilizzando l'interfaccia Esplora log.
Per saperne di più su come utilizzare i log in modo efficace, 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. |
|
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 di intent di QUERY | |
| EXECUTE errori di intent | |
| Errori relativi alle notifiche | |
| Errori di collegamento dell'account | |
| SDK Home locale HandlerError |
Sincronizza log
La tabella seguente elenca lo schema di una voce syncLog:
| Proprietà | Descrizione |
|---|---|
requestId |
ID richiesta 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 |
Trasporto utilizzato per la richiesta, ad esempio CLOUD o
MATTER, a seconda dell'integrazione. |
actionType |
Indicatore facoltativo dell'azione dell'utente intrapresa, 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 è stata instradata a Cloud fulfillment a seguito di un errore del fulfillment locale. |
statusType |
Indica lo stato della risposta all'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. |
Log delle notifiche
La tabella seguente elenca lo schema di una voce notificationLog:
| Proprietà | Descrizione |
|---|---|
requestId |
ID richiesta di notifica. |
structName |
Nome dello struct di notifica, ad esempio "ObjectDetection". |
status |
Indica lo stato della notifica. |
Impostazione livello di log
I progetti Cloud-to-cloud sono impostati per ricevere i log degli errori per impostazione predefinita e gli sviluppatori possono anche attivare la ricezione dei log delle operazioni riuscite. Questa operazione è particolarmente utile durante la fase di sviluppo, quando prevedi di acquisire tutti i log da alcuni agenti. Se superi la quota di logging, potrebbero essere applicati costi aggiuntivi al progetto.
Puoi controllare il livello di log per il tuo progetto nei seguenti modi:
In Actions on Google Console, vai alla pagina Progetti.
Seleziona il progetto per la smart home.
Scegli la scheda Sviluppo e fai clic su Azioni nella barra laterale.
Seleziona Tutti nell'elenco a discesa Importazione del controllo dei log.
Esclusioni dei log
Gli sviluppatori possono creare esclusioni dei log utilizzando il linguaggio delle 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 la procedura 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 su log per monitorare e analizzare i pattern all'interno dei loro log. Puoi inoltre creare grafici personalizzati e impostare 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.
Risorse correlate
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 di espressioni avanzate per eseguire query e analizzare i dati dei log.