Registro estructurado

En este documento, se analiza el concepto de registro estructurado y los métodos para agregar estructura a los campos de carga útil de las entrada de registro. Cuando la carga útil del registro tiene el formato de un objeto JSON y ese objeto se almacena en el campo jsonPayload, la entrada de registro se denomina registro estructurado. En el caso de estos registros, puedes crear consultas que busquen rutas de acceso JSON específicas y puedes indexar campos específicos en la carga útil del registro. Por el contrario, cuando la carga útil del registro se formatea como una cadena y se almacena en el campo textPayload, la entrada de registro es no estructurada. Puedes buscar en el campo de texto, pero no puedes indexar su contenido.

Para crear entradas de registro estructuradas, haz cualquiera de las siguientes acciones:

  • Llama al método de la API entries.write y proporciona un objeto LogEntry con el formato completo.
  • Usa el comando gcloud logging write.
  • Usa una biblioteca cliente de Cloud Logging que escriba registros estructurados.
  • Usa el servicio de BindPlane.

  • Usa un agente para escribir registros:

    • Algunos servicios de Google Cloud contienen un agente de Logging integrado que envía los datos escritos en stdout o stderr como registros a Cloud Logging. Puedes usar este enfoque para Google Cloud servicios como Google Kubernetes Engine, el entorno flexible de App Engine y Cloud Run Functions.
    • En el caso de las máquinas virtuales (VMs) de Compute Engine, te recomendamos que instales y configures el agente de operaciones para enviar registros estructurados a Cloud Logging. Si tus VMs existentes usan el agente de Logging heredado, ten en cuenta que este agente ya no es compatible. Si deseas obtener información sobre las alternativas de migración desde el agente de Logging heredado, consulta la guía de migración o Registro estructurado con el agente de Logging heredado para obtener información sobre cómo usar el agente de Logging heredado para escribir registros estructurados.

Para ver ejemplos de código, consulta Cómo escribir registros estructurados.

Escribe registros con gcloud CLI

Puedes escribir datos de registro con gcloud CLI. La interfaz admite registros no estructurados y registros estructurados. Cuando quieras escribir un registro estructurado, proporciona al comando un objeto JSON serializado.

Para obtener una guía de inicio rápido, consulta Escribe y consulta entradas de registro con Google Cloud CLI.

Para ver ejemplos de código, consulta la referencia de gcloud logging write.

Escribe registros con BindPlane

Puedes usar el servicio de BindPlane para enviar registros a Logging. En el caso de estos registros, las cargas útiles tienen formato JSON y se estructuran según el sistema fuente. Para obtener información sobre cómo encontrar y ver los registros transferidos con BindPlane, consulta la Guía de inicio rápido de BindPlane.

Escribe registros con el Agente de operaciones

Para obtener registros de tus instancias de Compute Engine, puedes usar el Agente de operaciones. El Agente de operaciones combina el registro y las métricas en un solo agente, proporciona una configuración basada en YAML y cuenta con registros de alta capacidad de procesamiento.

Para obtener información sobre cómo configurar el agente de operaciones para admitir registros estructurados o personalizar el formato de un registro estructurado, consulta Configura el agente de operaciones.

Soluciona problemas

Para solucionar problemas comunes que se encuentran al instalar el Agente de operaciones o interactuar con él, consulta Solución de problemas del agente.

¿Qué sigue?