Comparteix via


Evento de error en tareas

Este evento se genera cuando una tarea se completa con un error. Actualmente, todos los códigos de salida distintos de cero se consideran errores. Este evento se genera además de un evento de tarea completa y se puede usar para detectar cuándo se produce un error en una tarea.

En el ejemplo siguiente se muestra el cuerpo de un evento de error de tarea.

{
    "jobId": "myJob",
    "id": "myTask",
    "taskType": "User",
    "systemTaskVersion": 0,
    "requiredSlots": 1,
    "nodeInfo": {
        "poolId": "pool-001",
        "nodeId": "tvm-257509324_1-20160908t162728z"
    },
    "multiInstanceSettings": {
        "numberOfInstances": 1
    },
    "constraints": {
        "maxTaskRetryCount": 2
    },
    "executionInfo": {
        "startTime": "2016-09-08T16:32:23.799Z",
        "endTime": "2016-09-08T16:34:00.666Z",
        "exitCode": 1,
        "retryCount": 2,
        "requeueCount": 0,
        "result": "Failure",
        "schedulingError": {
            "category": "UserError",
            "code": "FailureExitCode",
            "message": "The task exited with an exit code representing a failure",
            "details": []
        }
    }
}
Nombre del elemento Tipo Notas
jobId Cuerda Identificador del trabajo que contiene la tarea.
id Cuerda Identificador de la tarea.
taskType Cuerda Tipo de la tarea. Es "JobManager" que indica que es una tarea de administrador de trabajos o "Usuario" que indica que no es una tarea de administrador de trabajos. Este evento no se emite para las tareas de preparación del trabajo, las tareas de liberación de trabajos ni las tareas de inicio.
systemTaskVersion Int32 Es el contador de reintento interno en una tarea. Internamente, el servicio Batch puede reintentar una tarea para tener en cuenta problemas transitorios. Estos problemas pueden incluir errores de programación interna o intentos de recuperación de nodos de proceso en un estado incorrecto.
requiredSlots Int32 Ranuras necesarias para ejecutar la tarea.
nodeInfo Tipo complejo Contiene información sobre el nodo de proceso en el que se ejecutó la tarea.
multiInstanceSettings Tipo complejo Especifica que la tarea es una tarea de instancias múltiples que requiere varios nodos de proceso. Consulte multiInstanceSettings para obtener más información.
constraints Tipo complejo Restricciones de ejecución que se aplican a esta tarea.
executionInfo Tipo complejo Contiene información sobre la ejecución de la tarea.

nodeInfo

Nombre del elemento Tipo Notas
poolId Cuerda Identificador del grupo en el que se ejecutó la tarea.
nodeId Cuerda Identificador del nodo en el que se ejecutó la tarea.

multiInstanceSettings

Nombre del elemento Tipo Notas
numberOfInstances Int32 Número de nodos de proceso requeridos por la tarea.

Restricciones

Nombre del elemento Tipo Notas
maxTaskRetryCount Int32 Número máximo de veces que se puede reintentar la tarea. El servicio Batch reintenta una tarea si su código de salida es distinto de cero.

Este valor controla específicamente el número de reintentos. El servicio Batch intenta la tarea una vez y, a continuación, puede volver a intentarlo hasta este límite. Por ejemplo, si el número máximo de reintentos es 3, Batch intenta una tarea hasta cuatro veces (un intento inicial y tres reintentos).

Si el número máximo de reintentos es 0, el servicio Batch no reintenta las tareas.

Si el número máximo de reintentos es -1, el servicio Batch reintenta las tareas sin límite.

El valor predeterminado es 0 (sin reintentos).

executionInfo

Nombre del elemento Tipo Notas
startTime Fecha y hora Hora a la que se inició la ejecución de la tarea. "En ejecución" corresponde al estado de ejecución , por lo que si la tarea especifica archivos de recursos o paquetes de aplicación, la hora de inicio refleja la hora en la que la tarea comenzó a descargarlas o implementarlas. Si la tarea se reinicia o se reintenta, es la hora más reciente en la que se inició la ejecución de la tarea.
endTime Fecha y hora Hora a la que se completó la tarea.
exitCode Int32 Código de salida de la tarea. Si se produjo un error en la tarea antes de empezar a ejecutarse, exitCode es null.
retryCount Int32 Número de veces que el servicio Batch reintenta la tarea. La tarea se reintenta si sale con un código de salida distinto de cero, hasta el valor de MaxTaskRetryCount especificado.
requeueCount Int32 Número de veces que el servicio Batch volvió a poner en cola la tarea como resultado de la solicitud del usuario.

Cuando los nodos se quitan de un grupo (mediante el cambio de tamaño o la reducción) o un trabajo está deshabilitado, puede optar por volver a poner en cola las tareas en ejecución en esos nodos. Este recuento realiza un seguimiento de cuántas veces se ha vuelto a poner en cola una tarea por estos motivos.
result Cuerda La cadena de resultado de la tarea, podría ser "Correcto" o "Error".
schedulingError Tipo complejo Contiene información detallada sobre el error.

schedulingError

Nombre del elemento Tipo Notas
category Cuerda La categoría de error, por ejemplo, "UserError".
code Cuerda El código de error, por ejemplo, "FailureExitCode".
message Cuerda El mensaje de error.
details Array Detalles del error.