Skip to content

Commit 874de1c

Browse files
committed
Added some documentation
1 parent e86550c commit 874de1c

File tree

3 files changed

+35
-1
lines changed

3 files changed

+35
-1
lines changed

README.md

Lines changed: 35 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,38 @@ With this command you can setup a notification for PRTG
77

88
```
99
PRTGNotificationHomeAssistant.exe --key "long generated key" -u "http://homeassisanturl" -l "light.noc" -c %colorofstate -s %sensorid
10-
```
10+
```
11+
12+
Setup PRTG
13+
- First create a notification Template
14+
- Sign in to PRTG
15+
- Goto setup -> account settings -> Notification Templates
16+
- Create a new template with the following settings:
17+
- Basic Settings
18+
- Template Name (something meaningfull for you)
19+
- Status: Started
20+
- Notification Summarization
21+
- Method: Always notify ASAP, never summarize
22+
- Enable Execute Program
23+
- Program File: Select PRTGNotificationHomeAssistant.bat
24+
- Parameters: --key "KEY" -u "HASS URL" -l "LIGHT" -c "%colorofstate" -s %sensorid
25+
- the KEY is set in Home Assistant
26+
- the HASS URL is the plain URL of you Home Assistant
27+
- the LIGHT is the entity_id of you light (or Hue group) that should react on the notification
28+
- %colorofstate is a PRTG variable (please don't change)
29+
- %sensorid is a PRTG variable (please don't change)
30+
- now click Save
31+
- then you will have something like: ![Settings](https://raw.githubusercontent.com/jaydouble/PRTGNotificationHomeAssistant/master/doc/notification%20settings.png "PRTG Notification Settings")
32+
- then set the notification trigger
33+
- Sign in to PRTG
34+
- Goto Devices -> Notification Triggers
35+
- Creating a trigger use the settings:
36+
- When sensor state is Down for at least 0 seconds, perform (You beautifull naming of the template you created)
37+
- When sensor state is Down for at least 300 seconds, perform (You beautifull naming of the template you created) and repeat every 0 minutes
38+
- When sensor leaves Down state after a notification was triggered, perform (You beautifull naming of the template you created)
39+
- repeat this for
40+
- Warning
41+
- Unusual
42+
- Unknown
43+
- Up
44+
- and you will have something like: ![Triggers](https://raw.githubusercontent.com/jaydouble/PRTGNotificationHomeAssistant/master/doc/notification%20triggers.png "PRTG Notification Truggers")

doc/notification settings.png

39 KB
Loading

doc/notification triggers.png

190 KB
Loading

0 commit comments

Comments
 (0)