Document the meter-analyzer-config catalog in admin runtime-rule / admin dsl-debug

[wu-sheng]

Context

apache/skywalking#13969 brings the meter-analyzer-config catalog (native MeterReportService rules) to parity with otel-rules: those rules now load through the shared Rules/RuleSetMerger pipeline, so a meter rule can be hot-added, structurally edited, or inactivated at runtime, and attached to a MAL DSL debug session — without restarting OAP.

Does swctl need a functional change? No.

On the wire that OAP change is purely additive — one more value in the shared Catalog enum:

OTEL_RULES("otel-rules"),
LOG_MAL_RULES("log-mal-rules"),
TELEGRAF_RULES("telegraf-rules"),
+METER_ANALYZER_CONFIG("meter-analyzer-config"),
LAL("lal"),

No new endpoints, no new request/response fields, no changed payload shapes. And swctl already passes it through:

• There is no client-side catalog allow-list — --catalog reaches the server verbatim.
• pkg/admin/runtimerule only ever calls the canonical/runtime/rule/{list,bundled,addOrUpdate,inactivate,delete,dump} routes; it never maps a catalog onto the /runtime/mal/otel-style shortcuts. That matters, because meter-analyzer-config is one of the two catalogs (with telegraf-rules) that deliberately has no shortcut route.

The e2e added in that same OAP PR (test/e2e-v2/cases/runtime-rule/meter/meter-runtime-rule-flow.sh) is the proof: it sets CATALOG="meter-analyzer-config" and drives all five phases — bundled visibility, hot add, structural edit with converter replacement, DSL debug session, inactivate — entirely through swctl admin runtime-rule … and swctl admin dsl-debug session … against an unmodified CLI.

What this PR does

What was stale is discoverability — --help still advertised only four catalogs.

• Add meter-analyzer-config to the --catalog flag help of admin runtime-rule and admin dsl-debug session start, and to the admin runtime-rule catalog list.
• Drop the two unreferenced Catalogs vars in pkg/admin/{runtimerule,dsldebug}. Nothing read them — they were a second copy of the catalog list, free to drift out of sync with OAP's enum, and this change is exactly the drift they would have caused. The rendered help text is now the single place the list lives; keeping it out of a client-side allow-list means a newer OAP catalog keeps working without a CLI release.
• CHANGES.md entry under 0.15.0.

Verification

$ swctl admin runtime-rule add --help
--catalog catalog rule catalog: otel-rules / log-mal-rules / telegraf-rules / meter-analyzer-config / lal
$ swctl admin dsl-debug session start --help
--catalog catalog session catalog: otel-rules / log-mal-rules / telegraf-rules / meter-analyzer-config / lal / oal

go build ./..., go vet, and go test ./pkg/admin/... ./internal/commands/admin/... all pass. make lint fails identically before and after (40 pre-existing lll violations in untouched files); this change adds none.

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Documents OAP’s new meter-analyzer-config catalog without changing CLI behavior.

Changes:

• Updates runtime-rule and DSL-debug help text.
• Removes unused catalog-list variables.
• Adds a 0.15.0 changelog entry.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
pkg/admin/runtimerule/runtimerule.go	Removes unused catalog list.
pkg/admin/dsldebug/dsldebug.go	Removes unused catalog list.
internal/commands/admin/runtimerule/runtimerule.go	Documents the meter catalog.
internal/commands/admin/dsldebug/dsldebug.go	Documents meter DSL debugging.
CHANGES.md	Records the documentation update.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.