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.
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 Actions. Para obtener más detalles sobre las funciones y los permisos de los datos de registro, consulta 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 con la interfaz del Explorador de registros.
Puedes obtener más información para usar los registros de manera eficaz en la sección 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 del Asistente Acción. |
|
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 |
Es el tiempo transcurrido antes de que se recibiera 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 |
Es un indicador opcional de la acción del usuario realizada, por ejemplo
QUERY o EXECUTE.
Para las acciones EXECUTE, incluye el comando que se emitió al
cumplimiento para las características compatibles, por ejemplo, ONOFF_OFF
|
trait |
Es la característica opcional asociada con esta acción del usuario. |
deviceTypes |
Es la lista de 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 enrutó al cumplimiento de la nube después de un error del cumplimiento local. |
statusType |
Indica el estado de la respuesta de intents, como SUCCESS,
PENDING, o OFFLINE. Para las respuestas ERROR, esta propiedad contiene
el errorCode que proporciona el cumplimiento.
|
externalDebugString |
Es un mensaje de depuración detallado opcional asociado con esta acción del usuario. |
locale |
Es el código de idioma asociado con la solicitud. |
Exclusiones de registros
Los desarrolladores pueden crear exclusiones de registros con el lenguaje de consulta de Logging 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 usar el Explorador de registros para crear consultas.
Puedes seguir los pasos para crear filtros de exclusión en
esta guía
(configura el filtro de exclusión para el _Default receptor).
Métricas basadas en registros
Los desarrolladores pueden usar métricas basadas en registros para hacer un seguimiento de los patrones y analizarlos en sus registros. También es posible crear gráficos personalizados y configurar alertas en métricas basadas en registros.
Para comenzar a usar métricas basadas en registros para smart home, consulta la guía para crear una métrica de contador basada en registros.
Recursos relacionados
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 uso excedido
- Cuotas y límites: Detalles sobre los límites y las políticas de retención para el uso de Logging.
- Consultas de registros avanzadas: Guía para usar expresiones avanzadas para consultar y analizar datos de registro.