Skip to main content

client-side okerr module and utilities

Project description

okerrupdate - client-side okerr module and utilities

Installation

sudo pip3 install okerrupdate
sudo okerrmod --init # enable few basic modules, create /etc/cron.d/ job, create okerrupdate config template
sudo vim /etc/okerr/okerrupdate

and modify okerrupdate file:

# Stub for okerrmod            
PREFIX=braconnier:
OKERR_TEXTID=
OKERR_SECRET=
OKERR_URL=
OKERR_DIRECT=0

OKERR_MOD_AVAIL=

or provide values to okerrmod --init as option values (e.g. okerrmod --init --textid MyTextid).

Basic usage

okerrupdate utility

okerrupdate is small script which updates/creates indicators in okerr project.

This will create simplest indicator 'myindicator' with all default settings (type 'heartbeat', policy 'Default'). Indicator will send alert if it will be updated to 'ERR' or if will not be updated for some time (Default policy period+patience).

$ okerrupdate myindicator OK
okerr updated (200 OK) myindicator@okerr = OK

This will create numerical indicator 'temp' with current value 36.6, and policy 'Daily'. Will send alert if not updated for a day or if value will be over maxlim (37).

$ okerrupdate -p Daily -m 'numerical|maxlim=37' temp 36.6
okerr updated (200 OK) temp@okerr = 36.6

Project TextID and secret is read from /etc/okerr/okerrupdate file or OKERR_TEXTID and OKERR_SECRET environment variables.

okerrmod utility

okerrmod is script to perform different local checks (such as free disk space, mysql running, load average, etc.). After initial okerrmod --init, few basic check modules are enabled.

List all available check modules (+ - module enabled, - - module disabled ):

$ okerrmod --list
+ backups 0.1 Check freshness for backup files
+ df 0.1 Free disk space
...

To run enabled checks just run okerrmod without any other commands:

xenon@braconnier:~$ sudo okerrmod 
okerr updated (200 OK) braconnier:maxfilesz@okerr = 9077814
okerr updated (200 OK) braconnier:apache@okerr = 0
okerr updated (200 OK) braconnier:nonempty@okerr = 0
okerr updated (200 OK) braconnier:empty@okerr = 0
...

To run just one check:

$ sudo okerrmod --run ok
okerr updated (200 OK) braconnier:ok@okerr = OK

To enable new check:

$ sudo okerrmod --enable runstatus
2020/01/17 16:12:30 enable /usr/local/lib/python3.7/dist-packages/okerrupdate/mods-available/runstatus
2020/01/17 16:12:30 make default config file: /etc/okerr/mods-env/runstatus

After this, you may want to edit default configuration for this check

sudo vim /etc/okerr/mods-env/runstatus

After this, okerrmod will run this check.

To create your own very basic check 'my' create dir /etc/okerr/mods-available/my and edit /etc/okerr/mods-available/my/check:

#!/usr/bin/python3
print("STATUS: OK")

or if you prefer shell (check is any executable file):

#!/bin/sh
echo STATUS: OK

Now you can run it manually okerrmod --run my, enable okerrmod --enable my, make/edit config file for it /etc/okerr/mods-env/my.

Using okerrupdate python library

Simplest case:

#!/usr/bin/python
import okerrupdate

op = okerrupdate.OkerrProject('MyTextID', secret='MySecret')
i = op.indicator('temp', method='numerical|maxlim=37', policy='Daily')
i.update('36.6')

Documentation

More info in okerrupdate documentation.

Other okerr resources

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

okerrupdate-1.2.64-py3-none-any.whl (36.9 kB view details)

Uploaded Python 3

File details

Details for the file okerrupdate-1.2.64-py3-none-any.whl.

File metadata

  • Download URL: okerrupdate-1.2.64-py3-none-any.whl
  • Upload date:
  • Size: 36.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/40.8.0 requests-toolbelt/0.9.1 tqdm/4.54.0 CPython/3.7.3

File hashes

Hashes for okerrupdate-1.2.64-py3-none-any.whl
Algorithm Hash digest
SHA256 d5daa6a9c5764e54a24cbd36c0751eb134acfb98821c91ea506ca263b3274c8f
MD5 fbdcd36da559f85c2ad43355d0dc2730
BLAKE2b-256 ad4ac28621523319a40c332f41864a3b2617986a6f9d9e7b0a368aaffb4e18bd

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page