Job Status

The jobStatus analyzer is used to report on the status of a job. The when attribute supports standard comparators to compare the number successful and failed pods within the job.

The jobStatus analyzer uses data from the clusterResources collector. The clusterResources collector is automatically added and will always be present.

The target job can be identified by name. The outcomes on this analyzer will be processed in order, and execution will stop after the first outcome that is truthy. Outcomes are optional in this analyzer. If no outcomes are specified, the Job's spec and status will be examined to automatically determine its status. In this case, only failed jobs will be reported in the results.

Parameters

name: (Optional) The name of the job to check. If name is not specified, all jobs will be analyzed.

namespace: (Optional) The namespace to look for the job in. If specified, analysis will be limited to jobs in this namespace.

namespaces: (Optional) The namespaces to look for the job in. If specified, analysis will be limited to jobs in these namespaces.

Example Analyzer Definition

apiVersion: troubleshoot.sh/v1beta2
kind: Preflight
metadata:
  name: post-install-job
spec:
  analyzers:
    - jobStatus:
        name: post-install-job
        namespace: default
        outcomes:
          - pass:
              when: "succeeded > 5"
              message: The post-install job has succeeded.
          - fail:
              when: "failed > 1"
              message: Too many containers in post-install job have failed.