Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

Pluggable Info Monitor for visibility and transparency

Project description

Pluggable Info Monitor is a web application to display information provided by plugins on a web page.

PIM for the Visibility and Transparency

Quick Start

1. Install requirements

pip install flask
pip install waitress
  1. Copy the source to a folder of your choice
  2. Check working:
    a. cd <path_to_info_monitor.py> a. python info_monitor b. in a browser window navigate to 127.0.0.1:8080 address c. the example plugins give some info - It works ;-)
  3. You can write your plugins using the examples

Usage

The index page will show the list of available plugins as links. These links can be used if PIM used interactively. The info pages will be changed (the next is showed) in every minute (can be changed in PIM_config.py). If used interactively, the info refreshes on keypress too.

To be useful for you, you have to write your own info providers according to examples.

The check_info_provider_interface.py checks the most important things of your plugins. (Can be started from the folder it resides)

Next version will be better. ;-)

Configuration

Serving IP address, port, refresh time interval can be set in PIM_config.py file

Compatibility

PIM needs at least Python 3.1

Features and versions:

ToDo / Planned features

  • COnfigurable font size
  • Configurable plugin folder outside of the program
  • Start plugin checking from web and get results as well
  • Package creation fro easier installation; using in virtualemv it can be installed with user privileges

Screenshot

Screenshot.jpg

One module gives four information with different severity levels

TL;DR

History

During development, specially in agile methodologies there is need to monitor the status of the development. So teams used to check the build status, test results, number of bugs etc. (Like Jenkins’s build monitor plugin (aka radiator)) So the idea came from this: Jenkins build monitor can show only the status of the jobs. And I wanted a tool that shows / monitors other things as well. (This is my first Python web application ;-) )

How PIM works

  1. PIM webpage is loaded in a browser (if not called, PIM does nothing)
  2. Index page is displayed. Clicking on a provider will display the info provided by the given provider. If no provider is clicked, the first will be selected automatically.
  3. gets the info from the provider
  4. creates a web page with the info it gathered. There are two parameters now which can modify the way the info is dispalyed. Severity (gives background color) and display splitting (full screen, half, quarter)
  5. PIM goes through the providers (ordered alphabetically by their name) and after the last one it starts the cycle from the first one.

Where the displayed info comes from?

You write the info provider plugins. The plugins must be put into info_providers folder. The providers must provide the info in the following structure

one_info = {
    'display_part': DisplayParts.FULL_SCREEN,
    'info_severity': InfoSeverity.INFO,
    'info': {
        'key_1': 42,
        'key_2': 'spam',
        'key_3': 'eggs',
    },
}

info_to_display = list()
info_to_display.append(one_info)

Installation

Requirements

PIM has is no any install procedure right now. You can get PIM from the source.

Release history Release notifications

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page