clowder

Client for the Clowder monitoring server


Keywords
clowder
License
Other
Install
pip install clowder==0.1.4

Documentation

Clowder Python Client

This is the python repository for the Clowder python client.

How to install

sudo pip install clowder

How to test

Basic example for tracking memory usage on server Create a python file memory_usage.py

import clowder
import psutil

clowder.api_key = '29rTtCyrBfZvABBMMbne'

clowder.ok({
   'name': 'Memory Utilization',
   'value': psutil.phymem_usage().percent
})

How to use

Run the file and make sure it works

python memory_usage.py

Then create a cron job to run every 5 minutes

*/5 * * * * python memory_usage.py

Parameters

Passed as python dictionary

  • name: (string - REQUIRED) A unique name for the check. All checks with this name will be combined.
  • url: (string - optional) The url to send data to. Defaults to www.clowder.io
  • value: (float - optional) The value of the check (such as response time, queue length, rows processed, etc.)
  • status: (integer - optional) Whether our not the check is passing (1, 0, -1). If failing, an alert is send.
  • frequency: (integer - optional) Duration in minutes until next check. If time passes without check, alert sounds.
  • alert: (function - optional) A lamdba function that passes or fails based on value