You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+8-4
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ The Process Watchdog is a Linux-based utility designed to start, monitor and man
11
11
## Overview
12
12
This application acts as a vigilant guardian for your critical processes, ensuring they remain operational at all times. It accomplishes this task by regularly monitoring the specified processes and taking appropriate actions if any anomalies are detected. The primary function of this application is to ensure that the managed processes remain active, restarting them if they crash or stop sending heartbeat messages.
13
13
14
-
This application is particularly useful in environments where multiple processes need to be constantly running, such as server systems, clouds or embedded devices. It operates based on the principle that each monitored process should periodically send heartbeat messages. If a process fails to send a heartbeat within the specified time interval, the watchdog manager assumes the process has halted/hang and automatically restarts it.
14
+
This application is particularly useful in environments where multiple processes need to be constantly running, such as server systems, clouds or embedded devices. It operates based on the principle that each monitored process should periodically send heartbeat messages. If a process fails to send a heartbeat within the specified time interval, the watchdog manager assumes the process has halted/hang and automatically restarts it. However there is also support for non-heartbeat sending processes.
15
15
16
16
## Features
17
17
- Starts and monitors specified processes listed in a configuration file.
@@ -22,9 +22,13 @@ This application is particularly useful in environments where multiple processes
22
22
- Generates statistics log files to track the status and history of each managed process.
23
23
24
24
## Requirements
25
-
- Processes managed by Process Watchdog must periodically send their heartbeat messages to prevent being restarted.
25
+
-If `heartbeat_interval > 0` : Processes managed by Process Watchdog must periodically send their heartbeat messages to prevent being restarted.
26
26
- Configuration file `config.ini` in the same directory with details about the processes to be managed and the UDP port for communication.
27
27
28
+
## Non-heartbeat sending processes
29
+
Process Watchdog is also supports non-heartbeat sending processes.
30
+
Set the `heartbeat_interval` config to zero to skip heartbeat checks for given processes.
31
+
28
32
## Configuration File : `config.ini`
29
33
An example configuration file looks like this:
30
34
@@ -64,11 +68,11 @@ n_apps = 4
64
68
-`name` : Name of the application.
65
69
-`start_delay` : Delay in seconds before starting the application.
66
70
-`heartbeat_delay` : Time in seconds to wait before expecting a heartbeat from the application.
67
-
-`heartbeat_interval` : Maximum time period in seconds between heartbeats.
71
+
-`heartbeat_interval` : Maximum time period in seconds between heartbeats (`0`:disables heartbeat checks).
68
72
-`cmd` : Command to start the application.
69
73
70
74
## Heartbeat Message
71
-
A heartbeat message is a UDP packet with the process ID (`PID`) prefixed by `p` (e.g., `p12345` for PID `12345`). It is sent periodically by every managed process to a specified UDP port.
75
+
For heartbeat sending processes : A heartbeat message is a UDP packet with the process ID (`PID`) prefixed by `p` (e.g., `p12345` for PID `12345`). It is sent periodically by every managed process to a specified UDP port.
72
76
73
77
Below are example heartbeat message codes in various languages:
0 commit comments