Come join our live training webinar every other Wednesday at 11am PST and hear LogicMonitor experts explain best practices and answer common questions. We understand these are uncertain times, and we are here to help!
Puppet is IT automation software that enables system administrators to manage provisioning and configuration of their infrastructure. We know that in addition to maintaining correct infrastructure configuration, system administrators additionally rely on monitoring to help prevent outages. Our Puppet module was created with this in mind, and allows your Puppet infrastructure code to manage your LogicMonitor account as well. This enables you to confirm that correct device properties are maintained, that devices are monitored by the correct Collector, that they remain in the right device groups and much more.
Notes:
LogicMonitor’s Puppet module defines 5 classes and 4 custom resource types:
In order to use LogicMonitor’s Puppet Module, you’ll need to make sure you have the following:
Store configs are required for the exported resources used by this module. To enable store configs, add storeconfigs = true to the [master] section of your puppet.conf file, like so:
# /etc/puppet/puppet.conf [master] storeconfigs = true
Once enabled, PuppetDB is needed to store the config info.
5. Device Configuration
As with your other LogicMonitor devices, the collector will need to communicate with the device in order to gather data. Make sure the correct properties and authentication protocols are configured as part of the Puppet installation.
You can install LogicMonitor’s Puppet Module one of two ways:
Run the following command on your Puppet Master to download and install the most recent version of the LogicMonitor Puppet Module published on Puppet Forge:
$ puppet module install logicmonitor-logicmonitor
$ cd /etc/puppet/modules $ git clone git: //github.com/logicmonitor/logicmonitor-puppet-v4.git $ mv logicmonitor-puppet-v4 logicmonitor
Once you’ve installed LogicMonitor’s Puppet Module, you can get started using the following sections:
We recommend you create a new user with administrator privileges in your Logic Monitor account that you will use exclusively within your Puppet nodes to track changes made by Puppet in the audit log. You will need to provision this user API Tokens.
This is the top level class for the LogicMonitor module; it only needs to be defined on the Puppet Master. It’s purpose is to set the LogicMonitor credentials to be used by all the child classes.
The master class enables communication between the LogicMonitor module and your LogicMonitor account for group and device management. This class acts as the collector for the lm_device and lm_devicegroup exported resources. This prevents conflicts and provides a single point of contact for communicating with the LogicMonitor API. This class must be explicitly declared on a single device. NOTE: All devices with the logicmonitor::collector and logicmonitor::master classes will need to be able to make outgoing https requests.
Parameters: none
This class manages the creation, download and installation of a LogicMonitor collector on the specified node.
This class is used to add devices to your LogicMonitor account. Devices which are managed through Puppet will have any properties not specified in the device definition removed.
class {'logicmonitor::device': collector => "qa1.domain.com", hostname => "10.171.117.9", groups => ["/Puppetlabs", "/Puppetlabs/Puppetdb"], properties => {"snmp.community" => "Puppetlabs"}, description => "This device hosts the PuppetDB instance for this deployment", } class {'logicmonitor::device': collector => $fqdn, display_name => "MySQL Production Host 1", groups => ["/Puppet", "/production", "/mysql"], properties => {"mysql.port" => 1234}, }
Adding a Device Group:
Type: lm_device_group Device groups should be added using an exported resource to prevent conflicts. It is recommend device groups are added from the same node where the logicmonitor::master class is included. Devices can be included in zero, one, or many device groups. Device groups are used to organize how your LogicMonitor Devices are displayed and managed and do not require a collector . Properties set at the device group level will be inherited by any devices added to the group.
To add collector to a node:
include logicmonitor::collector
If you want to specify a specific location where you’d like to install a collector:
class{"logicmonitor::collector": install_dir => $install_dir, }
To add and edit properties of device groups use lm_devicegroup, example below.
@@lm_device_group{"/parent/child/grandchild/greatgrandchild": ensure => present, disable_alerting => false, properties => {"snmp.community" => "n3wc0mm", "mysql.port" => 9999,"fake.pass" => "12345"}, description => "This is the description", }
For more examples of the module in action, check out logicmonitor-puppet-v4/README.md.
In This Article
