RIST¶

media.ingest.rist

Description¶

Receive MPEG-TS over RIST with retransmission-based recovery of network loss. Simple Profile and Main Profile are supported.

Configuration¶

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

streams:
- name: source1
  inputs:
  - rist:
      host: 0.0.0.0
      port: 5000
      profile: simple
      buffer_ms: 1000

Parameters¶

Parameter	Description
`host`	local address or multicast group
`port`	even Simple Profile media port.
`buffer_ms`, `reorder_ms`, `max_retries`	`buffer_ms` (1000), `reorder_ms` (70), `max_retries` (7) control recovery.
`peer_timeout_ms`	source timeout.
`multicast_interface`	group interface.
`profile`	`simple` or `main`.
`tunnel_port`, `tunnel_role`, `encryption_passphrase`, `allow_insecure_encryption`	Main uses `tunnel_port`, `tunnel_role` (`client`/`server`, default input role `server`), `encryption_passphrase`, `allow_insecure_encryption` (default `false`).

Authentication¶

Main Profile supports a shared PSK through encryption_passphrase. Simple Profile does not provide encryption.

Transport options¶

Simple Profile — RTP on even port P, RTCP on P+1.
Main Profile — GRE tunnel on tunnel_port.
ARQ — retransmission within the receive buffer budget.

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¶

Apply changes through the central API. Changing the source address or format reopens capture and may interrupt ingest while connecting. Check input state and arriving frames afterwards.

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.

Rist¶

Field	Type
`incoming_packets`	`counter`
`incoming_lost_packets`	`counter`
`incoming_recovered_packets`	`counter`
`incoming_unrecovered_packets`	`counter`
`incoming_duplicate_packets`	`counter`
`incoming_retransmitted_packets`	`counter`
`incoming_reordered_packets`	`counter`
`incoming_late_packets`	`counter`
`incoming_invalid_datagrams`	`counter`
`incoming_foreign_ssrc_packets`	`counter`
`incoming_foreign_profile_packets`	`counter`
`incoming_undecryptable_packets`	`counter`
`incoming_encryption_mismatch_packets`	`counter`
`source_restarts`	`counter`
`outgoing_nak_packets`	`counter`
`outgoing_packets`	`counter`
`outgoing_bytes`	`counter`
`outgoing_retransmitted_packets`	`counter`
`incoming_nak_packets`	`counter`
`retransmits_denied_cache`	`counter`
`retransmits_denied_rate`	`counter`
`cache_evicted_by_ceiling`	`counter`
`tunnel_keepalives_sent`	`counter`
`tunnel_keepalives_received`	`counter`
`tunnel_discarded_unknown_version`	`counter`
`tunnel_discarded_bad_encapsulation`	`counter`
`tunnel_discarded_unroutable`	`counter`
`tunnel_discarded_queue_full`	`counter`
`tunnel_discarded_foreign_profile`	`counter`
`rtt_us`	`gauge`
`tunnel_up`	`gauge`
`tunnel_silence_ms`	`gauge`
`tunnel_streams`	`gauge`
`tunnel_insecure_iv_allowed`	`gauge`
`memory_bytes`	`gauge`

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.