返回技能列表

run-chaos-experiment

pjt222
更新于 5 days ago
11 次查看
17
2
17
在 GitHub 上查看
测试aitestingdesign

关于

This skill enables developers to design and execute chaos engineering experiments using tools like Litmus or Chaos Mesh. It performs controlled fault injection to test system resilience, validate hypotheses, and improve failure recovery. Use it before major launches, after architecture changes, or during resilience drills to validate failure assumptions.

快速安装

Claude Code

推荐
主要方式
npx skills add pjt222/agent-almanac -a claude-code
插件命令备选方式
/plugin add https://github.com/pjt222/agent-almanac
Git 克隆备选方式
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/run-chaos-experiment

在 Claude Code 中复制并粘贴此命令以安装该技能

技能文档

執行混沌實驗

注入受控之故障以測試並改善系統韌性。

適用時機

  • 重大產品發佈前(負載測試)
  • 架構變更後(驗證韌性)
  • GameDay 或災難恢復演練期間
  • 為驗證對故障模式之假設
  • 作為 SRE 成熟度計劃之一部分

輸入

  • 必要:Kubernetes 集群(用於 Litmus 或 Chaos Mesh)
  • 必要:穩態定義(「正常」之樣貌)
  • 必要:欲測之假設(如「一個 pod 崩潰時 API 仍可用」)
  • 選擇性:可觀察性堆疊(Prometheus、Grafana)以量測影響
  • 選擇性:回滾計劃

步驟

步驟一:定義穩態與假設

記錄系統正常行為:

## Steady State Definition

### Service: API Gateway
- **Availability**: 99.9% (< 0.1% error rate)
- **Latency**: p95 < 200ms
- **Throughput**: 1000 req/s
- **Dependencies**: Database (Postgres), Cache (Redis), Auth Service

### Metrics
- `rate(http_requests_total{job="api"}[5m])`
- `histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m]))`
- `rate(http_requests_total{status=~"5.."}[5m])`

## Hypothesis
**"If one API pod is killed, the remaining pods will handle the load with <5s
disruption and no increase in error rate."**

### Validation Criteria
- Error rate remains <1%
- p95 latency stays <300ms (50ms grace)
- Service recovers within 5 seconds
- No cascading failures to downstream services

預期: 對正常行為與成功標準有清晰、可量測之定義。

失敗時: 若無法定義穩態,可觀察性不足。應先增加指標。

步驟二:設定爆炸半徑限制

縮小實驗範圍以最小化風險:

# chaos-config.yaml
apiVersion: v1
kind: Namespace
metadata:
  name: chaos-testing

---
# Label pods participating in chaos experiments
apiVersion: v1
kind: Pod
metadata:
  labels:
    chaos-enabled: "true"
    environment: staging  # NEVER production for first run

設定保護措施:

## Blast Radius Controls

### Environment
- **Scope**: Staging only (first 5 runs)
- **Production**: Only after 5 successful staging runs
- **Timing**: Business hours (09:00-17:00 local), never weekends/holidays

### Target Selection
- **Limit**: Max 1 pod per service
- **Percentage**: Max 25% of replicas
- **Exclusions**: Database, payment service, auth service (critical path)

### Auto-Abort Conditions
- Error rate >10% for >30 seconds
- Customer-facing alerts fire
- Manual abort signal from on-call engineer

### Rollback Plan
- Kubernetes will auto-restart killed pods
- Manual rollback: `kubectl rollout undo deployment/api`
- Incident declared if recovery takes >5 minutes

預期: 實驗有清晰邊界,不致打垮整個系統。

失敗時: 若爆炸半徑過大,縮小範圍。從一個非關鍵服務開始。

步驟三:安裝 Chaos Mesh

部署 Chaos Mesh(Kubernetes 原生):

# Add Chaos Mesh Helm repo
helm repo add chaos-mesh https://charts.chaos-mesh.org
helm repo update

# Install Chaos Mesh in isolated namespace
helm install chaos-mesh chaos-mesh/chaos-mesh \
  --namespace chaos-mesh \
  --create-namespace \
  --set dashboard.create=true \
  --set controllerManager.replicaCount=1

# Verify installation
kubectl get pods -n chaos-mesh

# Access dashboard
kubectl port-forward -n chaos-mesh svc/chaos-dashboard 2333:2333
# Open http://localhost:2333

替代:Litmus(中立於供應商):

# Install Litmus
kubectl apply -f https://litmuschaos.github.io/litmus/litmus-operator-v2.14.0.yaml

# Wait for Litmus pods
kubectl get pods -n litmus

# Install Litmus CRDs
kubectl apply -f https://hub.litmuschaos.io/api/chaos/master?file=charts/generic/experiments.yaml

預期: Chaos Mesh 或 Litmus 已運行,儀表板可存取。

失敗時: 檢查 RBAC 權限。混沌工具需集群範圍存取。

步驟四:建立並執行實驗

範例:Pod Kill 實驗(Chaos Mesh):

# pod-kill-experiment.yaml
apiVersion: chaos-mesh.org/v1alpha1
kind: PodChaos
metadata:
  name: api-pod-kill-test
  namespace: chaos-testing
spec:
  action: pod-kill
  mode: one  # Kill one pod only
  selector:
    namespaces:
      - production
    labelSelectors:
      app: api-gateway
      chaos-enabled: "true"
  duration: "30s"
  scheduler:
    cron: "@every 5m"  # Repeat every 5 minutes (for sustained testing)

施行實驗:

# Apply experiment
kubectl apply -f pod-kill-experiment.yaml

# Watch experiment status
kubectl get podchaos -n chaos-testing -w

# View detailed status
kubectl describe podchaos api-pod-kill-test -n chaos-testing

# Check which pods were affected
kubectl get events -n production --sort-by=.metadata.creationTimestamp | grep api-gateway

於 Grafana 監控影響:

# Error rate during experiment
rate(http_requests_total{status=~"5..", job="api"}[1m])

# Latency spike
histogram_quantile(0.95, rate(http_request_duration_seconds_bucket{job="api"}[1m]))

# Pod restarts
rate(kube_pod_container_status_restarts_total{pod=~"api-.*"}[5m])

預期: Pod 被殺,Kubernetes 重啟之,服務以小波動繼續。

失敗時: 若錯誤率激增或服務顯著降級,中止實驗並調查。

步驟五:分析結果並反覆

建立實驗報告:

# Chaos Experiment Report: API Pod Kill

**Date**: 2025-02-09
**Hypothesis**: API stays available if one pod crashes
**Tool**: Chaos Mesh
**Environment**: Staging
**Duration**: 30 seconds (pod kill + recovery)

## Results

### Metrics During Experiment
- **Error Rate**: Increased from 0.1% to 2.3% (spike lasted 8 seconds)
- **p95 Latency**: Increased from 180ms to 450ms (spike lasted 12 seconds)
- **Recovery Time**: 8 seconds (pod restart + load balancer update)

### Hypothesis Outcome
**FAILED**: Error rate exceeded 1% threshold, latency spike >300ms

## Root Cause Analysis
- Load balancer continued routing to killed pod for 8 seconds (stale endpoint)
- Readiness probe set to 10s interval (too slow)
- No pre-stop hook to drain connections gracefully

## Improvements Made
1. **Reduced readiness probe interval**: 10s → 2s
2. **Added pre-stop hook**: 5-second sleep for connection draining
3. **Tuned load balancer**: Enabled faster endpoint updates

## Follow-Up Experiment
- Re-run with same parameters in 1 week
- Expected: Error rate <1%, recovery <5s

於日誌追蹤實驗:

# chaos-experiment-log.csv
date,experiment,environment,status,error_rate_peak,recovery_time_s,outcome
2025-02-09,pod-kill-api,staging,complete,2.3%,8,failed
2025-02-16,pod-kill-api,staging,complete,0.8%,4,passed
2025-02-23,network-delay-db,staging,aborted,15%,N/A,failed

預期: 學習已捕捉、修正已實施、後續已排程。

失敗時: 若實驗後無行動,混沌工程淪為表演。應將修正列為優先。

步驟六:謹慎晉升至生產

當預備環境實驗持續通過:

# Production pod-kill experiment (more conservative)
apiVersion: chaos-mesh.org/v1alpha1
kind: PodChaos
metadata:
  name: api-pod-kill-prod
  namespace: chaos-testing
spec:
  action: pod-kill
  mode: one
  selector:
    namespaces:
      - production
    labelSelectors:
      app: api-gateway
      chaos-enabled: "true"
  duration: "10s"  # Shorter than staging
  scheduler:
    cron: "0 10 * * 2"  # Tuesdays at 10 AM only (predictable, low-risk time)

生產之保護措施:

# Create a kill switch for production chaos
kubectl create configmap chaos-killswitch \
  -n chaos-testing \
  --from-literal=enabled=true

# Update experiments to check kill switch
# (implementation depends on chaos tool)

預期: 生產實驗於低風險時段執行,並備有緊急開關。

失敗時: 若生產實驗引發事件,立即停用並進行事後檢討。

驗證

  • 穩態與假設已清楚定義
  • 爆炸半徑已限制(環境、範圍、時機)
  • 混沌工具(Chaos Mesh 或 Litmus)已安裝並測試
  • 實驗於預備環境成功執行
  • 結果已附指標與分析記錄
  • 已依發現實施改進
  • 後續實驗驗證了修正
  • 生產實驗僅於 5 次以上預備環境成功後執行

常見陷阱

  • 無假設:「看看會發生什麼」之混沌實驗浪費時間。應始終有假設。
  • 範圍過廣:一次殺死所有 pod 是測試災難恢復而非韌性。從小開始。
  • 生產優先:絕不於生產執行首次實驗。永遠先預備環境。
  • 忽視結果:無行動之混沌即表演。應修正所學。
  • 警報疲勞:混沌實驗會觸發警報。應於 Grafana 註記或靜音預期警報。
  • 無中止計劃:若實驗出錯,需有緊急開關。應預先備妥。

相關技能

  • setup-prometheus-monitoring - 用以量測實驗影響之指標
  • configure-alerting-rules - 混沌期間觸發之警報(預期內)
  • define-slo-sli-sla - 與 SLO 連動之穩態

GitHub 仓库

pjt222/agent-almanac
路径: i18n/wenyan-lite/skills/run-chaos-experiment
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

相关推荐技能

evaluating-llms-harness

测试

该Skill通过60+个学术基准测试(如MMLU、GSM8K等)评估大语言模型质量,适用于模型对比、学术研究及训练进度追踪。它支持HuggingFace、vLLM和API接口,被EleutherAI等行业领先机构广泛采用。开发者可通过简单命令行快速对模型进行多任务批量评估。

查看技能

cloudflare-cron-triggers

测试

这个Claude Skill提供了关于Cloudflare Cron Triggers的完整知识库,用于通过cron表达式定时执行Workers。它支持配置周期性任务、维护作业和自动化工作流,并能处理常见的cron触发错误。开发者可以用它来设置定时任务、测试cron处理器,并集成Workflows和Green Compute功能。

查看技能

webapp-testing

测试

该Skill为开发者提供了基于Playwright的本地Web应用测试工具集,支持自动化测试前端功能、调试UI行为、捕获屏幕截图和查看浏览器日志。它包含管理服务器生命周期的辅助脚本,可直接作为黑盒工具运行而无需阅读源码。适用于需要快速验证本地Web应用界面和交互功能的开发场景。

查看技能

finishing-a-development-branch

测试

这个Skill用于开发分支完成后的集成决策,当代码实现完成且测试通过时,它会引导开发者选择合适的工作流。它首先验证测试状态,然后提供合并、创建PR或清理等结构化选项。核心价值在于确保代码质量的同时,标准化分支收尾流程。

查看技能