Skip to content
Graphsignal Docs

Using Tags

Introduction

Section titled “Introduction”

Tags enable visualization and breakdown of traces, profiles, metrics, and resources. Tags can represent application versions, A/B test targets, departments, user IDs, session IDs, and so on. Graphsignal automatically adds many useful network, resource, server, and library 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 or calling graphsignal.watch():

Terminal window
export GRAPHSIGNAL_TAG_APP_VERSION="1.0"
export GRAPHSIGNAL_TAG_DEPLOYMENT="us-east-prod"
graphsignal-run <my-app>

Use the GRAPHSIGNAL_TAG_<NAME>=<value> form — each variable becomes a tag on every signal the profiler emits.