# chaosblade | ChaosBlade | Knowledge Base | Instagit

An easy to use and powerful chaos engineering experiment toolkit.（阿里巴巴开源的一款简单易用、功能强大的混沌实验注入工具）

GitHub Stars: 6.3k

Repository: https://github.com/chaosblade-io/chaosblade

---

## Articles

### [How to Migrate Experiments from Older ChaosBlade Versions to Newer Releases](/chaosblade-io/chaosblade/how-to-migrate-experiments-from-older-chaosblade-versions-to-newer-ones)

Easily migrate ChaosBlade experiments to newer releases. Learn how automatic schema detection and incremental updates simplify your upgrade process. Upgrade ChaosBlade confidently.

- Tags: migration-guide
- Published: 2026-02-27

### [Understanding the Relationship Between ChaosBlade and ChaosBlade-Operator](/chaosblade-io/chaosblade/whats-the-relationship-between-chaosblade-and-chaosblade-operator)

Discover the core relationship between ChaosBlade the engine and ChaosBlade-Operator the Kubernetes controller. Learn how experiments bridge to cluster resources via CRDs.

- Tags: internals
- Published: 2026-02-27

### [How ChaosBlade Handles Concurrent Experiments on the Same Target](/chaosblade-io/chaosblade/how-does-chaosblade-handle-concurrent-experiments-on-the-same-target)

Learn how ChaosBlade handles concurrent experiments on the same target using UID-level isolation and SQLite unique constraints for interference-free simultaneous runs.

- Tags: internals
- Published: 2026-02-27

### [Common Failure Modes When Injecting Faults Into Containers With ChaosBlade](/chaosblade-io/chaosblade/what-are-common-failure-modes-when-injecting-faults-into-containers)

Discover common failure modes when injecting faults into containers with ChaosBlade. Learn about executor resolution errors, invalid container IDs, and connectivity issues before applying faults.

- Tags: how-to-guide
- Published: 2026-02-27

### [How HTTP Server Mode Enables Remote Chaos Execution in ChaosBlade](/chaosblade-io/chaosblade/how-does-the-http-server-mode-enable-remote-chaos-execution)

Explore how ChaosBlade's HTTP server mode enables remote chaos execution. Trigger experiments via RESTful API using the same pipeline as the CLI for seamless control.

- Tags: how-to-guide
- Published: 2026-02-27

### [How to Extend ChaosBlade with Custom Matchers and Flags: A Complete Guide](/chaosblade-io/chaosblade/how-to-extend-chaosblade-with-custom-matchers-and-flags)

Extend ChaosBlade with custom matchers and flags dynamically without recompiling. Learn how to edit YAML specs for a complete guide. Accelerate your chaos engineering.

- Tags: how-to-guide
- Published: 2026-02-27

### [Chaosblade-Spec-Go Architecture: Understanding the ChaosBlade Specification Module](/chaosblade-io/chaosblade/whats-the-architecture-of-the-chaosblade-spec-go-specification-module)

Explore the chaosblade-spec-go architecture, a pure Go contract layer defining experiment models and execution channels for ChaosBlade fault injection. Understand its role in separating core engine and backends.

- Tags: architecture
- Published: 2026-02-27

### [How to Handle Experiments That Exceed Timeout or Hang Indefinitely in ChaosBlade](/chaosblade-io/chaosblade/how-to-handle-experiments-that-exceed-timeout-or-hang-indefinitely)

Discover how ChaosBlade manages experiments exceeding timeout or hanging indefinitely using background execution and automatic destroy commands for reliable chaos engineering.

- Tags: how-to-guide
- Published: 2026-02-27

### [Best Practices for Organizing and Naming Chaos Experiments in ChaosBlade](/chaosblade-io/chaosblade/what-are-best-practices-for-organizing-and-naming-chaos-experiments)

Master organizing and naming ChaosBlade experiments. Learn best practices for target action tuples and command specifications to streamline your chaos engineering. Optimize your experiments today.

- Tags: best-practices
- Published: 2026-02-27

### [How ChaosBlade Uses SQLite to Track Experiment State: Internal Database Mechanisms](/chaosblade-io/chaosblade/how-does-the-sqlite-database-track-experiment-state)

Discover how ChaosBlade uses SQLite to track experiment state. Learn about internal database mechanisms managing experiment lifecycles and statuses in this technical deep dive.

- Tags: internals
- Published: 2026-02-27

### [How to Write Custom Executors for Adding New Experiment Target Types in ChaosBlade](/chaosblade-io/chaosblade/how-to-write-custom-executors-for-adding-new-experiment-target-types)

Learn to write custom executors for new experiment target types in ChaosBlade. Implement the spec.Executor interface, create a factory function, and register your executor to extend ChaosBlade's capabilities.

- Tags: how-to-guide
- Published: 2026-02-27

### [Security Considerations When Running ChaosBlade in Production: A Complete Guide](/chaosblade-io/chaosblade/what-security-considerations-exist-when-running-chaosblade-in-production)

Discover essential security considerations for running ChaosBlade in production Address root privileges, capability constraints, container isolation, and HTTP server risks for safe chaos engineering.

- Tags: best-practices
- Published: 2026-02-27

### [How the ChaosBlade Kubernetes Operator Manages the Chaos Experiment Lifecycle](/chaosblade-io/chaosblade/how-does-the-kubernetes-operator-manage-the-chaos-experiment-lifecycle)

Discover how the ChaosBlade Kubernetes operator streamlines chaos experiment management. Learn about the create-monitor-destroy lifecycle powered by the ChaosBlade CRD for efficient chaos engineering.

- Tags: how-to-guide
- Published: 2026-02-27

### [How Experiment Cleanup and Resource Recovery Work in ChaosBlade](/chaosblade-io/chaosblade/how-does-experiment-cleanup-and-resource-recovery-work)

Learn how ChaosBlade cleans up experiments by reverting faults and persisting states. Discover resource recovery and the force removal option in Kubernetes.

- Tags: internals
- Published: 2026-02-27

### [What Is the Performance Overhead and Resource Consumption of Running Chaos Experiments?](/chaosblade-io/chaosblade/what-are-the-performance-overhead-and-resource-consumption-of-running-chaos-experiments)

Discover the performance overhead and resource consumption of ChaosBlade experiments. Learn how ChaosBlade adds minimal overhead, using ~1% CPU and MBs of RAM, while external binaries self-terminate.

- Tags: performance
- Published: 2026-02-27

### [How to Integrate ChaosBlade with CI/CD Pipelines: Complete Build Guide](/chaosblade-io/chaosblade/how-to-integrate-chaosblade-with-ci-cd-pipelines)

Integrate ChaosBlade with CI/CD pipelines using Makefile targets for consistent Go builds, cross-platform compilation, and Docker image creation on any platform.

- Tags: how-to-guide
- Published: 2026-02-27

### [How JVM Agent Injection Works for Java Chaos Engineering in ChaosBlade](/chaosblade-io/chaosblade/how-does-jvm-agent-injection-work-for-java-application-experiments)

Discover how JVM agent injection in ChaosBlade enhances Java chaos engineering. Learn how it attaches a sandbox agent to inject fault experiments into running Java applications.

- Tags: internals
- Published: 2026-02-27

### [How to Execute Chaos Experiments Remotely via SSH Channel in ChaosBlade](/chaosblade-io/chaosblade/how-to-execute-chaos-experiments-remotely-via-ssh-channel)

Execute chaos experiments remotely via SSH channel with ChaosBlade. The --channel=ssh flag securely runs commands on target hosts without agents. Learn how now.

- Tags: how-to-guide
- Published: 2026-02-27

### [ChaosBlade Prepare vs Create Commands: Key Differences Explained](/chaosblade-io/chaosblade/whats-the-difference-between-the-prepare-and-create-commands)

Understand the key differences between ChaosBlade prepare and create commands. Learn when to use them to setup your environment or launch chaos experiments effectively.

- Tags: deep-dive
- Published: 2026-02-27

### [How to Debug Failed or Hanging Chaos Experiments in ChaosBlade](/chaosblade-io/chaosblade/how-to-debug-failed-or-hanging-chaos-experiments)

Debug failed or hanging ChaosBlade experiments with the --debug flag. Uncover detailed logs to understand and resolve issues with your ChaosBlade experiments efficiently.

- Tags: how-to-guide
- Published: 2026-02-27

### [How the Kubernetes Executor Interacts with ChaosBlade CRDs: Implementation Deep Dive](/chaosblade-io/chaosblade/how-does-the-kubernetes-executor-interact-with-chaosblade-crds)

Understand how the Kubernetes executor translates CLI specs into ChaosBlade CRDs and manages their lifecycle within the chaosblade-io/chaosblade repository. Learn the implementation details.

- Tags: deep-dive
- Published: 2026-02-27

### [How to Create Custom Chaos Experiment Scenarios for New Targets in ChaosBlade](/chaosblade-io/chaosblade/how-to-create-custom-chaos-experiment-scenarios-for-new-targets)

Learn to create custom chaos experiment scenarios for new targets in ChaosBlade. Implement the spec executor interface, define command specs, and register your executor.

- Tags: how-to-guide
- Published: 2026-02-27

### [How the ChaosBlade Experiment Model Works Internally: Target-Action-Flag Architecture](/chaosblade-io/chaosblade/how-does-the-chaosblade-experiment-model-target-action-flag-work-internally)

Explore the internal workings of the ChaosBlade experiment model. Understand how the target-action-flag architecture maps to SQLite records for persistent, reversible chaos experiments.

- Tags: internals
- Published: 2026-02-27