É 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.
Registro de acesso
Para acessar Cloud Logging no Google Cloud Console, clique em Ver todos os produtos e acesse Operações > Registros.
O acesso aos dados de registro é gerenciado pelo Identity and Access Management (IAM) para os usuários do seu projeto de ações. Para mais detalhes sobre papéis e permissões para registros de dados, consulte o controle de acesso do Cloud Logging.
As entradas de registro são retidas por 30 dias de acordo com a política de retenção do Cloud Logging e, em seguida, são programadas para exclusão. Também é possível excluir entradas sob demanda usando a interface do Explorador de registros.
Saiba como usar os registros de forma eficaz na seção "Pesquisa de 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 Assistente. |
|
Logs de eventos
Os projetos 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 de QUERY | |
| Erros de intent EXECUTE | |
| Erros de notificações | |
| 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 que uma resposta fosse recebida, 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, por exemplo,
QUERY ou EXECUTE.
Para ações EXECUTE, inclui o comando emitido para
a conclusão de atributos 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. |
fallbackToCloud |
Indica se a solicitação foi roteada para o fulfillment na nuvem após um erro no 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
Os projetos Cloud-to-cloud são configurados para receber registros de erros por padrão, e os desenvolvedores também podem ativar o recebimento de registros de sucesso. Isso é útil principalmente 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ê ultrapassar a cota de geração de registros.
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 o projeto da casa inteligente.
Escolha a guia Develop e clique em Actions na barra lateral.
Selecione Todos na lista suspensa Transferência de controle de registro.
Exclusões de registro
Os desenvolvedores podem criar exclusões de registro usando a linguagem de consulta de registro para personalizar ainda mais os registros de maneira mais flexível. A linguagem de consulta de registro também é usada pelo Explorador de registros para 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, consulte como criar uma métrica de contador com base em registros.
Recursos relacionados
Para saber mais sobre como usar o Cloud Logging no seu projeto, consulte a documentação:
- Preços: detalhes sobre cotas 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 para consultar e analisar dados de registro.