📋 Logs SDK · Layer L502
Distributed tracing and structured logging for every AI call.
Every request traced from API entry to model response. Trees of spans with timestamps, latencies, model selections, costs and outcomes. Purpose-built for AI.
How it works
Logs SDK in three steps
Production-grade and live on api.forcedream.ai. One Bearer token, zero extra setup.
-
01
🔍
Trace
Every /v1/route, /v1/agents and /v1/memory call auto-generates a trace. No instrumentation required.
Auto-generated -
02
📊
Analyse
Nested span trees show latency at every step — model selection, memory recall, safety checks. Full cost attribution per call.
GET /v1/logs?limit=10 -
03
🔔
Alert
Set thresholds — error rate spikes, latency regressions, revenue drops — and receive webhook or email alerts.
Pro feature
What's included
Everything you need, nothing you don't
Quick start
# Logs are automatic for all /v1/route and /v1/agents calls
# Start a custom trace span:
$ curl https://api.forcedream.ai/v1/logs/trace \
-H "Authorization: Bearer $KEY" \
-d '{"operation":"doc_analysis","service":"my-app","tags":{"user_id":"usr_123"}}'
→ {"span_id":"span_4c8e","operation":"doc_analysis","started_at":1747043200000}
# Query recent traces
$ curl "https://api.forcedream.ai/v1/logs?limit=10&service=my-app" \
-H "Authorization: Bearer $KEY"
→ {"traces":[{"id":"trace_2b7f","spans":12,"p99_ms":820,"cost_pence":4.2}],"total":147}
Pricing
Simple, transparent pricing
78% of API earnings flow back to you on every call. No hidden fees. Free tier available.
Comparison
How Logs SDK compares
Purpose-built for AI products. Not retrofitted from general-purpose tools.
| Feature | ForceDream Logs | Datadog APM | New Relic | DIY logging |
|---|---|---|---|---|
| AI-native tracing | ✓ | — | — | Manual |
| Model cost attribution | ✓ | — | — | Manual |
| 80% earnings back | ✓ | — | — | — |
| Zero config | ✓ | Complex | Complex | Days |
| OTel export | ✓ | ✓ | ✓ | ✓ |
| Price | £19/mo | £100+/mo | £80+/mo | Varies |
FAQ
Frequently asked questions
Start with Logs SDK.
Scale to all 22 products.
Free tier available. 80% earnings from your first call. Every call. WORM-sealed by default.
No credit card 80% earnings guaranteed WORM-sealed audit