Data Core · Data Collection · Module

Instrumentation

What is deliberately captured and how — the design decision that determines which questions the organisation will ever be able to answer.

The idea

How it works

Instrumentation is usually a side effect of building something else, which means what gets captured is decided by an engineer under time pressure rather than by anyone thinking about questions.

Working backwards from the questions is the correction: list what the organisation will need to know, then check what would have to be captured for each.

Working with it

In practice

  1. 01

    Work backwards from the questions

    What will you need to know in a year? What would have to be captured for that to be answerable?

  2. 02

    Keep a tracking plan

    What is captured, where, with what fields. Without it, instrumentation is discovered by reading code.

  3. 03

    Capture identity carefully

    Whether events can be joined to a person or an account determines most of what analysis is possible.

  4. 04

    Record the gaps

    Questions that cannot currently be answered, so the next change to the system can close one.

One level in

The components of instrumentation

A component is something that exists afterwards which did not exist before — a deliverable or a mechanism, not an intention.

  1. The tracking plan

    What is captured, where, with which fields.

    Learn
  2. The joins

    Whether captured data can be connected to a person, account or session.

    Learn
  3. The gaps

    Questions that cannot be answered with current instrumentation.

    Learn

List what you will need to know in a year, then check what would have to be captured for it to be answerable.