Skip to content

Latest commit

 

History

History
274 lines (211 loc) · 11.9 KB

ZABBIX_WEB_ROLE.md

File metadata and controls

274 lines (211 loc) · 11.9 KB
Raw

community.zabbix.zabbix_web role

Table of Contents

Overview

Requirements

Operating Systems

This role will work on the following operating systems:

  • RedHat
  • Debian
  • Ubuntu

So, you'll need one of those operating systems.. :-) Please sent Pull Requests or suggestions when you want to use this role for other Operating Systems.

Zabbix Versions

See the following list of supported Operating Systems with the Zabbix releases.

Zabbix 5.0 4.4 4.0 (LTS) 3.0 (LTS)
Red Hat Fam 8 V
Red Hat Fam 7 V V V
Red Hat Fam 6 V
Red Hat Fam 5 V
Fedora V V
Ubuntu 20.04 focal
Ubuntu 19.10 eoan
Ubuntu 18.04 bionic V V
Ubuntu 16.04 xenial V V
Ubuntu 14.04 trusty V V V
Debian 10 buster V
Debian 9 stretch V V
Debian 8 jessie V V V
Debian 7 wheezy V V
macOS 10.15 V V
macOS 10.14 V V

Installation

Installing this role is very simple: ansible-galaxy install community.zabbix.zabbix_web

When the Zabbix Web needs to be running on the same host as the Zabbix Server, please also install the Zabbix Server by executing the following command: ansible-galaxy install community.zabbix.zabbix_server

Default username/password for the Zabbix Web interface is the default.

Username: Admin Password: zabbix

Role Variables

Main variables

The following is an overview of all available configuration defaults for this role.

Overall Zabbix

  • zabbix_server_version: This is the version of zabbix. Default: 5.0. Can be overridden to 4.4, 4.0, 3.4, 3.2, 3.0, 2.4, or 2.2. Previously the variable zabbix_version was used directly but it could cause some inconvenience. That variable is maintained by retrocompativility.

  • zabbix_repo: Default: zabbix

    • epel: install agent from EPEL repo
    • zabbix: (default) install agent from Zabbix repo
    • other: install agent from pre-existing or other repo

  • zabbix_repo_yum: A list with Yum repository configuration.

  • zabbix_repo_yum_schema: Default: https. Option to change the web schema for the yum repository(http/https)

  • zabbix_web_package_state: Default: present. Can be overridden to latest to update packages when needed.

  • zabbix_web_centos_release: Default: False. When the centos-release-scl repository needs to be enabled. This is required when using Zabbix 5.0 due to installation of a recent version of PHP.

  • zabbix_web_doubleprecision: Default: False. For upgraded installations, please read database upgrade notes (Paragraph "Enabling extended range of numeric (float) values") before enabling this option.

Zabbix Web specific

  • zabbix_url: This is the url on which the zabbix web interface is available. Default is zabbix.example.com, you should override it. For example, see "Example Playbook"
  • zabbix_url_aliases: A list with Aliases for the Apache Virtual Host configuration.
  • zabbix_timezone: Default: Europe/Amsterdam. This is the timezone. The Apache Virtual Host needs this parameter.
  • zabbix_vhost: Default: true. When you don't want to create an Apache Virtual Host configuration, you can set it to False.
  • zabbix_apache_vhost_port: The port on which Zabbix HTTP vhost is running.
  • zabbix_apache_vhost_tls_port: The port on which Zabbix HTTPS vhost is running.
  • zabbix_apache_vhost_listen_ip: On which interface the Apache Virtual Host is available.
  • zabbix_apache_can_connect_ldap: Default: false. Set SELinux boolean to allow httpd to connect to LDAP.
  • zabbix_php_install: Default: true. True / False. Switch for extra install of packages for PHP, currently on for Debian/Ubuntu.
  • zabbix_web_max_execution_time:
  • zabbix_web_memory_limit:
  • zabbix_web_post_max_size:
  • zabbix_web_upload_max_filesize:
  • zabbix_web_max_input_time:
  • zabbix_apache_include_custom_fragment: Default: true. Includes php_value vars max_execution_time, memory_limit, post_max_size, upload_max_filesize, max_input_time and date.timezone in vhost file.. place those in php-fpm configuration.
  • zabbix_web_env: (Optional) A Dictionary of PHP Environments settings.

The following properties are specific to Zabbix 5.0:

  • zabbix_php_fpm_dir_etc: etc HOME root directory of PHP-FPM
  • zabbix_php_fpm_dir_var: Var HOME root directory of PHP-FPM

TLS Specific configuration

The following properties are related when TLS/SSL is configured:

  • zabbix_apache_tls: If the Apache vhost should be configured with TLS encryption or not.
  • zabbix_apache_redirect: If a redirect should take place from HTTP to HTTPS
  • zabbix_apache_tls_crt: The path to the TLS certificate file.
  • zabbix_apache_tls_key: The path to the TLS key file.
  • zabbix_apache_tls_chain: The path to the TLS certificate chain file.
  • zabbix_apache_SSLPassPhraseDialog: Type of pass phrase dialog for encrypted private keys.
  • zabbix_apache_SSLSessionCache: Type of the global/inter-process SSL Session Cache
  • zabbix_apache_SSLSessionCacheTimeout: Number of seconds before an SSL session expires in the Session Cache
  • zabbix_apache_SSLCryptoDevice: Enable use of a cryptographic hardware accelerator

When zabbix_apache_tls_crt, zabbix_apache_tls_key and/or zabbix_apache_tls_chain are used, make sure that these files exists before executing this role. The Zabbix-Web role will not install the mentioned files.

See https://httpd.apache.org/docs/current/mod/mod_ssl.html for SSL* configuration options for Apache HTTPD.

Zabbix Server

  • zabbix_server_name: The name of the Zabbix Server.
  • zabbix_server_database: The type of database used. Can be: mysql or pgsql
  • zabbix_server_database_long: The type of database used, but long name. Can be: mysql or postgresql
  • zabbix_server_hostname: The hostname on which the zabbix-server is running. Default set to: {{ inventory_hostname }}
  • zabbix_server_listenport: On which port the Zabbix Server is available. Default: 10051
  • zabbix_server_dbhost: The hostname on which the database is running.
  • zabbix_server_dbname: The database name which is used by the Zabbix Server.
  • zabbix_server_dbuser: The database username which is used by the Zabbix Server.
  • zabbix_server_dbpassword: The database user password which is used by the Zabbix Server.
  • zabbix_server_dbport: The database port which is used by the Zabbix Server.

The following properties are related when using Elasticsearch for history storage:

  • zabbix_server_history_url: String with url to the Elasticsearch server or a list if the types are stored on different Elasticsearch URLs.
  • zabbix_server_history_types: List of history types to store in Elasticsearch.

See the following links for more information regarding Zabbix and Elasticsearch https://www.zabbix.com/documentation/3.4/manual/appendix/install/elastic_search_setup https://www.zabbix.com/documentation/4.0/manual/appendix/install/elastic_search_setup

Example Playbook

There are two ways of using the zabbix-web:

  • Single instance
  • Multi host setup

Single instance

When there is one host running both Zabbix Server and the Zabbix Web (Running MySQL as database):

- hosts: zabbix-server
  become: yes
  roles:
    - role: geerlingguy.apache
    - role: community.zabbix.zabbix_server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306
    - role: community.zabbix.zabbix_web
      zabbix_url: zabbix.mydomain.com
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

Multi host setup

This is a two host setup. On one host (Named: "zabbix-server") the Zabbix Server is running, and the other host (Named: zabbix-web) runs Zabbix Web (with MySQL as database):

- hosts: zabbix-server
  become: yes
  roles:
    - role: community.zabbix.zabbix_server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

- hosts: zabbix-web
  become: yes
  roles:
    - role: geerlingguy.apache
    - role: community.zabbix.zabbix_web
      zabbix_url: zabbix.mydomain.com
      zabbix_server_hostname: zabbix-server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306

Adding Environment Variables for zabbix_web

Sometimes you need to add environment variables to your zabbix.conf.php, for example to add LDAP CA certificates. To do this add a zabbix_web_env dictionary:

- hosts: zabbix-web
  become: yes
  roles:
    - role: geerlingguy.apache
    - role: community.zabbix.zabbix_web
      zabbix_url: zabbix.mydomain.com
      zabbix_server_hostname: zabbix-server
      zabbix_server_database: mysql
      zabbix_server_database_long: mysql
      zabbix_server_dbport: 3306
      zabbix_web_env:
        LDAPTLS_CACERT: /etc/ssl/certs/ourcert.pem

Using Elasticsearch for history storage

To use Elasticsearch for history storage you need to configure the zabbix_server_history_url and zabbix_server_history_types. You will also need to configure Elasticsearch in the zabbix_server role.

Zabbix can store the following history types in Elasticsearch:

  • Numeric (unsigned) - uint
  • Numeric (float) - dbl
  • Character - str
  • Log - log
  • Text - text

To store all history types in the same history URL the following variables should be set (make sure history url points to your Elasticsearch cluster):

zabbix_server_history_url: "http://localhost:9200"
zabbix_server_history_types:
  - 'str'
  - 'text'
  - 'log'
  - 'uint'
  - 'dbl'

Molecule

This role is configured to be tested with Molecule. You can find on this page some more information regarding Molecule:

With each Pull Request, Molecule will be executed via travis.ci. Pull Requests will only be merged once these tests run successfully.

License

GNU General Public License v3.0 or later

See LICENCE to see the full text.

Author Information

Please send suggestion or pull requests to make this role better. Also let us know if you encounter any issues installing or using this role.

Github: https://github.com/ansible-collections/community.zabbix