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 la Google Cloud Console, Haz clic en Ver todos los productos y, luego, ve a Operaciones > Registro.
El acceso a los datos de registro se administra a través de Identity and Access Management (IAM). para los usuarios del proyecto de Acciones. Para obtener más detalles sobre los roles y permisos de de registro, consulta Cloud Logging control de acceso.
Las entradas de registro se conservan durante 30 días según Cloud Logging. política de retención y, luego, se programó su eliminación. También puedes borrar entradas a pedido con el Interfaz del Explorador de registros.
Puedes obtener más información para usar los registros de forma eficaz en la sección Buscar 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 un Asistente Acción. |
|
Registros de eventos
Cloud-to-cloud de proyectos admiten los siguientes eventos en Cloud Registro:
| Recurso de Cloud Logging | Evento |
|---|---|
| Proyecto de acción del Asistente de Google | Errores de intent SYNC |
| Errores de intent QUERY | |
| Errores de intent EXECUTE | |
| Notificaciones errores | |
| Vinculación de cuentas errores | |
| SDK de Local Home HandlerError |
Sincronización de registros
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 recibiera 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 el ID de solicitud único, por ejemplo, 5325511189174727525. |
latencyMsec |
Tiempo transcurrido antes de que se reciba una respuesta, por ejemplo,
6000 |
executionType |
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
Entrega para los traits admitidos, como ONOFF_OFF
|
trait |
Es un 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 ERROR
esta propiedad contiene
el errorCode que proporciona la entrega.
|
externalDebugString |
Mensaje de depuración detallado opcional asociado a 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 struct 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 también es posible que los desarrolladores acepten recibir registros de éxito. Esto es especialmente útil durante la fase de desarrollo, cuando tienes pensado captar todos los registros de algunos agentes. Es posible que se apliquen cargos adicionales a tu proyecto si superen los cuota de registros.
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.
Selecciona la pestaña Develop y haz clic en Actions en la barra lateral.
Selecciona Todos en la lista desplegable Transferencia de control de registros.
Exclusiones de registros
Los desarrolladores pueden crear exclusiones de registros con una consulta de registro idioma personalizarlos de forma más flexible. Lenguaje de consulta de Logging también se usa en el Explorador de registros para ayudarte a crear para tus 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 rastrear y analizar patrones en sus registros. También es posible crear gráficos personalizados y configura alertas en métricas basadas en registros.
Si quieres comenzar a usar métricas basadas en registros para la casa inteligente, consulta Crea una guía de métricas basadas en registros de contadores.
Recursos relacionados
Para obtener más información sobre el uso de Cloud Logging en tu proyecto, consulta los siguientes vínculos: documentación:
- Precios: 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 sobre el uso de expresiones avanzadas para consultar y analizar datos de registro.