Skip to content
Independent notebook · software, testing, and open source No ads · no sponsored posts · no affiliate links
Soham Parekh software notebook

Tutorial note / Telemetry

A note on Gatsby telemetry

What the Gatsby command line tool may collect, where to read the details, and how to keep a quiet machine.

Topic Telemetry

Format Reference

Get your tools in place

All tutorials

The first time the Gatsby command line tool runs, it may print a short notice about anonymous usage data. The notice is easy to skim past. This note explains what it means and where the authoritative details live.

What the notice is

The notice is a disclosure, not a request for personal information. It tells you that the tool may collect aggregate data about how commands are used. The purpose is to help the maintainers understand which parts of the tool matter.

Read the source of truth

Telemetry is a moving target. The official Gatsby telemetry page is the place to check what is collected, how it is used, and how to turn it off. Read that page before you decide. It is shorter than the tool's documentation and more precise than a summary in a blog post.

If you want a quiet machine

The telemetry page lists the environment setting that disables the collection. If you are working in a shared environment, a container, or a CI job, decide once and record the choice in the project's setup notes. A small note now saves a conversation later.

A reasonable default

For a local project, leaving the default in place is a common choice. For a machine that handles sensitive work, turning it off is equally reasonable. The important part is making the choice consciously instead of clicking through the notice.

Field note

A notice is not a contract. Read the page, decide, and move on.

Reference shelf

Official documentation for Gatsby telemetry and the command line tool.