graphsignal-sdk

Instrument Python AI inference workloads with Graphsignal SDK for tracing and profiling.

241|12|Updated Apr 13, 2021
One-click install
npx skills add https://github.com/graphsignal/graphsignal-python --skill graphsignal-sdk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: graphsignal-sdk
Source: https://github.com/graphsignal/graphsignal-python/tree/main
Command: npx skills add https://github.com/graphsignal/graphsignal-python --skill graphsignal-sdk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Graphsignal SDK helps observe, profile, and debug AI inference workloads in Python by providing high-resolution profiling timelines, per-step tracing, and system metrics, enabling faster diagnosis and optimization.

Core Features & Use Cases

  • Auto-instrumentation for vLLM, SGLang, and PyTorch to capture traces, profiles, and metrics
  • Manual tracing and profiling APIs to annotate and measure custom code paths
  • GPU/CUPTI support for CUDA-based profiling and integration via graphsignal-run CLI

Quick Start

Install the Graphsignal SDK and configure it with your API key; then run your application with graphsignal-run to enable automatic instrumentation and observability.

Frequently Asked Questions about graphsignal-sdk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I profile Python AI inference workloads to debug latency issues?

You can profile Python AI inference workloads by setting up the Graphsignal SDK to capture high-resolution profiling timelines, per-step tracing, and system metrics for faster diagnosis and optimization. It provides auto-instrumentation for stacks like vLLM and PyTorch.

How do I set up automatic tracing for vLLM and SGLang inference servers?

Automatic tracing for vLLM and SGLang is set up by installing the Graphsignal SDK, configuring your API key via graphsignal.configure or the GRAPHSIGNAL_API_KEY environment variable, and running your application with the graphsignal-run CLI to enable instrumentation.

Does GPU profiling with CUDA require specific Python or CUPTI versions?

GPU profiling with CUDA CUPTI requires Python 3.9 or higher and optional CUDA CUPTI extras. You must install the SDK with graphsignal[cu12] or graphsignal[cu13] to enable GPU profiling and integration for your specific CUDA version.

Can I manually annotate custom code paths during model inference?

Yes, you can manually annotate custom code paths during model inference using the SDK's manual tracing and profiling APIs. This allows you to measure and observe specific custom code sections beyond the automatic instrumentation.

What is the best way to observe PyTorch inference traces and system metrics?

The best way to observe PyTorch inference traces and system metrics is to use an auto-instrumentation SDK that captures high-resolution timelines and per-step data, applying it directly to your Python-based inference stack for automatic observability.