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).
Requests series tags¶ 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
Requests series fields¶ fields
description
request_id
request id
execution_time
request execution time
Requests series additional fields¶ 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.
Errors series tags¶ 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
Errors series fields¶ fields
description
request_id
request id
Licensing series.
Triggered if liveness balance is over. Each point contains license check data.
Licensing series tags¶ tag name
description
service
always “luna-remote-sdk”
license_status
license status (“warning”, “error”)
Licensing series fields¶ 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.
Usages_statistic series tags¶ tag name
description
service
always “luna-remote-sdk”
Usages_statistic series fields¶ 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_occlusion_estimator_usages
face occlusion 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.
SDK monitoring series. Triggered on every request involving some SDK estimations. Each point contains data on estimations performed.
Sdkloop_task series tags¶ tag name
description
service
always “luna-remote-sdk”
image_count
number of images in request
Sdkloop_task series fields¶ fields
description
execution_time
task execution time in seconds
Image_load series.
SDK monitoring series. Triggered on every request involving some SDK estimations. Each point contains data on estimations performed.
Image_load series tags¶ 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
Image_load series fields¶ 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.
Aggregated_basic_attributes series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Aggregated_basic_attributes series fields¶ 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.
Aggregated_body_descriptor series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
Aggregated_body_descriptor series fields¶ 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.
Aggregated_face_descriptor series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
Aggregated_face_descriptor series fields¶ fields
description
execution_time
estimation time in seconds
Basic_attributes series.
SDK monitoring series. Triggered on every request involving basic attributes estimations. Each point contains data on estimations performed.
Basic_attributes series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Basic_attributes series fields¶ fields
description
execution_time
estimation time in seconds
Body_attributes series.
SDK monitoring series. Triggered on every request involving body attributes estimations. Each point contains data on estimations performed.
Body_attributes series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Body_attributes series fields¶ fields
description
execution_time
estimation time in seconds
Body_descriptor series.
SDK monitoring series. Triggered on every request involving body descriptor estimations. Each point contains data on estimations performed.
Body_descriptor series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
Body_descriptor series fields¶ 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.
Body_detection series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Body_detection series fields¶ 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.
Body_redetection series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Body_redetection series fields¶ 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.
SDK monitoring series. Triggered on every request involving body warp estimations. Each point contains data on estimations performed.
Body_warp series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Body_warp series fields¶ fields
description
execution_time
estimation time in seconds
Deepfake series.
SDK monitoring series. Triggered on every request involving deepfake estimations. Each point contains data on estimations performed.
Deepfake series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
mode
mode
Deepfake series fields¶ fields
description
execution_time
estimation time in seconds
Dynamic_range series.
SDK monitoring series. Triggered on every request involving dynamic range estimations. Each point contains data on estimations performed.
Dynamic_range series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Dynamic_range series fields¶ fields
description
execution_time
estimation time in seconds
Emotions series.
SDK monitoring series. Triggered on every request involving emotions estimations. Each point contains data on estimations performed.
Emotions series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Emotions series fields¶ fields
description
execution_time
estimation time in seconds
Eyebrow_expression series.
SDK monitoring series. Triggered on every request involving eyebrow expression estimations. Each point contains data on estimations performed.
Eyebrow_expression series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Eyebrow_expression series fields¶ fields
description
execution_time
estimation time in seconds
Eyes series.
SDK monitoring series. Triggered on every request involving eyes estimations. Each point contains data on estimations performed.
Eyes series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Eyes series fields¶ fields
description
execution_time
estimation time in seconds
Face_descriptor series.
SDK monitoring series. Triggered on every request involving face descriptor estimations. Each point contains data on estimations performed.
Face_descriptor series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
descriptor_version
descriptor version
Face_descriptor series fields¶ 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.
Face_detection series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_detection series fields¶ 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.
Face_detection_background series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_detection_background series fields¶ fields
description
execution_time
estimation time in seconds
Face_natural_light series.
SDK monitoring series. Triggered on every request involving face natural light estimations. Each point contains data on estimations performed.
Face_natural_light series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_natural_light series fields¶ fields
description
execution_time
estimation time in seconds
Face_redetection series.
SDK monitoring series. Triggered on every request involving face redetection estimations. Each point contains data on estimations performed.
Face_redetection series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_redetection series fields¶ 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.
SDK monitoring series. Triggered on every request involving face warp estimations. Each point contains data on estimations performed.
Face_warp series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_warp series fields¶ fields
description
execution_time
estimation time in seconds
Face_warp_quality series.
SDK monitoring series. Triggered on every request involving face warp quality estimations. Each point contains data on estimations performed.
Face_warp_quality series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Face_warp_quality series fields¶ fields
description
execution_time
estimation time in seconds
Fisheye series.
SDK monitoring series. Triggered on every request involving fisheye estimations. Each point contains data on estimations performed.
Fisheye series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Fisheye series fields¶ fields
description
execution_time
estimation time in seconds
Gaze_direction series.
SDK monitoring series. Triggered on every request involving gaze direction estimations. Each point contains data on estimations performed.
Gaze_direction series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Gaze_direction series fields¶ fields
description
execution_time
estimation time in seconds
Glasses series.
SDK monitoring series. Triggered on every request involving glasses estimations. Each point contains data on estimations performed.
Glasses series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Glasses series fields¶ fields
description
execution_time
estimation time in seconds
Head_pose series.
SDK monitoring series. Triggered on every request involving head pose estimations. Each point contains data on estimations performed.
Head_pose series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Head_pose series fields¶ fields
description
execution_time
estimation time in seconds
Headwear series.
SDK monitoring series. Triggered on every request involving headwear estimations. Each point contains data on estimations performed.
Headwear series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Headwear series fields¶ fields
description
execution_time
estimation time in seconds
Human_detection series.
SDK monitoring series. Triggered on every request involving human detection estimations. Each point contains data on estimations performed.
Human_detection series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Human_detection series fields¶ 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
Image_orientation series.
SDK monitoring series. Triggered on every request involving image orientation estimations. Each point contains data on estimations performed.
Image_orientation series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Image_orientation series fields¶ fields
description
execution_time
estimation time in seconds
Image_color_type series.
SDK monitoring series. Triggered on every request involving image color type estimations. Each point contains data on estimations performed.
Image_color_type series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Image_color_type series fields¶ fields
description
execution_time
estimation time in seconds
Landmarks5 series.
SDK monitoring series. Triggered on every request involving landmarks5 estimations. Each point contains data on estimations performed.
Landmarks5 series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Landmarks5 series fields¶ fields
description
execution_time
estimation time in seconds
Landmarks68 series.
SDK monitoring series. Triggered on every request involving landmarks68 estimations. Each point contains data on estimations performed.
Landmarks68 series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Landmarks68 series fields¶ fields
description
execution_time
estimation time in seconds
LivenessV1 series.
SDK monitoring series. Triggered on every request involving livenessv1 estimations. Each point contains data on estimations performed.
LivenessV1 series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
LivenessV1 series fields¶ fields
description
execution_time
estimation time in seconds
Mask series.
SDK monitoring series. Triggered on every request involving mask estimations. Each point contains data on estimations performed.
Mask series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Mask series fields¶ fields
description
execution_time
estimation time in seconds
Mouth_state series.
SDK monitoring series. Triggered on every request involving mouth state estimations. Each point contains data on estimations performed.
Mouth_state series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Mouth_state series fields¶ fields
description
execution_time
estimation time in seconds
People_count series.
SDK monitoring series. Triggered on every request involving people count estimations. Each point contains data on estimations performed.
People_count series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
People_count series fields¶ fields
description
execution_time
estimation time in seconds
Portrait_style series.
SDK monitoring series. Triggered on every request involving portrait style estimations. Each point contains data on estimations performed.
Portrait_style series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Portrait_style series fields¶ fields
description
execution_time
estimation time in seconds
Red_eyes series.
SDK monitoring series. Triggered on every request involving red eyes estimations. Each point contains data on estimations performed.
Red_eyes series tags¶ tag name
description
service
always “luna-remote-sdk”
batch_size
batch size for estimations
Red_eyes series fields¶ fields
description
execution_time
estimation time in seconds
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.