Renames the app/ingest/ package to app/glean/ and updates all references across Python modules, shell scripts, Vue components, tests, and documentation. Intentionally preserved: - SQLite column name ingest_time (avoids schema migration) - RetrievedEntry.ingest_time field (maps to the column above) - Any public-facing JSON keys that reference ingest_time Changes by category: - app/ingest/ → app/glean/ (full package move, all parsers) - app/tasks/ingest_scheduler.py → app/tasks/glean_scheduler.py - scripts/ingest_corpus.py → scripts/glean_corpus.py - tests/test_ingest_*.py → tests/test_glean_*.py - Docstrings, log messages, comments: ingest → glean - Env var: TURNSTONE_INGEST_INTERVAL → TURNSTONE_GLEAN_INTERVAL - Shell scripts: glean.log, glean_corpus.py references - README.md: multi-source ingest → multi-source glean - .env.example: updated env var name - patterns/: new diagnostic patterns from 2026-05-20 SSH incident (service_crash_loop, pkg_daemon_restart, ssh_forward_conflict) - SourcesView.vue: pipeline label updated - All test import paths updated to app.glean.* 285 tests passing.
63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# Tautulli Webhook Setup
|
|
|
|
Tautulli is a Plex Media Server (PMS) monitoring application. This guide shows
|
|
how to configure Tautulli to send playback events to Turnstone.
|
|
|
|
## Triggers to enable
|
|
|
|
In your notification agent, enable these triggers:
|
|
|
|
- Playback Start
|
|
- Playback Stop
|
|
- Playback Pause
|
|
- Playback Resume
|
|
- Playback Error
|
|
- Playback Buffering
|
|
|
|
## JSON body template
|
|
|
|
Paste this into the **JSON Data** field of the Tautulli Custom Script / Webhook
|
|
notification agent:
|
|
|
|
```json
|
|
{
|
|
"action": "{action}",
|
|
"timestamp": "{timestamp}",
|
|
"user": "{user}",
|
|
"player": "{player}",
|
|
"media_type": "{media_type}",
|
|
"title": "{title}",
|
|
"grandparent_title": "{grandparent_title}",
|
|
"quality": "{quality}",
|
|
"video_decision": "{video_decision}",
|
|
"audio_decision": "{audio_decision}",
|
|
"error_message": "{error_message}",
|
|
"session_key": "{session_key}"
|
|
}
|
|
```
|
|
|
|
## Webhook URL
|
|
|
|
```
|
|
http://<turnstone-host>:8534/turnstone/api/glean/tautulli
|
|
```
|
|
|
|
Replace `<turnstone-host>` with the hostname or IP of the machine running
|
|
Turnstone. (8534 is the default port; adjust if you're using a reverse proxy or changed the port)
|
|
|
|
## Optional token authentication
|
|
|
|
If you set `tautulli_token` in Turnstone settings, every webhook request must
|
|
include a matching header:
|
|
|
|
```
|
|
X-Tautulli-Token: <your-token>
|
|
```
|
|
|
|
Add this header in the Tautulli notification agent's **Headers** section.
|
|
Requests with a missing or wrong token are rejected with HTTP 403.
|
|
|
|
## Searching events
|
|
|
|
All events are stored under source `tautulli` and are immediately searchable
|
|
in Turnstone after each webhook is received.
|