| 
									
										
										
										
											2020-03-27 21:41:40 +01:00
										 |  |  | Notify about health state | 
					
						
							|  |  |  | ========================= | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | [◀ Go back to main README](../README.md) | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-05-03 15:07:50 +02:00
										 |  |  | 🛈 This script can not be used on its own but requires the base installation. | 
					
						
							|  |  |  | See [main README](../README.md) for details. | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2020-03-27 21:41:40 +01:00
										 |  |  | Description | 
					
						
							|  |  |  | ----------- | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | This script is run from scheduler periodically, sending notification on | 
					
						
							|  |  |  | health related events: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * voltage jumps up or down more than configured threshold | 
					
						
							|  |  |  | * power supply failed or recovered | 
					
						
							|  |  |  | * temperature is above or below threshold | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Note that bad initial state will not trigger an event. | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Only sensors available in hardware can be checked. See what your | 
					
						
							|  |  |  | hardware supports: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     / system health print; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Requirements and installation | 
					
						
							|  |  |  | ----------------------------- | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Just install the script and create a scheduler: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  |     $ScriptInstallUpdate check-health; | 
					
						
							|  |  |  |     / system scheduler add interval=1m name=check-health on-event="/ system script run check-health;" start-time=startup; | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | Configuration | 
					
						
							|  |  |  | ------------- | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | The configuration goes to `global-config-overlay`, These are the parameters: | 
					
						
							|  |  |  | 
 | 
					
						
							|  |  |  | * `CheckHealthTemperature`: an array specifying temperature thresholds for sensors | 
					
						
							|  |  |  | * `CheckHealthVoltagePercent`: percentage value to trigger voltage jumps | 
					
						
							|  |  |  | 
 | 
					
						
							| 
									
										
										
										
											2021-05-28 17:30:37 +02:00
										 |  |  | Also notification settings are required for e-mail, matrix and/or telegram. | 
					
						
							| 
									
										
										
										
											2020-03-27 21:41:40 +01:00
										 |  |  | 
 | 
					
						
							|  |  |  | --- | 
					
						
							|  |  |  | [◀ Go back to main README](../README.md)   | 
					
						
							|  |  |  | [▲ Go back to top](#top) |