Monitoring Setup - Livepeer Docs

This guide sets up production observability for a Livepeer Gateway using Prometheus and Grafana. The Gateway must already be running

for quick verification, see .

For on-chain Gateways, Prometheus metrics complement but do not replace

contract events and deposit state require separate monitoring.

Enable Metrics

Add the -monitor flag when starting the Gateway. Without it, the /metrics endpoint is not exposed.

Enable Metrics

livepeer \
  -gateway \
  -monitor \
  -metricsPerStream \
  -httpAddr 0.0.0.0:8935 \
  [other flags...]

Monitoring flags: Verify metrics are exposed:

Verify Metrics

curl http://localhost:8935/metrics | head -30

Prometheus-format output with livepeer_ prefixed metric names confirms the endpoint is active.

Setup

Key Metrics

Grafana Dashboards

The livepeer/livepeer-monitoring Docker stack includes three starter Grafana dashboards:

Node overview

Active sessions, success rate, transcoding latency, and Orchestrator connectivity. The primary operational dashboard for day-to-day monitoring.

Payment overview

ETH deposit and reserve over time, ticket value sent, and payment creation errors. Critical for on-chain Gateways to track deposit depletion rate.

Transcoding performance

Realtime ratios, latency distribution (p50, p95, p99), and segment success/failure breakdown. Useful for identifying quality degradation patterns.

Access Grafana at http://localhost:3000 (default credentials admin / admin). The starter dashboards are pre-configured to query the bundled Prometheus instance. Custom panels to consider adding:

Deposit depletion forecast (linear regression on livepeer_gateway_deposit over 24h)
Session count vs -maxSessions limit as a percentage gauge
AI discovery error rate overlaid with session count (correlation check)

Alert Rules

Critical

Critical Errors

groups:
  - name: livepeer-gateway-critical
    rules:
      - alert: GatewayDown
        expr: up{job=~"livepeer.*"} == 0
        for: 1m
        labels:
          severity: critical
        annotations:
          summary: "Livepeer Gateway is unreachable"

      - alert: DepositExhausted
        expr: livepeer_gateway_deposit < 10000000000000000
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "Gateway ETH deposit critically low ({{ $value | humanize }} wei)"

      - alert: SuccessRateCritical
        expr: |
          rate(livepeer_segment_transcoded_total[5m]) /
          rate(livepeer_segment_source_appeared_total[5m]) < 0.90
        for: 5m
        labels:
          severity: critical
        annotations:
          summary: "Transcoding success rate below 90%"

Warning

Warning Errors

      - alert: DepositLow
        expr: livepeer_gateway_deposit < 50000000000000000
        for: 10m
        labels:
          severity: warning
        annotations:
          summary: "Gateway ETH deposit below 0.05 ETH - top up soon"

      - alert: HighTranscodeLatency
        expr: |
          rate(livepeer_transcode_overall_latency_seconds_sum[5m]) /
          rate(livepeer_transcode_overall_latency_seconds_count[5m]) > 5
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Average transcoding latency exceeds 5 seconds"

      - alert: PaymentCreateErrors
        expr: rate(livepeer_payment_create_errors[5m]) > 0
        for: 2m
        labels:
          severity: warning
        annotations:
          summary: "Ticket creation errors - check Arbitrum RPC health"

      - alert: AIDiscoveryErrors
        expr: rate(livepeer_discovery_errors_total[5m]) > 0
        for: 5m
        labels:
          severity: warning
        annotations:
          summary: "Orchestrator discovery failing - check -orchAddr list"

Prometheus Metrics

Full table of all livepeer_* metrics.

On-Chain Metrics

TicketBroker events and Arbitrum contract monitoring.

Tools & Dashboards

Explorer, Livepeer Tools, livepeer_cli.

​Enable Metrics

​Setup

​Key Metrics

​Grafana Dashboards

​Alert Rules

​ Critical

​ Warning

​Related Pages

Prometheus Metrics

On-Chain Metrics

Tools & Dashboards

Enable Metrics

Setup

Key Metrics

Grafana Dashboards

Alert Rules

Critical

Warning

Related Pages