isabella232 / prtg_push

A Puppet module to provide PRTG HTTP push sensors

PRTG Push

Table of Contents

1. Description
2. Setup
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.

Description

PRTG Network Monitor is IT monitoring software for Windows that can monitor many metrics on servers and networking devices. It provides a flexible HTTP push sensor that allows administrators to monitor more metrics than PRTG provides out of the box. The PRTG Push Puppet module provides several defined Puppet resources for HTTP push sensors to run as cron jobs on *nix systems.

See Paessler's documentation on HTTP push sensors.

Setup

Setup with prtg_push is minimal; install the module as you would any other module, include prtg_push in your Puppet code and use the defined types provided (see #usage).

Note: prtg_push manages PRTG HTTP push sensors with cron. As a result, we strongly recommend that you purge unmanaged cron jobs with Puppet. If you don't purge unmanaged cron jobs, older push sensors will persist even after removing Puppet code.

You can purge unmanaged cron jobs by including something like the following in your Puppet code:

resources { 'cron':
  purge => true,
}

Usage

You can run an arbitrary command with the command_check defined type:

prtg_push::command_check { 'Logged in users check':
  command  => 'who | awk '{print $1}' | uniq | wc -l',
  hostname => 'prtg.example.com',
  port     => '5050',
  token    => 'my-prtg-token',
}

The newest_file defined type allows you to monitor the age of a given file:

prtg_push::newest_file { 'My backup':
  file_ext  => '.tar.gz',
  check_dir => '/opt/backups/,
  hostname  => 'prtg.example.com',
  port      => '5050',
  token     => 'my-prtg-token',
}

If you want to monitor whether a given service is running, you can use the service_check defined type:

prtg_push::service_check { 'sshd':
  hostname  => 'prtg.example.com',
  port      => '5050',
  token     => 'my-prtg-token',
}

Limitations

This module has only been tested on Ubuntu 16.04 machines.