DevelopersSystem ArchitectureObservability & Metrics

Observability & Metrics

Tangle supports observability at two layers:

  • On-chain metrics recording (optional): protocol contracts emit best-effort “activity signals” to a configured metrics recorder contract.
  • Off-chain QoS (optional): operators can expose dashboards/logs for their blueprint runtimes.

On-chain Metrics Recorder (Optional)

The core protocol can be configured with a metrics recorder (typically TangleMetrics). If the recorder is unset (address(0)), metrics are disabled.

Fail-safe Hooks

Metrics hooks are designed to be non-blocking: core actions should not revert if metrics recording is unavailable or faulty.

What Gets Recorded

TangleMetrics is a lightweight recorder that emits events and stores minimal aggregates for incentive distribution.

Off-chain QoS (Optional)

Blueprint runtimes can expose:

  • Health and service liveness (e.g., heartbeat visibility)
  • Job success rate and latency distributions
  • Logs for debugging / audit trails

QoS and dashboards are blueprint/operator dependent. For operator-facing expectations, see: