Skip to content

multi-stream-harness.md

Latest commit

 

History

History
70 lines (49 loc) · 2.89 KB

multi-stream-harness.md

File metadata and controls

70 lines (49 loc) · 2.89 KB
Raw
id howto-multi-stream-harness
type how-to
status current
tags
how-to
diagnostics
concurrency
harness
multi-stream

Multi-stream contention harness

Run two or more staggered live pulls against a running IPTV Tunerr instance, capture per-stream HTTP artifacts, sample /provider/profile.json, /debug/stream-attempts.json, and /debug/runtime.json, optionally snapshot Plex /status/sessions, and summarize sustained vs premature reads.

When to use

  • Reproducing “second stream starts, first dies” (provider concurrency, flaky HLS, or Tunerr pressure).
  • Collecting a single bundle for triage instead of hand-aligned double curl sessions.

Preconditions

  • Tunerr serve/run reachable (set TUNERR_BASE_URL, e.g. http://127.0.0.1:5004).
  • bash, curl, python3 on the machine running the harness.
  • At least two channel IDs or full /stream/... URLs.

Quick start

TUNERR_BASE_URL='http://127.0.0.1:5004' \
CHANNEL_IDS='325824,123456' \
RUN_SECONDS=40 \
START_STAGGER_SECS=3 \
./scripts/multi-stream-harness.sh

For longer live soaks, avoid filling .diag/ with MPEG-TS bodies and match Plex's internal fetcher shape:

TUNERR_BASE_URL='http://127.0.0.1:5004' \
CHANNEL_IDS='904206,904205,904207,177344' \
RUN_SECONDS=480 \
CURL_USER_AGENT='Lavf/60.16.100' \
DISCARD_BODY=true \
./scripts/multi-stream-harness.sh

Output lands under .diag/multi-stream/<run-id>/. Print summary.txt, then synthesize a verdict:

python3 scripts/multi-stream-harness-report.py --dir .diag/multi-stream/<run-id> --print

(summary.txt inside the run dir repeats the recommended --dir.)

Full detail

Artifact layout, CHANNEL_URLS_FILE, tuning POLL_SECS, ATTEMPTS_LIMIT, CURL_USER_AGENT, DISCARD_BODY, PMS_URL / PMS_TOKEN, and how to read report.txt / report.json: Runbook §10 — Two-stream collapse.

Related harnesses

CI / development

./scripts/verify runs bash -n on scripts/multi-stream-harness.sh and python3 -m py_compile on scripts/multi-stream-harness-report.py (see scripts/verify-steps.sh).

List recent harness output dirs (this family + live-race + stream-compare): python3 scripts/harness-index.py ( --json optional).

See also