Zabbix

The Zabbix integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] is the main integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] to connect to a Zabbix monitoring instance via the Zabbix API.

It is possible to publish Home Assistant state changes to Zabbix. In Zabbix a host has to be created which will contain the Home Assistant states as individual items. These items are automatically created using Zabbix Low-Level Discovery (LLD). In order to make setup in Zabbix easy, you can use this template for the host.

There is currently also support for the following device types within Home Assistant:

Configuration

To set the Zabbix integration集成将 Home Assistant 与您的设备、服务等连接和集成。 [Learn more] up, add the following information to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后,重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# Example configuration.yaml entry
zabbix:
  host: IP_ADDRESS

Configuration Variables

host string Required

Your Zabbix server.

path string (Optional, default: /zabbix/)

Path to your Zabbix install.

ssl boolean (Optional, default: false)

Set to true if your Zabbix installation is using SSL.

username string (Optional)

Your Zabbix username.

password string (Optional)

Your Zabbix password.

publish_states_host string (Optional)

The host that will receive the state changes from Home Assistant. It needs to be manually created in Zabbix first and have the template associated with it (see above).

exclude list (Optional)

Configure which integrations should be excluded from being published to Zabbix. (Configure Filter)

entities string | list (Optional)

The list of entity ids to be excluded from being published to Zabbix.

entity_globs string | list (Optional)

Exclude all entities matching a listed pattern.

domains string | list (Optional)

The list of domains to be excluded from being published to Zabbix.

include list (Optional)

Configure which integrations should be included in being published to Zabbix. If set, all other entities will not be published to Zabbix. (Configure Filter)

entities string | list (Optional)

The list of entity ids to be included in being published to Zabbix.

entity_globs string | list (Optional)

Include all entities matching a listed pattern.

domains string | list (Optional)

The list of domains to be included in being published to Zabbix.

Full configuration

# Example configuration.yaml entry
zabbix:
  host: ZABBIX_HOST
  path: ZABBIX_PATH
  ssl: false
  username: USERNAME
  password: PASSWORD
  publish_states_host: homeassistant
  exclude:
    domains:
      - device_tracker
    entities:
      - sun.sun
      - sensor.time

Configure filter

By default, no entity will be excluded. To limit which entities are being published to Zabbix, you can use the include and exclude parameters.

# Example filter to include specified domains and exclude specified entities
zabbix:
  include:
    domains:
      - alarm_control_panel
      - light
    entity_globs:
      - binary_sensor.*_occupancy
  exclude:
    entities:
      - light.kitchen_light

Filters are applied as follows:

  1. 不使用过滤器
    • 包含所有实体
  2. 仅包含
    • 实体列表中的实体包含:include
    • 否则,实体匹配域包含:include
    • 否则,实体匹配通配符包含:include
    • 否则:排除
  3. 仅排除
    • 实体列表中的实体排除:exclude
    • 否则,实体匹配域排除:exclude
    • 否则,实体匹配通配符排除:exclude
    • 否则:包含
  4. 域和/或通配符包含(还可能有排除)
    • 实体列表中的实体包含:include
    • 否则,实体列表中的排除:exclude
    • 否则,实体匹配通配符包含:include
    • 否则,实体匹配通配符排除:exclude
    • 否则,实体匹配域包含:include
    • 否则:排除
  5. 域和/或通配符排除(没有域和/或通配符包含)
    • 实体列表中的实体包含:include
    • 否则,实体列表中的排除:exclude
    • 否则,实体匹配通配符排除:exclude
    • 否则,实体匹配域排除:exclude
    • 否则:包含
  6. 没有域和/或通配符的包含或排除
    • 实体列表中的实体包含:include
    • 否则:排除

以下字符可用于实体通配符:

* - 星号表示零个、一个或多个字符
? - 问号表示零个或一个字符

Sensor

The zabbix sensor platform let you monitor the current count of active triggers for your Zabbix monitoring instance.

Important

You must have the Zabbix integration configured to use those sensors.

To set it up, add the following information to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file:

# Example configuration.yaml entry
sensor:
  - platform: zabbix
    triggers:
      name: Important Hosts Trigger Count
      hostids: [10051,10081,10084]
      individual: true

Configuration Variables

triggers string Required

Specifies that this sensor is for Zabbix ‘triggers’. In the future there will be other Zabbix sensors.

name string (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 string (Optional)

This is a list of Zabbix hostids that we want to filter our count on.

individual boolean (Optional, default: false)

A ‘true’/‘false’ to specify whether we should show individual sensors when a list of hostids 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).