Registrar y ver registros

En esta página, se describen los registros disponibles cuando se usa Cloud Run for Anthos en Google Cloud y cómo ver y escribir registros.

Cloud Run para Anthos en Google Cloud tiene dos tipos de registros que se envían automáticamente a Cloud Logging:

  • Registros de solicitudes: Registros de solicitudes enviadas a Cloud Run for Anthos en los servicios de Google Cloud. Estos registros se crean de forma automática.
  • Registros de contenedores: Registros emitidos desde las instancias de contenedor, por lo general, desde tu propio código, escritos en ubicaciones compatibles como se describe en Escribe registros de contenedores.

Visualiza registros

Puedes visualizar los registros de tu servicio de estas dos maneras:

  • Usa la página de Cloud Run for Anthos en Google Cloud en Cloud Console
  • Usa el visor de registros de Cloud Logging en Cloud Console.

Ambos métodos de visualización analizan los mismos registros almacenados en Cloud Logging, pero el visor de registros de Cloud Logging proporciona más detalles y más capacidades de filtrado.

Visualiza registros en Cloud Run para Anthos en Google Cloud

Para ver los registros en la página de Cloud Run for Anthos en Google Cloud, haz lo siguiente:

  1. Implementar en Cloud Run for Anthos en Google Cloud

  2. Hacer clic en el servicio deseado en la lista que se muestra

  3. Hacer clic en la pestaña REGISTROS para obtener los registros de solicitud y contenedor de todas las revisiones de este servicio. Puedes filtrar por nivel de gravedad del registro

Visualiza registros en Cloud Logging

Para ver tus registros de Cloud Run for Anthos en Google Cloud en el visor de registros de Cloud Logging:

  1. Ve a la página Visor de registros en Cloud Console:

    Ir a la página Visor de registros

  2. Selecciona un proyecto de Google Cloud existente en la parte superior de la página o crea un proyecto nuevo.

  3. Mediante el menú desplegable, selecciona el recurso Contenedor de Kubernetes.

Para obtener más información, consulta Visualiza registros en Logging de Google Cloud's operations suite.

Visualiza registros en Cloud Code

Para ver tus registros en Cloud Code, lee las guías de IntelliJ y Visual Studio Code.

Lee registros de manera programática

Si deseas leer los registros de manera programática, puedes usar uno de estos métodos:

Escribe registros de contenedores

Cuando escribes registros desde el servicio, Cloud Logging los selecciona de manera automática, siempre y cuando se escriban en cualquiera de estas ubicaciones:

Se espera que la mayoría de los desarrolladores escriban registros mediante transmisiones de salida estándar y error estándar.

Los registros de contenedores escritos en estas ubicaciones compatibles se asocian automáticamente con el servicio, la revisión y la ubicación de Cloud Run para Anthos en Google Cloud.

Correlaciona los registros de contenedores con un registro de solicitud

En el visor de registros, los registros que se correlacionan por el mismo trace se pueden ver en formato de “superior-secundario”. Cuando haces clic en el ícono de triángulo a la izquierda de la entrada de registro de la solicitud, los registros de contenedores relacionados con esa solicitud aparecen anidados en el registro de solicitud.

Los registros de contenedores no se correlacionan de forma automática con los registros de solicitudes, a menos que uses una biblioteca cliente de Cloud Logging. Para correlacionar registros de contenedores con registros de solicitudes sin usar una biblioteca cliente, puedes usar una línea de registro JSON estructurada que contenga un campo logging.googleapis.com/trace con el identificador de seguimiento extraído del encabezado X-Cloud-Trace-Context, como se muestra en el ejemplo anterior de un registro estructurado.

Controla el uso de recursos de registros de solicitudes

Los registros de solicitudes se crean de forma automática. Aunque no puedes controlar la cantidad de registros de solicitudes directamente desde Cloud Run for Anthos en Google Cloud, puedes usar la característica de exclusión de registros de Cloud Logging.

Nota sobre los agentes de registro

Si usaste Cloud Logging con ciertos productos de Google Cloud, como Compute Engine, es posible que hayas usado agentes de registro de Cloud Logging. Cloud Run for Anthos en Google Cloud no usa agentes de registro porque tiene compatibilidad integrada para la recopilación de registros.

Recurso de registro

Si haces clic en una entrada de registro en el visor de registros, se abre una entrada de registro con formato JSON para que puedas desglosar los detalles que desees.

Todos los campos de una entrada de registro, como las marcas de tiempo, la gravedad y las httpRequest, son estándar y se describen en la documentación sobre una entrada de registro.

Sin embargo, hay algunas etiquetas o etiquetas de recursos que son especiales para Cloud Run for Anthos en Google Cloud. A continuación, se enumeran algunas con contenido de muestra:

{
 httpRequest: {…}
 insertId:  "5c82b3d1000ece0000000000"
 labels: {
  instanceId:  "00bf4bf00000fb59c906a00000c9e29c2c4e06dce91500000000056008d2b6460f163c0057b97b2345f2725fb2423ee5f0bafd36df887fdb1122371563cf1ff453717282afe000001"
 }
 logName:  "projects/my-project/logs/kuberun/.googleapis.com%2Frequests"
 receiveTimestamp:  "2019-03-08T18:26:25.981686167Z"
 resource: {
  labels: {
   configuration_name:  "myservice"
   location:  "us-central1"
   project_id:  "my-project"
   revision_name:  "myservice-00002"
   service_name:  "myservice"
  }
  type:  "k8s_container"
 }
 severity:  "INFO"
 timestamp:  "2019-03-08T18:26:25.970397Z"
}
Campo Valores y notas
instanceId La instancia de contenedor que controló la solicitud.
logName Identifica el registro, por ejemplo, registro de solicitud, error estándar, salida estándar, etc.
configuration_name El recurso de configuración que creó la revisión que entregó la solicitud.
location Identifica la ubicación de GCP del servicio.
project_id El proyecto en el que se implementa el servicio.
revision_name La revisión que entregó la solicitud.
service_name El servicio que entregó la solicitud.
type k8s_container El tipo de recurso de Cloud Run for Anthos en Google Cloud.