User interaction
================

To execute analytics on stream user must create stream specifying desired analytics.
The description of `Luna-Video-Manager` and analytics interaction is available in `analytics chapter <./analytics.html>`_.

For stream creation, it is required to make `stream creation request <_static/api.html#operation/createStream>`_.
For stream recreation is required to make `stream recreation request <_static/api.html#operation/putStream>`_,
in this case the new stream data will be used and stream version will be increased by 1.

After new stream appearance, it have a `pending` status (more information about stream statuses available
in `streams statuses chapter <./streams_statuses.html>`_).

When stream is processed by one of the available agents (information about streams to agents distribution is
available in `streams distribution chapter <./streams_distribution.html>`_) it will have `in_progress` status.

While stream processing is taking place, the agent will send feedback to Luna-Video-Manager, which will
produce streams logs available by making `get stream logs request <_static/api.html#operation/getStreamsLogs>`_.

Stream processing can be stopped:
    - by user request (`stream patch request <_static/api.html#operation/patchStream>`_) - stream will have `stop` status
    - by user request (`stream delete request <_static/api.html#operation/removeStream>`_) - stream will be removed
    - when stream ends - stream will have `done` status
    - when fatal error occurrs - stream will have `failure` status

In all cases except for `manual streams logs deletion <_static/api.html#operation/deleteStreamsLogs>`_, streams logs
will be available by making `get stream logs request <_static/api.html#operation/getStreamsLogs>`_.

In all cases except for stream deletion stream data will be available by making `get stream request <_static/api.html#operation/getStream>`_.