Skip to main content
Version: 1.0.3

Define the Scope of Chaos Experiment

This document describes how to define the scope of a chaos experiment.

Chaos Mesh provides a variety of selectors, which you can use to define the scope of your chaos experiment. These selectors are defined in the spec.selector field of the chaos object.

Namespace selectors​

Namespace selectors filter the chaos experiment targets by the namespace. Defined as a set of strings. The default namespace selector for Chaos Mesh is the chaos experiment object. For example:

spec:
  selector:
    namespaces:
      - 'app-ns'

Label selectors​

Label selectors filter chaos experiment targets by the label. Defined as a map of string keys and values. For example:

spec:
  selector:
    labelSelectors:
      'app.kubernetes.io/component': 'tikv'

Annotation selectors​

Annotation selectors filter chaos experiment targets by the annotation. Defined as a map of string keys and values. For example:

spec:
  selector:
    annotationSelectors:
      'example-annotation': 'group-a'

Field selectors​

Field selectors filter chaos experiment targets by the resource field. Defined as a map of string keys and values. For example:

spec:
  selector:
    fieldSelectors:
      'metadata.name': 'my-pod'

For more details about field selectors, refer to the Kubernetes document.

Pod phase selectors​

Pod Phase selectors filter chaos experiment targets by the condition. Defined as a set of string. Supported conditions: Pending, Running, Succeeded, Failed, Unknown. For example:

spec:
  selector:
    podPhaseSelectors:
      - 'Running'

Pod selectors​

Pod selectors filter chaos experiment targets by the pod. Defined as a map of string keys and values. The key in this map specifies the namespace which the pods belong to, and each value under the key is a pod. If this selector is not empty, these pod defined in this map are used directly and other defined selectors will be ignored. For example:

spec:
  selector:
    pods:
      tidb-cluster: # namespace of the target pods
        - basic-tidb-0
        - basic-pd-0
        - basic-tikv-0
        - basic-tikv-1