Observability for railiance providing monitoring, metrics, alerting etc to enable the selforganizing control loop.
Find a file
custodian-sync 67283b66c2 chore(consistency): sync task status from DB [auto]
Updated by fix-consistency on 2026-09-28:
  - update .custodian-brief.md for railiance-telemetry

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0e6f1-443f-7783-9920-a16b2ffc467f
2026-09-28 10:23:35 +02:00
activity-definitions Prepare bounded telemetry runtime jobs and activity definitions 2026-09-06 19:32:26 +02:00
contracts Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
docs Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
history Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
rules Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
scripts Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
tasks Prepare bounded telemetry runtime jobs and activity definitions 2026-09-06 19:32:26 +02:00
tests Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
workplans Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
.custodian-brief.md chore(consistency): sync task status from DB [auto] 2026-09-28 10:23:35 +02:00
.gitignore Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
.repo-classification.yaml chore(classification): add repo classification 2026-08-25 14:02:41 +02:00
AGENTS.md Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
INTENT.md Place telemetry on the Quality dimension as Q2 Observability 2026-08-11 22:54:30 +02:00
LICENSE Seed INTENT, SCOPE, README for the observability layer 2026-08-11 21:51:42 +02:00
README.md Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00
SCOPE.md Implement private Q2 signal contract and durable reference receiver 2026-09-06 19:17:59 +02:00
WORK-RECORDS.md Complete local Prometheus mapping and record live acceptance blockers 2026-09-28 09:42:04 +02:00

railiance-telemetry

Observability for Railiance providing monitoring, metrics, alerting etc to enable the self-organizing control loop.

Status: private reference implementation. A versioned signal contract, SQLite receipt/inbox CLI and platform adapter are implemented and tested. No monitoring runtime or notification schedule is installed by this work. See the contract and workflow.

Why this repo exists

Five Railiance layers independently declare that they intend to be "self-evidencing" or "auditable" — infra, cluster, platform, apps, and forge. None of them owned the place that evidence goes. This repo is that place.

It owns the signal, not the meaning of the signal: conformance rules and consistency checks stay with the repos that own those concerns, and telemetry carries and surfaces their output.

Start here

  1. INTENT.md — why this exists and what it is becoming
  2. SCOPE.md — in scope, out of scope, how it fits
  3. AGENTS.md — session protocol
  4. workplans/

Placement and verification

Quality dimension, Q2 Observability, as recorded in INTENT/SCOPE. Monitoring workload packaging remains outside this repo.

Run python3 -m unittest discover -s tests -v (Python 3.11+, no dependencies). Live acceptance is tracked by RTEL-WP-0002-T04; local receipts are not external operator delivery proof.

Managed production package

rapp-telemetry packages Prometheus, Alertmanager and Grafana for railiance01, with telemetry.coulomb.social as the intended Grafana hostname. This repo retains Q2 contracts and rule meaning. The local receiver and activity candidates are reference tooling; do not enable them as a second production monitoring plane. The package records private installation and restore proof; delivery acceptance remains blocked in RTEL-WP-0002-T04. The Prometheus mapping supplies a tested report exporter and failure/absence rules for package integration.