Streams troubleshooting

A situation like this is possible when errors may occur during the processing of a stream or video file. Occasionally, logs from the luna-video-agent or video manager may contain error messages that can be difficult to interpret or do not provide a comprehensive understanding of the situation.

To diagnose and locate the problem, the following tools are available within the container:

Note

Here and below, the <luna-video-agent-docker-name> is luna-video-agent docker image id/name in system

Note

Basically it is recommended to use tools below step-by-step if there is no interpretation of problem. (Check stream/video availability using ffprobe, check it stability using ffmpeg and check that luna-video-agent service is allow to process stream using luna_decoder)

• ffprobe: A tool for retrieving information about media files. To analyze stream availability and its parameters, use the command:

  <luna-video-agent-docker-name> bash -c "ffprobe <stream-source>"
  

  The –help option provides information about available parameters:

  <luna-video-agent-docker-name> bash -c "ffprobe --help"
  

  Note

  Detailed ffprobe description and documentation available on it’s website

• ffmpeg: A tool for video processing. To check the availability and stability of the stream, use the command:

  <luna-video-agent-docker-name> bash -c "ffmpeg -i <stream-source> -f null /dev/null"
  

  (it will decode stream unless it is available and EOF was not received or interrupt by user). Observe the output to determine if connection failures occur or if the camera drops.

  The –help option provides information about available parameters:

  <luna-video-agent-docker-name> bash -c "ffmpeg --help"
  

  Note

  Detailed ffprobe description and documentation available on it’s website

• Luna Decoder: The decoder directly used by the service.

  Running the decoder without analytics and additional components allows to test the decoding of the stream or file. To run it, use the command:

  <luna-video-agent-docker-name> bash -c "luna_decoder <stream-source>"
  

  The –help option provides information about available parameters:

  <luna-video-agent-docker-name> bash -c "luna_decoder --help"
  

These tools will help determine whether the problem is stream/video unavailability, format incompatibility, connection instability, or other factors preventing processing. The data obtained will allows to properly understand the situation and helps to debug.