Monitoring¶
Data for monitoring¶
We are currently processing several types of events for monitoring:
request (any http request)
error (failed http request)
licensing
sdk estimation
analytics manager
Every event is a point in the time series. The point is represented as union of the following data:
series name
start event time
tags, indexed data in storage, dictionary: keys - string tag names, values - string, integer, float
fields, non indexed data in storage, dictionary: keys - string tag names, values - string, integer, float
Monitoring series¶
Requests series.
Triggered on every request. Each point contains a data about corresponding request (execution time and etc).
¶ tag name
description
service
always “luna-remote-sdk”
route
concatenation of a request method and a request resource (POST:/sdk)
status_code
http status code of response
¶ fields
description
request_id
request id
execution_time
request execution time
¶ fields
resource
description
load_images_for_processing_time
/sdk
time taken to load image for processing from request
load_images_for_processing_time
/iso
time taken to load image for processing from request
Errors series.
Triggered on failed request. Each point contains error_code of luna error.
¶ tag name
description
service
always “luna-remote-sdk”
route
concatenation of a request method and a request resource (POST:/sdk)
status_code
http status code of response
error_code
Luna Platform error code
¶ fields
description
request_id
request id
Licensing series.
Triggered if liveness balance is over. Each point contains license check data.
¶ tag name
description
service
always “luna-remote-sdk”
license_status
license status (“warning”, “error”)
¶ fields
description
liveness_balance
number of liveness estimations before the license expires
warnings
license warning messages
errors
license errors messages
Usages_statistic series.
Triggered on every request involving some SDK estimations. Each point contains data on the number of estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
¶ fields
description
people_counter_usages
people counter estimator usages count
face_detector_usages
face detector usages count
landmarks68_detector_usages
landmarks68 detector usages count
head_pose_estimator_usages
head pose estimator usages count
liveness_estimator_usages
liveness estimator usages count
mask_estimator_usages
mask estimator usages count
emotion_estimator_usages
emotion estimator usages count
mouth_estimator_usages
mouth estimator usages count
eye_estimator_usages
eye estimator usages count
gaze_estimator_usages
gaze estimator usages count
glasses_estimator_usages
glasses estimator usages count
face_warp_quality_estimator_usages
face warp quality estimator usages count
face_basic_attributes_extractor_usages
face basic attributes extractor usages count
face_descriptor_extractor_usages
face descriptor extractor usages count
iso_estimator_usages
iso estimator usages count
face_quality_estimator_usages
face quality estimator usages count
body_detector_usages
body detector estimator usages count
body_descriptor_extractor_usages
body descriptor extractor usages count
body_basic_attributes_estimator_usages
body basic attribute estimator usages count
body_upper_attributes_estimator_usages
body upper attribute estimator usages count
body_accessories_estimator_usages
body accessory estimator usages count
body_lower_attributes_estimator_usages
body lower attribute estimator usages count
deepfake_estimator_usages
deepfake estimator usages count
Sdkloop_task series.
Image_load series.
SDK monitoring series. Triggered on every request involving some SDK estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
format
image format, i.e. “JPEG”, “PNG”, etc.
exif
whether the exif loading is on
autorotated
whether the autorotation is on
¶ fields
description
execution_time
image loading time in seconds
size
image size in bytes
height
image height in pel
width
image width in pel
Aggregated_basic_attributes series.
SDK monitoring series. Triggered on every request involving aggregated basic attributes estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
Aggregated_body_descriptor series.
SDK monitoring series. Triggered on every request involving aggregated body descriptor estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
¶ fields
description
execution_time
estimation time in seconds
Aggregated_face_descriptor series.
SDK monitoring series. Triggered on every request involving aggregated face descriptor estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
¶ fields
description
execution_time
estimation time in seconds
Ags series.
Basic_attributes series.
Body_attributes series.
Body_descriptor series.
SDK monitoring series. Triggered on every request involving body descriptor estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
¶ fields
description
execution_time
estimation time in seconds
Body_detection series.
SDK monitoring series. Triggered on every request involving body detection estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
body_detection_height
body detection height
image_height
image height
body_detection_width
body detection width
image_width
image width
detection_count
detection count
Body_redetection series.
SDK monitoring series. Triggered on every request involving body redetection estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
body_detection_height
body detection height
image_height
image height
body_detection_width
body detection width
image_width
image width
detection_count
detection count
bbox_width
bbox width
bbox_height
bbox height
Body_warp series.
Deepfake series.
Dynamic_range series.
Emotions series.
Eyebrow_expression series.
Eyes series.
Face_descriptor series.
SDK monitoring series. Triggered on every request involving face descriptor estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
¶ fields
description
execution_time
estimation time in seconds
Face_detection series.
SDK monitoring series. Triggered on every request involving face detection estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
face_detection_height
face detection height
image_height
image height
face_detection_width
face detection width
image_width
image width
detection_count
detection count
Face_detection_background series.
SDK monitoring series. Triggered on every request involving face detection background estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
Face_natural_light series.
Face_redetection series.
SDK monitoring series. Triggered on every request involving face redetection estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
face_detection_height
face detection height
image_height
image height
face_detection_width
face detection width
image_width
image width
detection_count
detection count
bbox_width
bbox width
bbox_height
bbox height
Face_warp series.
Face_warp_quality series.
Fisheye series.
Gaze_direction series.
Glasses series.
Head_pose series.
Headwear series.
Human_detection series.
SDK monitoring series. Triggered on every request involving human detection estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
face_detection_height
face detection height
face_detection_width
face detection width
body_detection_height
body detection height
body_detection_width
body detection width
image_height
image height
image_width
image width
detection_count
detection count
face_detection_count
face detection count
body_detection_count
body detection count
Human_track series.
SDK monitoring series. Triggered on every request involving human track estimations. Each point contains data on estimations performed.
¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
¶ fields
description
execution_time
estimation time in seconds
track_count
track count
Image_orientation series.
Image_color_type series.
Landmarks5 series.
Landmarks68 series.
LivenessV1 series.
Mask series.
Mouth_state series.
People_count series.
Portrait_style series.
Red_eyes series.
frame_monitoring series.
Analytics manger monitoring series. Triggered on every frame of the video. Each point contains data on analytics performed on one frame.
¶ tag name
description
service
always “luna-remote-sdk”
concurrency
max number of frames processed in parallel
¶ fields
description
execution_time
analytics execution time in seconds
video_id
internal id of the video on which analytic was performed
¶ fields
description
human_tracking_frame_execution
time taken to execute human tracking analytic on a frame
crowd_frame_execution
time taken to execute crowd analytic on a frame
node_crowd series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
¶ fields
description
people_count
estimated amount of people
node_human_tracking series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
people_count
people tracked on a frame
¶ fields
description
face_count
faces detected on a frame
body_count
bodies detected on a frame
node_aggregated_body_attributes series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_body_thumbnail series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_body_descriptor series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_body_samples series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_deepfake series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_face_basic_attributes series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_face_thumbnail series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_face_descriptor series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_face_samples series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_aggregated_liveness series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_ags series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_emotions series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_eyes series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_gaze series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_glasses series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_head_pose series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_landmarks5 series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_mask series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_mouth series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_warp_quality series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_body_warp series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_event_policy series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
node_face_warp series.
Analytics manger nodes monitoring series. Triggered on every frame of the video if node was involved in analytics process. Each point contains data on node processing on a frame.
¶ tag name
description
service
always “luna-remote-sdk”
skipped
whether node was skipped or not (true or false)
¶ fields
description
execution_time
estimation time in seconds
video_id
Internal id of the video on which analytic was performed
Database¶
Monitoring is implemented as data sending to an influx database. You can setup your database credentials in configuration file in section “monitoring”.
Plugins¶
You can implement your own plugin for sending monitoring data. See plugins
Module request monitoring plugin example
- class luna_remote_sdk.crutches_on_wheels.cow.plugins.plugin_examples.request_monitoring_plugin_example.BaseRequestMonitoringPlugin(app)[source]¶
Base class for requests monitoring.
- class luna_remote_sdk.crutches_on_wheels.cow.plugins.plugin_examples.request_monitoring_plugin_example.RequestMonitoringPlugin(app)[source]¶
Example plugin sends a request data for monitoring to third-party source. Only one instance of this class exist during the program execution.