TSHTTP¶

media.ingest.tshttp

Description¶

Sapsan connects to an HTTP server and receives continuous MPEG-TS from the response body. See MPEG-TS for UDP and multicast ingest.

Configuration¶

Configure the stream through the central API. Stream configuration fragment:

streams:
- name: source1
  inputs:
  - tshttp:
      url: https://origin.example.com/studio/mpegts
      peer_timeout_ms: 5000

Parameters¶

Parameter	Description
`url`	HTTP source address
`peer_timeout_ms`	data inactivity timeout.

Transport options¶

HTTP or HTTPS, including chunked transfer. This input does not require a listening UDP port.

Supported codecs¶

H.264
HEVC / H.265
AV1
JPEG 2000
MPEG-2 Video
AAC (ADTS)
AC-3
E-AC-3
MPEG Audio (Layer II / III)
SMPTE ST 302M

MPEG-TS is the container; SRT, RIST, UDP and HTTP are delivery transports. This list describes extracting frames from MPEG-TS, not decoding them or player support.

AV1 requires stream_type 0x06 and the AV01 registration descriptor in the PMT; one PES must contain a complete temporal unit. AV1 in MPEG-TS without this signaling is not supported. AAC parsing uses ADTS; recognizing stream_type 0x11 does not establish LATM support. Opus can be identified in the PMT, but the current PES decoder does not emit its frames.

Error handling¶

Input state and failure cause are available in stream statistics. Connection loss or missing frames uses the shared retry and failover mechanisms.

Applying changes¶

Changing url restarts the input; changing only peer_timeout_ms applies without disconnecting.

Counters¶

The tables give exact protocol statistics field names, including event counters and current-value gauges. Zero fields may be omitted. API and Prometheus expose different projections; the full list is not necessarily present in one Admin API response. Detailed statistics depend on the counter license.

Common input totals: bytes, frames, errors, warnings. They aggregate protocol data and must not be added to protocol counters again.

Mpegts¶

Field	Type
`bytes`	`counter`
`sync_bytes`	`counter`
`packets`	`counter`
`frames`	`counter`
`errors`	`counter`
`errors_ts_pat`	`counter`
`errors_ts_service_lost`	`counter`
`broken`	`counter`
`memory_bytes`	`gauge`

MpegtsPid¶

Field	Type
`pid`	`label`
`pnr`	`label`
`packets`	`counter`
`frames`	`counter`
`empty_packets`	`counter`
`errors_adaptation_broken`	`counter`
`errors_ts_scrambled`	`counter`
`errors_ts_pmt`	`counter`
`errors_ts_cc`	`counter`
`errors_ts_tei`	`counter`
`errors_ts_psi_checksum`	`counter`
`errors_pid_lost`	`counter`
`broken_pes_count`	`counter`
`broken_pes_sum`	`counter`
`time_corrections`	`counter`
`corrected_backward_pts`	`counter`
`discarded_buffer_count`	`counter`
`discarded_buffer_sum`	`counter`
`fillers_count`	`counter`
`fillers_sum`	`counter`
`unpaired_fields`	`counter`
`warning_invalid_sibling_frames`	`counter`
`padding_pes_count`	`counter`
`padding_pes_sum`	`counter`
`orphan_pes_count`	`counter`
`dts_goes_backwards`	`counter`
`dts_jump_forward`	`counter`
`too_large_dts_jump`	`counter`
`pcr_resync`	`counter`
`pcr_jitter_ok_0`	`counter`
`pcr_jitter_ok_500ns`	`counter`
`pcr_jitter_fail_500us`	`counter`
`pcr_jitter_fail`	`counter`
`hrd_buffer_min`	`gauge`
`hrd_buffer_max`	`gauge`
`hrd_buffer_underrun`	`counter`
`ad_marks`	`counter`
`errors_ad_marks_dropped`	`counter`
`warning_ad_mark_descriptors_dropped`	`counter`

Other details¶

Alongside video and audio, MPEG-TS carries:

DVB teletext.
KLV metadata.
SCTE-35 markers.
Track language descriptors and DVB subtitle descriptors from the PMT.