From 7fc6b4782c65cfb7148d83cb60437c616f4aeae9 Mon Sep 17 00:00:00 2001 From: Whytey Date: Tue, 17 Jan 2017 19:34:18 +1000 Subject: [PATCH] Zabbix (#1596) * Markdown documentation for the zabbix component and sensors * Initial commit, matches the current PR for the component/sensor --- source/_components/sensor.zabbix.markdown | 40 +++++++++++++++++++++ source/_components/zabbix.markdown | 42 +++++++++++++++++++++++ 2 files changed, 82 insertions(+) create mode 100644 source/_components/sensor.zabbix.markdown create mode 100644 source/_components/zabbix.markdown diff --git a/source/_components/sensor.zabbix.markdown b/source/_components/sensor.zabbix.markdown new file mode 100644 index 00000000000..7253916859b --- /dev/null +++ b/source/_components/sensor.zabbix.markdown @@ -0,0 +1,40 @@ +--- +layout: page +title: "Zabbix Sensor" +description: "Instructions how to integrate Zabbix Triggers sensors within Home Assistant." +date: 2016-12-13 22:57 +sidebar: true +comments: false +sharing: true +footer: true +logo: +ha_category: Sensor +ha_release: 0.35 +--- + + +The `zabbix` sensor platform let you monitor the current count of active triggers for your [Zabbix](http://www.zabbix.com/) monitoring instance. + +

+You must have the [Zabbix component](/components/zabbix/) configured to use those sensors. +

+ +To set it up, add the following information to your `configuration.yaml` file: + +```yaml +# Example configuration.yaml entry +sensor: + - platform: zabbix + triggers: + name: Important Hosts Trigger Count + hostids: [10051,10081,10084] + individual: true +``` + +Configuration variables: + +- **triggers** (*Required*): Specifies that this sensor is for Zabbix 'triggers'. In the future there will be other Zabbix sensors. +- **name** (*Optional*): Allows you to specify the name for the Sensor, otherwise the host name, as stored in Zabbix, is used. This is useful when you are specifying a list of hostids to monitor as a single count. +- **hostids** (*Optional*): This is a list of Zabbis hostids that we want to filter our count on. +- **individual** (*Optional*): A 'true'/'false' to specify whether we should show individual sensors when a list of hostsids is provided. If false, the sensor state will be the count of all triggers for the specified hosts (or all hosts within the Zabbix instance, if hostids isn't provided). + diff --git a/source/_components/zabbix.markdown b/source/_components/zabbix.markdown new file mode 100644 index 00000000000..c113092c3c9 --- /dev/null +++ b/source/_components/zabbix.markdown @@ -0,0 +1,42 @@ +--- +layout: page +title: "Zabbix" +description: "Instructions how to integrate Zabbix into Home Assistant." +date: 2016-12-13 22:57 +sidebar: true +comments: false +sharing: true +footer: true +logo: g +ha_category: +featured: false +ha_release: 0.35 +--- + +The Zabbix component is the main component to connect to a Zabbix monitoring instance via the Zabbix API. + +```yaml +zabbix: + host: 192.168.0.100 + username: zabbix_user + password: zabbix_password +``` + +Configuration variables: +- **host** (*Required*): Your Zabbix server. +- **path** (*Optional*): Path to your Zabbix install. Defaults to `/zabbix/`. +- **ssl** (*Optional*): Set to `True` if your Zabbix installation is using SSL. Default to `False`. +- **username** (*Optional*): Your Zabbix username. +- **password** (*Optional*): Your Zabbix password. + +### {% linkable_title Full configuration %} + +```yaml +# Example configuration.yaml entry +zoneminder: + host: ZABBIX_HOST + path: ZABBIX_PATH + ssl: False + username: USERNAME + password: PASSWORD +```