Cloud Logging para materia

Puedes acceder a los registros de eventos para 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.

Ir a Cloud 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 deseas obtener más detalles sobre las funciones y los permisos para los datos de registro, 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 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 Es un contenedor para el proyecto de Google Cloud asociado con una Acción de Asistente.
  • project_id: Es el identificador del proyecto actual asociado con este recurso, por ejemplo my-project.

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 El tiempo transcurrido antes de que se reciba una respuesta, por ejemplo, 6000.
executionType Transporte que se usa para la solicitud, por ejemplo, CLOUD o MATTER, según tu integración.
actionType Indicador opcional de la acción del usuario realizada, 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 Rasgo opcional asociado con esta acción del usuario.
deviceTypes 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ó 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 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 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 registro, por lo que puedes usarlo 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 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 configurar alertas sobre métricas basadas en registros.

Si quieres comenzar a usar métricas basadas en registros para casa inteligente, consulta la guía sobre cómo crear una métrica basada en registros de contador.

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: 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.