opsview

UNKNOWN

Project URL RSS Feed Report issues

Module Stats

10,368 downloads

9,794 latest version

3.8 quality score

Version information

released May 5th 2014

Start using this module

Installation method

Add this module to your Puppetfile:

mod 'devon-opsview', '0.5.0'

Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add devon-opsview

Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install devon-opsview --version 0.5.0

Tags: opsview

Documentation

devon/opsview — version 0.5.0 May 5th 2014

Stable release download

If you're looking for stable releases, you can download this module at the Puppet Forge.

Introduction

Right now, the module only contains libraries to handle all of the REST requests to a given Opsview server. You will need to create /etc/puppet/opsview.conf with the following format on each client that you wish to connect with an Opsview server:

url: http://example.com/rest
username: foobar
password: foobaz

Please file bugs via the issue tracker above.

Prerequisites

Puppet (of course :)) Tested most recently with puppet 2.7.9
rest-client, json gems.

Puppet Types in this Module

opsview_attribute
opsview_contact
opsview_hostgroup
opsview_hosttemplate
opsview_keyword
opsview_monitored
opsview_notificationmethod
opsview_role
opsview_servicecheck
opsview_servicegroup

List of things to do

Separate out a few get/set methods from Puppet::Provider::Opsview - put them in a utility module instead.
Clean up Puppet::Provider::Opsview in general. Cull any class/instance methods we don't need (there's lots of duplication.)
Add default providers so that Puppet runs don't fail when there's no rest-client / json gems to use.

Contributors

Devon Peters <devon.peters@gmail.com>
Christian Paredes <christian.paredes@sbri.org>
Duncan Ferguson <duncs>
Amos Shapira <amosshapira>
John Kinsella <jlk>
Andreas Ntaflos <antaflos>

Types in this module release

opsview_servicecheck

Manages servicechecks in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the servicecheck is updated

Properties
dependencies	Array of dependencies for this servicecheck
description	Short description for the servicecheck
keywords	Array of keywords for this servicecheck
servicegroup	The servicegroup that this servicecheck belongs to. This servicegroup must be defined in puppet.

Providers
opsview

opsview_notificationmethod

Manages notificationmethods in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the notificationmethod is updated

Properties
active	Whether or not this is Active
command	The command to run when this method is used
contact_variables	Comman delimited string of variables that are used by this notification method
master	Whether or not this is enabled on the master

Providers
opsview

opsview_role

Manages roles in an Opsview monitoring system.

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the role is updated.

Properties
access_hostgroups	Array of hostgroups that this role can access.
access_keywords	Array of keywords that this role can access.
access_servicegroups	Array of servicegroups that this role can access.
accesses	Array of access properties defined for this role.
all_hostgroups	Whether or not this role has access to all hostgroups. Defaults to true.
all_keywords	Whether or not this role has access to all keywords. Defaults to false.
all_servicegroups	Whether or not this role has access to all servicegroups. Defaults to true.
description	Short description of this role.
hostgroups	Array of hostgroups that this role can configure, if CONFIGUREHOSTS is defined in accesses.
role	The name of this role.

Providers
opsview

opsview_servicegroup

Manages servicegroups in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the servicegroup is updated

Properties
servicegroup	This servicegroup

Providers
opsview

opsview_hosttemplate

Manages hosttemplates in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the hosttemplate is updated

Properties
description	description for this hosttemplate
hosttemplate	This hosttemplate
managementurls	Array of management urls for this hosttemplate
servicechecks	Array of servicechecks for this hosttemplate.

Providers
opsview

opsview_attribute

Manages attributes in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the attribute is updated

Properties
arg1	Optional argument 1 value.
arg2	Optional argument 2 value.
arg3	Optional argument 3 value.
arg4	Optional argument 4 value.
attribute	The name of the attribute to manage
value	Optional default attribute value.

Providers
opsview

opsview_monitored

Monitors the node from an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the host is updated

Properties
check_command	Host check command
enable_snmp	Whether or not SNMP is enabled for the host
hostattributes	Array of host attribute key pairs for this node
hostgroup	Opsview hostgroup
hosttemplates	Array of Opsview host templates that should be applied to this node
icon_name	Icon to set for the device
ip	Node IP address or name
keywords	Array of Opsview keywords should be applied to this node
monitored_by	The Opsview server that monitors this node
notification_interval	Host notification interval
parents	Array of parents for this node
servicechecks	Array of Opsview service checks that should be applied to this node
snmp_community	SNMP community string for SNMP protocol 1 and 2c
snmp_extended_throughput_data	Whether or not to gather extended data from interfaces (the unicast, multicasdt, broadcast stats)
snmp_max_msg_size	SNMP message size (default, 1Kio, 2Kio, 4Kio, 8Kio, 16Kio, 42Kio, 64Kio)
snmp_port	SNMP port
snmp_version	SNMP protocol version
snmpv3_authpassword	SNMP v3 Auth Password (should be 8 chars)
snmpv3_authprotocol	SNMP v3 Auth Protocol (md5 or sha)
snmpv3_privpassword	SNMP v3 Priv Password (should be 8 chars)
snmpv3_privprotocol	SNMP v3 Priv Protocol (des, aes or aes128)
snmpv3_username	SNMP v3 username
tidy_ifdescr_level	Set level of removing common words from ifDescr strings

Providers
opsview

opsview_contact

Manages contacts in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the contact is updated

Properties
allhostgroups24x7	A boolean defining whether or not all hostgroups will have 24x7 notifications for this contact.
allhostgroups8x5	A boolean defining whether or not all hostgroups will have 8x5 notifications for this contact.
allservicegroups24x7	A boolean defining whether or not all servicegroups will have 24x7 notifications for this contact.
allservicegroups8x5	A boolean defining whether or not all servicegroups will have 8x5 notifications for this contact.
description	Short description for the contact
encrypted_password	The user's encrypted password. Defaults to "password" if not specified.
fullname	Full name of the user
host_notification_options24x7	The host notification options for the 24x7 notification profile.
host_notification_options8x5	The host notification options for the 8x5 notification profile.
hostgroups24x7	An array of hostgroups for the 24x7 notification profile.
hostgroups8x5	An array of hostgroups for the 8x5 notification profile.
language	The user's language
notificationmethods24x7	An array of notificationmethods for the 24x7 notification profile.
notificationmethods8x5	An array of notificationmethods for the 8x5 notification profile.
role	The role that the user is in. Defaults are: Administrator View all, change none View all, change some View some, change none View some, change some
service_notification_options24x7	The service notification options for the 24x7 notification profile.
service_notification_options8x5	The service notification options for the 8x5 notification profile.
servicegroups24x7	An array of servicegroups for the 24x7 notification profile.
servicegroups8x5	An array of servicegroups for the 8x5 notification profile.
variables	A hash containing the contact notification variables and their values. Example: ... variables => { 'EMAIL' => 'someone@example.com', 'PAGER' => '555-1234' }, ...

Providers
opsview

opsview_hostgroup

Manages hostgroups in an Opsview monitoring system

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the hostgroup is updated

Properties
hostgroup	The name of the hostgroup to manage
parent	Parent hostgroup. Any defined parent's will be autorequired.

Providers
opsview

opsview_keyword

Manages keywords in an Opsview monitoring system.

Parameters
ensure
name
provider
reload_opsview	True if you want an Opsview reload to be performed when the keyword is updated.

Properties
all_hosts	Whether or not this keyword is applied to all hosts. Defaults to false.
all_servicechecks	Whether or not this keyword is applied to all servicechecks. Defaults to false.
description	Short description of this keyword.
hosts	Array of hosts to apply this keyword to
keyword	The name of this keyword.
roles	Array of roles which can view this keyword
servicechecks	Array of servicechecks to apply this keyword to
style	The viewport display style to use for this keyword. Available styles: `* errors_and_host_cells * group_by_host * group_by_service * host_summary * performance`
viewport	Whether or not the viewport for this keyword is enabled.

Providers
opsview

Modules

Discover

Contribute

Resources

About Forge

Getting Started