inlined-refs - SKILL.md Agent Skill

name: inlined-refs description: Generate a Kafka consumer group lag dashboard. Use when the user asks to monitor lag, build a dashboard for consumer lag, or wire up Prometheus exporters for Kafka. Do NOT trigger for producer metrics, broker JMX, or Streams-specific monitoring.

inlined-refs — consumer lag dashboarding

Step 1 — pick the exporter

We support two exporters. Read the comparison below before recommending.

Exporter comparison (from references/exporters.md)

kafka-exporter (Danielqsj)

Pros: lightweight, single binary, exposes per-group lag directly. Cons: stateful (consumes __consumer_offsets internally), can lag on large clusters.

Best for: clusters < 100 brokers, < 1000 consumer groups.

Config snippet:

kafka-exporter \
  --kafka.server=localhost:9092 \
  --kafka.version=3.5.0 \
  --web.listen-address=:9308

Confluent Control Center

Pros: official, covers full Confluent Platform metrics. Cons: paid licensing, heavier footprint.

Best for: enterprise Confluent Platform users.

Step 2 — Grafana dashboard

Use Grafana dashboard 7589 for kafka-exporter. Filter by consumer group, plot kafka_consumergroup_lag over a 5-minute window.

Step 3 — alerts

Set lag > 10,000 messages for 5 minutes as the default alert. Adjust per topic SLA.