Simulate Time Faults

TimeChaos Introduction

Chaos Mesh provides the TimeChaos experiment type. You can use this experiment type to simulate a time offset scenario. This document describes how to create a TimeChaos experiment and its associated configuration file.

note

TimeChaos only affects the PID 1 process in the PID namespace of the container, and child processes of the PID 1. For example, the process started by kubectl exec does not be affected.

You can create experiments in Chaos Dashboard or using the YAML configuration file.

Create experiments using Chaos Dashboard

1. Open Chaos Dashboard, and click NEW EXPERIMENT on the page to create a new experiment:

   

2. In the Choose a Target area, choose CLOCK SCREW and fill out the Clock ID and time offset.

   

3. Fill out the experiment information, and specify the experiment scope and the scheduled experiment duration:

   

4. Submit the experiment information.

Create experiments using the YAML file

1. Write the experiment configuration to the YAML configuration file. In the following example, the time-shift.yaml file is used.

   apiVersion: chaos-mesh.org/v1alpha1
   kind: TimeChaos
   metadata:
     name: time-shift-example
     namespace: chaos-mesh
   spec:
     mode: one
     selector:
       labelSelectors:
         'app': 'app1'
     timeOffset: '-10m100ns'

   This experiment configuration will shift the time of the processes in the specified Pod forward by 10 minutes and 100 nanoseconds.

2. After the configuration file is prepared, use kubectl to create an experiment:

   kubectl apply -f time-shift.yaml

The fields in the YAML configuration file are described in the following table: