É possível acessar os logs de eventos das suas integrações em Google Cloud Logging. Use o 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 o Cloud Logging no Google Cloud Console, clique em Ver todos os produtos e acesse Observabilidade > Logging.
O acesso aos dados de registro é gerenciado pelo Identity and Access Management (IAM) para usuários do seu projeto de Actions. Para mais detalhes sobre papéis e permissões para dados de registro, 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.
O 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 para o projeto na nuvem do Google 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 | |
| EXECUTE | |
| Erros de notificações | |
| Erros na vinculação de contas | |
| SDK do Home Local 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 de uma resposta ser 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 de solicitação exclusivo, 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 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 atributos compatíveis, por exemplo, ONOFF_OFF
|
trait |
Atributo opcional associado 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 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ções
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 do Cloud-to-cloud são configurados para receber registros de erros por padrão, e os desenvolvedores também podem optar por receber registros de sucesso. Isso é útil principalmente durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Cobranças adicionais poderão ser aplicadas ao seu projeto se você exceder a cota de geração de registros.
Para controlar o nível de registro do projeto:
No Actions on Google Console, acesse a página "Projetos".
Selecione o 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 a linguagem de consulta do Logging 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 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, confira o guia de criação de uma métrica 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 excedente.
- Cotas e limites: detalhes sobre limites e políticas de retenção para o uso do Logging.
- Consultas de registros avançadas: guia para usar expressões avançadas para consultar e analisar dados de registro.