Skip to content

Status Specification

It contains status details provided at status inside chaosresult.

Experiment Status

It contains experiment status provided at status.experimentStatus inside chaosresult. It contains following fields:

  • failStep: Flag to show the failure step of the ChaosExperiment
  • phase: Flag to show the current phase of the experiment
  • probesuccesspercentage: Flag to show the probe success percentage
  • verdict: Flag to show the verdict of the experiment
View the experiment status

Field .status.experimentStatus.failstep
Description Flag to show the failure step of the ChaosExperiment
Range n/a(type: string)
Notes The .status.experimentStatus.failstep Show the step at which the experiment failed. It helps in faster debugging of failures in the experiment execution.

Field .status.experimentStatus.phase
Description Flag to show the current phase of the experiment
Range Awaited,Running,Completed,Aborted (type: string)
Notes The .status.experimentStatus.phase shows the current phase in which the experiment is. It gets updated as the experiment proceeds.If the experiment is aborted then the status will be Aborted.

Field .status.experimentStatus.probesuccesspercentage
Description Flag to show the probe success percentage
Range 1 to 100 (type: int)
Notes The .status.experimentStatus.probesuccesspercentage shows the probe success percentage which is a ratio of successful checks v/s total probes.

Field .status.experimentStatus.verdict
Description Flag to show the verdict of the experiment.
Range Awaited,Pass,Fail,Stopped (type: string)
Notes The .status.experimentStatus.verdict shows the verdict of the experiment. It is Awaited when the experiment is in progress and ends up with Pass or Fail according to the experiment result.

view the sample example:

Name:         engine-nginx-pod-delete
Namespace:    default
Labels:       app.kubernetes.io/component=experiment-job
              app.kubernetes.io/part-of=litmus
              app.kubernetes.io/version=1.13.8
              chaosUID=aa0a0084-f20f-4294-a879-d6df9aba6f9b
              controller-uid=6943c955-0154-4542-8745-de991eb47c61
              job-name=pod-delete-w4p5op
              name=engine-nginx-pod-delete
Annotations:  <none>
API Version:  litmuschaos.io/v1alpha1
Kind:         ChaosResult
Metadata:
  Creation Timestamp:  2021-09-29T13:28:59Z
  Generation:          6
  Resource Version:    66788
  Self Link:           /apis/litmuschaos.io/v1alpha1/namespaces/default/chaosresults/engine-nginx-pod-delete
  UID:                 fe7f01c8-8118-4761-8ff9-0a87824d863f
Spec:
  Engine:      engine-nginx
  Experiment:  pod-delete
Status:
  Experiment Status:
    # step on which experiment fails
    Fail Step:                 N/A
    # phase of the chaos result
    Phase:                     Completed
    # Success Percentage of the litmus probes
    Probe Success Percentage:  100
    # Verdict of the chaos result
    Verdict:                   Pass
  History:
    Failed Runs:   1
    Passed Runs:   1
    Stopped Runs:  0
    Targets:
      Chaos Status:  targeted
      Kind:          deployment
      Name:          hello
Events:              <none>

Result History

It contains history of experiment runs present at status.history. It contains following fields:

  • passedRuns: It contains cumulative passed run count
  • failedRuns: It contains cumulative failed run count
  • stoppedRuns: It contains cumulative stopped run count
  • targets.name: It contains name of target application
  • target.kind: It contains kinds of target application
  • target.chaosStatus: It contains chaos status
View the history details

Field .status.history.passedRuns
Description It contains cumulative passed run count
Range ANY NON NEGATIVE INTEGER
Notes The .status.history.passedRuns contains cumulative passed run counts for a specific ChaosResult.

Field .status.history.failedRuns
Description It contains cumulative failed run count
Range ANY NON NEGATIVE INTEGER
Notes The .status.history.failedRuns contains cumulative failed run counts for a specific ChaosResult.

Field .status.history.stoppedRuns
Description It contains cumulative stopped run count
Range ANY NON NEGATIVE INTEGER
Notes The .status.history.stoppedRuns contains cumulative stopped run counts for a specific ChaosResult.

Field .status.history.targets.name
Description It contains name of the target application
Range string
Notes The .status.history.targets.name contains name of the target application

Field .status.history.targets.kind
Description It contains kind of the target application
Range string
Notes The .status.history.targets.kind contains kind of the target application

Field .status.history.targets.chaosStatus
Description It contains status of the chaos
Range targeted, injected, reverted
Notes The .status.history.targets.chaosStatus contains status of the chaos

view the sample example:

Name:         engine-nginx-pod-delete
Namespace:    default
Labels:       app.kubernetes.io/component=experiment-job
              app.kubernetes.io/part-of=litmus
              app.kubernetes.io/version=1.13.8
              chaosUID=aa0a0084-f20f-4294-a879-d6df9aba6f9b
              controller-uid=6943c955-0154-4542-8745-de991eb47c61
              job-name=pod-delete-w4p5op
              name=engine-nginx-pod-delete
Annotations:  <none>
API Version:  litmuschaos.io/v1alpha1
Kind:         ChaosResult
Metadata:
  Creation Timestamp:  2021-09-29T13:28:59Z
  Generation:          6
  Resource Version:    66788
  Self Link:           /apis/litmuschaos.io/v1alpha1/namespaces/default/chaosresults/engine-nginx-pod-delete
  UID:                 fe7f01c8-8118-4761-8ff9-0a87824d863f
Spec:
  Engine:      engine-nginx
  Experiment:  pod-delete
Status:
  Experiment Status:
    Fail Step:                 N/A
    Phase:                     Completed
    Probe Success Percentage:  100
    Verdict:                   Pass
  History:
    # fail experiment run count
    Failed Runs:   1
    # passed experiment run count
    Passed Runs:   1
    # stopped experiment run count
    Stopped Runs:  0
    Targets:
      # status of the chaos
      Chaos Status:  targeted
      # kind of the application
      Kind:          deployment
      # name of the application
      Name:          hello
Events:              <none>