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 mediante 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.
El acceso a los datos de registro se administra a través de Identity and Access Management (IAM) para los usuarios de tu proyecto de Acciones. Si quieres 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 programan para su eliminación. También puedes borrar entradas a pedido mediante la interfaz del Explorador de registros.
Puedes obtener más información sobre cómo usar los registros de manera efectiva en la sección de búsqueda de registros 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 de Asistente. |
|
Registros de eventos
Los proyectos Cloud-to-cloud admiten los siguientes eventos en Cloud Logging:
| Recurso de Cloud Logging | Evento |
|---|---|
| Proyecto de acción del Asistente de Google | Errores de intent SYNC |
| Errores de intent de QUERY | |
| Errores de 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 que se reciba una 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 |
Es un ID de solicitud único, por ejemplo, 5325511189174727525. |
latencyMsec |
Tiempo transcurrido antes de recibir una respuesta, por ejemplo, 6000. |
executionType |
Es el transporte que se usa para la solicitud, por ejemplo, CLOUD o MATTER, según tu integración. |
actionType |
Indicador opcional de la acción que realizó el usuario, por ejemplo, QUERY o EXECUTE.
En el caso de las acciones EXECUTE, incluye el comando emitido a la entrega para las características compatibles, por ejemplo, ONOFF_OFF.
|
trait |
Es una característica opcional asociada con esta acción del usuario. |
deviceTypes |
Es una lista de los tipos de dispositivos afectados por el evento, por ejemplo, LIGHT. |
isSuccess |
Indica si la solicitud recibió una respuesta correcta. |
fallbackToCloud |
Indica si la solicitud se enruta a la entrega en la nube después de un error de una 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 proporcionó la entrega.
|
externalDebugString |
Mensaje opcional de depuración detallado 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 registros de errores de forma predeterminada, y los desarrolladores también pueden aceptar recibir registros de éxito. Esto es muy útil durante la fase de desarrollo, en la que planeas capturar todos los registros de unos pocos agentes. Es posible que se apliquen cargos adicionales a tu proyecto si superas la cuota de registro.
Puedes controlar el nivel de registro de tu proyecto de las siguientes maneras:
En Actions on Google Console, ve a la página Proyectos.
Selecciona tu proyecto de casa inteligente.
Elige la pestaña Develop y haz clic en Actions en la barra lateral.
Selecciona Todo en la lista desplegable Transferencia de control de registros.
Exclusiones de registros
Los desarrolladores pueden crear exclusiones de registros con el lenguaje de consulta de registro para personalizar aún más sus registros de una manera más flexible. El Explorador de registros también usa el lenguaje de consulta de Logging, por lo que puedes usarlo para crear consultas.
Puedes seguir los pasos a fin de 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 patrones en sus registros. También es posible crear gráficos personalizados y configurar alertas sobre las métricas basadas en registros.
Si quieres comenzar a usar métricas basadas en registros para la casa inteligente, consulta la guía sobre cómo crear una métrica basada en registros de contador.
Recursos relacionados
Si quieres obtener más información para usar Cloud Logging en tu proyecto, consulta la siguiente documentación:
- Precios: Son detalles sobre las asignaciones y los costos por excedente.
- Cuotas y límites: 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 a fin de consultar y analizar datos de registro.