É possível acessar os registros de eventos das suas integrações em Google Cloud Logging. Use Cloud Logging para analisar 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 Ver 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 usuários do seu projeto do Actions. Para mais detalhes sobre papéis e permissões para dados de registros, 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 depois são programadas para exclusão. Também é possível excluir entradas sob demanda usando a interface do Explorador de registros.
Saiba mais sobre como usar os registros de maneira eficaz na seção "Pesquisar registros" do Guia de solução de problemas.
O Cloud Logging oferece 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 para o projeto do Google Cloud associado a uma ação do Google Assistente. |
|
Logs de eventos
Os projetos do Cloud-to-cloud são compatíveis com 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 | |
| Notificações erros | |
| Erros de vinculação de contas | |
| 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 de casa inteligente. |
httpLatencyMsec |
Tempo decorrido antes do 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 de solicitação exclusivo, 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 sua integração. |
actionType |
Indicador opcional da ação realizada pelo usuário, 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 |
Indica se a solicitação recebeu uma resposta bem-sucedida. |
fallbackToCloud |
Indica se a solicitação foi encaminhada para o fulfillment na 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 essa 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
Por padrão, os projetos do Cloud-to-cloud são configurados para receber registros de erros, e os desenvolvedores podem ativar o recebimento de registros de sucesso também. Isso é especialmente útil durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Se você exceder a cota de geração de registros, poderão ser aplicadas cobranças adicionais ao seu projeto.
Para controlar o nível de registro do seu projeto, faça o seguinte:
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 Tudo na lista suspensa Ingestão de controle de registros.
Exclusões de registro
Os desenvolvedores podem criar exclusões de registros usando a linguagem de consulta de registros para personalizar ainda mais os registros de maneira mais flexível. A linguagem de consulta do Logging também é usada pelo Explorador de registros, que pode ajudar a criar 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 o guia de criação de métricas de contador com base em registros.
Recursos relacionados
Para saber mais sobre como usar o Cloud Logging no seu projeto, consulte a seguinte documentação:
- Preços: detalhes sobre alocações e custos excedentes.
- Cotas e limites: detalhes sobre limites e políticas de retenção para uso de geração de registros.
- Consultas de registros avançadas: guia para usar expressões avançadas e consultar e analisar dados de registro.