Skip to content

A Puppet module to provide PRTG HTTP push sensors

Notifications You must be signed in to change notification settings

puppetlabs/prtg_push

Repository files navigation

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.

About

A Puppet module to provide PRTG HTTP push sensors

Topics

Resources

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published