Puoi accedere ai log eventi delle integrazioni da Google Cloud Logging Usa Cloud Logging per esplorare i log, creare metriche e avvisi oppure ed esportare i log in altre applicazioni Google Cloud Pub/Sub.
Logging degli accessi
Per accedere a Cloud Logging dal Google Cloud Console, fai clic su Visualizza tutti i prodotti e poi su Operazioni > Logging.
L'accesso ai dati di logging è gestito tramite Identity and Access Management (IAM) per gli utenti del tuo progetto Actions. Per maggiori dettagli su ruoli e autorizzazioni per i dati di logging, consulta Cloud Logging controllo dell'accesso.
Le voci di log vengono conservate per 30 giorni in base ai dati di Cloud Logging criteri di conservazione, ne è stata pianificata l'eliminazione. Puoi anche eliminare le voci on demand utilizzando Interfaccia di Esplora log.
Per saperne di più su come utilizzare i log in modo efficace, consulta la 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 assistente Azione. |
|
Log eventi
Cloud-to-cloud progetti supportano i seguenti eventi in Cloud Logging:
| Risorsa Cloud Logging | Evento |
|---|---|
| Progetto di azione dell'Assistente Google | Errori di intent SYNC |
| Errori di intent QUERY | |
| ESEGUI errori di intent | |
| Notifiche errori | |
| Collegamento dell'account errori | |
| SDK Local Home HandlerError . |
Sincronizzare i log
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 di 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 che una risposta ricevesse 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 eseguita dall'utente, ad esempio
QUERY o EXECUTE.
Per le azioni EXECUTE, include il comando emesso per
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 |
Se la richiesta ha ricevuto una risposta positiva. |
fallbackToCloud |
Se la richiesta è stata indirizzata al fulfillment Cloud a seguito di un errore dalla distribuzione locale. |
statusType |
Indica lo stato della risposta di intent, ad esempio SUCCESS,
PENDING o OFFLINE. Per ERROR
risposte, questa proprietà contiene
il valore errorCode fornito dal fulfillment.
|
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 dello struct di notifica, ad esempio "ObjectDetection". |
status |
Indica la stato della notifica. |
Impostazione del livello di log
Cloud-to-cloud progetti sono impostati per ricevere log degli errori per impostazione predefinita, e gli sviluppatori possono attivare anche la ricezione dei log di operazione riuscita. Ciò è particolarmente utile durante la fase di sviluppo, quando prevedi di acquisire con tutti i log di alcuni agenti. Potrebbero essere applicati costi aggiuntivi al tuo progetto se supera il 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 Sviluppo e fai clic su Azioni nella barra laterale.
Seleziona Tutto nell'elenco a discesa Importazione controllo log.
Esclusioni dei log
Gli sviluppatori possono creare esclusioni di log usando query di logging lingua per personalizzare ulteriormente i log in modo più flessibile. Linguaggio di query di Logging viene utilizzato anche da Esplora log per utilizzarlo per creare query.
Puoi seguire la procedura per creare filtri di esclusione all'indirizzo
questa guida
(configura il filtro di esclusione per il sink _Default).
Metriche basate su log
Gli sviluppatori possono utilizzare Metriche basate su log per monitorare e analizzare i pattern all'interno dei loro log. È inoltre possibile creare grafici personalizzati e configurare gli avvisi. sulle metriche basate su log.
Per iniziare a utilizzare le metriche basate su log per la smart home, consulta creazione di una guida alle metriche dei contatori basate su log.
Risorse correlate
Per saperne di più sull'uso di Cloud Logging nel tuo progetto, consulta quanto segue 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 sui log: Guida all'utilizzo delle espressioni avanzate per eseguire query e analizzare i dati dei log.