Você pode acessar os logs de eventos das suas integrações no Google Cloud Logging Use Cloud Logging para analisar registros, criar métricas e alertas ou exportar registros para outros aplicativos usando Google Cloud Pub/Sub:
Geração de registros de acesso
Para acessar Cloud Logging do Google Cloud Console, clique em Mostrar todos os produtos e acesse Operações > Geração de registros.
O acesso aos dados de registro é gerenciado pelo Identity and Access Management (IAM) para os usuários do seu projeto do Actions. Para mais detalhes sobre os papéis e as permissões de geração de registros, consulte o Cloud Logging controle de acesso.
As entradas de registro são mantidas por 30 dias pelo política de retenção e programados para exclusão. Também é possível excluir entradas sob demanda com o Interface da Análise de registros.
Saiba mais sobre como usar os registros de maneira eficaz na seção Como pesquisar registros do Guia de solução de problemas.
Cloud Logging fornece os seguintes tipos de recursos:
| Tipo de recurso | Nome de exibição | Descrição | Rótulos |
|---|---|---|---|
assistant_action_project |
Projeto de ação do Google Assistente | Um contêiner do projeto do Google Cloud associado a um Assistente Ação. |
|
Logs de eventos
Cloud-to-cloud projetos aceitam os seguintes eventos no Cloud Geração de registros:
| Recurso do Cloud Logging | Evento |
|---|---|
| Projeto de ação do Google Assistente | Erros de intent SYNC |
| Erros de intent QUERY | |
| Erros de intent EXECUTE | |
| Notificações erros | |
| Vinculação de contas erros | |
| SDK local do Google Home HandlerError |
Registros de sincronização
A tabela abaixo lista o esquema de uma entrada syncLog:
| Propriedade | Descrição |
|---|---|
requestId |
ID da solicitação de intent para casa inteligente. |
httpLatencyMsec |
Tempo decorrido até que uma resposta seja recebida. |
status |
Indica o status da resposta da intent. |
Registros de execução
A tabela abaixo lista o esquema de uma entrada executionLog:
| Propriedade | Descrição |
|---|---|
requestId |
ID exclusivo da solicitação, por exemplo, 5325511189174727525. |
latencyMsec |
Tempo decorrido antes do recebimento de uma resposta, por exemplo,
6000: |
executionType |
Transporte usado para a solicitação, por exemplo, CLOUD ou
MATTER, dependendo da integração. |
actionType |
Indicador opcional da ação do usuário realizada, por exemplo
QUERY ou EXECUTE.
Para ações EXECUTE, inclui o comando emitido para
fulfillment para características compatíveis, por exemplo, ONOFF_OFF
|
trait |
Característica opcional associada a essa ação do usuário. |
deviceTypes |
Lista de tipos de dispositivos afetados pelo evento, por exemplo
LIGHT: |
isSuccess |
Se a solicitação recebeu uma resposta bem-sucedida. |
fallbackToCloud |
Se a solicitação foi encaminhada para o fulfillment da nuvem após um erro do fulfillment local. |
statusType |
Indica o status da resposta da intent, como SUCCESS.
PENDING ou OFFLINE. Para ERROR
respostas, essa propriedade contém
o errorCode fornecido pelo fulfillment.
|
externalDebugString |
Mensagem de depuração detalhada opcional associada a esta ação do usuário. |
locale |
Código do idioma associado à solicitação. |
Registros de notificação
A tabela abaixo lista o esquema de uma entrada notificationLog:
| Propriedade | Descrição |
|---|---|
requestId |
ID da solicitação de notificação. |
structName |
Nome da estrutura de notificação, como "ObjectDetection". |
status |
Indica o status da notificação. |
Configuração do nível de registro
Cloud-to-cloud projetos estão configurados para receber registros de erros por padrão. e os desenvolvedores também podem ativar o recebimento de registros de sucesso. Isso é muito útil durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Cobranças adicionais podem ser aplicadas ao seu projeto se você exceder o cota de geração de registros.
Para controlar o nível de registro do seu projeto:
No Actions on Google Console, acesse a página "Projetos".
Selecione seu projeto de casa inteligente.
Escolha a guia Desenvolver e clique em Ações na barra lateral.
Selecione Todos na lista suspensa Ingestão de controle de registros.
Exclusões de registro
Os desenvolvedores podem criar exclusões de registros usando consulta de geração de registros idioma para personalizar ainda mais os registros com mais flexibilidade. Linguagem de consulta do Logging também é usado pela Análise de registros, para que você possa usá-la para criar consultas.
Siga as etapas para criar filtros de exclusão em
este guia
Configure o filtro de exclusão para o coletor _Default.
Métricas com base em registros
Os desenvolvedores podem usar Métricas com base em registros para rastrear e analisar padrões em seus registros. Também é possível criar gráficos personalizados e configure alertas nas métricas com base em registros.
Para começar a usar as métricas com base em registros para casas inteligentes, confira como criar um guia para métricas com base em registros de contador.
Recursos relacionados
Para saber mais sobre como usar o Cloud Logging no seu projeto, consulte os Documentação:
- Preços: Detalhes sobre cotas e custos excedentes.
- Cotas e limites: Detalhes sobre limites e políticas de retenção para o uso da geração de registros.
- Consultas de registros avançados: Guia sobre o uso de expressões avançadas para consultar e analisar dados de registro.