Esta é a Central do desenvolvedor do Google Home, a nova plataforma para aprender a desenvolver ações de casa inteligente. Observação: você continua criando ações no Console do Actions.

Acessar registros de eventos com o Cloud Logging

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

É possível acessar os logs de eventos para 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 em Google Cloud Console , clique em Ver todos os produtos e acesse Operações > Logging.

Acesse Cloud Logging

O acesso aos dados de registro é gerenciado pelo Identity and Access Management (IAM) para os usuários do projeto do Actions. Para mais detalhes sobre papéis e permissões para registrar dados, 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 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 Assistente.
  • project_id: o identificador do projeto atual associado a este recurso, por exemplo, my-project.

Logs de eventos

Cloud-to-cloud projects support the following events in 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 notificações
Erros de vinculação de conta
SDK local do Google Home HandlerError

Sincronizar registros

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 do recebimento da 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 exclusivo da solicitação, por exemplo, 5325511189174727525.
latencyMsec Tempo decorrido antes do recebimento de uma resposta, por exemplo, 6000.
executionType Transporte usado na 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 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.

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, como "ObjectDetection".
status Indica o status da notificação.

Configuração no nível do registro

Por padrão, projetos Cloud-to-cloud são configurados para receber registros de erros, e é possível que os desenvolvedores ativem o recebimento deles. Isso é útil principalmente durante a fase de desenvolvimento, quando você planeja capturar todos os registros de alguns agentes. Poderão ser aplicadas cobranças adicionais ao seu projeto se você exceder a cota de geração de registros.

É possível controlar o nível de registro do seu projeto:

  1. No Actions on Google Console , go to the Projects page.

    Acesse o console do Actions on Google

  2. Selecione seu projeto de casa inteligente.

  3. Escolha a guia Desenvolver e clique em Ações na barra lateral.

  4. Selecione Todos na lista suspensa Ingestão do controle de registros.

Exclusões de registro

Os desenvolvedores podem criar exclusões de registro 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 pelo Explorador de registros. Assim, você pode usá-lo para criar consultas.

Siga as etapas de criação de 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 casa inteligente, confira Como criar um guia de métricas com base em registros.

Para saber mais sobre como usar o Cloud Logging no seu projeto, consulte a documentação abaixo: