Graphsignal: Inference Profiler
Graphsignal is a production-scale inference profiling platform that helps engineers optimize AI performance across models, engines, GPUs, and other accelerators. It provides essential visibility across the inference stack, including:
- Continuous, high-resolution profiling timelines exposing operation durations and resource utilization across inference workloads.
- LLM generation tracing with per-step timing, token throughput, and latency breakdowns for major inference frameworks.
- System-level metrics for inference engines and hardware (CPU, GPU, accelerators).
- Error monitoring for device-level failures and inference errors.
- Automatic engine flag optimization, AI chat for bottleneck investigation, and profiling context for AI coding agents.
Learn more at graphsignal.com.
Install
UV_TOOL_BIN_DIR=/usr/local/bin uv tool install 'graphsignal[cu12]' # CUDA 12.x
# or
UV_TOOL_BIN_DIR=/usr/local/bin uv tool install 'graphsignal[cu13]' # CUDA 13.x
Alternative: install into your workload environment
If you prefer a single environment, or you use the graphsignal.watch() Python API (which requires graphsignal importable by your application), install it directly into your workload's environment instead:
pip install 'graphsignal[cu12]' # CUDA 12.x
# or
pip install 'graphsignal[cu13]' # CUDA 13.x
Profile
Wrap your launch command with graphsignal-run:
export GRAPHSIGNAL_API_KEY=<my-api-key>
graphsignal-run vllm serve <model> --port 8001
Environment variables read by the profiler:
| Variable | Purpose |
|---|---|
GRAPHSIGNAL_API_KEY (required) |
Your account API key. |
GRAPHSIGNAL_TAG_<KEY>=<value> |
Arbitrary tag attached to all signals (e.g. GRAPHSIGNAL_TAG_DEPLOYMENT=us-prod). |
Sign up for a free account at graphsignal.com; you'll find the API key in Settings / API Keys.
See the Profiler CLI reference for the full set of options.
Applications that bootstrap themselves can call graphsignal.watch() from Python instead — see the Profiler API reference.
See integration documentation for libraries and inference engines:
Optimize
Log in to Graphsignal to monitor and analyze your application.
Optimize with AI
Three ways to optimize with AI:
- Auto-flags —
graphsignal-run --auto-flagssets engine flags at launch - Optimize chat — ask questions about a time window in the Graphsignal app
- graphsignal-context — let an AI coding agent (Claude Code, Codex, or Gemini) fetch and analyze profiling data in your IDE
See AI Optimization for details.
Overhead
The profiler has minimal impact on production performance. CUDA kernel activity is collected via CUPTI with low-overhead APIs, and analysis and upload happen in the sidecar process.
Security and Privacy
The profiler only establishes outbound connections to api.graphsignal.com to send data; inbound connections or commands are not possible.
Content and sensitive information, such as prompts and completions, are not recorded.
Troubleshooting
If something doesn't look right, report it to our support team via your account.
In case of connection issues, please make sure outgoing connections to https://api.graphsignal.com are allowed.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file graphsignal-0.20.4.tar.gz.
File metadata
- Download URL: graphsignal-0.20.4.tar.gz
- Upload date:
- Size: 283.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.10.20 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f521941fb02c4ac78e670ed1e99973548427fac32ca227ea4c9294e4ee724fb
|
|
| MD5 |
d92f94df3964b376d41c89231ca133b2
|
|
| BLAKE2b-256 |
c053a75df5a78a8aeb558b9dea641319723034a5541f2712399098de80c8739c
|
File details
Details for the file graphsignal-0.20.4-py3-none-any.whl.
File metadata
- Download URL: graphsignal-0.20.4-py3-none-any.whl
- Upload date:
- Size: 311.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
poetry/2.4.1 CPython/3.10.20 Linux/6.17.0-1020-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
42f3d937ec8b5bcf82e0b9e6d1e1383d04115e62ae0415d9cff7c0e7a0603619
|
|
| MD5 |
f1757c2692c20ab40795ba3eba7299d6
|
|
| BLAKE2b-256 |
492fd1c5a313d6f20df2f502eb8cd56d0bb450a470349ccf0067b20fa40a0cf4
|
