É 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 usando o Google Cloud Pub/Sub.
Registro de acesso
Para acessar Cloud Logging no Google Cloud Console, clique em Ver todos os produtos e vá para Operações > Geração de registros.
O acesso aos dados de geração de registros é gerenciado pelo Identity and Access Management (IAM) para os usuários do seu 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 retidas 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 do Explorador de registros.
Saiba mais sobre como usar 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 para o projeto do Google Cloud associado a uma ação do Google 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 do Google 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 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 |
Indica se a solicitação recebeu uma resposta bem-sucedida. |
fallbackToCloud |
Indica 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. |
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 do struct de notificação, por exemplo, "ObjectDetection". |
status |
Indica o status da notificação. |
Configuração no nível de registro
Cloud-to-cloud projetos são definidos para receber registros de erro por padrão, e é possível que os desenvolvedores ativem 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. Pode haver cobranças extras 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 o projeto de casa inteligente.
Selecione 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 pelo Explorador de registros para ajudar na criação de 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 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 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 uso de registros.
- Consultas avançadas de registros: guia para usar expressões avançadas para consultar e analisar dados de registros.