Introduction

The Luna-Video-Manager service is intended for streams distribution among agents and subsequent analysis of these streams.

The agent is a third-party service designed to decode and execute analytics on streams. There is a Luna-Video-Agent service provided by VL, but there is a possibility to create your own agent, see agent interaction chapter for details.

The Luna-Video-Manager distributes streams to agents taking into account of available analytics, does not create/modify analytics itself, but only registers analytics provided by agent(s) and uses knowledge about agent possibility to work with one or another analytics to distribute streams. For more information about analytics see analytics chapter.

Each Luna-Video-Manager can serve a limited count of user requests and each agent can analyze a limited count of streams, that’s why these services can be scaled like so each Luna-Video-Manager has access to one and the same database and each agent has access to one of Luna-Video-Managers. For more information about interaction with database in this case see master instance chapter.

Note

The Luna-Video-Manager can work with streams and files, to simplify the description here and below the stream will be used to denote both options since the difference from the point of view of processing and distribution is only that the file will end anyway

User interaction

Common user interaction occurs as follows:

• stream creation using stream creation request

• watch stream status using get stream request

• stop or start stream processing using patch stream request

For more information about user interaction see user interaction chapter. For more information about stream lifecycle see streams lifecycle.

Agent interaction

The Luna-Video-Manager interaction with agent occurs as follows:

• agent register itself using register agent request

• agent periodically get streams for analysis using get streams request

• agent send feedback to Luna-Video-Manager using send feedback request

For more information about agent interaction see agent interaction chapter.

Luna-Video-Manager background processes

Independently of Luna-Video-Manager instance count, one of them will become master instance (see master instance for details). The master instance will periodically execute several tasks:

• distribute streams to agents (see streams distribution for details)

• streams restarting (see streams autorestart for details)

• streams downgrade (see streams downgrade for details)

• agents downgrade (see agents downgrade for details)