Version: 1.0.0

StressChaos Experiment

This document helps you create StressChaos experiments.

StressChaos can generate plenty of stresses over a collection of pods. The stressors is injected into the target pods via the chaos-daemon internally.

Configuration

A StressChaos shares common configurations like other chaos, such as how to select pods, how to specify periodic chaos. You can refer to other docs for details. It defines stressors in either of the following two ways:

  • stressors

    Stressors defines a plenty of stressors supported to stress system components out. You can use one or more of them to make up various kinds of stresses. At least one of the stressors should be specified. The following is supported stressors for now:

    1. memory

      A memory stressor will continuously stress virtual memory out.

      OptionTypeRequiredDescription
      workersIntegerTrueSpecifies concurrent stressing instance.
      sizeStringFalseSpecifies memory size consumed per worker, default is the total available memory. One can also specify the size as % of total available memory or in units of B, KB/KiB, MB/MiB, GB/GiB, TB/TiB.
    2. cpu

      A cpu stressor will continuously stress CPU out.

      OptionTypeRequiredDescription
      workersIntegerTrueSpecifies concurrent stressing instance. Actually it specifies how many CPUs to stress when it's less than available CPUs.
      loadIntegerFalseSpecifies percent loading per worker. 0 is effectively a sleep (no load) and 100 is full loading.
  • stressngStressors

    StressngStressors defines a plenty of stressors just like Stressors except that it's an experimental feature and more powerful.

    You can define stressors in stress-ng (see also man stress-ng) dialect.

    Note:

    However, not all of the supported stressors are well tested. It might be retired in later releases. Therefore, it is recommended to use Stressors to define the stressors and use this only when you want more stressors unsupported by Stressors.

    When both StressngStressors and Stressors are defined, StressngStressors wins.

Usage

Below is an example YAML file of StressChaos which is set to burn 1 CPU for 30 seconds in every 2 minutes:

apiVersion: chaos-mesh.org/v1alpha1
kind: StressChaos
metadata:
name: burn-cpu
namespace: chaos-testing
spec:
mode: one
selector:
namespaces:
- tidb-cluster-demo
stressors:
cpu:
workers: 1
duration: "30s"
scheduler:
cron: "@every 2m"
  1. Create a namespace for your application. For example, tidb-cluster-demo:

    kubectl create ns tidb-cluster-demo
  2. Create your pods in the target namespace:

    kubectl apply -f *your-pods.yaml*
  3. Inject a StressChaos:

    kubectl apply -f *your-stress-chaos.yaml*

Then, your pod's CPU will burn for 30 seconds.