Expand description
Mira: OTLP in, immutable Arrow blocks out, one binary.
ModulesΒ§
- alert π
- Static-rule alerting: a KYAML document in, webhooks out.
- api π
- The query API.
- config π
- Deployment configuration: KYAML with OmegaConf-style interpolation.
- json π
- OTLP/HTTP with a JSON body.
- mcp π
- MCP, on the same port as everything else.
- pipeline π
- The ingest path.
- receiver π
- OTLP receivers.
- telemetry π
- Mira storing Miraβs telemetry, in Mira.
- term π
- A terminal, hand-rolled on
libc. - tui π
- The terminal UI.
- ui π
- The UI, compiled into the binary.
- update π
mira updateβ replace this binary with a release from GitHub.
ConstantsΒ§
- DRAIN_
GRACE π - How long a stop is allowed to take before the process leaves without it.
- USAGE π
StaticsΒ§
- QUERIES π
- Queries served and what they cost, since start.
- QUERY_
MAX_ πNANOS - QUERY_
NANOS π - START π
- When the process started, so the counters below have a denominator. Forced in
serve_withrather than left to first touch, or βuptimeβ would mean βseconds since someone first askedβ.
FunctionsΒ§
- check_
source π - The guards
serve_withruns, for amira mira --data-dirthat maps exactly the same blocks with no server in front of it. - drain π
- Stop accepting, then let everything already in flight land.
- first_
stopped π - Resolve as soon as any one flusher has returned.
- health π
- Liveness, plus what the ingest path has refused so far.
- json_ok π
- load π
- Precedence is flag > file > default. Hand-rolled: the flag set exists only to override the file, so a parser crate would be more code than the thing it parses.
- load_
from π loadwithout the two flags that end the process, so it can be called.- main π
- ops_
router π - The three endpoints that answer for the process rather than for the data: liveness, readiness, and everything this node counts about itself.
- peak_
rss π - High-water mark of this processβs resident set, in bytes.
- ready π
- Readiness is one question: can this instance accept an export and make it
durable? Everything else about the process is
/healthβs. - readyz π
- Readiness: 200 while exports can be made durable, 503 once they cannot.
- replay π
- Push everything the log holds that no block claims back through the flushers, before the listeners open.
- run π
- serve π
- serve_
with π - The server proper, with its stop edge passed in rather than taken from the process. A test can hold that edge; nothing else needs to.
- shutdown π
- Resolve on the first stop signal.
- stats π
- Everything this node knows about itself, in one document.
- timed π
- Wrapped around the query router only, so OTLP writes and UI asset fetches do not land in the read latency an operator is reading.
- tui_
source π - Where a
mira mirainvocation should read from.