En este documento, se describe cómo habilitar, generar y visualizar registros de Cloud Logging para un trabajo por lotes.
Puedes usar los registros para obtener información útil analizando tus trabajos. Por ejemplo, los registros pueden ayudarte a depurar trabajos con errores.
En particular, los registros solo se generan después de que un trabajo comienza a ejecutarse y solo si el registro estaba habilitado para el trabajo. Si necesitas analizar un trabajo sin registros, consulta los eventos de estado.
Antes de comenzar
- Si nunca usaste Batch, revisa Comienza a usar Batch y habilitar Batch completando el requisitos previos para los proyectos y usuarios.
-
Para obtener los permisos que necesitas para analizar un trabajo con registros, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Para crear un trabajo, sigue estos pasos:
-
Editor de trabajos por lotes (
roles/batch.jobsEditor
) en el proyecto -
Usuario de cuenta de servicio (
roles/iam.serviceAccountUser
) en la cuenta de servicio del trabajo, que, de forma predeterminada, es la cuenta de servicio predeterminada de Compute Engine
-
Editor de trabajos por lotes (
-
Para ver los registros, haz lo siguiente:
Visor de registros (
roles/logging.viewer
) en el proyecto
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
-
Para crear un trabajo, sigue estos pasos:
Habilita el registro de un trabajo
Para permitir que se generen registros para un trabajo, habilita los registros desde Cloud Logging cuando creas el trabajo:
- Si creas un trabajo con la consola de Google Cloud, los registros de Cloud Logging siempre estarán habilitados.
Si creas un trabajo con la CLI de gcloud o la API de Batch, los registros de Cloud Logging se inhabilitan de forma predeterminada. Para habilitar los registros de Cloud Logging, incluye lo siguiente: del campo
logsPolicy
durante la creación del trabajo:{ ... "logsPolicy": { "destination": "CLOUD_LOGGING" } ... }
Escribir y generar registros para un trabajo
Cuando se habilitan los registros de Cloud Logging para un trabajo, este servicio genera automáticamente cualquiera de los registros que se escriben para el trabajo. Específicamente, los trabajos por lotes pueden tener los siguientes tipos de registros:
Registros del agente (
batch_agent_logs
): Son registros de las actividades del agente de servicio por lotes.Por lotes, se escriben automáticamente registros de agentes para cada trabajo que habilitó el registro.
registros de tareas (
batch_task_logs
): registros de todos los datos que configuraste ejecutables del trabajo para escribir transmisión de salida estándar (stdout
) o transmisión con error estándar (stderr
).De manera opcional, puedes escribir registros de tareas para cada trabajo que haya habilitado el registro.
Visualiza los registros de un trabajo
Puedes ver los registros de un trabajo con la consola de Google Cloud, la CLI de gcloud, la API de Logging, Go, Java, Python o C++.
Console
Para ver los registros de un trabajo con la consola de Google Cloud, haz lo siguiente:
En la consola de Google Cloud, ve a la página Lista de trabajos.
En la columna Nombre del trabajo, haz clic en el nombre de un trabajo. Se abrirá la página Detalles del trabajo.
Haz clic en la pestaña Registros. Batch muestra todos los registros asociados con el trabajo.
Opcional: Para filtrar los registros, haz lo siguiente:
Ingresa un filtro en el campo Filtro.
En la lista Gravedad, selecciona una gravedad.
Haz clic en crear una consulta con el Explorador de registros Parámetros de filtro por lotes.
Ver en el Explorador de registros. para
gcloud
Para ver los registros con la CLI de gcloud, usa el comando gcloud logging read
:
gcloud logging read "QUERY"
En el ejemplo anterior, QUERY
es un valor
por lotes que contenga
Parámetros de filtro por lotes.
API
Para ver registros con la API de Logging, usa el
Método entries.list
:
POST https://logging.googleapis.com/v2/entries:list
{
"resourceNames": [
"projects/PROJECT_ID"
],
"filter": "QUERY"
"orderBy": "timestamp desc"
}
Reemplaza lo siguiente:
PROJECT_ID
: el ID del proyecto de tu proyecto.QUERY
: un por lotes que contenga Parámetros de filtro por lotes.
Go
Go
Para obtener más información, consulta la API de Go por lotes documentación de referencia.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Java
Para obtener más información, consulta la API de Java por lotes documentación de referencia.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Python
Para obtener más información, consulta la documentación de referencia de la API de Python de lotes.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C++
C++
Para obtener más información, consulta la API de C++ por lotes documentación de referencia.
Para autenticarte en Batch, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Filtra registros de Batch
Para filtrar los registros por lotes, escribe una consulta que incluya uno o más de los siguientes parámetros de filtro y cero o más operadores booleanos (AND
, OR
y NOT
).
Para filtrar los registros de un trabajo específico, especifica el ID único del trabajo (UID):
labels.job_uid=JOB_UID
En el ejemplo anterior,
JOB_UID
es el UID del trabajo. Para obtener el UID de un trabajo, consulta los detalles del trabajo.Para filtrar un tipo específico de registros de lotes, especifica el tipo de registro:
logName=projects/PROJECT_ID/logs/BATCH_LOG_TYPE
Reemplaza lo siguiente:
PROJECT_ID
: el ID del proyecto del proyecto para el que deseas ver los registros.BATCH_LOG_TYPE
: Es el tipo de Los registros por lotes que quieres ver, ya seabatch_task_logs
para los registros de tareas obatch_agent_logs
para los registros del agente.
Para filtrar registros con eventos de estado personalizados, especifica que el registro debe definir el campo
jsonPayload.batch/custom/event
:jsonPayload.batch"/"custom"/"event!=NULL_VALUE
Para filtrar registros de una o más gravedades específicas, especifica la siguiente comparación:
severityCOMPARISON_OPERATORSEVERITY_ENUM
Reemplaza lo siguiente:
COMPARISON_OPERATOR
: Un operador de comparación, por ejemplo,>=
.SEVERITY_ENUM
: Una enumeraciónLogSeverity
que describe la gravedad de un registro, por ejemplo,ERROR
.
Para obtener más opciones de filtro, consulta la documentación del lenguaje de consulta de Cloud Logging.
¿Qué sigue?
- Obtén más información sobre la solución de problemas.
- Obtén más información sobre Cloud Logging.
- Obtén más información para escribir registros de tareas.
- Obtén más información sobre cómo exportar información de trabajo.
- Obtén más información para borrar trabajos.