Skip to content

Monitoring#

Monitoring is implemented as sending data to InfluxDB. Monitoring for LUNA Streams is enabled by default. Monitoring for FaceStream is disabled by default. To enable FaceStream monitoring, you need to enable the "send_data" setting and set additional settings from the "monitoring" section.

Monitoring for LUNA Streams works similarly to monitoring of LUNA PLATFORM services. This document describes FaceStream monitoring information. See additional information on monitoring LUNA Streams in the "Monitoring" section of the LUNA PLATFORM administrator manual.

The following data is sent to InfluxDB:

  • measurement element. It is equal to the value of fs-requests.

  • tag set:

    • fs_ip - IP address where FaceStream is deployed
    • source - the "name" field set when creating a stream in LUNA Streams (optional)
    • stream_id - stream ID

  • field set:

    • track_id - track ID
    • event_id - event ID
    • request_id - external ID for communication with monitoring of LUNA PLATFORM services
    • track_start_time - track start time
    • track_best_shot_time - the time when the frame with the bestshot being sent appeared in the system
    • track_best_shot_min_size_time (optional) - the time when the detection size reached the value specified in the "best_shot_min_size" parameter
    • track_best_shot_proper_size_time (optional) - time when the detection size reached the value specified in the "best_shot_proper_size" parameter
    • liveness_start_time (optional) - Liveness start time
    • liveness_end_time (optional) - Liveness end time
    • bestshot_count - the number of bestshots sent
    • time_from_first_frame_to_send - the time that passed from the appearance of the first frame in FS to sending to LP
    • track_send_count - the number of tracks sent

    Tags containing time are sent as UTC with microsecond precision.

  • <timestamp> element. Is the time the bestshot(s) was(were) sent in microseconds.

There may be several bestshots, because sending from one track at a time counts as one measurement. To save this measurement, InfluxDB uses the last bestshot data from the bestshots group. Data that is unique for each best shot (track_best_shot_time, liveness_start_time, liveness_end_time) will be lost for all bestshots except the last one if sent this way.

If there are no optional fields, the data of these fields will not be sent to the Influxdb.

During normal monitoring operation, no additional information is output to the FaceStream logs. If an error is detected during monitoring, the corresponding message will appear in the FaceStream logs.

InfluxDB OSS 2#

For InfluxDB OSS 2 usage, you should:

  • Install the DB. See the "InfluxDB OSS 2 container launch" in the installation without LP manual.
  • Register in the DB. InfluxDB has a user interface where you can register. You should visit <server_ip>:<influx_port>.
  • Configure the display of monitoring information in the GUI. It is not described in this documentation.