Push_list

Push_List

This requests a list of currently active pushes.

The request looks like this:

{
  "push_list": true //value is ignored
}

And is responded to as follows:

{
  "push_list":[
    [ID, "STREAMNAME", "URI", "URI", logs, pushstatus],
    //Etcetera
  ]
}

The ID is a unique per-push identifier that can be used to stop the given push (see "push_stop" below), the stream name and first URI are the values from the original call. The second URI is after handling any triggers and/or , which may be identical to the first if neither was applicable. logs is a JSON array of log messages applicable o this push. pushstatus is a JSON object containing the latest push status (containing output-specific name/value pairs).

If an entry is missing, it is no longer running/functional. Thus, all entries are currently active.

If this call is done simultaneously with a start push call, it may not yet contain the push as starting a push takes a moment. The same goes for stop push calls.

Refreshing a few times afterwards to make sure the push started (or stopped) correctly is advisable.

Example live output

{
    "push_list": [
        [
            9791,  //PID of the Push process
            "exampleinput", //source stream name
            "rtmp://example/live/exampleoutput", //given push target
            "rtmp://example/live/exampleoutput", // parsed push target
            [
                [ //Log information, `null` if none at current log level
                    1762482474,
                    "INFO",
                    "No cert or key set, regular RTMP mode",
                    "live",
                    9791,
                    "MistOutRTMP",
                    "../src/output/output_rtmp.cpp"
                ],
                [
                    1762482474,
                    "INFO",
                    "About to push stream live out. Host: example, port: 1935, app: live, stream: exampleoutput",
                    "exampleinput",
                    9791,
                    "MistOutRTMP",
                    "../src/output/output_rtmp.cpp"
                ],
                [
                    1762482474,
                    "INFO",
                    "Booting new session Odecf84f5c65c5c68ee786b84f1af434ae07200494ec685838b907461986b373c",
                    "exampleinput",
                    9791,
                    "MistOutRTMP",
                    "../lib/comms.cpp"
                ],
                [
                    1762482474,
                    "INFO",
                    "Server version: FMS/3,5,5,2004",
                    "exampleinput",
                    9791,
                    "MistOutRTMP",
                    "../src/output/output_rtmp.cpp"
                ],
                [
                    1762482474,
                    "INFO",
                    "Re-selecting tracks because compatible codec list was updated",
                    "exampleinput",
                    9791,
                    "MistOutRTMP",
                    "../src/output/output_rtmp.cpp"
                ]
            ],
            {
                "active_ms": 4219, // time the push has been active in ms
                "active_seconds": 4, // time the push has been active in s
                "bytes": 1918407, // bytes total send
                "current_target": "", 
                "latency": 427, // Latency in millisecond between source live point and push out.
                "media_tx": 4080, // media transferred in millisecond
                "mediatime": 3641593, // Last media timestamp send according to metadata
                "tracks": [  // tracks within the push
                    0,
                    2
                ]
            }
        ]
    ]
}