Plugins 〉Zabbix

Application
community

Zabbix

  • Overview
  • Installation
  • Change log
  • Related content

Zabbix plugin for Grafana

CircleCI Version codecov Change Log Docs Twitter URL Donate

Visualize your Zabbix metrics with the leading open source software for time series analytics.

Dashboard

Features

  • Select multiple metrics by using Regex
  • Create interactive and reusable dashboards with template variables
  • Show events on graphs with Annotations
  • Display active problems with Triggers panel
  • Transform and shape your data with metric processing functions (Avg, Median, Min, Max, Multiply, Summarize, Time shift, Alias)
  • Find problems faster with Alerting feature
  • Mix metrics from multiple data sources in the same dashboard or even graph
  • Discover and share dashboards in the official library

See all features overview and dashboards examples at Grafana-Zabbix Live demo site. Visit plugins page at grafana.com and check out available Grafana data sources, panels and dashboards.

Installation

Install by using grafana-cli

grafana-cli plugins install alexanderzobnin-zabbix-app

Or see more installation options in docs.

Getting started

First, configure Zabbix data source. Then you can create your first dashboard with step-by-step Getting started guide.

Documentation

Community Resources, Feedback, and Support

  • Found a bug? Want a new feature? Feel free to open an issue.
  • Have a question? You also can open issue, but for questions, it would be better to use Grafana Community portal.
  • Need additional support? Contact me for details alexanderzobnin@gmail.com

:copyright: 2015-2021 Alexander Zobnin alexanderzobnin@gmail.com

Licensed under the Apache 2.0 License

For more information, visit the docs on plugin installation.

Change Log

[4.2.3] - 2021-09-21

Fixed

  • Different collection intervals compatibility (stacked graph issue), #1211
  • Graph broken when trend data used, #1300
  • Zabbix API request error "EOF", #1295
  • Item tag does not accept variables, #1283
  • Failed to query data, rpc error, #1262
  • Error Cannot read property 'isZabbix54OrHigher' of undefined when creating a variable template query, #1282

[4.2.2] - 2021-08-25

Fixed

  • Different item intervals compatibility (stacked graph issue), #1211
  • Random "Failed to call resource" errors and plugin restarts, #1269
  • Top function does not work if number of series less than provided N, #1267
  • Hostnames are not displayed on multiple selection (regular expression), #1265
  • Cannot unmarshal number into Go struct field ZabbixDatasourceSettingsDTO.timeout of type string, #1254
  • sortSeries() does not sort by series name, #1274

[4.2.1] - 2021-08-10

Fixed

  • No data on queries with aggregation function
  • Wrong percentile aggregation

[4.2.0] - 2021-08-10

Added

  • Support functions on the backend (alerting with functions), #869
  • Support item tags instead of application in Zabbix 5.4, #1258

Fixed

  • Direct DB connection - No data in Grafana 8.0, #1221
  • Error when attempting to acknowledge problems in Grafana 8.0, #1239
  • Explore button in Problems view doesn't work (redirects to 404), #1240
  • Zabbix value mapping doesn't work in Grafana 8.0, #1222
  • Unable to see acknowledges if problem has tags, #1233
  • Ack button is not visible on narrow layouts, #1252

[4.1.5] - 2021-05-18

Fixed

  • Fix compatibility with Zabbix 5.4, #1188

[4.1.4] - 2021-03-09

Fixed

  • Field/Standard options/Display name stopped working in 4.1 release, #1130
  • Functions: trendsValue(sum) is not working, #935

[4.1.3] - 2021-03-05

Fixed

  • Explore: Error "Unexpected field length", #1150
  • Problems: item last value truncated text, #1145
  • Problems: minor UI bug, #1149
  • Option to disable zabbix value mapping translation in query, #1128

[4.1.2] - 2021-01-28

Fixed

  • Item ID query mode doesn't work, #1148
  • IT Services: a.round_interval is not a function, #1142
  • Problems: Text overlap between the tooltip and description boxes, #1138
  • Problems: expanded row overwritten on refresh, #1143

[4.1.1] - 2020-12-30

Fixed

  • Graphs with dependent items failed to render, #1123

[4.1.0] - 2020-12-28

Added

  • Data Frames support, #10820. This solves various issues below:
  • Use units configured in Zabbix if possible
  • Use value mappings from Zabbix
  • Align points in each series to prevent stacking graph issues
  • Fill missing points with null values, #1109
  • Problems: filter problems by time range, #1094
  • ARM build (ARM64 and ARM v6), #1028

Fixed

  • Grafana doesn't prevent from saving alerts with template variables, #1100
  • Query inspector is not working, #1097
  • Problems panel query editor issues, #988
  • Problems: unable to change severity to Not Classified, #1104
  • Problems: ack message limited to 64 characters, #1122

[4.0.2] - 2020-11-13

Fixed

  • Query mode Text returns no data for last value, #1062
  • Able to configure API request timeout, #1046
  • Support basic auth for backend requests, #1048
  • Problems: fix empty problems list when null value used as a filter
  • Problems: fix long item values displaying

[4.0.1] - 2020-09-02

Fixed

  • Plugin is not signed, #1038
  • Datasource: "Parse error Invalid JSON. An error occurred on the server while parsing the JSON text" , #1004
  • Datasource: Skip TLS Verify button does not work, #1029
  • Config: can't select Direct DB Connection in Grafana 7.1.5, #1027
  • Problems: trigger dependencies not resolved, #1024

[4.0.0] - 2020-08-25

4.0 Feature highlights

Grafana-Zabbix 4.0 comes with a bunch of changes under the hood. The most important thing introduced is a backend, which brings a number of benefits:

  • Alerting support (limited, data processing functions are not supported yet).
  • Fixed security issues related to exposing data source credentials to the Grafana frontend and storing password as a plain text in database.
  • Improved performance (plugin can cache queries and process data on the backend).
  • With improved security it makes easier to add actions (execute scripts, close problems, etc).

Installation

Prerequisites: plugin requires Grafana 7.0 to run.

Use the grafana-cli tool to install Zabbix from the commandline:

  1. grafana-cli plugins install alexanderzobnin-zabbix-app
  2. Unsigned plugins are not loading by default, so allow it in the Grafana config file:
    allow_loading_unsigned_plugins = alexanderzobnin-zabbix-datasource
    
  3. restart Grafana server

Refer to allow_loading_unsigned_plugins option description for more information.

Security

  • Zabbix credentials available for everyone who can see dashboard, #380
  • Store password encrypted, #800

Added

  • Alerting support (limited, data processing functions are not supported yet) , #801
  • Problems: execute scripts, #978
  • Problems: tooltip with problem description
  • Problems: use severity filter from panel options

Fixed

  • Problems: problems history
  • Problems: sorting by severity, #921
  • Datasource: reconnecting on request error
  • Problems: filtering by tags
  • Problems: sorting order
  • Problems: performance improvements (remove unnecessary queries)
  • Problems: empty problem list, #955
  • Problems: panel migrations when panel options is not opened (options not saved after reload)
  • Problems: item value tooltip placement

Removed

  • Old alerting feature (show heart icon on the panel), replaced by Grafana alerting

[4.0.0-alpha4] - 2020-07-21

Fixed

  • Problems: filtering by tags
  • Problems: sorting order
  • Problems: performance improvements (remove unnecessary queries)

[4.0.0-alpha3] - 2020-07-17

Fixed

  • Problems: empty problem list, #955

[4.0.0-alpha2] - 2020-06-18

Fixed

  • Problems: panel migrations when panel options is not opened (options not saved after reload)
  • Problems: item value tooltip placement

Added

  • Problems: use severity filter from panel options

Removed

  • Old alerting feature (show heart icon on the panel), replaced by Grafana alerting

[4.0.0-alpha1] - 2020-06-04

4.0 Feature highlights

Grafana-Zabbix 4.0 comes with a bunch of changes under the hood. The most important thing introduced is a backend, which brings a number of benefits:

  • Alerting support (limited, data processing functions are not supported yet).
  • Fixed security issues related to exposing data source credentials to the Grafana frontend and storing password as a plain text in database.
  • Improved performance (plugin can cache queries and process data on the backend).
  • With improved security it makes easier to add actions (execute scripts, close problems, etc).

Installation

Prerequisites: plugin requires Grafana 7.0 to run.

Version 4.0 is currently in alpha state and not published at grafana.com. In order to install it, follow these steps:

  1. Go to the GitHub releases and find latest 4.0.0 release.
  2. Download .zip package with plugin from release assets (asset name is grafana-zabbix-4.0.0-<alphaX|betaX>.zip).
  3. Unpack it and put into grafana plugins folder.
  4. Unsigned plugins are not loading by default, so allow it in config:
    allow_loading_unsigned_plugins = alexanderzobnin-zabbix-datasource
    
  5. restart Grafana server

Refer to allow_loading_unsigned_plugins option description for more information.

Security

  • Zabbix credentials available for everyone who can see dashboard, #380
  • Store password encrypted, #800

Added

  • Alerting support (limited, data processing functions are not supported yet) , #801
  • Problems: execute scripts, #978

[3.12.2] - 2020-05-28

Fixed

  • Annotations feature doesn't work, #964
  • Alias variables do not work with direct DB connection enabled, #965

[3.12.1] - 2020-05-25

Fixed

  • Problems: panel fails with error (cannot read property 'description' of undefined) , #954
  • Problems: problem name filter doesn't work, #962
  • Problems: acknowledged filter doesn't work, #961

[3.12.0] - 2020-05-21

Added

  • Variables: able to query item values, #417
  • Functions: expose host, item, app to the alias functions, #619
  • Problems: navigate to Explore and show graphs for the problem, #948
  • Problems: able to show Problems/Recent problems/History, #495
  • Problems: icon with acknowledges count, #946
  • IT Services: support SLA intervals, #885

Fixed

  • Explore doesn't work with Zabbix datasource, #888
  • SLA value is incorrect, #885
  • Graph panel randomly shows no data, #861
  • Variables: unable to edit variables in Grafana 7.0.0, #949
  • Variables: wrong variable scope inside repeated rows, #912
  • Problems: resolve macros in URLs, #190
  • Problems: unable to acknowledge resolved problem, #942
  • Problems: resolved problems color and severity set to Not classified, #909
  • Problems: can't acknowledge alert in panel with a single problem, #900
  • Annotations: ITEM.VALUE behaves like ITEM.LASTVALUE in annotations, #891
  • Alert state on the panel (heart icon) doesn't work in Grafana 6.7, #931
  • Consolidated average is not accurate with direct DB connection, #752

Changed

  • Problems panel uses new problem.get API which is not compatible with Zabbix 3.x, #495
  • Problems panel is metrics panel now, problems query editor moved to the data source.
  • Zabbix version is auto detected now, #727

[3.11.0] - 2020-03-23

Added

  • Improve variable query editor, #705
  • Transform/percentile function, #868

Fixed

  • Problems panel: stopped working in Grafana 6.7.0, #907
  • Problems panel: event severity change, #870
  • Problems panel: color is changed to acknowledged even if there is only message without acknowledgment, #857
  • Percentile function returns incorrect results, #862

[3.10.5] - 2019-12-26

Added

  • SLA over time graphs, #728
  • Additional time ranges in functions, #531

Fixed

  • Problems panel: query editor broken in Grafana 6.4, #817
  • Datasource: function editor is not working, #810
  • Datasource: cannot add a function to query from typeahead, #468
  • Datasource: annotations editor broken in Grafana 6.x, #813
  • React plugins issue, #823

[3.10.4] - 2019-08-08

Fixed

  • Problems panel: query editor broken in Grafana 6.3, #778
  • Problems panel: some heart icons are missing, #754

[3.10.3] - 2019-07-26

Fixed

  • Direct DB Connection: can't stay enabled, #731
  • Triggers query mode: count doesn't work with Singlestat, #726
  • Query editor: function editor looks odd in Grafana 6.x, #765
  • Alerting: heart icon on panels in Grafana 6.x, #715

[3.10.2] - 2019-04-23

Fixed

  • Direct DB Connection: provisioned datasource fails to load, #711
  • Functions: sumSeries doesn't work in couple with other aggregation functions, #530
  • Problems panel: performance and memory issues, #720 , #712
  • Problems panel: hide acknowledge button for read-only users, #722
  • Problems panel: "no data" overlaps table header when font size increased, #717
  • Problems panel: problem description does not resize problem bar, #704
  • Triggers query mode: problems not filtered by selected groups, #709

[3.10.1] - 2019-03-05

Fixed

  • Problems panel: unable to edit panel in Grafana 6.0, #685
  • Problems panel: datasource selector is empty, #692
  • Problems panel: "acknowledged" filter doesn't work correctly, #678 #691
  • Problems panel: acknowledged color isn't working, #676
  • Problems panel: highlight background doesn't work correctly for resolved events in List view, #681
  • Problems panel: duplicated page size entries, #696
  • Direct DB Connection: unable to get trends data from InfluxDB, #675
  • Annotations are not displayed when time set to a full day/week/month, #680
  • Datasource provisioning with direct DB connection enabled failed #688
  • Functions: offset function returns NaN in singlestat panel, #683
  • Functions: median() doesn't correspond to aggregateBy(median) , #690
  • Docs: add warnings about installation methods, #693

[3.10.0] - 2019-02-14

Added

  • Table-like layout for Problems (former Triggers) panel, #673
  • Problems panel: able to show last problems from dashboard time range, #550
  • Problems panel: filter problems by event tags, #487
  • Problems panel: option for displaying groups and proxy, #418
  • Support InfluxDB as Direct DB Connection datasource, #640, collaboration with Gleb Ivanovsky aka @i-ky
  • Support datasource provisioning with direct DB connection enabled, #614
  • Functions: offset function, #387, thanks to @drakosha
  • Functions: removeAboveValue, removeBelowValue, transformNull functions, #562, thanks to @gelonsoft

Fixed

  • t.replace is not a function error when adding new metric, #661
  • Problems panel: error when acknowledging problems in Zabbix 4.0, #629
  • Problems panel: direct link rendered image, #605
  • Direct DB Connection: Cannot read property 'name' of null error when no series returned, #571
  • Direct DB Connection: consolidateBy(sum) does not work correctly, #603
  • Direct DB Connection: consolidateBy() affects other metrics in a panel, #602

Changed

  • Disable auto-creation of Zabbix/Linux Server dashboards (still can be imported from datasource config page) , #422
  • Use Webpack for building plugin, #632
  • dist/ folder removed from repo, installation from github repo doesn't work anymore, #693

[3.9.1] - 2018-05-02

Fixed

  • Datasource fails when "Direct DB connection" enabled #564
  • Alerting and health icons on panels #556
  • Alerting threshold error #549

[3.9.0] - 2018-03-23

Added

  • Table format support for text data #492
  • Option to enable triggers background highlighting #532
  • Option to disable acknowledges for read-only users #481

Fixed

  • Triggers panel has broken styles in Grafana 5.0 #522
  • Undefined username in acknowledges #393

[3.8.1] - 2017-12-21

Fixed

  • Triggers panel multiple targets bug (typing in one target affects other)
  • Triggers panel event source icon

[3.8.0] - 2017-12-20

Added

  • Multiple data sources support for triggers panel, #431

Changed

  • Triggers Panel fully redesigned, closed a bunch of issues: #431, #488, #299, #485, #412, #157, #483, #487, #248
  • Tests migrated to Jest

Fixed

  • Triggers panel refreshing issues
  • aggregateBy() function bug, #498

[3.7.0] - 2017-10-24

Added

  • PostgreSQL support for Direct DB Connection.
  • Triggers query mode which allows to count active alerts by group, host and application, #141
  • sortSeries() function that allows to sort multiple timeseries by name, #447, thanks to @mdorenkamp
  • percentil() function, thanks to @pedrohrf
  • Zabbix System Status example dashboard.

Changed

  • Included dashboards moved to data source. Go to the data source config to import it.

Fixed

  • Direct DB connection doesn't work with ONLY_FULL_GROUP_BY option enabled, #445
  • Application selection doesn't work, #352
  • "data points outside time range" error when there is no datapoints and aggregation function is used
  • Missed Max data points option in Grafana 4.5+
  • Missed query editor help in Grafana 4.5+
  • Alert threshold detection with <= >= = operators, thanks to @akotynski.

[3.6.1] - 2017-07-26

Fixed

  • cannot read property 'enable' of undefined error after upgrade, #436

[3.6.0] - 2017-07-26

Added

  • Direct DB Connection, which allows to use existing SQL data source for querying history data directly from Zabbix database.
  • Docs: Direct DB Connection reference and configuration.
  • consolidateBy function, which allows to specify aggregation function for time series data.
  • movingAverage and exponentialMovingAverage functions.
  • Item ID editor mode for querying items by id.

Changed

  • IT Services query editor. Now user able to select multiple services by using regex, #415

Fixed

  • Template variables support in annotations and triggers panel (trigger name field) , #428
  • Parsing of template variable query with braces, #432
  • sumSeries() function bug, #286

[3.5.1] - 2017-07-10

Fixed

  • Bug with alerting when template queries are used, #424

[3.5.0] - 2017-07-05

Added

  • rate() function, which calculates per-second rate for growing counters.
  • Benchmarks for time series functions. Used Benchmark.js library.

Changed

  • Template query format. New format is {group}{host}{app}{item}. It allows to use names with dot. Updated templating docs, #254
  • Update included dashboards. Add templated zabbix datasource and use it for all metrics.
  • Improved performance of groupBy() functions (at 6-10x faster than old).
  • Fill empty intervals by null when aggregations are used, #388

Fixed

  • Item name expanding when key contains commas in quoted params, like my_key["a=1,b=2",c,d]
  • Incorrect points order when trends are used #202
  • Triggers panel styles for light theme
  • Bug with text metrics when singlestat or table shows NaN, #325

[3.4.0] - 2017-05-17

Added

  • Alerting: highlight panel contained metrics with fired triggers.
  • Alerting: add thresholds to panels from zabbix triggers.
  • Docs: add docs for setAliasByRegex() from @v-zhuravlev
  • Support millisecond resolution on graphs. Patch from Jay Dawes ajaxous@gmail.com.
  • Sum and count aggregations.
  • Expand user macros in items #212
  • replaceAlias() function #287
  • Additional Range config option for trends #364

Changed

  • Add template variables to dropdown metric list #310
  • Add all value regex /.*/ to host dropdown.
  • Replace native map() and forEach() methods by lodash.

Fixed

  • Templatig issue when no values returned #354
  • Add host name for multiple text metrics.
  • Timeshift issue (Datapoints outside time range) for multiple targets with timeshift() , #338

[3.3.0] - 2017-02-10

Added

  • Triggers panel: allow to hide hosts in maintenance #186
  • Triggers panel: allow to change font size #351.
  • Triggers panel: table pagination #229
  • Triggers panel: add 'enable scroll' control and page size input.

Changed

  • Triggers panel: rearrange options.

Fixed

  • Grunt: fix watch task.

[3.2.1] - 2017-02-02

Added

  • Docs: add building instructions.
  • setAliasByRegex() function

Changed

  • Docs: deprecate special repo with built plugins.
  • Triggers panel: remove 'default' from datasources list (cause error), iss #340
  • Add dist/ directory to repo to correspond development guide http://docs.grafana.org/plugins/development/

Fixed

  • Triggers panel: metrics suggestion.
  • Triggers panel: event acknowledge.
  • Triggers panel: panel styles.
  • Query editor: options styles.
  • Docs: fixed timeShift() docs
  • Error for new empty panel #337
  • Checking query for variables.

[3.2.0] - 2017-02-02 [YANKED]

Added

  • timeShift() function #307