# Instrumentation Plan

An instrumentation plan specifies the data a product must emit to answer priority questions, including event logic, properties, ownership, and validation.

- Type: artifact
- Domain: Data, experimentation & growth
- Level: Intermediate
- Last reviewed: 2026-09-21
- Original: [Soroush’s Product Wiki](<https://wiki.soroush.uk/topic/instrumentation-plan/>)

## What it means

An instrumentation plan, often called a tracking plan, is an implementation specification for analytics data. It states which events and properties to collect, exactly when they fire, where values originate, how users or accounts are identified, and how quality, privacy, testing, and release will be managed.

## Why it matters

Analytics questions cannot be answered reliably when collection logic lives only in code or memory. A shared plan aligns product, design, engineering, data, privacy, and quality assurance before implementation. It also creates acceptance criteria for verifying that observed events represent real product behavior.

## When to use it

Create or update an instrumentation plan for a new product, feature, journey, experiment, or analytics migration. Begin with decisions and questions rather than tracking every interface action. Revisit the plan when flows, identity models, consent requirements, or metric definitions change.

## How it works

1. List the decisions, questions, journeys, and measures the data must support.
2. Specify each event’s name, meaning, trigger, actor, object, properties, allowed values, and identity requirements.
3. Record platform coverage, source system, owner, privacy classification, consent behavior, and retention constraints.
4. Implement in a test environment and verify payloads, duplicates, ordering, missing values, and edge cases against acceptance criteria.
5. Release with monitoring, documentation, versioning, and a process for correcting or deprecating data.

## A practical example

For a document-sharing flow, the plan defines “Share Link Created” only after the server confirms creation. Properties include document type, permission level, and entry point, but exclude document names. QA tests web and mobile, offline retries, duplicate submissions, and anonymous-to-signed-in identity transitions.

## Where it breaks

A plan adds coordination cost and can become stale if treated as a one-time spreadsheet. Passing payload checks does not prove the selected events answer useful questions. Excessive collection increases privacy, security, storage, and governance burdens.

## Common mistakes

- Instrumenting every click without a question or decision it supports.
- Describing an event name but not its exact firing condition and source.
- Testing only the happy path or sending development traffic into production data.

## Visualization

[View the visualization on the website](<https://wiki.soroush.uk/topic/instrumentation-plan/#visualization-instrumentation-plan>)

## Sources

1. [What Events Do You Need?](<https://www.amplitude.com/docs/get-started/select-events>) — Amplitude Docs · Official planning guidance
2. [Getting Started with Amplitude](<https://www.amplitude.com/docs/data/data-get-started>) — Amplitude Docs · Official instrumentation documentation
3. [About Events](<https://support.google.com/analytics/answer/9322688?hl=en>) — Google Analytics Help · Official analytics documentation

## Related topics

- [Event Taxonomy](<https://wiki.soroush.uk/topic/event-taxonomy/>)
- [Product Analytics](<https://wiki.soroush.uk/topic/product-analytics/>)
- [Guardrail Metrics](<https://wiki.soroush.uk/topic/guardrail-metrics/>)
