ObservabilityXLIII · InstrumentationInstrumentation
Manual vs Automatic Instrumentation
What you'll learn
- Explain manual vs automatic instrumentation in production terms
- Configure and operate manual vs automatic instrumentation in a production observability stack
- Recognise and diagnose the most common failure modes
- Apply the discipline to a real environment
Prerequisites
Verified against Prometheus 2.55.x · Alertmanager 0.28.x · node_exporter 1.8.x · blackbox_exporter 0.26.x · Grafana 11.x · Loki 3.x · Tempo current · OpenTelemetry Collector 0.110.x · Grafana Alloy current · Docker Engine 28.x · Ubuntu 24.04 LTS · Debian 12 (Bookworm) · RHEL / Rocky / AlmaLinux 9.x · 2026-08-13
Manual adds explicit code.
Automatic hooks the framework.
A typical service has both.
What it is
A precise definition of manual vs automatic instrumentation, scoped to production operations.
Why a sysadmin cares
Production framing.
How it works
The mental model.
example_setting: valueHow to configure it
Real configuration examples with annotated options.
promtool check config /etc/prometheus/prometheus.ymlHow to validate it
Commands the operator runs to confirm the configuration is live and correct.
How it can fail
The high-frequency failure modes: silent misconfiguration, crash on load, performance regression, permissions failure, schema / version drift.
How to troubleshoot it
The diagnostic order.
Security implications
Manual vs Automatic Instrumentation 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 changes in a non-production environment.
Verification
You should now be able to answer:
- What is manual vs automatic instrumentation in production terms?
- Why does a sysadmin care about it?
- How does it fail and how do you diagnose the failure?
Quiz
Knowledge check · 8 questions
Q1. What is the primary purpose of manual vs automatic instrumentation?
Q2. Which failure mode of manual vs automatic instrumentation is most operationally costly?
Q3. Production verification should run on production hosts.
Q4. First response when manual vs automatic instrumentation misbehaves?
Q5. Name one signal that confirms manual vs automatic instrumentation is healthy.
Q6. Which of these are validation steps?
Q7. Right discipline when changing in production?
Q8. Telemetry usefulness requires:
Passing score: 75%. Answers are checked in this browser.