UNICORN Monitoring API Service

Description

With binance_websocket_api_manager.start_monitoring_api() you can start a restful API service (example_monitoring.py) on http://127.0.0.1:64201/status/icinga/ to report the status of the UNICORN Binance WebSocket API Manager to a monitoring system inclusive performance metrics. The check_command has the opportunity to send its version to the monitoring API via http://127.0.0.1:64201/status/icinga/0.0.1 to provide update infos.

The ICINGA/Nagios check_command 'check_unicorn_monitoring_api.py' for the UNICORN Monitoring API can connect to this restful API service, collect the data and deliver it to the ICINGA/Nagios system.

Read the Howto: Monitoring UNICORN Binance WebSocket API Manager with ICINGA2 to learn, how you can connect your application with ICINGA2.

Technical

Status

OK, WARNING, CRITICAL or UNKOWN

• WARNING:
  • restarts_last_hour_of_stream_x >= 3
  • available updates
    • UNICORN Binance WebSocket API
    • UnicornFy
    • check_unicorn_monitoring_api.py'
• CRITICAL:
  • restarts_last_hour_of_stream_x >= 10
  • crashed streams
• UNKOWN: the check_command is not able to connect to the monitoring API services

Perfdata

• average receives per second since last status check
• average speed per second since last status check
• total received bytes since start
• total received length since start
• stream_buffer length
• stream_buffer items
• reconnects
• uptime

Parameter

Use binance_websocket_api_manager.start_monitoring_api(warn_on_update=False) to disable the WARNING status on available updates.