[docs] Create docs for zabbix installation

[Artur Kaszuba]

We need to create docs with description how to install and configure zabbix for CI systems.

Please describe:
- requirements for zabbix
- how to install zabbix server, changes required in hiera and puppet master configuration
- how to configure zabbix for CI, maybe we could create some basic templates in repository
- how to add jenkins master and slaves to zabbix

[Igor Shishkin (teran)]

@Artur,

Please clarify what kind of doc you want to get?
I'm asking because basic role zbxserver and zbxproxy roles provided in puppet-manifests repo [0] are real working examples.
At the same time zabbix is not related to CI systems at all, since it monitor the lower infra layer and doesn't pay any attention to high level CI systems.

So please clarify deeper what you want to get.
Probably we could create docstrings and build documentation to cover such kind of questions.

[0] https://github.com/fuel-infra/puppet-manifests

[Artur Kaszuba (akaszuba)]

At the start in this documentation we should show:
- how to install basic zabbix server from manifests, if we already have working roles in manifests then it is enough to describe how to use it to get simple zabbix installation, it could be simple installation, one server without proxy
- how to configure zabbix server, only the required steps, we dont need to teach how to use all zabbix functions, but we must to describe what steps are needed to get worked solution after end of puppet apply
- how to install zabbix agent, it is probably done just by setting variables in hiera, but it should be described to show what end user need to do/check to get agent installed and propertly configured
- how to add zabbix aggent to server and how to enable tests on it

After this steps we should get simple installation of zabbix, with monitoring of basic elements of system. Then we require to add monitoring of CI elements:
- we already have some number of tests for CI, (number of executors, no slave process, etc), maybe you could export it to json and put in repository, in documentation we could describe how to import it and enable on selected servers
- we have also tests for failed jobs, it will be very usefull to describe how to use it, and i think it is also required to describe

About zabbix tests i can only guess what we have configured and we can describe. I dont have access to our zabbix configs and i only show examples which i remember :)
It will be good to add all our CI related tests, of course some of tests could be not easy to export and describe, at the start we can describe the simpler part.

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/259387

[Fuel Devops McRobotson (fuel-devops-robot)]

Related fix proposed to branch: master
Change author: Mateusz Matuszkowiak <email address hidden>
Review: https://review.fuel-infra.org/14862

[Fuel Devops McRobotson (fuel-devops-robot)]

Related fix proposed to branch: master
Change author: Mateusz Matuszkowiak <email address hidden>
Review: https://review.fuel-infra.org/14883

[Fuel Devops McRobotson (fuel-devops-robot)]

Reviewed: https://review.fuel-infra.org/14883
Submitter: Mateusz Matuszkowiak <email address hidden>
Branch: master

Commit: 44bc2235185443133e5d580748cf5b687fe3c138
Author: Mateusz Matuszkowiak <email address hidden>
Date: Mon Dec 21 15:19:05 2015

Add tools-open.config acls for opening tools projects

In order to be able to publish our Zabbix data like
templates, items, triggers, it is required to
make specific acls.

Change-Id: I3fff31375b729aadcb26b650418eb9c21f153c8c
Related-Bug: #1510556

[Fuel Devops McRobotson (fuel-devops-robot)]

Reviewed: https://review.fuel-infra.org/14862
Submitter: Mateusz Matuszkowiak <email address hidden>
Branch: master

Commit: d5e89379a1698fbf98c7b3d4284a5446b7c21390
Author: Mateusz Matuszkowiak <email address hidden>
Date: Tue Dec 22 09:47:58 2015

Make tools/zabbix-maintenance open to the public

This repo will store additionally Zabbix data like:
- triggers,
- items,
- templates.

Change-Id: I36ec1d1a2a528573325ea4602c1b25bb32423897
Related-Bug: #1510556

[Fuel Devops McRobotson (fuel-devops-robot)]

Related fix proposed to branch: master
Change author: Mateusz Matuszkowiak <email address hidden>
Review: https://review.fuel-infra.org/14906

[Fuel Devops McRobotson (fuel-devops-robot)]

Reviewed: https://review.fuel-infra.org/14906
Submitter: Mateusz Matuszkowiak <email address hidden>
Branch: master

Commit: cad9ba7881757e291712f3cd7d1143bafc0f5615
Author: Mateusz Matuszkowiak <email address hidden>
Date: Tue Dec 22 14:16:32 2015

Added zabbix templates from fuels infra prod

Change-Id: Iee38e421aef201f101ef050aade4c3eed4eddf14
Related-Bug: #1510556

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/259387
Committed: https://git.openstack.org/cgit/openstack/fuel-web/commit/?id=85fac74231cf694184da20d3b9bf09736c039102
Submitter: Jenkins
Branch: master

commit 85fac74231cf694184da20d3b9bf09736c039102
Author: Mateusz Matuszkowiak <email address hidden>
Date: Wed Dec 30 12:39:06 2015 +0100

    zabbix server deployment doc related to Fuel infra

    Change-Id: Iefd680f6be4c2fb3e1e076c4214c2f876e43c93d
    Related-Bug: #1510556