Bernhard.Linz/mailGraph
1
0
Fork 0
mirror of https://github.com/moudsen/mailGraph synced 2025-01-30 20:01:38 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update README.md, June 29, 2023

Browse Source
This commit is contained in:
moudsen 2023-06-29 16:16:52 +02:00 committed by GitHub
parent 4b28d3f066
commit e80a2a56a3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 51 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
README.md
View File

@ -1,65 +1,24 @@
## Zabbix 6.4.x testing ##
_(2023/06/29)_
Zabbix 6.4.x verification is in progress. Required intermediate release to fix one major issue (Zabbix login parameters deprecation) and some minor coding updates.
Expect to continue with automatic configuration within the next 2 months.
## Zabbix 6.2.x testing ##
_(2022/10/10)_
Testing completed. No immediate issues found.
_(2022/08/22)_
Zabbix 6.2.x testing is in progress. Once completed the next effort will be to deliver on automatic configuration detection and automatic updates.
## Major rework announcement
_(2022/03/16)_
Testing on Zabbix 6.0.2 LTS has been suvccesfully completed in one of my production level environments. Updating Wiki and other documentation on on short notice.
_(2022/02/22)_
Testing on Zabbix 6.0 LTS is in progress. If successful documentatione will be updated accordingly.
At the same time the provisioned auto configuration/installation tool for mailGraph will be introduced (also including an auto-update function).
_(2021/12/16)_
I've decided to take v2.0 forward through a series of code rewrites to facilitate some requests and to start with the code separation for obtaining Graphs through stand-alone code.
Also looking at the "Zabbix Web Agent" possibilities recently added to Zabbix 5.4 at the same time. Still no clue why Zabbix does not also move the Graph generation into such module and to provision an API on it ...
## Major changes to the code due to Zabbix 5.4+ recode by Zabbix team(2021/12/16)
A major change was required to deal with some API changes found in Zabbix 5.4+.
- itemId is no longer passed by default by Zabbix. As a result the itemId is now picked up from the Trigger information (itemId from the first element in "functions").
- Some parameters moved under "params" in JSON.
- Care is taken about Some (unneccessry) warnings and index errors due to lack of testing of information available.
To upgrade from v1.x to v2.00 you only have to replace mailGraph.php. No changes made to other files in this release.
## IMPORTANT NOTE ##
As a result of a major functional change in Zabbix 5.4 (Screens no longer exist and are all moved into Dashboards) the mailGraph.screen macro no longer functions under Zabbix 5.4+. A code rewrite is in progress to deal with detecting the Zabbix version and to pick dashboard.get instead of screen.get as a source list for the graphs that should be included in the mail message.
## Minor bugfixes to the code (2021/10/06)
Code improvements to prevent possible errors leading into a non-functional mailGraph ... (typical error within log or Zabbix: "json error").
Please inform me (raise an issue) in case you have PHP related errors in your logs - this should no longer be the case with v1.31.
## mailGraph (v2.02)
Zabbix Media module and scripts for sending e-mail alerts with graphs.
**v1.x is no longer supported; please upgrade to the current v2 release**
**Please use the Wiki for information on how to install, configure and use MailGraph in Zabbix**
## UPGRADE NOTES
### v2.01
Updated: mailGraph.php
### v2.00
Updated: mailGraph.php
### v1.31
Updated: mailGraph.php
### v1.29
Updated: mailGraph.php
### v1.27
If you upgrade to v1.27 please be aware of the additional features for adding Tags to Trigger and Host to add additional graphs and the associated `html.template` updates that come alone with it (otherwise the new graphs will not show ...).
### v1.25 and higher
Template data provisioning and code has fundamentally changed. If you upgrade from an earlier version as v1.25, make sure you understand the changes in templates/html.template (now making use of arrays for lists of items).
## Example message
The below message is just an example of what MailGraph is capable of. The template engine ("Twig") allows for a fully customized message creation to your needs! It is also possible to add more Zabbix fields. If you need additional fields just raise an issue ticket and ask and I'll see what I can do.