É possível acessar os registros de eventos das suas integrações em Google Cloud Logging. Use Cloud Logging para explorar registros, criar métricas e alertas ou exportar registros para outros aplicativos usando o Google Cloud Pub/Sub.
Geração de registros de acesso
Para acessar Cloud Logging no Google Cloud Console, clique em Mostrar todos os produtos e acesse Operações > Logging.
O acesso aos dados de registro é gerenciado pelo Identity and Access Management (IAM) para usuários do projeto do Actions. Para mais detalhes sobre papéis e permissões para registrar dados, consulte o controle de acesso do Cloud Logging.
As entradas de registro são mantidas por 30 dias de acordo com a política de retenção do Cloud Logging e, em seguida, programadas para exclusão. Também é possível excluir entradas sob demanda usando a 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 uma ação do Assistente. |
|
Logs de eventos
Os projetos Cloud-to-cloud aceitam os seguintes eventos no Cloud Logging:
Recurso do Cloud Logging | Evento |
---|---|
Projeto de ação do Google Assistente | Erros de intent SYNC |
Erros de intent QUERY | |
Erros de intent EXECUTE | |
Erros de Notificações | |
Erros de vinculação de conta | |
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é o recebimento de uma resposta. |
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 de uma resposta ser recebida, por exemplo,
6000 . |
executionType |
Transporte usado para a solicitação, por exemplo, CLOUD ou
MATTER , dependendo da sua 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
o fulfillment das 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 respostas ERROR , 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
Os projetos Cloud-to-cloud são configurados para receber registros de erros por padrão. Os desenvolvedores também podem optar por receber registros de sucesso. Isso é especialmente útil durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Pode haver cobranças extras no projeto se você exceder a 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 registro usando a linguagem de consulta de geração de registros para personalizar ainda mais os registros de maneira mais flexível. A linguagem de consulta do Logging também é usada pela Análise de registros para que você possa usá-la na criação de consultas.
Siga as etapas para criar filtros de exclusão neste 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 nos registros. Também é possível criar gráficos personalizados e configurar alertas em métricas com base em registros.
Para começar a usar métricas com base em registros para casas inteligentes, confira como criar um guia de métricas com base em registros de contador.
Recursos relacionados
Para saber mais sobre como usar o Cloud Logging no seu projeto, consulte a seguinte documentação:
- Preços: detalhes sobre cotas e custos de sobreuso.
- Cotas e limites: detalhes sobre limites e políticas de retenção para o uso da geração de registros.
- Consultas avançadas de registros: guia para o uso de expressões avançadas para consultar e analisar dados de registros.