LoadDensity 繁體中文手冊
繁中手冊依照讀者使用順序分為十二章:安裝 → 執行壓測 → 撰寫動作腳本 → 韌性強化 → 擴展 → 整合。可使用左側目次,或直接跳到下方章節。
第 1 章 — 入門
安裝 LoadDensity、執行第一次壓測,並建立專案骨架。
第 2 章 — 核心 API
面向 Locust 的封裝:環境、Runner、使用者代理。
第 3 章 — 動作撰寫與執行
組合 JSON 動作腳本、參數化資料、建立情境流程,串接測試後 callback。
第 4 章 — 使用者模板
協定驅動程式:HTTP、FastHttp、Async HTTP/2、WebSocket、SSE、gRPC (unary + 串流)、MQTT、原生 TCP/UDP、SQL、Redis、Kafka、MongoDB。
第 5 章 — 報告與可觀測性
產生 HTML / JSON / XML / CSV / JUnit / 百分位摘要 / chart 報告,將 指標送至 Prometheus、InfluxDB、OTLP 或 Datadog DogStatsD,並把即時 進度推送到瀏覽器。
第 6 章 — 編排與擴展
執行分散式 master/worker 群集、透過參數解析器共享狀態、依擷取變數 控制執行流程,並以內建 load shape 引導 ramp。
第 7 章 — 可靠度
自適應重試、失敗預算 / circuit breaker、網路條件、process supervisor — 讓 CI 無人值守也能安全執行。
第 8 章 — 錄製、資料與匯入器
將 HAR、Postman v2.1、OpenAPI 3.x、cURL、k6、JMeter JMX 轉成可執行 動作 JSON,將測試紀錄持久化到 SQLite,並比對歷次執行結果。
第 9 章 — Auth
含 cache 的 OAuth2 token helper、JWT 簽發(HS / RS)、AWS Signature v4,以及所有 HTTP user template 都支援的 mTLS client-cert。
第 10 章 — 工具、CLI 與診斷
命令列子指令、硬化的控制 socket server、traceback 中可能出現的例外 階層,以及編輯器 / CI 整合:linter、schema、LSP、VS Code 擴充套件、 GitHub Action、pre-commit。
第 11 章 — 整合
選用的 GUI、可讓 Claude 驅動 LoadDensity 的 MCP server。
第 12 章 — API Reference
自動產生的 Python API reference。
參考
- API Reference
- je_load_density
- je_load_density.utils.executor.action_executor
- je_load_density.utils.parameterization.parameter_resolver
- je_load_density.utils.recording.har_importer
- je_load_density.utils.metrics.prometheus_exporter
- je_load_density.utils.metrics.influxdb_sink
- je_load_density.utils.metrics.opentelemetry_exporter
- je_load_density.utils.test_record.test_record_class
- je_load_density.utils.test_record.sqlite_persistence
- je_load_density.utils.generate_report.generate_html_report
- je_load_density.utils.generate_report.generate_json_report
- je_load_density.utils.generate_report.generate_xml_report
- je_load_density.utils.generate_report.generate_csv_report
- je_load_density.utils.generate_report.generate_junit_report
- je_load_density.utils.generate_report.generate_summary_report
- je_load_density.utils.socket_server.load_density_socket_server
- je_load_density.wrapper.create_locust_env.create_locust_env
- je_load_density.wrapper.start_wrapper.start_test
- je_load_density.wrapper.user_template.request_executor
- je_load_density.wrapper.user_template.scenario_runner
- je_load_density.wrapper.user_template.http_user_template
- je_load_density.wrapper.user_template.fast_http_user_template
- je_load_density.wrapper.user_template.websocket_user_template
- je_load_density.wrapper.user_template.grpc_user_template
- je_load_density.wrapper.user_template.mqtt_user_template
- je_load_density.wrapper.user_template.socket_user_template
- je_load_density.mcp_server.server