Skip to content
Graphsignal Docs

Using Tags

Introduction

Section titled “Introduction”

Tags enable visualization and breakdown of profiles, metrics, errors, and resources. Tags can represent application versions, A/B test targets, departments, deployments, and so on. Graphsignal automatically adds many useful host, process, and device tags.

Adding tags

Section titled “Adding tags”

See the Quick Start for instructions on installing and running the Graphsignal profiler.

Tags are passed to the profiler subprocess via environment variables. Set them before invoking graphsignal-run:

Terminal window
export GRAPHSIGNAL_TAG_APP_VERSION="1.0"
export GRAPHSIGNAL_TAG_DEPLOYMENT="us-east-prod"
graphsignal-run ...

Use the GRAPHSIGNAL_TAG_<NAME>=<value> form — each variable becomes a tag on every signal the profiler emits. Tags appear in the local /signals payload’s context, and on every uploaded signal in the production feedback loop.