[![Build Status][travis-img-master]][travis-ci] [![Puppet Forge][pf-img]][pf-link] [![GitHub tag][gh-tag-img]][gh-link]

Zabbix Agent Puppet Module

Table of Contents

1. Overview
2. Setup requirements
3. Parameters
4. Usage
5. Contributing
6. Contributors
7. License

Overview

This module manages the zabbix agent for a monitored machine. It can also, optionally, manage repositories related to Zabbix on Linux. On the Red Hat family of OS's, this includes both EPEL and Zabbix. On the Debian family, this is just the Zabbix repo. On SUSE this is the "Server Monitoring Software" repo. On Windows this module utilizes the [Chocolatey][chocolatey] provider.

Setup Requirements

This module has been tested against Puppet 4.x on:

• CentOS 6 & 7
• Debian 7 & 8
• OpenSUSE Leap 42.1 & 42.2
• Red Hat 5, 6, 7
• SUSE Linux Enterprise Server 12
• Ubuntu Server 14.04 16.04
• Windows 7
• Windows Server 2012 R2

Testing via Travis-CI is also done against Puppet 3.x with, and without, future parser.

Parameters:

Depreciated options

These options were removed in v2.1.0. If they exist in your manifests or hiera data they will cause a compilation failure.

$include_dir
$include_file
$logfile
$servers
$servers_active

Preinstall

manage_repo_epel
Determines if the EPEL repo is managed on the RedHat family of OS's.
Default: false
Type: boolean

manage_repo_zabbix
Determines if the Zabbix repo is managed on the RedHat family of OS's.
Default: false
Type: boolean

Install

custom_require_linux
Passed directly to require of package resource when on Linux
Default: undef

custom_require_windows
Passed directly to require of package resource when on Windows
Default: undef

ensure_setting
Passed directly to ensure of package resource
Default: 'present'

Config

allow_root
0 - do not allow, 1 - allow
Type: integer

buffer_send
Range: 1-3600
Type: integer

buffer_size
Range: 2-65535
Type: integer

config_dir
Defines the directory in which config files live
Default on Linux: '/etc/zabbix'
Default on Windows: 'C:/ProgramData/zabbix'

debug_level
Range: 0-4
Type: integer

enable_remote_commands
0 - not allowed, 1 - allowed
Type: integer

host_metadata
Range: 0-255 characters
Type: string

host_metadata_item
Parameter that defines an item used for getting host metadata used during host auto-registration process.
To disable, set to ''.
Default: 'system.uname'

hostname
The hostname used in the config file.
Default: downcase($::fqdn)

hostname_item
An item to be used for determining a host's name

include_files
Equates to include in zabbix_agentd.conf. Renamed due to include being special in Puppet. An array with one or more files to be included in the config. On non-Windows systems, this can be a folder or a path with a wildcard. See zabbix_agentd.conf for details.
Type: array

item_alias
Equates to alias in zabbix_agentd.conf. Renamed due to alias being the name of a Puppet metaparameter. Sets an alias for an item key.
Type: array

listen_ip
List of comma delimited IP addresses that the agent should listen on.
Type: string

listen_port
Range: 1024-32767
Default: 10050
Type: integer

load_module
Type: string

load_module_path
Type: string

log_file_size
Range: 0-1024
Type: integer

log_file
The full path to where Zabbix should store it's logs.
Default on Windows: 'C:\zabbix_agentd.log'
Default on Linux: '/var/log/zabbix/zabbix_agentd.log'
Type: string

log_type
Log output type.
Type: string

log_remote_commands
0 - disabled, 1 - enabled
Type: integer

max_lines_per_second
Range: 1-1000
Type: integer

package_name
Name of the Zabbix Agent package.
The default values for this can be found in params.pp as it is OS dependent.
Type: string

perf_counter
Each item should be formmated as follows: