mirror of
https://github.com/moudsen/mailGraph
synced 2025-10-28 16:17:39 +01:00
Compare commits
56 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
88862f69eb | ||
|
|
b31f686e24 | ||
|
|
bf7927a0c3 | ||
|
|
b43611588a | ||
|
|
b1f635ab36 | ||
|
|
dce6f57876 | ||
|
|
74e8a79e4c | ||
|
|
ba3e860fe0 | ||
|
|
2045601eca | ||
|
|
5f49628b8a | ||
|
|
a069dfa99d | ||
|
|
2c2561149a | ||
|
|
0847513eae | ||
|
|
62a3ee6149 | ||
|
|
a7196f8bc5 | ||
|
|
ededded428 | ||
|
|
624ce29a39 | ||
|
|
16729e0720 | ||
|
|
97dba8f197 | ||
|
|
288b0adaf7 | ||
|
|
2859d427f7 | ||
|
|
0cd169a9d2 | ||
|
|
8269195795 | ||
|
|
6da6da77fb | ||
|
|
00a67cbb65 | ||
|
|
bf970029ea | ||
|
|
9f3bfb5c69 | ||
|
|
504422f452 | ||
|
|
3ef16ae597 | ||
|
|
a597ce6ab3 | ||
|
|
a04050c3bc | ||
|
|
b81414e06d | ||
|
|
accb8f40d6 | ||
|
|
bf5bbcb778 | ||
|
|
702725e5f7 | ||
|
|
0725e01bc0 | ||
|
|
a8858784a5 | ||
|
|
39ada5d6ff | ||
|
|
32b8582757 | ||
|
|
9c42ee4b89 | ||
|
|
fa7fba040a | ||
|
|
3a4a7ab23e | ||
|
|
7075b40ad1 | ||
|
|
8bc476ed63 | ||
|
|
e80a2a56a3 | ||
|
|
4b28d3f066 | ||
|
|
93535d4006 | ||
|
|
b9622da72f | ||
|
|
56fb68ae9c | ||
|
|
fa51c3e59e | ||
|
|
4ae62b3a1f | ||
|
|
0731b87d44 | ||
|
|
bdf4b05a6b | ||
|
|
df16444665 | ||
|
|
bccd134523 | ||
|
|
27c1d64511 |
51
README.md
51
README.md
@@ -1,27 +1,42 @@
|
|||||||
## Minor bugfixes to the code (2021/10/06)
|
## Introduction ##
|
||||||
Code improvements to prevent possible errors leading into a non-functional mailGraph ... (typical error within log or Zabbix: "json error").
|
Over the years I've been using Zabbix as both personal and business solution for monitoring. One of the missing features in Zabbix itself was the ability to have graphs generated and associated to monitoring messages as well as an easy way to jump back into Zabbix when searching for monitoring information for specific events, problems or to have a direct link to the associated Zabbix item or host.
|
||||||
|
|
||||||
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.
|
This initiated the development of mailGraph v1 in Zabbix 5.4 delivering an elementary solution for sending HTML enriched messages from Zabbix including graphs.
|
||||||
|
To facilitate in a very flexible way to setup and format messages including the graphs, Twig made its introduction towards mailGraph v2, the current release branch of mailGraph.
|
||||||
|
|
||||||
## mailGraph (v1.31)
|
The below message is just an example of what MailGraph is capable of. The template engine in Twig allows for a fully customized message creation to your needs! It is also possible to add more Zabbix fields as any field is passed to Twig when accessible in Zabbix through the macro mechanism.
|
||||||
Zabbix Media module and scripts for sending e-mail alerts with graphs.
|
|
||||||
|
|
||||||
**Please use the Wiki for information on how to install, configure and use MailGraph in Zabbix**
|
Note that all Zabbix host, item or screen related information is made available to Twig automatically.
|
||||||
|
|
||||||
## UPGRADE NOTES
|
Example message:
|
||||||
### v1.31
|
|
||||||
Updated: mailGraph.pgp - Bugfixes and c
|
|
||||||
|
|
||||||
### v1.29
|

|
||||||
Updated: mailGraph.php
|
|
||||||
|
|
||||||
### v1.27
|
mailGraph is capable of adding several series of graphs into a single message delivering a unique experience when and how groups of graph images per the requested periods of time are added.
|
||||||
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 ...).
|
Currently mailGraph supports hosts, (one or more related) items and screens (applicable to Zabbix 5.4 only).
|
||||||
|
|
||||||
### v1.25 and higher
|
More information can be found in the Wiki.
|
||||||
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
|
## Installation ##
|
||||||
The below message is just an example of what MailGraph is capable of. The template engine used ("Twig") allows for a fully customized message creation to your needs!
|
Please refer to the Wiki how to get mailGraph installed and configured on your system.
|
||||||
|
|
||||||
[](images/Example-mail-message-v122.png)
|
## Announcement - Zabbix 5.x maintenance for mailGraph end-of-life - mailGraph 3.x development in progress ##
|
||||||
|
_(2023/11/01)_
|
||||||
|
|
||||||
|
As per November 2023 the maintenance on mailGraph v2.x for Zabbix 5.x will stop in conjunction with the Zabbix lifecycle policy (https://www.zabbix.com/life_cycle_and_release_policy) as Zabbix 5 is nearing it's end of life.
|
||||||
|
|
||||||
|
In conjunction mailGraph v2.x is now frozen and I'm setting up a roadmap for mailGraph v3.x starting new development in Alfa mode as November 2023. This new code is not expected to be published until start of 2024.
|
||||||
|
|
||||||
|
Principal bug fixing on mailGraph v2.x (logic failure or similar) will continue but only for Zabbix 6.x onwards.
|
||||||
|
|
||||||
|
I'm open to new feature requests - please raise an issue for this in this Github space.
|
||||||
|
|
||||||
|
## Special thank you ##
|
||||||
|
I would like to express my gratitude to the following people that have actively contributed to bring bugs and improvements to my attention:
|
||||||
|
- [pqvindesland](https://github.com/pqvindesland)
|
||||||
|
- [BernardLinz](https://github.com/BernhardLinz)
|
||||||
|
- [WMP](https://github.com/WMP)
|
||||||
|
- [dima-online](https://github.com/dima-online)
|
||||||
|
|
||||||
|
## IMPORTANT NOTE for users of mailGraph v2 and older and Zabbix versions under 6.0 ##
|
||||||
|
As per November 2023, mailGraph is no longer maintained for Zabbix 5 and older.
|
||||||
|
|||||||
@@ -1,7 +1,5 @@
|
|||||||
{
|
{
|
||||||
"script_baseurl": "https:\/\/mydomain.com\/",
|
"script_baseurl": "https:\/\/mydomain.com\/",
|
||||||
"cli_itemId": 0,
|
|
||||||
"cli_triggerId": 0,
|
|
||||||
"cli_eventId": 0,
|
"cli_eventId": 0,
|
||||||
"cli_duration": 0,
|
"cli_duration": 0,
|
||||||
"cli_recipient": "recipient@mydomain.com",
|
"cli_recipient": "recipient@mydomain.com",
|
||||||
@@ -15,14 +13,19 @@
|
|||||||
"zabbix_user_pwd": "astrongpassword",
|
"zabbix_user_pwd": "astrongpassword",
|
||||||
"zabbix_api_user": "alogicalusername",
|
"zabbix_api_user": "alogicalusername",
|
||||||
"zabbix_api_pwd": "astrongpassword",
|
"zabbix_api_pwd": "astrongpassword",
|
||||||
"mail_from": "sender@mydomain.com",
|
|
||||||
"subject": "{{ HOST_NAME|raw }}: ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
|
"subject": "{{ HOST_NAME|raw }}: ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
|
||||||
"smtp_server": "localhost",
|
"smtp_server": "localhost",
|
||||||
"smtp_port": 25,
|
"smtp_port": 25,
|
||||||
"smtp_transport": "none",
|
"smtp_security": "none",
|
||||||
"smtp_strict": "yes",
|
"smtp_strict": "yes",
|
||||||
|
"smtp_from_address": "mailgraph@mydomain.com",
|
||||||
|
"smtp_from_name": "mailGraph",
|
||||||
|
"smtp_reply_address": "feedback@mydomain.com",
|
||||||
|
"smtp_reply_name": "mailGraph response mailbox",
|
||||||
"graph_match": "any",
|
"graph_match": "any",
|
||||||
"period": "20m",
|
"period": "20m",
|
||||||
"period_header": "Last 20 minutes",
|
"period_header": "Last 20 minutes",
|
||||||
|
"retention_images": 7,
|
||||||
|
"retention_logs": 14,
|
||||||
"debug": 0
|
"debug": 0
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,7 +1,5 @@
|
|||||||
{
|
{
|
||||||
"script_baseurl": "https:\/\/mydomain.com\/",
|
"script_baseurl": "https:\/\/mydomain.com\/",
|
||||||
"cli_itemId": 0,
|
|
||||||
"cli_triggerId": 0,
|
|
||||||
"cli_eventId": 0,
|
"cli_eventId": 0,
|
||||||
"cli_duration": 0,
|
"cli_duration": 0,
|
||||||
"cli_recipient": "recipient@mydomain.com",
|
"cli_recipient": "recipient@mydomain.com",
|
||||||
@@ -15,12 +13,15 @@
|
|||||||
"zabbix_user_pwd": "astrongpassword",
|
"zabbix_user_pwd": "astrongpassword",
|
||||||
"zabbix_api_user": "alogicalusername",
|
"zabbix_api_user": "alogicalusername",
|
||||||
"zabbix_api_pwd": "astrongpassword",
|
"zabbix_api_pwd": "astrongpassword",
|
||||||
"mail_from": "sender@mydomain.com",
|
|
||||||
"subject": "{{ HOST_NAME|raw }}: ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
|
"subject": "{{ HOST_NAME|raw }}: ({{ EVENT_SEVERITY }}) {{ EVENT_NAME|raw }}",
|
||||||
"smtp_server": "localhost",
|
"smtp_server": "localhost",
|
||||||
"smtp_port": 25,
|
"smtp_port": 25,
|
||||||
"smtp_transport": "none",
|
"smtp_security": "none",
|
||||||
"smtp_strict": "yes",
|
"smtp_strict": "yes",
|
||||||
|
"smtp_from_address": "mailgraph@mydomain.com",
|
||||||
|
"smtp_from_name": "mailGraph",
|
||||||
|
"smtp_reply_address": "feedback@mydomain.com",
|
||||||
|
"smtp_reply_name": "mailGraph response mailbox",
|
||||||
"graph_match": "any",
|
"graph_match": "any",
|
||||||
"periods": "10m,4h,2d,7d",
|
"periods": "10m,4h,2d,7d",
|
||||||
"periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
|
"periods_headers": "Last 10 minutes,Last 4 hours,Last 2 days,Last 7 days",
|
||||||
|
|||||||
BIN
images/Screenshot 2023-08-18 110118.png
Normal file
BIN
images/Screenshot 2023-08-18 110118.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 115 KiB |
1
javascript/READ.ME
Normal file
1
javascript/READ.ME
Normal file
@@ -0,0 +1 @@
|
|||||||
|
Issue #32 has been resolved. The javascript code now works for Zabbix 5.4, 6.0 LTS and 6.4.
|
||||||
@@ -1,7 +1,19 @@
|
|||||||
|
// mailGraph v2.16
|
||||||
|
|
||||||
|
// Function to test string
|
||||||
|
function isJSON(str) {
|
||||||
|
try {
|
||||||
|
JSON.stringify(JSON.parse(str));
|
||||||
|
return true;
|
||||||
|
} catch (e) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
try {
|
try {
|
||||||
// Pickup parameters
|
// Pickup parameters
|
||||||
params = JSON.parse(value),
|
params = JSON.parse(value),
|
||||||
req = new CurlHttpRequest(),
|
req = new HttpRequest(),
|
||||||
fields = {},
|
fields = {},
|
||||||
resp = '',
|
resp = '',
|
||||||
result = { tags: {} };
|
result = { tags: {} };
|
||||||
@@ -13,14 +25,18 @@ try {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Declare output type
|
// Declare output type
|
||||||
req.AddHeader('Content-Type: application/json');
|
req.addHeader('Content-Type: application/json');
|
||||||
|
|
||||||
// Must have fields
|
// Pick up fields relevant for mailGraph API level call while parsing/casting fields that should be integer
|
||||||
fields.itemId = params.itemId;
|
fields.itemId = params.itemId * 1;
|
||||||
fields.eventId = params.eventId;
|
fields.eventId = params.eventId * 1;
|
||||||
fields.recipient = params.recipient;
|
fields.recipient = params.recipient;
|
||||||
fields.baseURL = params.baseURL;
|
fields.baseURL = params.baseURL;
|
||||||
fields.duration = params.duration;
|
fields.duration = params.duration * 1;
|
||||||
|
|
||||||
|
if (fields.recipient.charAt(0) == '{') {
|
||||||
|
throw '[MailGraph Webhook] Please define recipient for the test message!';
|
||||||
|
}
|
||||||
|
|
||||||
// Optional fields
|
// Optional fields
|
||||||
if (typeof params.graphWidth === 'string') { fields.graphWidth = params.graphWidth; }
|
if (typeof params.graphWidth === 'string') { fields.graphWidth = params.graphWidth; }
|
||||||
@@ -40,22 +56,44 @@ try {
|
|||||||
|
|
||||||
// Post information to the processing script
|
// Post information to the processing script
|
||||||
Zabbix.Log(4, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
|
Zabbix.Log(4, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
|
||||||
var resp = req.Post(params.URL,JSON.stringify(fields));
|
var resp = req.post(params.URL,JSON.stringify(fields));
|
||||||
Zabbix.Log(4, '[Mailgraph Webhook] Receiving response:' + resp);
|
Zabbix.Log(4, '[Mailgraph Webhook] Received response:' + resp);
|
||||||
|
|
||||||
// If there was an error, report it
|
// The response can be
|
||||||
if (req.Status() != 200) { throw JSON.parse(resp).errors[0]; }
|
// - did not receive status 200 as result (contains HTTP server response)
|
||||||
|
// - null (no response received at all)
|
||||||
|
// - empty string (likely no e-mail sent due to recipient issue)
|
||||||
|
// - not json (debugging message for troubleshooting or configuration hints)
|
||||||
|
// - json (contains the mail message ID sent)
|
||||||
|
|
||||||
// We expect the message id back from the processing script
|
if (req.getStatus() != 200) {
|
||||||
resp = JSON.parse(resp);
|
throw '[MailGraph Webhook] Processing of mailGraph.php failed: ' + resp;
|
||||||
result.tags.__message_id = resp.messageId;
|
}
|
||||||
|
if (resp==null) {
|
||||||
|
throw '[MailGraph Webhook] No response received from mailGraph.php? This should not occur (check URL and your webserver!)';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (resp=='') {
|
||||||
|
throw '[MailGraph Webhook] No data received from mailGraph - please check recipient address or mailGraph log and retry.';
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check if JSON was returned
|
||||||
|
if (!isJSON(resp)) {
|
||||||
|
throw '[MailGraph Webhook] An error has occurred during processing: ' + resp;
|
||||||
|
}
|
||||||
|
|
||||||
|
// We expect the message id back from the processing script response in JSON format
|
||||||
|
msg = JSON.parse(resp);
|
||||||
|
|
||||||
|
result.tags.__message_id = msg.messageId;
|
||||||
|
Zabbix.Log(4, '[MailGraph Webhook] Message sent with identification "' + msg.messageId + '"');
|
||||||
|
|
||||||
// Pass the result back to Zabbix
|
// Pass the result back to Zabbix
|
||||||
return JSON.stringify(result);
|
return JSON.stringify(result);
|
||||||
}
|
}
|
||||||
catch (error)
|
catch (error)
|
||||||
{
|
{
|
||||||
// In case something went wrong in the processing, pass the error back to Zabbix
|
// In case something else went wrong in the processing, pass the error back to Zabbix
|
||||||
Zabbix.Log(127, 'MailGraph notification failed: '+error);
|
Zabbix.Log(127, 'MailGraph notification failed: '+error);
|
||||||
throw 'MailGraph notification failed : '+error;
|
throw 'MailGraph notification failed : '+error;
|
||||||
}
|
}
|
||||||
|
|||||||
701
mailGraph.php
701
mailGraph.php
File diff suppressed because it is too large
Load Diff
245
mailGraph.xml
245
mailGraph.xml
@@ -1,7 +1,7 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
<zabbix_export>
|
<zabbix_export>
|
||||||
<version>5.0</version>
|
<version>5.4</version>
|
||||||
<date>2021-03-17T12:55:43Z</date>
|
<date>2023-08-16T20:38:38Z</date>
|
||||||
<media_types>
|
<media_types>
|
||||||
<media_type>
|
<media_type>
|
||||||
<name>MailGraph</name>
|
<name>MailGraph</name>
|
||||||
@@ -9,7 +9,7 @@
|
|||||||
<parameters>
|
<parameters>
|
||||||
<parameter>
|
<parameter>
|
||||||
<name>baseURL</name>
|
<name>baseURL</name>
|
||||||
<value>https://mydomain.com/zabbix/</value>
|
<value>https://myzabbix.com/zabbix/</value>
|
||||||
</parameter>
|
</parameter>
|
||||||
<parameter>
|
<parameter>
|
||||||
<name>duration</name>
|
<name>duration</name>
|
||||||
@@ -35,10 +35,6 @@
|
|||||||
<name>infoTest</name>
|
<name>infoTest</name>
|
||||||
<value>Test</value>
|
<value>Test</value>
|
||||||
</parameter>
|
</parameter>
|
||||||
<parameter>
|
|
||||||
<name>itemId</name>
|
|
||||||
<value>{ITEM.ID}</value>
|
|
||||||
</parameter>
|
|
||||||
<parameter>
|
<parameter>
|
||||||
<name>periods</name>
|
<name>periods</name>
|
||||||
<value>10m,4h,1d,7d</value>
|
<value>10m,4h,1d,7d</value>
|
||||||
@@ -61,128 +57,157 @@
|
|||||||
</parameter>
|
</parameter>
|
||||||
<parameter>
|
<parameter>
|
||||||
<name>URL</name>
|
<name>URL</name>
|
||||||
<value>https://mydomain.com/mailGraph.php</value>
|
<value>https://myzabbix.com/mailGraph.php</value>
|
||||||
</parameter>
|
</parameter>
|
||||||
</parameters>
|
</parameters>
|
||||||
<script>try {
|
<script>// mailGraph v2.16
|
||||||
// Pickup parameters
|
|
||||||
params = JSON.parse(value),
|
// Function to test string
|
||||||
req = new CurlHttpRequest(),
|
function isJSON(str) {
|
||||||
fields = {},
|
try {
|
||||||
resp = '',
|
JSON.stringify(JSON.parse(str));
|
||||||
result = { tags: {} };
|
return true;
|
||||||
|
} catch (e) {
|
||||||
// Set HTTP proxy if required
|
return false;
|
||||||
if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') {
|
}
|
||||||
req.setProxy(params.HTTPProxy);
|
}
|
||||||
fields.HTTPProxy = params.HTTPProxy;
|
|
||||||
}
|
try {
|
||||||
|
// Pickup parameters
|
||||||
// Declare output type
|
params = JSON.parse(value),
|
||||||
req.AddHeader('Content-Type: application/json');
|
req = new HttpRequest(),
|
||||||
|
fields = {},
|
||||||
// Must have fields
|
resp = '',
|
||||||
fields.itemId = params.itemId;
|
result = { tags: {} };
|
||||||
fields.eventId = params.eventId;
|
|
||||||
fields.recipient = params.recipient;
|
// Set HTTP proxy if required
|
||||||
fields.baseURL = params.baseURL;
|
if (typeof params.HTTPProxy === 'string' && params.HTTPProxy.trim() !== '') {
|
||||||
fields.duration = params.duration;
|
req.setProxy(params.HTTPProxy);
|
||||||
|
fields.HTTPProxy = params.HTTPProxy;
|
||||||
// Optional fields
|
}
|
||||||
if (typeof params.graphWidth === 'string') { fields.graphWidth = params.graphWidth; }
|
|
||||||
if (typeof params.graphHeight === 'string') { fields.graphHeight = params.graphHeight; }
|
// Declare output type
|
||||||
if (typeof params.subject === 'string') { fields.subject = params.subject; }
|
req.addHeader('Content-Type: application/json');
|
||||||
if (typeof params.showLegend === 'string') { fields.showLegend = params.showLegend; }
|
|
||||||
if (typeof params.periods === 'string') { fields.periods = params.periods; }
|
// Pick up fields relevant for mailGraph API level call while parsing/casting fields that should be integer
|
||||||
if (typeof params.periods_headers === 'string') { fields.periods_headers = params.periods_headers; }
|
fields.itemId = params.itemId * 1;
|
||||||
if (typeof params.debug === 'string') { fields.debug = params.debug; }
|
fields.eventId = params.eventId * 1;
|
||||||
|
fields.recipient = params.recipient;
|
||||||
// Add generic fields
|
fields.baseURL = params.baseURL;
|
||||||
Object.keys(params).forEach(function(key) {
|
fields.duration = params.duration * 1;
|
||||||
if (key.substring(0, 4) == 'info') {
|
|
||||||
fields[key] = params[key];
|
if (fields.recipient.charAt(0) == '{') {
|
||||||
}
|
throw '[MailGraph Webhook] Please define recipient for the test message!';
|
||||||
});
|
}
|
||||||
|
|
||||||
// Post information to the processing script
|
// Optional fields
|
||||||
Zabbix.Log(4, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
|
if (typeof params.graphWidth === 'string') { fields.graphWidth = params.graphWidth; }
|
||||||
var resp = req.Post(params.URL,JSON.stringify(fields));
|
if (typeof params.graphHeight === 'string') { fields.graphHeight = params.graphHeight; }
|
||||||
Zabbix.Log(4, '[Mailgraph Webhook] Receiving response:' + resp);
|
if (typeof params.subject === 'string') { fields.subject = params.subject; }
|
||||||
|
if (typeof params.showLegend === 'string') { fields.showLegend = params.showLegend; }
|
||||||
// If there was an error, report it
|
if (typeof params.periods === 'string') { fields.periods = params.periods; }
|
||||||
if (req.Status() != 200) { throw JSON.parse(resp).errors[0]; }
|
if (typeof params.periods_headers === 'string') { fields.periods_headers = params.periods_headers; }
|
||||||
|
if (typeof params.debug === 'string') { fields.debug = params.debug; }
|
||||||
// We expect the message id back from the processing script
|
|
||||||
resp = JSON.parse(resp);
|
// Add generic fields
|
||||||
result.tags.__message_id = resp.messageId;
|
Object.keys(params).forEach(function(key) {
|
||||||
|
if (key.substring(0, 4) == 'info') {
|
||||||
// Pass the result back to Zabbix
|
fields[key] = params[key];
|
||||||
return JSON.stringify(result);
|
}
|
||||||
}
|
});
|
||||||
catch (error)
|
|
||||||
{
|
// Post information to the processing script
|
||||||
// In case something went wrong in the processing, pass the error back to Zabbix
|
Zabbix.Log(4, '[MailGraph Webhook] Sending request: ' + params.URL + '?' + JSON.stringify(fields));
|
||||||
Zabbix.Log(127, 'MailGraph notification failed : '+error);
|
var resp = req.post(params.URL,JSON.stringify(fields));
|
||||||
throw 'MailGraph notification failed : '+error;
|
Zabbix.Log(4, '[Mailgraph Webhook] Received response:' + resp);
|
||||||
|
|
||||||
|
// The response can be
|
||||||
|
// - did not receive status 200 as result (contains HTTP server response)
|
||||||
|
// - null (no response received at all)
|
||||||
|
// - empty string (likely no e-mail sent due to recipient issue)
|
||||||
|
// - not json (debugging message for troubleshooting or configuration hints)
|
||||||
|
// - json (contains the mail message ID sent)
|
||||||
|
|
||||||
|
if (req.getStatus() != 200) {
|
||||||
|
throw '[MailGraph Webhook] Processing of mailGraph.php failed: ' + resp;
|
||||||
|
}
|
||||||
|
if (resp==null) {
|
||||||
|
throw '[MailGraph Webhook] No response received from mailGraph.php? This should not occur (check URL and your webserver!)';
|
||||||
|
}
|
||||||
|
|
||||||
|
if (resp=='') {
|
||||||
|
throw '[MailGraph Webhook] No data received from mailGraph - please check recipient address or mailGraph log and retry.';
|
||||||
|
}
|
||||||
|
|
||||||
|
// Check if JSON was returned
|
||||||
|
if (!isJSON(resp)) {
|
||||||
|
throw '[MailGraph Webhook] An error has occurred during processing: ' + resp;
|
||||||
|
}
|
||||||
|
|
||||||
|
// We expect the message id back from the processing script response in JSON format
|
||||||
|
msg = JSON.parse(resp);
|
||||||
|
|
||||||
|
result.tags.__message_id = msg.messageId;
|
||||||
|
Zabbix.Log(4, '[MailGraph Webhook] Message sent with identification "' + msg.messageId + '"');
|
||||||
|
|
||||||
|
// Pass the result back to Zabbix
|
||||||
|
return JSON.stringify(result);
|
||||||
|
}
|
||||||
|
catch (error)
|
||||||
|
{
|
||||||
|
// In case something else went wrong in the processing, pass the error back to Zabbix
|
||||||
|
Zabbix.Log(127, 'MailGraph notification failed: '+error);
|
||||||
|
throw 'MailGraph notification failed : '+error;
|
||||||
}</script>
|
}</script>
|
||||||
<process_tags>YES</process_tags>
|
<process_tags>YES</process_tags>
|
||||||
<description>The "URL" must point to the location of the processing script. If a proxy is required, define "HTTPProxy" for the proxy address.
|
<description>The "URL" must point to the location of the processing script. If a proxy is required, define "HTTPProxy" for the proxy address.
|
||||||
|
|
||||||
Customization:
|
Customization:
|
||||||
- "graphWidth" and "graphWidth" can be defined for the image size
|
- "graphWidth" and "graphWidth" can be defined for the image size
|
||||||
- "showLegend" can be defined to show or hide the legend of the graph
|
- "showLegend" can be defined to show or hide the legend of the graph
|
||||||
- "subject" can be defined for a customized subject for the mail message
|
- "subject" can be defined for a customized subject for the mail message
|
||||||
- "periods" and "periods_headers" can be defined for displaying multiple periods of the same graph, or
|
- "periods" and "periods_headers" can be defined for displaying multiple periods of the same graph, or
|
||||||
- "period" and "period_header" can be defined to display a single graph
|
- "period" and "period_header" can be defined to display a single graph
|
||||||
|
|
||||||
The html.template and plain.template files can be adjusted (TWIG format).
|
The html.template and plain.template files can be adjusted (TWIG format).
|
||||||
|
|
||||||
More details are available at https://github.com/moudsen/mailGraph</description>
|
More details are available at https://github.com/moudsen/mailGraph</description>
|
||||||
<message_templates>
|
<message_templates>
|
||||||
<message_template>
|
<message_template>
|
||||||
<event_source>TRIGGERS</event_source>
|
<event_source>TRIGGERS</event_source>
|
||||||
<operation_mode>PROBLEM</operation_mode>
|
<operation_mode>PROBLEM</operation_mode>
|
||||||
<subject>Problem: {EVENT.NAME}</subject>
|
<subject>Problem: {EVENT.NAME}</subject>
|
||||||
<message>Problem started at {EVENT.TIME} on {EVENT.DATE}
|
<message>Problem started at {EVENT.TIME} on {EVENT.DATE}
|
||||||
Problem name: {EVENT.NAME}
|
Problem name: {EVENT.NAME}
|
||||||
Host: {HOST.NAME}
|
Host: {HOST.NAME}
|
||||||
Severity: {EVENT.SEVERITY}
|
Severity: {EVENT.SEVERITY}
|
||||||
Operational data: {EVENT.OPDATA}
|
Operational data: {EVENT.OPDATA}
|
||||||
Original problem ID: {EVENT.ID}
|
Original problem ID: {EVENT.ID}
|
||||||
{TRIGGER.URL}
|
Trigger ID (/url): {TRIGGER.ID} {TRIGGER.URL}</message>
|
||||||
|
|
||||||
eventId: {EVENT.ID}
|
|
||||||
TriggerId: {TRIGGER.ID}
|
|
||||||
itemId: {ITEM.ID]</message>
|
|
||||||
</message_template>
|
</message_template>
|
||||||
<message_template>
|
<message_template>
|
||||||
<event_source>TRIGGERS</event_source>
|
<event_source>TRIGGERS</event_source>
|
||||||
<operation_mode>RECOVERY</operation_mode>
|
<operation_mode>RECOVERY</operation_mode>
|
||||||
<subject>Resolved in {EVENT.DURATION}: {EVENT.NAME}</subject>
|
<subject>Resolved in {EVENT.DURATION}: {EVENT.RECOVERY.NAME}</subject>
|
||||||
<message>Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}
|
<message>Problem has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}
|
||||||
Problem name: {EVENT.NAME}
|
Problem name: {EVENT.RECOVERY.NAME}
|
||||||
Problem duration: {EVENT.DURATION}
|
Problem duration: {EVENT.DURATION}
|
||||||
Host: {HOST.NAME}
|
Host: {HOST.NAME}
|
||||||
Severity: {EVENT.SEVERITY}
|
Severity: {EVENT.SEVERITY}
|
||||||
Original problem ID: {EVENT.ID}
|
Original problem ID: {EVENT.ID}
|
||||||
{TRIGGER.URL}
|
Trigger ID: {TRIGGER.ID} {TRIGGER.URL}</message>
|
||||||
|
|
||||||
eventId: {EVENT.ID}
|
|
||||||
TriggerId: {TRIGGER.ID}
|
|
||||||
itemId: {ITEM.ID]</message>
|
|
||||||
</message_template>
|
</message_template>
|
||||||
<message_template>
|
<message_template>
|
||||||
<event_source>TRIGGERS</event_source>
|
<event_source>TRIGGERS</event_source>
|
||||||
<operation_mode>UPDATE</operation_mode>
|
<operation_mode>UPDATE</operation_mode>
|
||||||
<subject>Updated problem in {EVENT.AGE}: {EVENT.NAME}</subject>
|
<subject>Updated problem in {EVENT.AGE}: {EVENT.NAME}</subject>
|
||||||
<message>{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}.
|
<message>{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}.
|
||||||
{EVENT.UPDATE.MESSAGE}
|
{EVENT.UPDATE.MESSAGE}
|
||||||
|
|
||||||
Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}.
|
Current problem status is {EVENT.STATUS}, age is {EVENT.AGE}, acknowledged: {EVENT.ACK.STATUS}.
|
||||||
|
|
||||||
eventId: {EVENT.ID}
|
Event ID: {EVENT.ID}
|
||||||
TriggerId: {TRIGGER.ID}
|
Trigger ID: {TRIGGER.ID}</message>
|
||||||
itemId: {ITEM.ID]</message>
|
|
||||||
</message_template>
|
</message_template>
|
||||||
</message_templates>
|
</message_templates>
|
||||||
</media_type>
|
</media_type>
|
||||||
|
|||||||
@@ -81,6 +81,9 @@
|
|||||||
.content {
|
.content {
|
||||||
font-size: 14px;
|
font-size: 14px;
|
||||||
}
|
}
|
||||||
|
.acknowledge {
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
</style>
|
</style>
|
||||||
</head>
|
</head>
|
||||||
<body>
|
<body>
|
||||||
@@ -112,6 +115,18 @@
|
|||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
</table>
|
</table>
|
||||||
|
{% if ACKNOWLEDGES|length > 0 %}
|
||||||
|
<br/>
|
||||||
|
{% for anAck in ACKNOWLEDGES %}
|
||||||
|
<table style="border:0; text-align:left;" cellpadding="5" cellspacing="0">
|
||||||
|
<tr>
|
||||||
|
<td class="acknowledge">
|
||||||
|
<b>{{ anAck._clock }}</b><br/><em>({{ anAck.username }}, {{ anAck.name }} {{ anAck.surname }})</em><br/>[{{ anAck._actions }}]<br/>{{ anAck.message }}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
</table>
|
||||||
|
{% endfor %}
|
||||||
|
{% endif %}
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
<tr>
|
<tr>
|
||||||
@@ -120,10 +135,12 @@
|
|||||||
Event ID: <a href="{{ EVENTDETAILS_URL }}">{{ EVENT_ID }}</a> //
|
Event ID: <a href="{{ EVENTDETAILS_URL }}">{{ EVENT_ID }}</a> //
|
||||||
Trigger ID: <a href="{{ TRIGGER_URL }}">{{ TRIGGER_ID }}</a> //
|
Trigger ID: <a href="{{ TRIGGER_URL }}">{{ TRIGGER_ID }}</a> //
|
||||||
Item ID: <a href="{{ ITEM_URL }}">{{ ITEM_ID }}</a> //
|
Item ID: <a href="{{ ITEM_URL }}">{{ ITEM_ID }}</a> //
|
||||||
Host ID: <a href="{{ HOST_URL }}">{{ HOST_ID }}</a>
|
Host ID: <a href="{{ HOST_URL }}">{{ HOST_ID }}</a> //
|
||||||
|
<a href="{{ HOST_PROBLEMS_URL }}">Problems</a>
|
||||||
{% if GRAPH_ZABBIXLINK|length > 0 %}
|
{% if GRAPH_ZABBIXLINK|length > 0 %}
|
||||||
// Graph ID: <a href="{{ GRAPH_ZABBIXLINK }}">{{ GRAPH_ID }}</a>
|
// Graph ID: <a href="{{ GRAPH_ZABBIXLINK }}">{{ GRAPH_ID }}</a>
|
||||||
{% endif %}
|
{% endif %}
|
||||||
|
// <a href="{{ ACK_URL }}">Ack</a>
|
||||||
</div>
|
</div>
|
||||||
</td>
|
</td>
|
||||||
</tr>
|
</tr>
|
||||||
|
|||||||
Reference in New Issue
Block a user