Why Counters Aren't Plotted Directly'

Raw counter graphs are misleading because counters monotonically increase. Plots that show counter values directly confuse resets, scale, and time-comparison. The right approach is rate() over a window.

What it is

A precise definition scoped to production operations.

Why a sysadmin cares

Production framing.

How it works

The mental model.

example_setting: value

How to configure it

Real configuration examples.

promtool check config /etc/prometheus/prometheus.yml

How to validate it

Commands the operator runs to confirm the configuration is live and correct.

How it can fail

Failure modes: silent misconfiguration, crash on load, performance regression, permissions failure, schema / version drift.

How to troubleshoot it

Diagnostic order: was it working before? what does the service view say? what does the platform view say? form hypothesis, find evidence, test, validate.

Security implications

The topic has security implications wherever the relevant component exposes an HTTP endpoint, an authentication layer, or a credential.

Performance implications

Performance implications come from cardinality, scrape / push interval, rule size, retention, and query cost.

Production guidance

• Validate before applying.
• Test in non-production.

Verification

• What is the topic in production terms?
• Why does a sysadmin care?
• How does it fail and how do you diagnose the failure?

Quiz