En esta página, se describen los registros disponibles cuando se usa Cloud Run for Anthos y cómo ver y escribir registros.
Cloud Run for Anthos tiene dos tipos de registros que se envían de forma automática a Cloud Logging:
- Registros de solicitudes: registros de solicitudes enviadas a los servicios de Cloud Run for Anthos. 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 la consola de Google Cloud
- Usa el explorador de registros de Cloud Logging en la consola de Google Cloud.
Ambos métodos de visualización analizan los mismos registros almacenados en Cloud Logging, pero el Explorador de registros de Cloud Logging proporciona más detalles y más capacidades de filtrado.
Visualiza registros en Cloud Run for Anthos
Para ver los registros en la página de Cloud Run for Anthos, haz lo siguiente:
Hacer clic en el servicio deseado en la lista que se muestra
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 los registros de Cloud Run for Anthos en el explorador de registros de Cloud Logging, sigue estos pasos:
Ve al Explorador de registros en la consola de Google Cloud.
Selecciona un proyecto de Google Cloud existente en la parte superior de la página o crea un proyecto nuevo.
Mediante el menú desplegable, selecciona el recurso Contenedor de Kubernetes.
Para obtener más información, consulta Usa el Explorador de registros.
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:
- Usa un receptor de registros en Pub/Sub y una secuencia de comandos para extraerlos de Pub/Sub.
- Llama a la API de Logging mediante las bibliotecas cliente del lenguaje de programación que uses.
- Llama a los extremos de la API de REST de Logging directamente.
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:
- Transmisiones de salida estándar (
stdout
) o de error estándar (stderr
) - Cualquier archivo en el directorio
/var/log
- Syslog (
/dev/log
) - Registros escritos mediante bibliotecas cliente de Cloud Logging, que están disponibles para muchos lenguajes populares
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 de manera automática con el servicio, la revisión y la ubicación de Cloud Run for Anthos.
Comparación entre el uso de texto simple y de JSON estructurado en los registros
Cuando escribes registros, puedes enviar una string de texto simple o una sola línea de JSON serializado, que también se conoce como datos estructurados. Cloud Logging lo recopila y analiza, y se coloca en jsonPayload
. En cambio, el mensaje de texto simple se coloca en textPayload
.
Escribe registros estructurados
En el siguiente fragmento, se muestra cómo escribir entradas de registro estructuradas. También se muestra cómo correlacionar los mensajes de registro con el registro de solicitud correspondiente.
Node.js
Python
Comienza a usarlo
Un tipo de Entry
proporciona la estructura para cada entrada de registro:
Cuando se registra una estructura de Entry, se llama al método String
para ordenarla según el formato JSON que espera Cloud Logging:
Java
Habilita el registro JSON con Logback y SLF4J mediante la habilitación del codificador de JSON de Logstash en la configuración logback.xml
.
Campos JSON especiales en los mensajes
Cuando proporcionas un registro estructurado como un diccionario JSON, algunos campos especiales se quitan de jsonPayload
y se escriben en el campo correspondiente en la LogEntry generada, como se describe en la documentación sobre campos especiales.
Por ejemplo, si el JSON incluye una propiedad severity
, se quita de jsonPayload
y aparece como la severity
de la entrada de registro.
La propiedad message
se usa como el texto de visualización principal de la entrada de registro si está presente.
Para obtener más información sobre las propiedades especiales, lee la sección Recurso de registro.
Correlaciona los registros de contenedores con un registro de solicitud
En el Explorador 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, puedes usar la función 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 no usa agentes de registro porque tiene compatibilidad integrada con la recopilación de registros.
Recurso de registro
Si haces clic en una entrada de registro en el Explorador 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 exclusivas de Cloud Run for Anthos. A continuación, se enumeran algunas con contenido de muestra:
{
httpRequest: {…}
insertId: "5c82b3d1000ece0000000000"
labels: {
instanceId: "00bf4bf00000fb59c906a00000c9e29c2c4e06dce91500000000056008d2b6460f163c0057b97b2345f2725fb2423ee5f0bafd36df887fdb1122371563cf1ff453717282afe000001"
}
logName: "projects/my-project/logs/anthos/run/archive/.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: "cloud_run_revision"
}
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 |
cloud_run_revision El tipo de recurso de Cloud Run for Anthos. |