É possível acessar os registros de eventos das suas integrações em Google Cloud Logging. Use Cloud Logging para explorar 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 Mostrar 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 registrar dados, 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.
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. |
|
Registros de execução
A tabela abaixo lista o esquema de uma entrada executionLog:
| Propriedade | Descrição |
|---|---|
requestId |
ID exclusivo da solicitação, 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 sua 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 das 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 esta ação do usuário. |
locale |
Código do idioma associado à solicitação. |
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 na criação de 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 como criar um guia de métricas 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 sobreuso.
- Cotas e limites: detalhes sobre limites e políticas de retenção para o uso da geração de registros.
- Consultas avançadas de registros: guia para o uso de expressões avançadas para consultar e analisar dados de registros.