Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tracectrl.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
TraceCtrl

TraceCtrl gives security teams and developers complete visibility into every agent action, tool call, and data access — with runtime protection and attack graph risk scoring. Built by CloudsineAI.

​
What TraceCtrl Does

Agent Visibility

See every LLM call, tool invocation, and agent-to-agent message in real time. Know exactly what your agents are doing.

Security Enrichment

Every span is enriched with security attributes — tool risk categories, input provenance, session correlation, and prompt drift detection.

Topology Mapping

Automatically discovers agent-to-agent and agent-to-tool relationships, building a live topology graph of your agentic system.

Risk Scoring

TAGAAI-powered attack graph analysis scores agents and paths by exploitability — prompt injection, excessive agency, data leakage.

​
How It Works

TraceCtrl uses OpenTelemetry as the transport layer. You add 3 lines to your agent code, and the SDK captures every operation as enriched spans. 
import tracectrl
tracectrl.configure(service_name="my-agent")
tracectrl.tag_agent(name="my-agent", role="primary")

from tracectrl.instrumentation.strands import StrandsInstrumentor
StrandsInstrumentor().instrument()

# Your existing agent code — no changes needed
Spans flow through the OTel Collector into ClickHouse, where the TraceCtrl Engine processes them into an agent inventory, topology graph, and risk scores — all queryable via API and visible in the dashboard.

​
Supported Frameworks

FrameworkPackageVersionDownloadsStatus
Agnotracectrl-instrumentation-agnoPyPIDownloadsStable
AWS Strandstracectrl-instrumentation-strandsPyPIDownloadsStable
CrewAItracectrl-instrumentation-crewai——Source only
LangChaintracectrl-instrumentation-langchain——Source only
Google ADKtracectrl-instrumentation-google-adk——Source only
OpenClawNative OTEL — no SDK needed——Stable
Stable = published to PyPI and tested end-to-end. Source only = the instrumentor package exists in the TraceCtrl repo and can be installed from source (pip install -e ./sdk/tracectrl-instrumentation-<framework>), but is not yet on PyPI. OpenClaw uses its native OTEL export — no TraceCtrl SDK needed. See the OpenClaw instrumentor guide.

​
Next Steps

Quickstart

Get TraceCtrl running in 5 minutes with Docker Compose.

SDK Installation

Install the SDK and instrument your first agent.