voxpupuli / puppet-graphite_powershell

Graphite PowerShell module for Puppet

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with graphite_powershell
   • What graphite_powershell affects
   • Beginning with graphite_powershell
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Limitations - OS compatibility, etc.
7. Development - Guide for contributing to the module

Overview

Module to send metrics to graphite from windows

Module Description

Installs a windows service that reports system metrics to graphite

Setup

What graphite_powershell affects

• Powershell file and xml config file
• windows service

Beginning with graphite_powershell

Install with defaults:

  class { 'graphite_powershell':
    server => 'graphite.mycorp.com'
  }

Install and just send network counters:

  class { 'graphite_powershell':
    server               => 'graphite.mycorp.com',
    performance_counters => [
      '\Network Interface(*)\Bytes Received/sec',
      '\Network Interface(*)\Bytes Sent/sec',
      '\Network Interface(*)\Packets Received Unicast/sec',
      '\Network Interface(*)\Packets Sent Unicast/sec',
      '\Network Interface(*)\Packets Received Non-Unicast/sec',
      '\Network Interface(*)\Packets Sent Non-Unicast/sec',
    ]
  }

Usage

Classes and Defined Types

Class: graphite_powershell

Parameters within graphite_powershell:

server

The graphite server in which to send the configured metrics

install_url

The url from which to download the graphite powershell script

install_dir

The location in which to install the graphite powershell script

port

The port that the graphite server is running on.

metric_path

The graphite namespece in which the stats will be sent to

metric_send_interval

The time inveral (in seconds) in which to send metrics to the graphite server

timezone

The timezone of your graphite server.

performance_counters

A list of the performance counters that you want to be sent to graphite.

metric_filters

A list of names you want to filter out of the performance counter list

verbose_logging

If enabled, will log each of the metrics that were sent to the graphite server.

Reference

Classes

Pulic Classes

• graphite_powershell: Guides the install of graphite powershell and creates the windows service

Limitations

This module is tested on the following platforms:

• Windows 2008
• Windows 2008 R2
• Windows 2012
• Windows 2012 R2

It is tested with the OSS version of Puppet only.

Contributing

Please read CONTRIBUTING.md for full details on contributing to this project.

puppet-graphite_powershell's Issues

Hard coded path to config file in config class

The configuration "file" resource has a hard coded path to "C:\GraphitePowershell", when the $install_dir parameter could specify an alternate installation directory.

Possibly change to:

file { "${install_dir}/StatsToGraphiteConfig.xml":

Thanks
L

Graphite-PowerShell.ps1 is no more

The install_url no longer works as the author of Graphite-PowerShell has changed formats for his work.

Undocumented dependency on joshcooper-powershell

The only dependancies listed are stdlib and opentable-filedownload. It will not install for me because it wants to install joshcooper-powershell and I have puppetlabs-powershell. Powershell is obviously a dependency. That should be documented. But it should also maybe work with the puppet labs version.

Error: Could not install module 'puppet-graphite_powershell' (latest)
Dependency 'joshcooper-powershell' (v0.0.6) would overwrite /puppet/modules_common/powershell
Currently, 'puppetlabs-powershell' (v1.0.6) is installed to that directory
Use puppet module install --ignore-dependencies to install only this module