Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions doc/bin/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,6 +83,20 @@ downstream sees it. A sparse stream such as SCTE-35 goes quiet between cues, so
the line reports rather than alarms; `Import::stats` carries the same counters
for a caller that sets its own limit.

`import ts` also counts the ETSI TR 101 290 errors of the feed it receives, at
that standard's fixed limits: `TS_sync_loss`, `Sync_byte_error`, `PAT_error`,
`Continuity_count_error`, `PMT_error`, `Transport_error`, `CRC_error` (PAT and
PMT), `PCR_repetition_error`, `PCR_discontinuity_indicator_error` and
`PTS_error`. They are cumulative, logged with their totals in the sample after
any of them moves, and carried on `Import::stats` stream-wide and per PID. They
change nothing that is published. They grade the stream as it reached the
importer, not the wire a receiver sees downstream, and the PCR checks grade
consecutive PCR values rather than arrival times, so they speak for the encoder
and not for the network in front of the importer. Table, PCR and PTS intervals
run on the program clock, which starts at the first PCR after the PMT.
`PID_error` is covered, more strictly, by the access-unit counts above.
`PCR_accuracy_error` is not measured.

MPEG-TS import takes one program. A multi-program stream is refused before
anything is published, naming its programs, rather than merged onto one clock;
a PAT that adds a program mid-stream ends the import the same way.
Expand Down
5 changes: 3 additions & 2 deletions doc/bin/srt.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,9 @@ source (`--connect`); `moq export srt` serves SRT to players or pushes to a
remote. The payload is MPEG-TS, so the same codecs as [`import ts`](/bin/cli)
apply: H.264/H.265 video and AAC, MP2, AC-3, or E-AC-3 audio. Ingest logs the
same per-stream lines as `import ts`, under an `srt{path=...}` span: an
elementary stream that stopped delivering access units, and audio frame sync
lost.
elementary stream that stopped delivering access units, audio frame sync lost,
and the TR 101 290 counters when one moves. They grade the TS as SRT delivered
it, after retransmission.

```bash
# Accept a contribution feed and publish it
Expand Down
6 changes: 1 addition & 5 deletions quest/m1/ts-damaged-units.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Decided (maintainer, 2026-09-30):
- Count each drop in a new cumulative per-PID `damaged` counter on the stream's
stats row, beside `resyncs` and `discarded`, reported by `ts::stats::Log`.
It names what happened; no TR 101 290 check matches a codec error, and
[TS import health](/quest/m2/ts-import-health.md) keeps the ETSI names.
the TR 101 290 counters keep the ETSI names.
The rows are `#[non_exhaustive]`, so the field is additive; follow
[TS stats module](/quest/m1/ts-stats-module.md)'s names if it has landed.
- Errors that are not confined to one unit (the producer refusing a rewind,
Expand All @@ -50,7 +50,3 @@ Public API: additive, one stats field. Wire: none.
## Closes

- [#4581](https://github.com/moq-dev/moq/issues/4581) - one malformed packet ends the TS import

## Related

- [TS import health](/quest/m2/ts-import-health.md) - the TR 101 290 counters for the same feed
2 changes: 1 addition & 1 deletion quest/m1/ts-stats-module.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ Decided while planning the follow-ups of
- Update moq-cli's `publish.rs`, the only consumer that names these types.
moq-srt only uses `stats::Log`.
- Main still adds fields under the old names: #4584 added `crc_error`, and
[TS import health](/quest/m2/ts-import-health.md) adds more. `Export::stats`
the TR 101 290 counters added more. `Export::stats`
(#4577) also returns the old `ts::Stats`. The rename carries those at merge time. Update the type names in the quests still open
when this lands, including [media stats schema](/quest/m1/stats/schema.md)
and [Rust reporters](/quest/m1/stats/rust.md).
Expand Down
1 change: 0 additions & 1 deletion quest/m2/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,6 @@ waiting on an upstream release waits in [m4](/quest/m4/README.md).
- [Keep-alive by deadline](/quest/m2/quic-keep-alive.md) - a PING only when the idle deadline nears, no fixed timer
- [Socket close](/quest/m2/noq-socket-close.md) - `moq-quic` releases an endpoint's socket on close, so moq-tokio drops its wrapper
- [GOP overhead](/quest/m2/gop-overhead.md) - price the I-frames a short GOP pays for, deciding whether a long GOP plus a keyframe request is worth designing
- [TS import health](/quest/m2/ts-import-health.md) - `moq import ts` counts the TR 101 290 errors of the feed it receives, PCR and PTS graded on its own values
- [TS health stats](/quest/m2/ts-health-stats.md) - the TS counters ride the stats plumbing beside the media counters
- [TS stopped log: audio and video only](/quest/m2/ts-stopped-av-only.md) - sparse data PIDs like SCTE-35 stop logging "stopped delivering" every quiet second
- [Teleoperation](/quest/m2/teleop/README.md) - MoQ carries robot video down and control up on one session as a library capability
Expand Down
1 change: 0 additions & 1 deletion quest/m2/ts-health-stats.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,4 +42,3 @@ Decided while planning [#1838](https://github.com/moq-dev/moq/issues/1838):
- [TS stats module](/quest/m1/ts-stats-module.md) - the owned `track` that lets the rows deserialize
- [Media stats schema](/quest/m1/stats/schema.md) - the snapshot the counters flatten into
- [Rust reporters](/quest/m1/stats/rust.md) - `moq import --stats` and the stats interval
- [TS import health](/quest/m2/ts-import-health.md) - the ingest counters
111 changes: 0 additions & 111 deletions quest/m2/ts-import-health.md

This file was deleted.

Loading
Loading