Te damos la bienvenida al Centro para desarrolladores de Google Home, el nuevo destino para aprender a desarrollar acciones para el hogar inteligente. Nota: Continuarás compilando acciones en la Consola de Actions.

Accede a los registros de eventos con Cloud Logging

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Puedes acceder a los registros de eventos de tus integraciones desde Google Cloud Logging . Usa Cloud Logging para explorar registros, crear métricas y alertas, o exportar registros a otras aplicaciones con Google Cloud Pub/Sub.

Registro de acceso

Para acceder a Cloud Logging desde Google Cloud Console , haz clic en Ver todos los productos y, luego, ve a Operaciones > Logging.

Ir a Cloud Logging

El acceso a los datos de registro se administra a través de la administración de identidades y accesos (IAM) para los usuarios de tu proyecto de acciones. Si deseas obtener más detalles sobre las funciones y los permisos para registrar datos, consulta el control de acceso de Cloud Logging.

Las entradas de registro se conservan durante 30 días según la política de retención de Cloud Logging y, luego, se programa su eliminación. También puedes borrar entradas a pedido con la interfaz del Explorador de registros.

Puedes obtener más información sobre cómo usar los registros de manera eficaz en la sección sobre registros de búsqueda de la guía de solución de problemas.

Cloud Logging proporciona los siguientes tipos de recursos:

Tipo de recurso Nombre visible Descripción Etiquetas
assistant_action_project Proyecto de acción del Asistente de Google Un contenedor para el proyecto de Google Cloud asociado con una acción del Asistente.
  • project_id: Es el identificador de tu proyecto actual asociado con este recurso, por ejemplo, my-project.

Registros de eventos

Cloud-to-cloud projects support the following events in Cloud Logging:

Recurso de Cloud Logging Evento
Proyecto de acción del Asistente de Google Errores de intent de SYNC
Errores de intent QUERY
Errores del intent EXECUTE
Errores de notificaciones
Errores de vinculación de cuentas
SDK de Local Home HandlerError

Registros de sincronización

En la siguiente tabla, se muestra el esquema de una entrada syncLog:

Propiedad Descripción
requestId ID de solicitud de intent de casa inteligente.
httpLatencyMsec Tiempo transcurrido antes de recibir la respuesta
status Indica el estado de la respuesta del intent.

Registros de ejecución

En la siguiente tabla, se muestra el esquema de una entrada executionLog:

Propiedad Descripción
requestId ID de solicitud único, por ejemplo, 5325511189174727525
latencyMsec Tiempo transcurrido antes de recibir la respuesta, como 6000
executionType Transporte usado para la solicitud, por ejemplo, CLOUD o MATTER, según tu integración.
actionType Indicador opcional de la acción del usuario que se realiza, por ejemplo, QUERY o EXECUTE. Para las acciones EXECUTE, se incluye el comando emitido a fin de entregar las características compatibles, por ejemplo, ONOFF_OFF.
trait Rasgo opcional asociado con esta acción del usuario.
deviceTypes Lista de los tipos de dispositivos afectados por el evento (por ejemplo, LIGHT).
isSuccess Indica si la solicitud recibió una respuesta exitosa.
fallbackToCloud Indica si la solicitud se enruta a la entrega en la nube después de un error de la entrega local.
statusType Indica el estado de la respuesta del intent, como SUCCESS, PENDING o OFFLINE. Para las respuestas de ERROR, esta propiedad contiene el errorCode que proporciona la entrega.
externalDebugString Mensaje de depuración detallado y opcional asociado con esta acción del usuario.
locale Es el código de idioma asociado con la solicitud.

Registros de notificaciones

En la siguiente tabla, se muestra el esquema de una entrada notificationLog:

Propiedad Descripción
requestId ID de solicitud de notificación.
structName Nombre de la estructura de notificación, como "ObjectDetection".
status Indica el estado de la notificación.

Configuración de nivel de registro

Los proyectos Cloud-to-cloud están configurados para recibir los registros de errores de forma predeterminada, y también es posible que los desarrolladores acepten recibir los registros de éxito. Esto es muy útil durante la fase de desarrollo, cuando planeas capturar todos los registros de algunos agentes. Es posible que se apliquen cargos adicionales a tu proyecto si excedes la cuota de registro.

Puedes controlar el nivel de registro de tu proyecto si haces lo siguiente:

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

    Ir a la consola de Actions on Google

  2. Selecciona tu proyecto de casa inteligente.

  3. Elige la pestaña Desarrolla y haz clic en Acciones en la barra lateral.

  4. Selecciona Todas en la lista desplegable Transferencia de control de registros.

Exclusiones de registros

Los desarrolladores pueden crear exclusiones de registros mediante el lenguaje de consulta de registros para personalizar aún más sus registros de una manera más flexible. El lenguaje de consulta de registros también se usa en el Explorador de registros, por lo que puedes usarlo para ayudar a crear consultas.

Puedes seguir los pasos para crear filtros de exclusión en esta guía (configura el filtro de exclusión para el receptor _Default).

Métricas basadas en registros

Los desarrolladores pueden usar métricas basadas en registros para realizar un seguimiento y analizar los patrones dentro de sus registros. También es posible crear gráficos personalizados y configurar alertas en las métricas basadas en registros.

A fin de comenzar a usar las métricas basadas en registros para el hogar inteligente, consulta Crea una guía de métricas basadas en registros.

Para obtener más información sobre el uso de Cloud Logging en tu proyecto, consulta la siguiente documentación:

  • Precios: Detalles sobre las asignaciones y los costos por excedente
  • Cuotas y límites: Obtén detalles sobre los límites y las políticas de retención para el uso de registros.
  • Consultas de registros avanzadas: Guía para usar expresiones avanzadas con el fin de consultar y analizar datos de registro.