stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 3 Releases Wiki Activity

docs consolidation, big sln build fixes, new advisories and sprints/tasks

Browse Source
This commit is contained in:
master
2026-01-05 18:37:04 +02:00
parent d0a7b88398
commit d7bdca6d97
175 changed files with 10322 additions and 307 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/observability/observability.md
View File

@@ -86,7 +86,7 @@ This guide captures the canonical signals emitted by Concelier and Excititor onc
### 2.2 Trace usage
- Correlate UI dashboard entries with traces via `traceId` surfaced in violation drawers (`docs/15_UI_GUIDE.md`).
- Correlate UI dashboard entries with traces via `traceId` surfaced in violation drawers (`docs/UI_GUIDE.md`).
- Use `aoc.guard` spans to inspect guard payload snapshots. Sensitive fields are redacted automatically; raw JSON lives in secure logs only.
- For scheduled verification, filter traces by `initiator="scheduled"` to compare runtimes pre/post change.

8
docs/observability/ui-telemetry.md
View File

@@ -78,7 +78,7 @@
- `ui.api.fetch` – HTTP fetch to backend; attributes: `service`, `endpoint`, `status`, `networkTime`.
- `ui.sse.stream` – Server-sent event subscriptions (status ticker, runs); attributes: `channel`, `connectedMillis`, `reconnects`.
- `ui.telemetry.batch` – Browser OTLP flush; attributes: `batchSize`, `success`, `retryCount`.
- `ui.policy.action` – Policy workspace actions (simulate, approve, activate) per `docs/15_UI_GUIDE.md`.
- `ui.policy.action` – Policy workspace actions (simulate, approve, activate) per `docs/UI_GUIDE.md`.
- **Propagation:** Spans use W3C `traceparent`; gateway echoes header to backend APIs so traces stitch across UI → gateway → service.
- **Sampling controls:** `OTEL_TRACES_SAMPLER_ARG` (ratio) and feature flag `telemetry.forceSampling` (sets to 100 % for incident debugging).
- **Viewing traces:** Grafana Tempo or Jaeger via collector. Filter by `service.name = stellaops-console`. For cross-service debugging, filter on `correlationId` and `tenant`.
@@ -147,7 +147,7 @@ Integrate alerts with Notifier (`ui.alerts`) or existing Ops channels. Tag incid
| `OTEL_SERVICE_NAME` | Service tag for traces/logs. Set to `stellaops-console`. | auto |
| `CONSOLE_TELEMETRY_SSE_ENABLED` | Enables `/console/telemetry` SSE feed for dashboards. | `true` |
Feature flag changes should be tracked in release notes and mirrored in `docs/15_UI_GUIDE.md` (navigation and workflow expectations).
Feature flag changes should be tracked in release notes and mirrored in `docs/UI_GUIDE.md` (navigation and workflow expectations).
---
@@ -171,7 +171,7 @@ Feature flag changes should be tracked in release notes and mirrored in `docs/15
- [ ] DPoP/fresh-auth anomalies correlated with Authority audit logs during drill.
- [ ] Offline capture workflow exercised; evidence stored in audit vault.
- [ ] Screenshots of Grafana dashboards committed once they stabilise (update references).
- [ ] Cross-links verified (`docs/deploy/console.md`, `docs/security/console-security.md`, `docs/15_UI_GUIDE.md`).
- [ ] Cross-links verified (`docs/deploy/console.md`, `docs/security/console-security.md`, `docs/UI_GUIDE.md`).
---
@@ -179,7 +179,7 @@ Feature flag changes should be tracked in release notes and mirrored in `docs/15
- `/docs/deploy/console.md` – Metrics endpoint, OTLP config, health checks.
- `/docs/security/console-security.md` – Security metrics & alert hints.
- `docs/15_UI_GUIDE.md` – Console workflows and offline posture.
- `docs/UI_GUIDE.md` – Console workflows and offline posture.
- `/docs/observability/observability.md` – Platform-wide practices.
- `/ops/telemetry-collector.md` & `/ops/telemetry-storage.md` – Collector deployment.
- `/docs/operations/console-docker-install.md` – Compose/Helm environment variables.