Description

Installs and configures Zabbix agent and server with PostgreSQL and Nginx. Provides LWRP for creating and modifying Zabbix objects.

Requirements

Platform:

• Ubuntu

Cookbooks:

• apt
• build-essential
• lvm
• nginx
• postgresql_lwrp
• php-fpm

Attributes

Default

• node['zabbix']['version'] - Defaults to 2.4.
• node['zabbix']['api-version'] - Defaults to 2.4.4.

Agent

• node['zabbix']['agent']['include'] - Defaults to /opt/zabbix/etc.
• node['zabbix']['agent']['scripts'] - Defaults to /opt/zabbix/scripts.
• node['zabbix']['agent']['templates'] - Defaults to /opt/zabbix/templates.
• node['zabbix']['agent']['loglevel'] - Defaults to 3.
• node['zabbix']['agent']['remotecmds'] - Defaults to 0.
• node['zabbix']['agent']['timeout'] - Defaults to 3.
• node['zabbix']['agent']['listen_ip'] - Defaults to 0.0.0.0.
• node['zabbix']['agent']['enable_remote_commands'] - Defaults to 0.
• node['zabbix']['agent']['serverhost'] - Defaults to node['ipaddress'].
• node['zabbix']['agent']['user_params'] - Defaults to { ... }.

Database

• node['zabbix']['server']['database']['filesystem'] - Defaults to ext4.
• node['zabbix']['server']['database']['lvm_group'] - Defaults to shared.
• node['zabbix']['server']['database']['lvm_volume'] - Defaults to /dev/sda3.
• node['zabbix']['server']['database']['partition_size'] - Defaults to 10G.
• node['zabbix']['server']['database']['cluster'] - Defaults to main.
• node['zabbix']['server']['database']['databag'] - Defaults to zabbix.
• node['zabbix']['server']['database']['locale'] - Defaults to en_US.utf8.
• node['zabbix']['server']['database']['mount_point'] - Defaults to /var/lib/postgresql.
• node['zabbix']['server']['database']['network'] - Defaults to 127.0.0.0/8.
• node['zabbix']['server']['database']['version'] - Defaults to 9.4.
• node['zabbix']['server']['database']['configuration']['listen_addresses'] - Defaults to 127.0.0.1.
• node['zabbix']['server']['database']['configuration']['port'] - Defaults to 5432.
• node['zabbix']['server']['database']['configuration']['max_connections'] - Defaults to 300.
• node['zabbix']['server']['database']['configuration']['shared_buffers'] - Defaults to 128MB.
• node['zabbix']['server']['database']['configuration']['maintenance_work_mem'] - Defaults to 128MB.
• node['zabbix']['server']['database']['configuration']['work_mem'] - Defaults to 8MB.
• node['zabbix']['server']['database']['configuration']['effective_cache_size'] - Defaults to 2GB.
• node['zabbix']['server']['database']['configuration']['log_min_duration_statement'] - Defaults to 1000.
• node['zabbix']['server']['database']['configuration']['archive_mode'] - Defaults to on.
• node['zabbix']['server']['database']['configuration']['archive_command'] - Defaults to exit 0.

Server

• node['zabbix']['server']['service'] - Defaults to zabbix-server.
• node['zabbix']['server']['credentials']['databag'] - Defaults to zabbix.
• node['zabbix']['server']['config']['listenip'] - Defaults to 0.0.0.0.
• node['zabbix']['server']['config']['debuglevel'] - Defaults to 3.
• node['zabbix']['server']['config']['workers'] - Defaults to { ... }.
• node['zabbix']['server']['config']['hk'] - Defaults to { ... }.
• node['zabbix']['server']['config']['cache'] - Defaults to { ... }.
• node['zabbix']['server']['config']['timeouts'] - Defaults to { ... }.
• node['zabbix']['server']['config']['global'] - Defaults to { ... }.
• node['zabbix']['server']['config']['alerts'] - Defaults to { ... }.

Web

• node['zabbix']['server']['web']['server_name'] - Defaults to localhost.
• node['zabbix']['server']['web']['listen'] - Defaults to 127.0.0.1.
• node['zabbix']['server']['web']['port'] - Defaults to 9200.
• node['zabbix']['server']['web']['max_requests'] - Defaults to 500.
• node['zabbix']['server']['web']['max_children'] - Defaults to 5.
• node['zabbix']['server']['web']['min_spare_servers'] - Defaults to 1.
• node['zabbix']['server']['web']['max_spare_servers'] - Defaults to 3.
• node['zabbix']['server']['web']['process_manager'] - Defaults to dynamic.
• node['zabbix']['server']['web']['configuration']['php_admin_value[date.timezone]'] - Defaults to UTC.
• node['zabbix']['server']['web']['configuration']['php_admin_flag[display_errors]'] - Defaults to false.
• node['zabbix']['server']['web']['configuration']['php_admin_value[error_reporting]'] - Defaults to E_ALL & ~E_DEPRECATED.
• node['zabbix']['server']['web']['configuration']['php_admin_value[error_log]'] - Defaults to /var/log/zabbix-php-error.log.
• node['zabbix']['server']['web']['configuration']['php_admin_value[max_execution_time]'] - Defaults to 600.
• node['zabbix']['server']['web']['configuration']['php_admin_value[max_input_time]'] - Defaults to 300.
• node['zabbix']['server']['web']['configuration']['php_admin_value[memory_limit]'] - Defaults to 128M.
• node['zabbix']['server']['web']['configuration']['php_admin_value[post_max_size]'] - Defaults to 32M.
• node['zabbix']['server']['web']['configuration']['php_admin_flag[register_globals]'] - Defaults to true.

Recipes

• zabbix_lwrp::agent - Installs and configures Zabbix agent.
• zabbix_lwrp::connect - Connects to Zabbix API to sync configuration.
• zabbix_lwrp::default - Installs and configures Zabbix official repository and agent.
• zabbix_lwrp::database - Installs and configures Zabbix database.
• zabbix_lwrp::host - Creates host via Zabbix API.
• zabbix_lwrp::partition - Configures LVM for Zabbix database.
• zabbix_lwrp::repository - Installs Zabbix official repository.
• zabbix_lwrp::server - Installs and configures Zabbix server.
• zabbix_lwrp::web - Installs and configures Zabbix frontend.

Data bag

Data bag zabbix must contains the following items:
* admin (with Zabbix admin password)
* databases
* users

databases and users items related to the postgresql database (see postgresql_lwrp cookbook)

For examples see fixture data bag test/fixtures/databags/zabbix/

LWRP

This cookbooks provides next resources:
* zabbix_action
* zabbix_application
* zabbix_connect
* zabbix_database
* zabbix_graph
* zabbix_host
* zabbix_media_type
* zabbix_screen
* zabbix_template
* zabbix_user_group
* zabbix_user_macro

zabbix_action

Creates zabbix action with operations, conditions and messages.

Actions

<table>
<tr>
<th>Action</th>
<th>Description</th>
</tr>
<tr>
<td>sync</td>
<td>Default action. Sync action description with one's in zabbix server</td>
</tr>
</table>

Attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>name</td>
<td><strong>Name attribute</strong>. Name of the action (required)</td>
<td></td>
</tr>
<tr>
<td>event_source</td>
<td>Source of event for action, now only :trigger allowed</td>
<td>:triggers</td>
</tr>
<tr>
<td>escalation_time</td>
<td>Delay between escalation steps</td>
<td>60</td>
</tr>
<tr>
<td>enabled</td>
<td>Is action enabled?</td>
<td>true</td>
</tr>
<tr>
<td>message_subject</td>
<td>Subject of action message</td>
<td></td>
</tr>
<tr>
<td>message_body</td>
<td>Body of action message</td>
<td>true</td>
</tr>
<tr>
<td>send_recovery_message</td>
<td>Send recovery message when conditions of action become false</td>
<td>false</td>
</tr>
<tr>
<td>recovery_message_subject</td>
<td>Subject of recovery message</td>
<td></td>
</tr>
<tr>
<td>recovery_message_body</td>
<td>Body of recovery message</td>
<td></td>
</tr>
<tr>
<td>operation</td>
<td>Add an operation to action, see below. It's possible to add more then one operation</td>
<td></td>
</tr>
<tr>
<td>condition</td>
<td>Add an condition to action, see below. It's possible to add more the one condition</td>
<td></td>
</tr>
</table>

Attributes for operation.
<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>type</td>
<td>Type of operation, can be :message or :command</td>
<td>:message</td>
</tr>
<tr>
<td>escalation_time</td>
<td>Time to escalate to next step</td>
<td></td>
</tr>
<tr>
<td>start</td>
<td>Start step, when this operation take place</td>
<td></td>
</tr>
<tr>
<td>stop</td>
<td>Last step, when this operation take place</td>
<td></td>
</tr>
<tr>
<td>user_groups</td>
<td>Zabbix user group names that'll receive message</td>
<td></td>
</tr>
<tr>
<td>message</td>
<td>Message description, see below</td>
<td>Use default actin message if empty</td>
</tr>
</table>

Attributes for conditions.
<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>type</td>
<td>Type of condition, can be one of :trigger, :trigger_value, :trigger_serverity, :host_group, :maintenance</td>
<td></td>
</tr>
<tr>
<td>operator</td>
<td>Operator for condition, can be one of :equal, :not_equal, :like, :not_like, :in, :gte, :lte, :not_in</td>
<td></td>
</tr>
<tr>
<td>value</td>
<td>Value for condition.</td>
<td></td>
</tr>
</table>

It also possible to use short form of condition, like:
ruby
condition :trigger, :equal, '42th trigger name'


Attributes for message.
<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>use_default_message</td>
<td>Use default message from action</td>
<td></td>
</tr>
<tr>
<td>subject</td>
<td>Message subject</td>
<td></td>
</tr>
<tr>
<td>message</td>
<td>Message body</td>
<td></td>
</tr>
<tr>
<td>media_type</td>
<td>Name of media type to use</td>
<td>By default all media types are used</td>
</tr>
</table>

Examples

zabbix_action 'Test action' do
  action :sync
  event_source :triggers
  operation do
    user_groups 'Test group'
    message do
      use_default_message false
      subject 'Test {TRIGGER.SEVERITY}: {HOSTNAME1} {TRIGGER.STATUS}: {TRIGGER.NAME}'
      message "Trigger: {TRIGGER.NAME}\n"\
        "Trigger status: {TRIGGER.STATUS}\n" \
        "Trigger severity: {TRIGGER.SEVERITY}\n" \
        "\n" \
        "Item values:\n" \
        '{ITEM.NAME1} ({HOSTNAME1}:{TRIGGER.KEY1}): {ITEM.VALUE1}'
      media_type 'sms'
    end
  end

  condition :trigger_severity, :gte, :high
  condition :host_group, :equal, 'Main'
  condition :maintenance, :not_in, :maintenance
end

zabbix_application

Creates application, items and triggers. You should think about items and triggers like nested
resources inside zabbix_application lwrp.

Actions

<table>
<tr>
<th>Action</th>
<th>Description</th>
</tr>
<tr>
<td>sync</td>
<td>Default action. Sync application description with one's in zabbix server</td>
</tr>
</table>

Attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>name</td>
<td><strong>Name attribute</strong>. Name of the application (required)</td>
<td></td>
</tr>
<tr>
<td>item</td>
<td>Add an item to application, see below. It's possible to add more then one item</td>
<td></td>
</tr>
<tr>
<td>trigger</td>
<td>Add an trigger to application, see below. It's possible to add more the one trigger</td>
<td></td>
</tr>
</table>

Item attributes

Create/update zabbix item
<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>key</td>
<td><strong>Name attribute</strong>. Zabbix key for an item, should be unique.</td>
<td></td>
</tr>
<tr>
<td>type</td>
<td>Type of zabbix check, possible values
:zabbix, :trapper, :active, :calculated
</td>
<td></td>
</tr>
<tr>
<td>name</td>
<td>Descriptive name of zabbix check, shown in web-interface
</td>
<td></td>
</tr>
<tr>
<td>frequency</td>
<td>How often zabbix checks this item in seconds</td>
<td>60</td>
</tr>
<tr>
<td>history</td>
<td>How many days store item's history</td>
<td>7 days</td>
</tr>
<tr>
<td>multiplier</td>
<td>Set a multiplier for item</td>
<td>0</td>
</tr>
<tr>
<td>trends</td>
<td>How many days store item's trends (archived history)</td>
<td>365</td>
</tr>
<tr>
<td>units</td>
<td>Set a unit for item</td>
<td></td>
</tr>
<tr>
<td>value_type</td>
<td>Type of gathered value, possible values
:float, :character, :log_line, :unsigned_int, :text
</td>
<td>:unsigned_int</td>
</tr>
</table>

Trigger attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
</table>

Examples

zabbix_application "Test application" do
  action :sync

  item 'vfs.fs.size[/var/log,free]' do
    type :active
    name 'Free disk space on /var/log'
    frequency 600
    value_type :unsigned_int
  end

  trigger "Number #{node.fqdn} of free inodes on log < 10%" do
    expression "{#{node.fqdn}:vfs.fs.size[/var/log,free].last(0)}>0"
    severity :high
  end
end

zabbix_connect

Examples

zabbix_connect 'default' do
  action :make
  apiurl 'http://localhost/api_jsonrpc.php'
  databag 'zabbix'
end

zabbix_database

Examples

zabbix_database db_name do
  db_user db_user
  db_pass db_pass
  db_host db_host
  db_port db_port
  action :create
end

zabbix_graph

Examples

zabbix_graph 'Test Graph' do
  action :create
  width 640
  height 480
  graph_items [:key => 'vfs.fs.size[/var/log,free]', :color => '111111']
end

zabbix_host

Examples

zabbix_host node['fqdn'] do
  action :create
  host_group 'Hosts'
  use_ip true
  ip_address node['ipaddress']
end

zabbix_media_type

Examples

zabbix_media_type 'sms' do
  action :create
  type :sms
  modem '/dev/modem'
end

zabbix_screen

Examples

zabbix_screen 'Test Screen' do
  action :sync
  screen_item 'Test Graph' do
    resource_type :graph
  end
end

zabbix_template

Actions

<table>
<tr>
<th>Action</th>
<th>Description</th>
</tr>
<tr>
<td>add</td>
<td>Default action. Add a template to node</td>
</tr>
<tr>
<td>import</td>
<td>Import templates from xml file to zabbix server</td>
</tr>
</table>

Attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>path</td>
<td><strong>Name attribute</strong>. Path to file for :import or name of template for :add action (required)</td>
<td></td>
</tr>
<tr>
<td>host_name</td>
<td>Name of host new template to add</td>
<td>FQDN of current node</td>
</tr>
</table>

Examples

zabbix_template '/opt/zabbix/templates/zbx_templates_linux.xml' do
  action :import
end

zabbix_template 'Linux_Template'
  action :add
end

zabbix_user_group

Actions

<table>
<tr>
<th>Action</th>
<th>Description</th>
</tr>
<tr>
<td>create</td>
<td>Default action. Create a new zabbix user group</td>
</tr>
</table>

Attributes

<table>
<tr>
<th>Attribute</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td>name</td>
<td><strong>Name attribute</strong>. Name of new zabbix user group (required)</td>
<td></td>
</tr>
</table>

Examples

zabbix_user_group 'Test group' do
  action :create
end

zabbix_user_macro

Examples

zabbix_user_macro 'Test_macro' do
  action :create
  value 'foobar'
end

Usage

To install Zabbix agent just include zabbix_lwrp default recipe into your node's run_list:

{
  "name":"my_node",
  "run_list": [
    "recipe[zabbix_lwrp]"
  ]
}

This recipe should be included before all usage of LWRP, because connection to zabbix server is established here.

To install Zabbix server include the following recipes:

{
  "name":"my_node",
  "run_list": [
    "recipe[zabbix_lwrp::default]",
    "recipe[zabbix_lwrp::database]",
    "recipe[zabbix_lwrp::server]",
    "recipe[zabbix_lwrp::web]"
  ]
}

For examples of LWRP see fixture cookbook in tests/fixtures/cookbooks.

License and Maintainer

Maintainer:: LLC Express 42 (cookbooks@express42.com)

License:: MIT