Connect Tracearr

Add Tracearr to Kochab with its public API key for cross-server streams, alerts, and playback analytics.

Tracearr watches your media servers and records who streamed what, flagging activity against rules you set. Unlike Tautulli (Plex only) or Jellystat (Jellyfin only), one Tracearr can cover Plex, Jellyfin, and Emby together.

What Kochab exposes through Tracearr

  • Recent activity: live streams with the direct play / direct stream / transcode split
  • Alerts: recent rule violations and a 24 hour alert count
  • Flagged users: who tripped a rule, and which violations are acknowledged
  • Resources: server resource readings Tracearr collects
  • Libraries: per-library breakdown across every server Tracearr watches
  • Analytics charts: plays over time, by hour, by day of week, and per month; top platforms; stream types by user; transcode split; peak concurrency; bandwidth; top users and top watched
  • Commands: terminate an in-progress stream
  • Notifications: rule violations, plus media server offline and online events, after a one-time paste into Tracearr (see Set up notifications)

Kochab probes for Tracearr’s v2 API at connect time and uses it when present, falling back to v1 otherwise. You do not need to pick a version.

Not exposed through Tracearr

  • Editing Tracearr’s rules, users, or server list. Set those up in the Tracearr web UI
  • Administering the media servers Tracearr watches

Before you start

In Tracearr: Settings -> API Key. Copy the public API key. Kochab stores it in the device’s secure storage and sends it as a bearer token.

Default connection

Field Typical value
Port 9000 (the API port)
Scheme http by default, https if you have set it up
Auth Public API key, sent as a bearer token

Add in Kochab

  1. Open More > Stacks & Services > + > Add service and choose Tracearr.
  2. Enter the host or IP, set Port to 9000 (or your configured port), and set Use HTTPS to match the address.
  3. Paste the public API key.
  4. Tap Test & Add.

Set up notifications

Tracearr 2.2 and later keep webhooks under Destinations, which only the Tracearr owner can edit from the web UI. The API key Kochab uses cannot add one, so you paste the URL in once yourself.

  1. In Kochab, open Tracearr, tap the edit (pencil) button, and tap Set up under Notifications. Tap Copy URL.
  2. In Tracearr, open Settings -> Destinations and select Add destination.
  3. Choose Webhook (JSON), name it Kochab, and paste the URL.
  4. Turn on Receive violations, select Test to check it, then Save. A test notification should reach your phone.
  5. For server alerts, open Automations -> New automation, pick Server down, and send it to the Kochab destination. Do the same with Server back up.

On Tracearr before 2.2, open Settings -> Notifications, add a JSON Webhook agent, and paste the URL into Webhook URL.

Base path behind a reverse proxy

If you serve Tracearr under a path (for example https://example.com/tracearr), include that path in the URL you enter. Kochab appends the API routes to whatever base you give it.

TLS

Self-signed certificates use the same trust flow as other services. See Certificate trust.

Tips

  • Tracearr is an analytics and monitoring surface. Add your media servers to Kochab as well for browsing, playback, and artwork.
  • Where you run more than one analytics source, the Analytics screen blends them rather than making you choose.
  • A newly connected Tracearr needs to sync its servers before the numbers look right.

Official docs

Tracearr documentation