https://github.com/express42/zabbix_lwrp
Express 42 zabbix cookbook
https://github.com/express42/zabbix_lwrp
chef cookbooks iac zabbix
Last synced: 5 months ago
JSON representation
Express 42 zabbix cookbook
- Host: GitHub
- URL: https://github.com/express42/zabbix_lwrp
- Owner: express42
- License: mit
- Created: 2015-03-31T19:11:42.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2020-02-19T14:33:25.000Z (over 5 years ago)
- Last Synced: 2025-03-31T08:38:52.747Z (7 months ago)
- Topics: chef, cookbooks, iac, zabbix
- Language: Ruby
- Size: 1.16 MB
- Stars: 13
- Watchers: 22
- Forks: 20
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/express42/zabbix_lwrp)
[](https://codeclimate.com/github/express42/zabbix_lwrp)
[](https://travis-ci.org/express42/zabbix_lwrp)
# Description
[](https://gitter.im/express42/zabbix_lwrp?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
Installs and configures Zabbix agent and server with PostgreSQL/MySQL and Nginx. Provides LWRP for creating and modifying Zabbix objects.
# Requirements
## Platform:
* ubuntu
* centos
* windows
## Cookbooks:
* apt
* build-essential
* chef_nginx
* chocolatey
* database
* lvm
* php-fpm
* postgresql
* mysql2_chef_gem
* mysql
* yum-mysql-community
* mysql2_chef_gem
* windows_firewall
# Attributes
## Agent
* `node['zabbix']['agent']['windows']['installer']` - 'chocolatey' or 'bin'(zabbix binaries). Defaults to `chocolatey`.
* `node['zabbix']['agent']['windows']['version']` - Defaults to `3.2.0`.
* `node['zabbix']['agent']['windows']['chocolatey']['repo']` - Defaults to `https://chocolatey.org/api/v2`.
* `node['zabbix']['agent']['windows']['path']` - Defaults to `C:\ProgramData\zabbix`.
* `node['zabbix']['agent']['scripts']` - Defaults to `case node['platform']`.
* `node['zabbix']['agent']['include']` - Defaults to `case node['platform']`.
* `node['zabbix']['agent']['config']['listen_ip']` - Defaults to `0.0.0.0`.
* `node['zabbix']['agent']['config']['listen_port']` - Defaults to `10050`.
* `node['zabbix']['agent']['config']['serverhost']` - Defaults to `localhost`.
* `node['zabbix']['agent']['config']['hostname']` - Defaults to `node['fqdn']`.
* `node['zabbix']['agent']['config']['pidfile']` - Defaults to `/var/run/zabbix/zabbix_agentd.pid`.
* `node['zabbix']['agent']['config']['logs']` - Defaults to `{ ... }`.
* `node['zabbix']['agent']['config']['global']` - Defaults to `{ ... }`.
* `node['zabbix']['agent']['config']['user_params']` - Defaults to `{ ... }`.
## Postgresql
* `node['zabbix']['version']` - Defaults to `3.2`.
* `node['zabbix']['api-version']` - Defaults to `3.1.0`.
* `node['zabbix']['host']['group']` - Defaults to `Hosts`.
* `node['zabbix']['host']['name']` - Defaults to `node['fqdn']`.
* `node['zabbix']['host']['dns']` - Defaults to `node['fqdn']`.
* `node['zabbix']['host']['ipaddress']` - Defaults to `node['ipaddress']`.
* `node['zabbix']['host']['ipmi']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['ipmi']['port']` - Defaults to `623`.
* `node['zabbix']['host']['ipmi']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['jmx']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['jmx']['port']` - Defaults to `12345`.
* `node['zabbix']['host']['jmx']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['snmp']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['snmp']['port']` - Defaults to `161`.
* `node['zabbix']['host']['snmp']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['agent']['use_ip']` - Defaults to `true`.
* `node['zabbix']['java_gateway']['enabled']` - Defaults to `false`.
* `node['zabbix']['java_gateway']['config']` - Defaults to `{ ... }`.
* `node['zabbix']['server']['database']['mysql']['filesystem']` - Defaults to `ext4`.
* `node['zabbix']['server']['database']['mysql']['lvm_group']` - Defaults to `shared`.
* `node['zabbix']['server']['database']['mysql']['lvm_volume']` - Defaults to `/dev/sda3`.
* `node['zabbix']['server']['database']['mysql']['partition_size']` - Defaults to `10G`.
* `node['zabbix']['server']['database']['mysql']['mount_point']` - Defaults to `/var/lib/mysql_zabbix`.
* `node['zabbix']['server']['database']['mysql']['databag']` - Defaults to `zabbix`.
* `node['zabbix']['server']['database']['mysql']['version']` - Defaults to `5.5`.
* `node['zabbix']['server']['database']['mysql']['service_name']` - Defaults to `zabbix`.
* `node['zabbix']['server']['database']['mysql']['database_name']` - Defaults to `zabbix`.
* `node['zabbix']['server']['database']['mysql']['configuration']['listen_addresses']` - Defaults to `127.0.0.1`.
* `node['zabbix']['server']['database']['mysql']['configuration']['port']` - Defaults to `3306`.
* `node['zabbix']['server']['database']['mysql']['configuration']['character_set']` - Defaults to `utf8`.
* `node['zabbix']['server']['database']['mysql']['configuration']['collate']` - Defaults to `utf8_bin`.
* `node['zabbix']['server']['database']['postgresql']['filesystem']` - Defaults to `ext4`.
* `node['zabbix']['server']['database']['postgresql']['lvm_group']` - Defaults to `shared`.
* `node['zabbix']['server']['database']['postgresql']['lvm_volume']` - Defaults to `/dev/sda3`.
* `node['zabbix']['server']['database']['postgresql']['partition_size']` - Defaults to `10G`.
* `node['zabbix']['server']['database']['postgresql']['cluster']` - Defaults to `main`.
* `node['zabbix']['server']['database']['postgresql']['databag']` - Defaults to `zabbix`.
* `node['zabbix']['server']['database']['postgresql']['locale']` - Defaults to `en_US.utf8`.
* `node['zabbix']['server']['database']['postgresql']['mount_point']` - Defaults to `/var/lib/postgresql`.
* `node['zabbix']['server']['database']['postgresql']['network']` - Defaults to `127.0.0.0/8`.
* `node['zabbix']['server']['database']['postgresql']['version']` - Defaults to `9.4`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['listen_addresses']` - Defaults to `127.0.0.1`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['port']` - Defaults to `5432`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['max_connections']` - Defaults to `300`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['shared_buffers']` - Defaults to `128MB`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['maintenance_work_mem']` - Defaults to `128MB`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['work_mem']` - Defaults to `8MB`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['effective_cache_size']` - Defaults to `2GB`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['log_min_duration_statement']` - Defaults to `1000`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['archive_mode']` - Defaults to `on`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['archive_command']` - Defaults to `exit 0`.
* `node['zabbix']['server']['database']['postgresql']['configuration']['wal_level']` - Defaults to `archive`.
## MySQL
* `node['zabbix']['server']['database']['mysql']['filesystem']` - Defaults to `ext4`
* `node['zabbix']['server']['database']['mysql']['lvm_group']` - Defaults to `shared`
* `node['zabbix']['server']['database']['mysql']['lvm_volume']` - Defaults to `/dev/sda3`
* `node['zabbix']['server']['database']['mysql']['partition_size']` - Defaults to `10G`
* `node['zabbix']['server']['database']['mysql']['mount_point']` - Defaults to `/var/lib/mysql_zabbix`. Do not set to `/var/lib/mysql` because it will conflict.
* `node['zabbix']['server']['database']['mysql']['databag']` - Defaults to `zabbix`
* `node['zabbix']['server']['database']['mysql']['version']` - Defaults to `5.5`
* `node['zabbix']['server']['database']['mysql']['service_name']` - Defaults to `zabbix`
* `node['zabbix']['server']['database']['mysql']['database_name']` - Defaults to `zabbix`
* `node['zabbix']['server']['database']['mysql']['configuration']['listen_addresses']` - Defaults to `127.0.0.1`
* `node['zabbix']['server']['database']['mysql']['configuration']['port']` - Defaults to `3306`
* `node['zabbix']['server']['database']['mysql']['configuration']['character_set']` - Defaults to `utf8`
* `node['zabbix']['server']['database']['mysql']['configuration']['collate']` - Defaults to `utf8_bin`
## Default
* `node['zabbix']['version']` - Defaults to `3.2`.
* `node['zabbix']['api-version']` - Defaults to `3.1.0`.
* `node['zabbix']['server']['database']['vendor']` - Defaults to `postgresql`. Make sure that is setup for MySQL.
## Host
* `node['zabbix']['host']['group']` - Defaults to `Hosts`.
* `node['zabbix']['host']['name']` - Defaults to `node['fqdn']`.
* `node['zabbix']['host']['dns']` - Defaults to `node['fqdn']`.
* `node['zabbix']['host']['ipaddress']` - Defaults to `node['ipaddress']`.
* `node['zabbix']['host']['ipmi']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['ipmi']['port']` - Defaults to `623`.
* `node['zabbix']['host']['ipmi']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['jmx']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['jmx']['port']` - Defaults to `12345`.
* `node['zabbix']['host']['jmx']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['snmp']['enabled']` - Defaults to `false`.
* `node['zabbix']['host']['snmp']['port']` - Defaults to `161`.
* `node['zabbix']['host']['snmp']['use_ip']` - Defaults to `true`.
* `node['zabbix']['host']['agent']['use_ip']` - Defaults to `true`.
## Java Gateway
* `node['zabbix']['java_gateway']['enabled']` - Defaults to `false`.
* `node['zabbix']['java_gateway']['timeout']` - Defaults to `3`.
* `node['zabbix']['java_gateway']['listen_ip']` - Defaults to `127.0.0.1`.
* `node['zabbix']['java_gateway']['listen_port']` - Defaults to `10052`.
* `node['zabbix']['java_gateway']['pollers']` - Defaults to `5`.
## Server
* `node['zabbix']['server']['database']['vendor']` - Defaults to `postgresql`.
* `node['zabbix']['server']['service']` - Defaults to `zabbix-server`.
* `node['zabbix']['server']['credentials']['databag']` - Defaults to `zabbix`.
* `node['zabbix']['server']['templates']` - Defaults to `/opt/zabbix/templates`.
* `node['zabbix']['server']['sync_hosts']` - Defaults to `false`.
* `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']['java_gateway']` - Defaults to `{ ... }`.
* `node['zabbix']['server']['config']['alerts']` - Defaults to `{ ... }`.
* `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']['start_servers']` - Defaults to `2`.
* `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`.
* `node['nginx']['default_site_enabled']` - Defaults to `false`.
# Recipes
* zabbix_lwrp::agent_linux - Installs and configures Zabbix agent for Linux.
* zabbix_lwrp::agent_win_bin - Installs and configures Zabbix agent for Windows.
* zabbix_lwrp::agent_win_choco - Installs and configures Zabbix agent for Windows.
* 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::postgresql - Installs and configures PostgreSQL database for Zabbix.
* zabbix_lwrp::mysql - Installs and configures MySQL database for Zabbix.
* zabbix_lwrp::database - Installs and configures Zabbix database.
* zabbix_lwrp::default - Installs and configures Zabbix official repository and agent.
* zabbix_lwrp::host - Creates host via Zabbix API.
* zabbix_lwrp::java_gateway - Installs and configures Zabbix Java Gateway.
* 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.
# Resources
* [zabbix_action](#zabbix_action)
* [zabbix_application](#zabbix_application)
* [zabbix_connect](#zabbix_connect)
* [zabbix_database](#zabbix_database)
* [zabbix_graph](#zabbix_graph)
* [zabbix_host](#zabbix_host)
* [zabbix_media_type](#zabbix_media_type)
* [zabbix_screen](#zabbix_screen)
* [zabbix_template](#zabbix_template)
* [zabbix_user_group](#zabbix_user_group)
* [zabbix_user_macro](#zabbix_user_macro)
## zabbix_action
### Actions
- sync: Default action.
### Attribute Parameters
- name:
- event_source:
- escalation_time: Defaults to 60.
- enabled: Defaults to true.
- message_subject:
- message_body:
- send_recovery_message: Defaults to false.
- recovery_message_subject:
- recovery_message_body:
## zabbix_application
### Actions
- sync: Default action.
### Attribute Parameters
- name:
## zabbix_connect
### Actions
- make: Default action.
### Attribute Parameters
- name:
- databag:
- apiurl:
- user:
- password:
- sync: Defaults to false.
## zabbix_database
### Actions
- create: Default action.
### Attribute Parameters
- db_vendor: Defaults to "postgresql".
- db_name:
- db_user:
- db_pass:
- db_host:
- db_port:
## zabbix_graph
### Actions
- create: Default action.
### Attribute Parameters
- name:
- height:
- width:
- graph_items:
- graph_type:
## zabbix_host
### Actions
- create: Default action.
### Attribute Parameters
- type: Defaults to 1.
- host_name:
- host_group:
- port: Defaults to 10050.
- ip_address:
- dns:
- use_ip: Defaults to true.
- ipmi_enabled: Defaults to false.
- snmp_enabled: Defaults to false.
- jmx_enabled: Defaults to false.
- ipmi_port: Defaults to 623.
- snmp_port: Defaults to 161.
- jmx_port: Defaults to 12345.
- ipmi_use_ip: Defaults to true.
- snmp_use_ip: Defaults to true.
- jmx_use_ip: Defaults to true.
## zabbix_media_type
### Actions
- create: Default action.
### Attribute Parameters
- name:
- type:
- server:
- helo:
- email:
- path:
- gsm_modem:
- username:
- password:
## zabbix_screen
### Actions
- sync: Default action.
### Attribute Parameters
- name:
- hsize:
- vsize:
## zabbix_template
### Actions
- add: Default action.
- import:
### Attribute Parameters
- host_name:
- path:
## zabbix_user_group
### Actions
- create: Default action.
### Attribute Parameters
- name:
## zabbix_user_macro
### Actions
- create: Default action.
### Attribute Parameters
- name:
- value:
- host_name:
# Data bag
Data bag `zabbix` must contains the following items:
* admin (with Zabbix admin password)
* postgresql
* users
`postgresql` and `users` items related to the postgresql database
`users` item related to MySQL database, necessarily contains `root` and `zabbix` entries
For examples see fixture data bag `test/fixtures/databags/zabbix/`
## Using node.run_state
Optionally this data can be provided in node.run_state instead of data bags.
This is useful in a wrapper cookbook that retrieves credentials from other locations such as chef-vault.
Simply set the 'databag' attributes to the value of the run_state key that contains the data.
### Example Wrapper Cookbook
```ruby
#Your super secret code to get credentials here
node.default['zabbix']['server']['database']['databag'] = 'zabbix_data'
node.default['zabbix']['server']['database']['postgresql']['databag'] = 'zabbix_data'
node.default['zabbix']['server']['credentials']['databag'] = 'zabbix_data'
node.run_state['zabbix_data'] = {
'users' => {
'id' => 'users',
'users' => {
'zabbix' => {
'options' => {
'password' => secret_zabbix_pass_here
'superuser' => false
}
}
}
},
'databases' => {
'id' => 'databases',
'databases' => {
'zabbix' => { 'options' => { 'owner' => 'zabbix' } }
}
},
'admin' => {'id' => 'admin', 'pass' => secret_admin_pass_here }
}
include_recipe 'zabbix_lwrp::default'
include_recipe 'zabbix_lwrp::database'
include_recipe 'zabbix_lwrp::server'
include_recipe 'zabbix_lwrp::web'
```
# Resources
This cookbooks provides next resources:
* [zabbix_action](#zabbix_action)
* [zabbix_application](#zabbix_application)
* [zabbix_connect](#zabbix_connect)
* [zabbix_database](#zabbix_database)
* [zabbix_graph](#zabbix_graph)
* [zabbix_host](#zabbix_host)
* [zabbix_media_type](#zabbix_media_type)
* [zabbix_screen](#zabbix_screen)
* [zabbix_template](#zabbix_template)
* [zabbix_user_group](#zabbix_user_group)
* [zabbix_user_macro](#zabbix_user_macro)
## zabbix_action
Creates zabbix action with operations, conditions and messages.
### Actions
Action
Description
sync
Default action. Sync action description with one's in zabbix server
### Attributes
Attribute
Description
Default
name
Name attribute. Name of the action (required)
event_source
Source of event for action, now only :trigger allowed
:triggers
escalation_time
Delay between escalation steps
60
enabled
Is action enabled?
true
message_subject
Subject of action message
message_body
Body of action message
true
send_recovery_message
Send recovery message when conditions of action become false
false
recovery_message_subject
Subject of recovery message
recovery_message_body
Body of recovery message
operation
Add an operation to action, see below. It's possible to add more then one operation
condition
Add an condition to action, see below. It's possible to add more the one condition
Attributes for operation.
Attribute
Description
Default
type
Type of operation, can be :message or :command
:message
escalation_time
Time to escalate to next step
start
Start step, when this operation take place
stop
Last step, when this operation take place
user_groups
Zabbix user group names that'll receive message
message
Message description, see below
Use default actin message if empty
Attributes for conditions.
Attribute
Description
Default
type
Type of condition, can be one of :trigger, :trigger_value, :trigger_serverity, :host_group, :maintenance
operator
Operator for condition, can be one of :equal, :not_equal, :like, :not_like, :in, :gte, :lte, :not_in
value
Value for condition.
It also possible to use short form of condition, like:
```ruby
condition :trigger, :equal, '42th trigger name'
```
Attributes for message.
Attribute
Description
Default
use_default_message
Use default message from action
subject
Message subject
message
Message body
media_type
Name of media type to use
By default all media types are used
### Examples
```ruby
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 resource.
### Actions
Action
Description
sync
Default action. Sync application description with one's in zabbix server
### Attributes
Attribute
Description
Default
name
Name attribute. Name of the application (required)
item
Add an item to application, see below. It's possible to add more then one item
trigger
Add an trigger to application, see below. It's possible to add more the one trigger
### Item attributes
Create/update zabbix item
Attribute
Description
Default
key
Name attribute. Zabbix key for an item, should be unique.
type
Type of zabbix check, possible values
:zabbix, :trapper, :active, :calculated
name
Descriptive name of zabbix check, shown in web-interface
frequency
How often zabbix checks this item in seconds
60
history
How many days store item's history
7 days
multiplier
Set a multiplier for item
0
trends
How many days store item's trends (archived history)
365
units
Set a unit for item
value_type
Type of gathered value, possible values
:float, :character, :log_line, :unsigned_int, :text
:unsigned_int
### Trigger attributes
Attribute
Description
Default
### Examples
```ruby
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
```ruby
zabbix_connect 'default' do
action :make
apiurl 'http://localhost/api_jsonrpc.php'
databag 'zabbix'
end
```
## zabbix_database
### Examples
```ruby
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
```ruby
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
```ruby
zabbix_host node['fqdn'] do
action :create
host_group 'Hosts'
use_ip true
ip_address node['ipaddress']
end
```
## zabbix_media_type
### Examples
```ruby
zabbix_media_type 'sms' do
action :create
type :sms
gsm_modem '/dev/modem'
end
```
## zabbix_screen
### Examples
```ruby
zabbix_screen 'Test Screen' do
action :sync
screen_item 'Test Graph' do
resource_type :graph
end
end
```
## zabbix_template
### Actions
Action
Description
add
Default action. Add a template to node
import
Import templates from xml file to zabbix server
### Attributes
Attribute
Description
Default
path
Name attribute. Path to file for :import or name of template for :add action (required)
host_name
Name of host new template to add
FQDN of current node
### Examples
```ruby
zabbix_template '/opt/zabbix/templates/zbx_templates_linux.xml' do
action :import
end
zabbix_template 'Linux_Template'
action :add
end
```
## zabbix_user_group
### Actions
Action
Description
create
Default action. Create a new zabbix user group
### Attributes
Attribute
Description
Default
name
Name attribute. Name of new zabbix user group (required)
### Examples
```ruby
zabbix_user_group 'Test group' do
action :create
end
```
## zabbix_user_macro
### Examples
```ruby
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`:
```json
{
"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:
```json
{
"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 ()
Source:: https://github.com/express42/zabbix_lwrp
Issues:: https://github.com/express42/zabbix_lwrp/issues
License:: MIT