wu-sheng opened a new pull request, #13864:
URL: https://github.com/apache/skywalking/pull/13864
## Summary
- New `admin-server` module hosts admin / on-demand write APIs on a shared
HTTP port (default `17128`) plus a dedicated admin-internal gRPC bus (default
`17129`) for peer-to-peer cluster RPCs (runtime-rule Suspend/Resume/Forward,
DSL debug install/collect/stop). Privileged admin RPCs stay isolated from the
agent network.
- Runtime-rule hot-update (already shipped in 10.4.0) is restructured onto
`admin-server`'s HTTP host. All admin writes serialize on a deterministic
single-main OAP per cluster; non-main nodes transparently forward over the
admin-internal gRPC bus, so an L7 LB in front of the admin port can route any
operator request to any OAP.
- New `dsl-debugging` module implements [SWIP-13](docs/en/swip/SWIP-13.md) —
a sample-based runtime debugger that captures per-stage inputs/outputs as
MAL/LAL/OAL process live ingest. Idle path is one volatile-bool read per probe
call site (JIT-eliminable); active sessions fan out to every cluster peer, with
LB-safe routing, hard caps (`MAX_ACTIVE_SESSIONS=200`, `recordCap≤10000`,
`retentionMillis≤1h`), and verbatim ANTLR-slice `sourceText` per sample.
Operators upgrading to 10.5.0 with `SW_RECEIVER_RUNTIME_RULE=default` must
also set `SW_ADMIN_SERVER=default`; OAP fails fast at startup otherwise.
Per-DSL operator references:
[MAL](docs/en/setup/backend/admin-api/dsl-debugging-mal.md) /
[LAL](docs/en/setup/backend/admin-api/dsl-debugging-lal.md) /
[OAL](docs/en/setup/backend/admin-api/dsl-debugging-oal.md). Common ground:
[DSL Debug API](docs/en/setup/backend/admin-api/dsl-debugging.md). Admin host:
[Admin API readme](docs/en/setup/backend/admin-api/readme.md).
## Test plan
- [x] Unit tests across all touched modules pass (`dsl-debugging`,
`runtime-rule`, `admin-server`, `server-core`, `meter-analyzer`,
`log-analyzer`, `oal-rt`)
- [x] New concurrent-install regression test confirms `MAX_ACTIVE_SESSIONS`
is never exceeded under contention
- [x] `LALScriptExecutionTest` 48/48 green (regression-tested after a
related getter revert)
- [x] Four E2E cases under
`test/e2e-v2/cases/dsl-debugging/{mal,lal-block,lal-statement,oal}/` drive the
full session lifecycle against real telemetry through BanyanDB + runtime-rule
and assert the captured wire shape per DSL
- [ ] CI green
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
