# TrafficWar

> Real-time event observability for live request flow, latency percentiles, distributed traces, searchable events, alerts, and service metrics.

TrafficWar turns application events into an interactive live map, mergeable latency metrics, request waterfalls, event exploration, alerts, and service-scoped Prometheus hot metrics.

## Shipped capabilities

- TrafficWar Live Map across edge, backend, database, Redis, S3, and external-service tiers.
- Count, error, rate, moment, and latency-percentile metrics.
- Searchable raw events with service, method, route, trace, geography, source, status, and error filters.
- Distributed trace waterfalls connected by `trace_id`.
- Email, Telegram, and verified webhook alert destinations.
- Published `@trafficwar/node` server SDK and direct JSON or MessagePack ingest API.
- Primary compute and object storage with OVHcloud in Frankfurt, Germany.

## Frequently asked questions

### What is TrafficWar?

TrafficWar is a real-time event observability service. It turns application events into live request maps, latency percentiles, traces, searchable event data, alerts, and Prometheus-compatible hot metrics.

### How do I send events?

Install the published @trafficwar/node server SDK, create a service API key, and call capture with one event or an array. The SDK batches delivery automatically. A Python SDK is implemented but remains unpublished.

### Can I inspect individual requests?

Yes. Explore filters events by service, route, HTTP method, trace, geography, source, status, and error. Historical raw-event coverage depends on the selected plan.

### What does the TrafficWar Live Map show?

The live map turns incoming spans into a tier-aware flow across edge, backend, database, Redis, and S3 dependencies, with latency and failures visible as traffic arrives.

### Does TrafficWar support distributed traces?

Yes. Give every span in a request the same trace_id and label. TrafficWar reconstructs the waterfall and shows inclusive and exclusive time across tiers.

### Where is TrafficWar hosted?

Primary compute and object storage are hosted with OVHcloud in Frankfurt, Germany. The privacy policy, DPA, and subprocessor list describe data handling in detail.

## Links

- [Developer documentation](https://trafficwar.tech/docs)
- [Pricing](https://trafficwar.tech/pricing)
- [Privacy policy](https://trafficwar.tech/privacy)
- [Data Processing Addendum](https://trafficwar.tech/dpa)
- [Subprocessors](https://trafficwar.tech/subprocessors)