Clarification on HLS vs. LLHLS Dump Configuration (Documentation Discrepancy)

[Mengsreang-Chhoeung]

Hi OvenMediaEngine Team,

I am currently exploring the dump features of the HLS and LL-HLS publishers by walkthrough the REST API. Here is my json response of my application:

{
  "name": "default",
  "host": {
    "names": ["*"]
  },
  "originMapStore": {
    "originHostName": "ome.origin.local",
    "redisServer": {
      "host": "redis.local:6379"
    }
  },
  "applications": [
    {
      "name": "39421458",
      "type": "live",
      "providers": {
        "rtmp": {}
      },
      "publishers": {
        "hls": {
          "segmentDuration": 6,
          "segmentCount": 5,
          "dumps": {
            "dump": [
              {
                "enable": true,
                "targetStreamName": "*",
                "outputPath": "/data/recordings/hls/${VHostName}_${AppName}_${StreamName}/${YYYY}_${MM}_${DD}_${hh}_${mm}_${ss}",
                "playlists": {
                  "playlist": ["playlist.m3u8"]
                }
              }
            ]
          }
        },
        "llhls": {
          "segmentDuration": 4,
          "segmentCount": 10,
          "dumps": {
            "dump": [
              {
                "enable": true,
                "targetStreamName": "*",
                "outputPath": "/data/recordings/llhls/${VHostName}_${AppName}_${StreamName}/${YYYY}_${MM}_${DD}_${hh}_${mm}_${ss}",
                "playlists": {
                  "playlist": ["llhls.m3u8"]
                }
              }
            ]
          }
        },
        "ovt": {}
      },
      "outputProfiles": {
        "outputProfile": [
          {
            "encodes": {
              "audios": [
                {
                  "bitrate": 128000,
                  "channel": 2,
                  "codec": "aac",
                  "name": "aac_audio",
                  "samplerate": 44100
                }
              ],
              "videos": [
                {
                  "bitrate": 2500000,
                  "codec": "h264",
                  "framerate": 30,
                  "height": 720,
                  "keyFrameInterval": 60,
                  "name": "720p",
                  "width": 1280
                },
                {
                  "bitrate": 800000,
                  "codec": "h264",
                  "framerate": 30,
                  "height": 360,
                  "keyFrameInterval": 60,
                  "name": "360p",
                  "width": 640
                }
              ]
            },
            "name": "abr_stream",
            "outputStreamName": "${OriginStreamName}",
            "playlists": [
              {
                "fileName": "llhls",
                "name": "Standard_ABR",
                "options": {
                  "enableTsPackaging": true,
                  "webRtcAutoAbr": true
                },
                "renditions": [
                  {
                    "audio": "aac_audio",
                    "name": "720p",
                    "video": "720p"
                  },
                  {
                    "audio": "aac_audio",
                    "name": "360p",
                    "video": "360p"
                  }
                ]
              }
            ]
          }
        ]
      }
    }
  ]
}

And the dump of the LL-HLS is working perfectly but the dump of HLS isn't.
And then I walkthrough to your document and see that snippet:

Image from this page

My question: Is the document on this part correct to put the dump of HLS into the LL-HLS config?

[getroot]

@c-cabral Could you help this?

[Pinmonyoudom]

How is it now?

[getroot]

The documentation is wrong, thanks for pointing it out. The HLS publisher and the LLHLS publisher each read their own <Dumps> block independently (HLS publisher reads <HLS><Dumps>, LLHLS publisher reads <LLHLS><Dumps>). I've fixed the doc in #2116.

That said, your config already has the dump under hls, which is the correct placement, and HLS dump works on my side with a similar setup. Could you share the OME log around the time the stream starts, and the contents of the output directory? playlist.m3u8 matches the default HLS playlist name, so the dump should be running.