Service Watcher
What is Service Watcher?
Service Watcher is WinWraper's event log. Every time a service changes state, starting, stopping, crashing, or throwing an error, an event entry is recorded with a timestamp.
Opening Service Watcher
Click the 👁 Watcher button on the Service List toolbar.
Event types
| Event | Colour | Meaning |
|---|---|---|
| STARTING | Yellow | Service is being started |
| RUNNING | Green | Service started successfully |
| AUTO-RESTART | Amber | Waiting to restart after a crash |
| STOPPING | Orange | Service is being stopped |
| STOPPED | Grey | Service has stopped or crashed (see description) |
| ERROR | Red | Serious error (rapid exit, system error) |
| WARNING | Light yellow | Warning (non-zero exit code, unusual CPU/RAM, etc.) |
| ADD | Purple | A service was added to WinWraper |
| REMOVE | Purple-grey | A service was removed from management |
Filtering and searching
Filter by service
Use the "All services" dropdown to view the log for a specific service or all services at once.
Filter by time
Use the From / To date pickers to narrow the time range.
Search by content
Type a keyword into the Search box to show only events whose description contains that text.
💡Tip
When the Circuit Breaker trips, look for STOPPED events just before it, the description contains the exit code and uptime, telling you exactly why the service keeps crashing.
Auto Refresh
Enable Auto Refresh to have Watcher update automatically as new events arrive, like watching logs in a terminal but with a polished interface.
Pagination
Watcher loads 300 events per page. Click "Load older" at the bottom of the list to load earlier events.
Exporting to CSV
- In Service Watcher, click Export CSV.
- Choose the folder to save to.
- The CSV file contains: timestamp, service_name, event_type, description.
Useful for sharing incident reports or calculating uptime.
Clearing the log
Click Clear All to delete the entire history.
⚠️Warning
Clearing the log cannot be undone. Export to CSV first if you need to keep the history.
Next: Gateway & Health Check →