É possível acessar os logs de eventos das suas integrações em Google Cloud Logging. Use o Cloud Logging para explorar registros, criar métricas e alertas ou exportar registros para outros aplicativos com 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 > Logging.
O acesso aos dados de geração de registros é gerenciado pelo Identity and Access Management (IAM) para usuários do projeto do Actions. Para mais detalhes sobre os papéis e as permissões dos 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 com eficácia 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 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 | |
| Erros de Notifications | |
| 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 da intent de 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 de solicitação exclusivo, por exemplo, 5325511189174727525. |
latencyMsec |
Tempo decorrido até o recebimento de uma resposta, 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 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 |
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 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, por exemplo, "ObjectDetection". |
status |
Indica o status da notificação. |
Configuração no nível de registro
Os projetos Cloud-to-cloud são definidos para receber registros de erros por padrão, e é possível que os desenvolvedores aceitem 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. Outras taxas poderão ser aplicadas ao projeto se você exceder a cota de geração de registros.
É possível controlar o nível de registro do seu projeto das seguintes maneiras:
Em 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 para criar consultas.
Siga as etapas para criar filtros de exclusão neste guia (configure o filtro de exclusão do coletor _Default).
Métricas com base em registros
Os desenvolvedores podem usar as métricas com base em registros para acompanhar 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 em casas inteligentes, confira o guia sobre como criar um contador de métricas 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 cotas e custos excedentes.
- Cotas e limites: detalhes sobre limites e políticas de retenção para uso de registros.
- Consultas avançadas de registros: guia para usar expressões avançadas para consultar e analisar dados de registros.