Alert Runbooks

AuditorUnavailable

Runbook: AuditorUnavailable

Alert Details

Description

This alert triggers when the maximum value of the audit jobs queue exceeds a certain threshold, indicating that the auditor service is unavailable or not processing jobs.

Possible Causes

Troubleshooting Steps

  1. Check Auditor Service Status

    • Command: systemctl status auditor-service
    • Expected Output: The status of the auditor service. Look for “active (running)”.
    • Example:
      1
      2
      3
      4
      
      $ systemctl status auditor-service
      ● auditor-service.service - Auditor Service
         Loaded: loaded (/etc/systemd/system/auditor-service.service; enabled; vendor preset: enabled)
         Active: active (running) since Wed 2024-11-13 14:00:00 UTC; 19min ago
  2. Restart Auditor Service

    • Command: sudo systemctl restart auditor-service
    • Expected Output: The service restarts without errors.
    • Example:
      1
      
      $ sudo systemctl restart auditor-service
  3. Check Network Connectivity

    • Command: ping -c 4 auditor-service-hostname
    • Expected Output: Successful ping responses.
    • Example:
      1
      2
      3
      4
      5
      6
      
      $ ping -c 4 auditor-service-hostname
      PING auditor-service-hostname (192.168.1.3) 56(84) bytes of data.
      64 bytes from auditor-service-hostname: icmp_seq=1 ttl=64 time=0.123 ms
      64 bytes from auditor-service-hostname: icmp_seq=2 ttl=64 time=0.124 ms
      64 bytes from auditor-service-hostname: icmp_seq=3 ttl=64 time=0.125 ms
      64 bytes from auditor-service-hostname: icmp_seq=4 ttl=64 time=0.126 ms
  4. Verify Auditor Configuration

    • Command: cat /etc/auditor-service/config.yml
    • Expected Output: Configuration file contents. Ensure all settings are correct.
    • Example:
      1
      2
      3
      
      $ cat /etc/auditor-service/config.yml
      job_name: 'audit-jobs'
      max_queue_age: 300

Additional Steps