É possível acessar os registros de eventos das integrações no Google Cloud Logging. Use Cloud Logging para explorar 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 no Google Cloud Console, clique em Ver 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 dados de registro, consulte 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 registros de maneira eficaz na seção Pesquisar registros do guia de solução de problemas.
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 Ação. |
|
Logs de eventos
Cloud-to-cloud projetos oferecem suporte aos seguintes eventos no Cloud Logging:
| Recurso do Cloud Logging | Evento |
|---|---|
| Projeto de ação do Google Assistente | SYNC |
| 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 até que uma resposta fosse recebida. |
status |
Indica o status da resposta de 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 até 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 realizada, por exemplo
QUERY ou EXECUTE.
Para ações EXECUTE, inclui o comando emitido para o
fulfillment de 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 de 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 essa ação do usuário. |
locale |
Código de 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 definidos para receber registros de erros por padrão, e os desenvolvedores também podem ativar o recebimento de registros de sucesso. Isso é especialmente útil durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Taxas adicionais podem ser aplicadas ao seu projeto se você exceder a cota de registro.
É possível controlar o nível de registro do projeto das seguintes maneiras:
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 registro.
Exclusões de registro
Os desenvolvedores podem criar exclusões de registro usando linguagem de consulta de registro para personalizar ainda mais os registros de maneira mais flexível. A linguagem de consulta de geração de registros também é usada pela Análise de registros. Assim, é possível usar a Análise de registros para ajudar a 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 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 casa inteligente, consulte o guia 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 seguinte documentação:
- Preços: detalhes sobre alocações e custos de excedente.
- Cotas e limites: detalhes sobre limites e políticas de retenção para uso de registro.
- Consultas de registros avançadas: guia para usar expressões avançadas para consultar e analisar dados de registro.