Errores conocidos

En esta página, se describen problemas conocidos con los que puedes encontrarte cuando usas Batch.

Si necesitas más ayuda para usar Batch, consulta la documentación de solución de problemas o obtén asistencia.

Es posible que Pub/Sub no envíe notificaciones para estados intermedios durante cambios rápidos

Es posible que Pub/Sub no envíe notificaciones para todos los estados intermedios cuando un trabajo o una tarea cambian muy rápido. Por ejemplo, supongamos que una tarea cambia rápidamente de estado de ASSIGNED a RUNNING y, luego, a FAILED. En ese caso, es posible que no recibas una notificación de que la tarea alcanzó el estado RUNNING.

Para mitigar este problema, te recomendamos que, cuando quieras ver el historial de estado completo de un trabajo o una tarea, veas los eventos de estado en lugar de las notificaciones de Pub/Sub.

Para obtener más información sobre las notificaciones de Pub/Sub, consulta Supervisa el estado del trabajo con notificaciones de Pub/Sub y BigQuery.

Los registros de tiempo de espera no indican si se excedió el tiempo de espera de la tarea o del ejecutable

Cuando un trabajo falla por exceder un tiempo de espera, los registros asociados con el trabajo no indican si la falla se debió al tiempo de espera de la tarea correspondiente o al tiempo de espera del ejecutable correspondiente.

Para solucionar este problema, establece valores de tiempo de espera diferentes para las tareas y los ejecutables. Luego, puedes identificar si una falla se debió a que se excedió el tiempo de espera de la tarea o del ejecutable correspondiente con el siguiente procedimiento:

1. Identifica la tarea, el ejecutable y la hora de una falla por tiempo de espera excedido.

   1. Consulta los registros del trabajo.

   2. Busca un registro que mencione el código de salida de tiempo de espera excedido, 50005. Este registro tiene un textPayload similar al siguiente mensaje:

      Task task/JOB_UID-group0-TASK_INDEX/0/0 runnable RUNNABLE_INDEX...exitCode 50005
      

      En ese registro, registra TASK_INDEX como la tarea con errores, RUNNABLE_INDEX como el ejecutable con errores y el valor timestamp del registro como la hora de la falla por tiempo de espera excedido.

2. Identifica la hora de inicio de la tarea con errores.

   1. Consulta los eventos de estado de la tarea con errores.

   2. Busca el evento de estado que mencione el siguiente mensaje:

      Task state is updated from ASSIGNED to RUNNING
      

      En ese evento de estado, registra el campo eventTime como la hora de inicio de la tarea con errores.

3. Calcula el tiempo de ejecución total de la tarea con errores, \({failedTaskRunTime}\), con la siguiente fórmula:

   \[{failedTaskRunTime}={failureTime}-{failedTaskStartTime}\]

   Reemplaza los siguientes valores:

   • \({failureTime}\): Es la hora de la falla por tiempo de espera excedido.
   • \({failedTaskStartTime}\): Es la hora de inicio de la tarea con errores.

4. Identifica el tiempo de espera excedido:

   • Si \({failedTaskRunTime}\) coincide con el tiempo de espera que configuraste para la tarea con errores, se excedió el tiempo de espera de esa tarea con errores y se produjo la falla.

   • De lo contrario, se excedió el tiempo de espera que configuraste para el ejecutable con errores y se produjo la falla.

Es posible que los trabajos que consumen reservas se retrasen o se impidan

Cuando intentas crear y ejecutar un trabajo que consume reservas de Compute Engine, es posible que Batch retrase o impida incorrectamente que se ejecute el trabajo. En particular, Batch requiere que los proyectos tengan suficientes cuotas de recursos de Compute Engine incluso cuando esas cuotas de recursos se usan en reservas no consumidas.

Soluciona el problema

Para solucionar este problema en un trabajo, agrega una etiqueta con el nombre goog-batch-skip-quota-check y el valor true al campo labels a nivel del trabajo. Esta etiqueta hace que Batch omita la verificación de las cuotas de recursos de tu proyecto antes de intentar crear un trabajo.

**Importante:** No se recomienda habilitar la etiqueta goog-batch-skip-quota-check para los trabajos que no pueden consumir ninguna reserva en tu proyecto. Por ejemplo, evita esta solución alternativa cuando tu proyecto no tenga reservas de Compute Engine o cuando un trabajo requiera VMs que no sean compatibles con esas reservas. De lo contrario, si los trabajos omiten innecesariamente las verificaciones de cuota, es posible que veas fallas innecesarias por cuota insuficiente.

Por ejemplo, para evitar o resolver este problema en un trabajo de secuencia de comandos básico que puede consumir reservas, crea y ejecuta un trabajo con la siguiente configuración de JSON:

{
  "taskGroups": [
    {
      "taskSpec": {
        "runnables": [
          {
            "script": {
              "text": "echo Hello world from task ${BATCH_TASK_INDEX}"
            }
          }
        ]
      },
      "taskCount": 3
    }
  ],
  "allocationPolicy": {
    "instances": [
      {
        VM_RESOURCES
      }
    ],
  },
  "labels": {
    "goog-batch-skip-quota-check": "true"
  },
  "logsPolicy": {
    "destination": "CLOUD_LOGGING"
  }
}

Reemplaza VM_RESOURCES por los recursos de VM que coinciden con la reserva que deseas que consuma el trabajo.

Para obtener más instrucciones, consulta Crea y ejecuta un trabajo que pueda consumir VMs reservadas y Define etiquetas personalizadas para el trabajo.

Identifica el problema

Este problema no se indica con ningún mensaje de error específico. En cambio, este problema puede ocurrir en las siguientes circunstancias:

• Si tu proyecto reserva todos los recursos para los que tiene cuota, este problema impide cualquier trabajo que especifique esos recursos.

  Por ejemplo, supongamos que tu proyecto tiene lo siguiente:

  • Una cuota máxima para las GPU H100 de 16.
  • Una reserva de un solo proyecto no consumida para 2 VMs a3-highgpu-8g, que reserva 16 GPU H100 en total.

  En este caso, este problema impide que tu proyecto programe y ejecute cualquier trabajo que esté configurado correctamente para consumir cualquiera de las GPU H100 reservadas.

• Si tu proyecto reserva algunos de los recursos para los que tiene cuota, este problema puede impedir o retrasar los trabajos que especifican esos recursos.

  Por ejemplo, supongamos que tu proyecto tiene lo siguiente:

  • Una cuota máxima para las GPU H100 de 16.
  • Una reserva de un solo proyecto no consumida para 1 VM a3-highgpu-8g, que reserva 8 GPU H100 en total.
  • Una VM a3-highgpu-8g que está configurada para no consumir ninguna reserva y que, en ocasiones, se borra y se vuelve a crear. (Esta VM usa 8 GPU H100 no reservadas cuando existe).

  En este caso, este problema solo permite que tu proyecto programe y comience a ejecutar cualquier trabajo que esté configurado correctamente para consumir cualquiera de las GPU H100 reservadas cuando la VM a3-highgpu-8g no existe.

Es posible que los trabajos fallen cuando se especifican imágenes de SO de VM de Compute Engine (o personalizadas) con kernels desactualizados

Un trabajo puede fallar si especifica una imagen de SO de VM de Compute Engine que no tiene la versión de kernel más reciente. Este problema también afecta a las imágenes personalizadas basadas en imágenes de SO de VM de Compute Engine. Las imágenes públicas de Compute Engine que causan este problema no se identifican fácilmente y están sujetas a cambios en cualquier momento.

Este problema no se indica con un mensaje de error específico. En cambio, considera este problema si tienes un trabajo que falla de forma inesperada y especifica una imagen de SO de VM de Compute Engine o una imagen personalizada similar.

Para evitar o resolver este problema, puedes hacer lo siguiente:

Nota: Si tu trabajo usa GPU, consulta también Los trabajos que usan GPU y las imágenes de SO de VM con kernels desactualizados fallan solo cuando se instalan controladores automáticamente.

1. Siempre que sea posible, usa imágenes de Batch o imágenes personalizadas basadas en imágenes de Batch, que no se ven afectadas por este problema.
2. Si no puedes usar una imagen de Batch, prueba la versión más reciente de tu imagen de Compute Engine preferida. Por lo general, es más probable que las versiones más recientes de las imágenes de Compute Engine tengan la versión de kernel más reciente que las versiones anteriores.
3. Si la versión más reciente de una imagen específica no funciona, es posible que debas probar con otro SO o crear una imagen personalizada. Por ejemplo, si la versión más reciente de Debian 12 no funciona, puedes intentar crear una imagen personalizada a partir de una VM de Compute Engine que ejecute Debian 12 y que hayas actualizado para usar la versión de kernel más reciente.

Este problema se debe a una versión de kernel desactualizada en la imagen de SO de la VM que hace que la VM se reinicie. Cuando un trabajo especifica cualquier imagen de SO de VM que no sea de Batch o que no se base en una imagen de Batch, Batch instala los paquetes necesarios en las VMs del trabajo después de que se inician. Los paquetes necesarios pueden variar para diferentes trabajos y cambiar con el tiempo, y es posible que requieran que tu imagen de SO de VM tenga la versión de kernel más reciente. Este problema aparece cuando la actualización de la versión de kernel requiere que la VM se reinicie, lo que hace que falle la instalación del paquete y el trabajo.

Para obtener más información sobre las imágenes de SO de VM, consulta Descripción general del entorno de SO para las VMs de un trabajo.

Es posible que los trabajos que usan GPU y las imágenes de SO de VM con kernels desactualizados fallen solo cuando se instalan controladores automáticamente

Este problema está estrechamente relacionado con Es posible que los trabajos fallen cuando se especifican imágenes de SO de VM de Compute Engine (o personalizadas) con kernels desactualizados. En particular, los trabajos que especifican una imagen de SO de VM de Compute Engine (o personalizada) sin el kernel más reciente y usan GPU pueden fallar solo si intentas instalar los controladores de GPU automáticamente. Para estos trabajos, también puedes resolver las fallas si instalas los controladores de GPU de forma manual.

Para obtener más información sobre las GPU, consulta Crea y ejecuta un trabajo que use GPU.