Analiza un trabajo con registros

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

En esta página, se describe cómo habilitar y ver los registros de Cloud Logging para un trabajo.

Puedes usar registros a fin de obtener información que sea útil para analizar tus trabajos. Por ejemplo, los registros pueden ayudarte a depurar trabajos con errores. Cuando Cloud Logging está habilitado para un trabajo, Cloud Logging genera los siguientes tipos de registros que puedes ver:

  • Registros de tareas (batch_task_logs): Registros de cualquier dato escrito en los flujos de salida estándar (stdout) y de error estándar (stderr). Si deseas generar registros de tareas de tu trabajo, configúralas a fin de escribir datos para análisis y depuración en estas transmisiones.
  • Registros de agentes (batch_agent_logs): Registros de actividades del agente de servicios de Batch Batch genera de forma automática estos registros para tu trabajo.

Ten en cuenta que Cloud Logging solo genera registros después de que un trabajo comienza a ejecutarse. Para verificar si un trabajo comenzó a ejecutarse, descríbelo y confirma que el estado del trabajo sea RUNNING o un estado posterior. Si necesitas analizar un trabajo que no generó registros, por ejemplo, porque falló antes del estado RUNNING, describe el trabajo mediante la CLI de gcloud o la API de Batch y verifica el campo statusEvents.

Antes de comenzar

  • Si nunca usaste Batch, revisa Primeros pasos con Batch y completa los requisitos previos para proyectos y usuarios.
  • Si quieres obtener los permisos que necesitas para analizar un trabajo mediante registros, pídele a tu administrador que te otorgue las siguientes funciones de IAM:

    • Para crear un trabajo con registros habilitados, usa el editor de trabajos por lotes (roles/batch.jobsEditor) del proyecto.
    • Para ver los registros, usa el visor de registros (roles/logging.viewer) en el proyecto.

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.

Habilita registros para un trabajo

A fin de generar registros para un trabajo, habilita Cloud Logging cuando crees el trabajo:

  • Si creas un trabajo con Google Cloud Console, Cloud Logging siempre está habilitado.
  • Si creas un trabajo con la CLI de gcloud o la API de Batch, Cloud Logging está inhabilitado de forma predeterminada. A fin de habilitar Cloud Logging, incluye la siguiente configuración para el campo logsPolicy mientras creas el trabajo:

    {
        ...
        "logsPolicy": {
            "destination": "CLOUD_LOGGING"
        }
        ...
    }
    

Ver registros de un trabajo

Puedes ver los registros de un trabajo en Cloud Logging mediante Google Cloud Console, la CLI de gcloud o la API de Logging.

Consola

Para ver los registros de un trabajo con Google Cloud Console, haz lo siguiente:

  1. Describe un trabajo.
  2. En la página Detalles del trabajo, en la sección Registros, haz clic en Cloud Logging. Se abrirá la página Explorador de registros.

    De forma predeterminada, el Explorador de registros muestra todos los registros de tareas de este trabajo.

    Recomendado: Para filtrar qué registros se muestran, consultas de compilación; por ejemplo, ingresa una consulta de registros por lotes en el campo de editor de consultas.

gcloud

Para ver los registros mediante la CLI de gcloud, usa el comando gcloud logging read:

gcloud logging read "QUERY"

En el ejemplo anterior, QUERY es una consulta de registros de Batch.

API

Para ver los registros mediante 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:

Escribe consultas para filtrar los registros de Batch

Puedes filtrar los registros de Batch si escribes 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 (UID) del trabajo:

    labels.job_uid=JOB_UID
    

    En el ejemplo anterior, JOB_UID es el UID del trabajo. Para obtener el UID de un trabajo, describe el trabajo.

  • Para filtrar un tipo específico de registros de Batch, especifica el tipo de registro:

    logName=projects/PROJECT_ID/logs/BATCH_LOG_TYPE
    

    Reemplaza lo siguiente:

    • PROJECT_ID: el ID del proyectodel proyecto del que deseas ver los registros.
    • BATCH_LOG_TYPE: Es el tipo de registros por lotes que deseas ver, ya sea batch_task_logs para los registros de tareas o batch_agent_logs para los registros de agentes.

¿Qué sigue?