Skip to content

Examples

Find your alert. See what Virca does with it.

The process is up, but the URL stops answering. The process is gone. A port stops answering. Logs fill the disk. Nine common alerts on web and app servers, and what Virca does with each.

Each example uses ActionBooks in the product today. An ActionBook is a fix written down as one file your team can read and approve. The Virca Worker is a process on your server. It watches the server and runs the fixes your team approves.

Known problems

The Worker runs the fix, then re-checks.

Your team approves each fix. The Worker checks that the alert is real, gathers the facts, runs the fix and re-checks its target. With approval mode on, every run an alert starts waits for approval in Virca.

Every example, the same frame

  1. 1What fired
  2. 2What was checked
  3. 3What ran
  4. 4The re-check
  5. 5What the record shows
Server names and values on this page are illustrative.

Known problems · 01

URL not responding

When your team links this alert to a restart. Until then, the Worker looks first, then stops and tells your team.

214/url_down

If no one acts: Users of that service can keep getting errors.

What fired
Health URL down on web-03 /healthz · 02:30
What was checked
/healthz times out · nginx running, not answering is_service_active: true
What ran
Restarted nginx service: nginx
The re-check
/healthz answers 200 http_status: 200

What the record shows

ActionBook
http_endpoint_recovery
Server
web-03
Started by
The alert
Fix approved by
Dana on your team
Result
ok
Closed with the approved fix

If /healthz already answers http_status: 200 Already answering again. Virca changed nothing.

Known problems · 02

Process stopped

With an ActionBook your team approved, for nginx on web-01.

219/process_down

If no one acts: The service can stay down until someone restarts it.

What fired
nginx stopped on web-01 14:10
What was checked
Is nginx still down? is_service_active: false
What ran
Restarted nginx service: nginx
The re-check
nginx is running again service_status: active

What the record shows

ActionBook
restart_down_service
Server
web-01
Started by
The alert
Fix approved by
Dana on your team
Result
ok
Closed with the approved fix

If nginx is already back is_service_active: true Already running again. Virca changed nothing.

Known problems · 03

Disk filling up

With an ActionBook your team approved, started by your team, for /data/logs.

201/host_filesystem_high

If no one acts: Once the disk is full, writes fail and the app can stop.

What fired
Disk filling up on web-06 /data · Used (%): 78 · 10:05
What was checked
The log folder folder: /data/logs
What ran
Deleted the oldest logs, kept the newest order: oldest first
The re-check
The log folder got smaller folder: /data/logs · size (GB): 31 → 4

What the record shows

ActionBook
data_log_delete
Server
web-06
Started by
Someone on your team
Fix approved by
Dana on your team
Result
ok
Closed with the approved fix

If the growth is not in /data/logs No approved fix fits. Virca stops and tells your team.

Known problems · 04

CPU too high

With an ActionBook your team approved, for the process using the most CPU.

201/host_cpu_high

If no one acts: Requests to that server can slow down or time out.

What fired
CPU high on api-01 CPU (%): 97.2 · 09:15
What was checked
The process using the most CPU PID 48213 · Name thumbnailer · CPU (%) 92.6
What ran
Stopped that process with SIGTERM only signal: SIGTERM
The re-check
PID 48213 is no longer running is_process_running: false

What the record shows

ActionBook
kill_runaway_pid
Server
api-01
Started by
The alert
Fix approved by
Dana on your team
Result
ok
Closed with the approved fix

init, systemd and sshd are never touched. SIGTERM only. For your main app, link the alert to a service restart instead.

Known problems · 05

Memory too high

With an ActionBook your team approved, for the process using the most memory.

201/host_memory_high

If no one acts: To free memory, Linux may stop a process you need.

What fired
Memory high on batch-01 Memory (%): 96.4 · 11:20
What was checked
The process using the most memory PID 7731 · Name batch-export · RSS 11.8 GB
What ran
Stopped that process with SIGTERM only signal: SIGTERM
The re-check
PID 7731 is no longer running is_process_running: false

What the record shows

ActionBook
kill_memory_hog
Server
batch-01
Started by
The alert
Fix approved by
Dana on your team
Result
ok
Closed with the approved fix

If that process is your main app, link the alert to a restart of its service instead.

Looked into first

The Worker looks first, then stops and tells your team.

These alerts have no set fix. The Worker looks into the server and saves the findings to the record. Your team decides the next step.

Not every event ends in an action, and that is the point.

Looked into first · 06

Port closed

Ports close for different reasons on each server. No single fix fits.

217/port_probe_down

If no one acts:Services that use that port can't connect to it.

What fired
Port 8080 closed on api-02 11:42
What was checked
Whether the port can be reached TCP api-02:8080 · result: refused
What was checked
The route to the port DNS ok · ping ok
What was checked
Outbound access from the server result: ok
What ran
No approved fix fits. Virca stops and tells your team.

What the record shows

Server
api-02
Saved
reachability · route · outbound access
Next
your team
Stops and tells your team

Your team takes over from the record.

Looked into first

All three end the same way. The Worker looks into it, saves its findings to the record, then stops and tells your team.

  • 07

    Swap too high

    201/host_swap_high

    If no one acts: The server can slow down as it moves memory to and from disk.

    Saved to the record: server memory and the processes using the most memory.

  • 08

    Disk busy

    201/disk_device_busy_high

    If no one acts: Reads and writes queue up, and apps on the server slow down.

    Saved to the record: a snapshot of CPU, memory, disk and load.

  • 09

    Network surge

    201/network_traffic_surge

    If no one acts: The network can fill up, and normal requests slow down or fail.

    Saved to the record: connection counts, listening ports and waiting connections.