@local/dsh-prometheus-plugin
用于 dsh 的 PromQL 插件：将 Prometheus HTTP API 作为智能体工具提供
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:HuckOps/dsh-prometheus-plugin#fe6c819b825c9aebb4ed294921412e399e05b1edPrometheus Plugin 以 @local/dsh-prometheus-plugin 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness (dsh) plugin that exposes the
Prometheus HTTP API as a set of tools an LLM agent can call. Built on the
Cordis framework and
@deepseek-ai/dsh-tools.
src/client.ts) with consistent error formatting
and a configurable request timeout (AbortController, default 30s).@deepseek-ai/dsh-tools, friendly for agent use.admin-snapshot, admin-delete-series, admin-clean-tombstones)
require --web.enable-admin-api.search-metric-names, search-label-names, search-label-values)
require --enable-feature=search-api.format-query, parse-query, query-exemplars, status-tsdb (3.6.0+),
status-self-metrics, features, …). Pointing a tool at an older server
returns an HTTP error from Prometheus itself.Install the bundle into your dsh profile:
git clone https://github.com/HuckOps/dsh-prometheus-plugin
# In dsh (agent or Plugin Manager), install the bundle:
# plugin_manager install_bundle /path/to/dsh-prometheus-plugin
The bundle declares cordis.patch.yml, which registers the promql-plugin
entry with the package @local/dsh-prometheus-plugin (resolved via the
dsh.bundle.patch field in package.json). No manual cordis.yml editing is
needed.
The patch ships a default config:
- insert:
- id: promql-plugin
name: '@local/dsh-prometheus-plugin'
config:
prometheusEndpoint: http://127.0.0.1:9090
Edit the patch (or override the entry's config) to point at your Prometheus
instance. prometheusEndpoint defaults to http://127.0.0.1:9090 when omitted.
To build from source:
npm install # postinstall runs tsc, output to lib/
Note: runtime dependencies (
@deepseek-ai/dsh-tools,@deepseek-ai/cordis,@deepseek-ai/schemastery) are declared as peer dependencies matching the DSH host runtime; they are not bundled into the plugin.
All tools are registered with the promql- prefix.
| Tool | Prometheus endpoint |
|---|---|
promql-query | GET /api/v1/query |
promql-query-range | GET /api/v1/query_range |
promql-format-query | GET /api/v1/format_query |
promql-parse-query | GET /api/v1/parse_query |
promql-query-exemplars | GET /api/v1/query_exemplars |
| Tool | Prometheus endpoint |
|---|---|
promql-series | GET /api/v1/series |
promql-labels | GET /api/v1/labels |
promql-label-values | GET /api/v1/label/{name}/values |
promql-metadata | GET /api/v1/metadata |
| Tool | Prometheus endpoint |
|---|---|
promql-targets | GET /api/v1/targets |
promql-targets-metadata | GET /api/v1/targets/metadata |
promql-scrape-pools | GET /api/v1/scrape_pools |
| Tool | Prometheus endpoint |
|---|---|
promql-rules | GET /api/v1/rules |
promql-alerts | GET /api/v1/alerts |
promql-alertmanagers | GET /api/v1/alertmanagers |
| Tool | Prometheus endpoint |
|---|---|
promql-status-config | GET /api/v1/status/config |
promql-status-flags | GET /api/v1/status/flags |
promql-status-runtimeinfo | GET /api/v1/status/runtimeinfo |
promql-status-buildinfo | GET /api/v1/status/buildinfo |
promql-status-tsdb | GET /api/v1/status/tsdb (3.6.0+) |
promql-status-tsdb-blocks | GET /api/v1/status/tsdb/blocks |
promql-status-walreplay | GET /api/v1/status/walreplay |
promql-status-self-metrics | GET /api/v1/status/self_metrics |
promql-features | GET /api/v1/features |
--enable-feature=search-api)| Tool | Prometheus endpoint |
|---|---|
promql-search-metric-names | GET /api/v1/search/metric_names |
promql-search-label-names | GET /api/v1/search/label_names |
promql-search-label-values | GET /api/v1/search/label_values |
--web.enable-admin-api)| Tool | Prometheus endpoint |
|---|---|
promql-admin-snapshot | POST /api/v1/admin/tsdb/snapshot |
promql-admin-delete-series | POST /api/v1/admin/tsdb/delete_series |
promql-admin-clean-tombstones | POST /api/v1/admin/tsdb/clean_tombstones |
.
├── cordis.patch.yml # dsh bundle patch: registers the promql-plugin entry
├── package.json # bundle manifest (dsh.bundle.patch) + peer deps
├── icon.svg # bundle display icon
├── locale/
│ ├── en.json
│ └── zh.json
├── tsconfig.json
├── README.md
├── LICENSE
└── src/
├── index.ts # package entry: re-exports apply/inject/Config
├── client.ts # shared HTTP client + error handling + timeout
├── query.ts # query / query_range / format_query / parse_query / query_exemplars
├── metadata.ts # series / labels / label_values / metadata
├── targets.ts # targets / targets_metadata / scrape_pools
├── rules.ts # rules / alerts / alertmanagers
├── status.ts # config / flags / runtimeinfo / buildinfo / tsdb / tsdb_blocks / walreplay / self_metrics / features
├── search.ts # search/metric_names / search/label_names / search/label_values
├── admin.ts # admin/tsdb/snapshot / delete_series / clean_tombstones
└── plugin.ts # entry: imports and registers all tools
MIT © 2026 HuckOps