Open source Restart on Crash alternative with Sensu support
C#
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
OpenRoC
libOpenRoC
testOpenRoC
.gitignore
LICENSE
README.md

README.md

OpenRoC

Open-source Restart on Crash alternative with Sensu support.

Main Window

Main Window screenshot

Top menu bar

Add

Adds a new process to monitor. Clicking this button will open up a Process Window.

Delete

Removes selected processes in the Process list section. You may multi-select different Processes or use the CTRL key to select them individually.

Settings

Opens up OpenRoC's Settings Window.

Logs

Opens up OpenRoC's Logs Window. Logs are also stored and rotated (every 10MB) into a file named OpenRoC.log next to where you have OpenRoC.exe located.

About

Opens up OpenRoC's About Window. You may find third-party licenses and credits here.

Process list

Process column

Lists all currently monitored Processes. You may use the check mark next to a Process to disable its monitoring. In order to add a Process to this list, you can either use the Add button or you can do so by accessing the Right-click menu. Double-clicking on a Process opens up its Process Window to edit.

Status column

Reports the current state of the Process as well as the time it has spent since the last time it entered this state. States are:

  • Running: Process is running correctly and being monitored for crashes.
  • Stopped: Process is stopped (not running) and being monitored.
  • Disabled: Process is stopped and is not being monitored.

Performance graph

It shows a line-graph of the cumulative % usage of three main resources on the computer OpenRoC is running on. CPU usage (red), RAM usage (blue), and GPU usage (green) are data gathered for the past few seconds.

Bottom status bar

Shows useful tips and explanations about some highlighted UI items.

Right-click menu

You can access this menu by right-clicking anywhere in the Process column section. Following buttons are available in this menu:

  • Add: same as Add.
  • Edit: same as double clicking a Process in Process column.
  • Delete: same as Delete
  • Disable: same as using check boxes of a Process in Process column.
  • Start Process(es): sets state of a Process to running.
  • Stop Process(es): sets state of a Process to stopped.
  • Show Window(s): sets state of a Process to disabled.

Taskbar menu

You can access this menu by right-clicking on OpenRoC's icon in your task-bar while it's running.

Show/Hide

Toggles UI visibility of OpenRoC.

Exit

Quits OpenRoC.

Process Window

Process Window screenshot

Process path

  • Executable Path: path to the Process .exe. Only .exe is allowed (e.g .bat files are not allowed).
  • Working Directory: working directory of the Process. This is usually the same directory where the Process .exe is located.

Crash settings

  • Crashed if not running: Assume a Process is crashed if it's not running. If you set the initial state to running and OpenRoC sees Process is stopped, it will go into the running state.
  • Crashed if unresponsive: Some Processes may have unresponsive windows, in that case assume it is crashed and restart it.
  • Unresponsiveness time period: The number of seconds passed until OpenRoC assumes an unresponsive process is crashed.
  • Grace period: The number of seconds to wait before attempting a relaunch of a crashed Process.

Pre-start event

You can specify a script to be executed before OpenRoC attempts to start the Process again. OpenRoC will wait for the script to execute before starting the Process.

Post-stop event

You can specify a script to be executed after OpenRoC stops the Process. OpenRoC will wait for the script to execute before starting the Process. You can also opt-in for an aggressive method of stopping processes (recommended).

MISC. settings

Most options in this part are self-explanatory. Most-notably you can set the initial state of the Process after you hit Save and return to the Main Window.

Settings Window

Settings Window screenshot

Start settings

Start minimized

Enables OpenRoC to start minimized in task-bar next time it launches.

Single instance mode

Forces only one instance of OpenRoC being able to launch on this machine.

Sensu settings

Enables Sensu client socket support via UDP.