vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
hyperhive/hive-metric
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
damocles 621245306f swarm-controller: move OTEL deps to workspace level, drop jobq_metrics singleton
2026-08-19 18:10:22 +02:00
..
src fix(hive-metric): blocking OTLP client (no-reactor panic), reject negative counters, allow negative gauges 2026-07-10 21:27:56 +02:00
Cargo.toml swarm-controller: move OTEL deps to workspace level, drop jobq_metrics singleton 2026-08-19 18:10:22 +02:00
README.md docs(#2627): add READMEs for the remaining infra crates 2026-07-23 13:16:29 +02:00

README.md

hive-metric

A tiny CLI that pushes a single labeled metric to the OTEL collector, then exits. Built on the OpenTelemetry Rust SDK with the OTLP HTTP/JSON exporter.

When to use it

For emitting a one-off counter or gauge from a shell script or systemd unit without embedding an OTEL SDK in the caller — the harness and various hive scripts use it to record per-agent metrics.

Usage

hive-metric <name> <value> [--type counter|gauge] [--labels key=value ...]

Standard OTEL environment variables are read automatically by the SDK:

  • OTEL_EXPORTER_OTLP_ENDPOINT — collector URL (required)
  • OTEL_EXPORTER_OTLP_HEADERS — auth headers (Key=Value,...)
  • OTEL_RESOURCE_ATTRIBUTES — resource labels (k=v,...)

The harness populates all of these per-agent when services.hyperhive.otel.enable = true. See docs/observability.md for the collector setup and the metrics hyperhive exports.