This version is compatible with:
- Puppet Enterprise 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
- Puppet >= 4.7.0 < 6.0.0
Start using this module
This module is designed to install sysstat on EL and Debian Linux systems to facilitate gathering troubleshooting data for Puppet Support cases.
- Setup - The basics of getting started with support_sysstat
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
This module is designed to make it easier to capture relevant information on resource usage of Linux nodes, specifically in cases where this information will assist in troubleshooting tickets raised with Puppet Support.
This module will install sysstat on any required node if it is not already present, and configure it to summarise all captured data daily. It also includes a number of tasks to make it simpler to see the captured metrics within the Console.
This module requires the
puppetlabs-stdlib module as a pre-requisite.
To start with the
support_sysstat module, simply include the
support_sysstat class in your
site.pp or use the Console to classify a node group with the
support_sysstat class in a node's classification will ensure that sysstat is installed, and for Debian based nodes it will also enable
sa2 processing of the binary data collected by
sa1, which is not enabled by default on Debian and derivatives such as Ubuntu.
sa2 binary is called with the
-A flag, which means that by default all the counters and datapoints will be returned. There is little overhead in doing this which is why it's not been changed from the default.
This module also includes 3 Tasks:
- A task to return all captured metrics for the current day with an optional
endparameter to enable time bounds. These parameters must be entered in
- A task that allows only specific metrics to be returned. The required metrics can simply be selected by changing a required parameter to
true. The available metrics are
block(block device metrics),
swap(swap metrics) and
tables(file and inode table metrics). There are also the same optional time bound as for the previous task.
- A task that returns all or selected metrics for any given day for which there is a
saXXfile in the save directory. The day of the month must be provided in a 2 digit
DDformatted string and there is the same optional time bound available within that day as for the previous two tasks.
There are 2 classes provided by this module:
support_sysstat - Wrapper class to install and manage sysstat on Linux nodes.
support_sysstat::install - Installs sysstat and ensures that the cron jobs are enabled.
There are also 3 tasks provided by this module:
support_sysstat::snapshot - Task to display all captured metrics for the current day in the Console.
support_sysstat::filtered_snapshot - Task to display only selected metrics for the current day in the Console.
support_sysstat::freeform_parse - Task to return metrics from any previous day stored in the save directory in the Console.
This module is designed to work on EL and Debian based Linux distributions. Other Linux distributions may work but are not guaranteed to. In order to use this module on other Linux distros, you will need to fork the module and edit the
support_sysstat class in
init.pp to add further OS families to the conditional statement.
0.1.0 - Initial release.\ 0.2.0 - README Style and metadata.json updates.\ 0.3.0 - Update README.\ 0.4.0 - Added Tasks.
What are tasks?
Modules can contain tasks that take action outside of a desired state managed by Puppet. It’s perfect for troubleshooting or deploying one-off changes, distributing scripts to run across your infrastructure, or automating changes that need to happen in a particular order as part of an application deployment.
Tasks in this module release
- puppetlabs/stdlib (>= 4.0.0 < 5.0.0)