The ALOHA appliance offers a limited in-memory buffer of logs that you can access from the Logs tab, which covers a limited history.

This section shows you how to send logs from a physical or virtual Aloha appliance to an external Syslog server.

Configuring ALOHA to send logs

Send all logs

  1. Log into the administration panel of the ALOHA (port 4444).

  2. Go to the Services tab and locate the entry named syslog.

  3. Click the setup setup_icon icon to display the configuration page.

  4. Delete the line "no autostart" to enable the service to start automatically when the machine boots.

  5. Decide which types of logs you want to send:

    • system: major system events like kernel errors

    • events: errors when starting/stopping HAProxy and any errors/warnings that this produces

    • traffic: access logs from HAProxy

    • console: events such as logins to the administration interface

  6. For each log type that you want to send, specify the IP address of the destination syslog server and the severity level you require. Severity levels are: "emerg", "alert", "crit", "err", "warning", "notice", "info", "debug".

    server 192.168.0.1:514

    If you choose to log all types of traffic, the textbox now looks similar to the text below:

    service syslog system
      ########## Syslog server dedicated to major system events
      # server <remote_server_ip[:port]>  : send all msg to this remote server
      # console_level <level>       : do not kernel msg above <level> to console
      #------------
      server 192.168.0.1:514
      service syslog events
      ########## Syslog server dedicated to loadbalancer events
      # server <remote_server_ip[:port]>  : send all msg to this remote server
      # console_level <level>       : do not kernel msg above <level> to console
      #------------
      server 192.168.0.1:514
      service syslog traffic
      ########## Syslog server dedicated to traffic
      # server <remote_server_ip[:port]>  : send all msg to this remote server
      # console_level <level>       : do not kernel msg above <level> to console
      #------------
      server 192.168.0.1:514
      service syslog console
      ########## Syslog server dedicated to wui console
      # server <remote_server_ip[:port]>  : send all msg to this remote server
      # console_level <level>       : do not kernel msg above <level> to console
      #------------
      server 192.168.0.1:514
  7. Click OK and Close to return to the S*Services*tab.

  8. Click restart_icon to restart.

Send logs for a specific frontend

You can configure ALOHA to send logs for a specific frontend or use a different log server for each frontend, as needed.

  1. Log into the administration panel of the ALOHA (port 4444).

  2. Browse to the LB Layer7 tab.

  3. For the desired frontend, add the following:

    log 192.168.0.1:514
  4. Click OK and apply_icon to apply.

Configuring the Syslog server

After you configure ALOHA to send logs, you must configure a Syslog server on the system to receive the log entries.

  1. Create a file named /etc/rsyslog.d/10-aloha.conf with the following contents:

    # Collect log with UDP
    $ModLoad imudp
    $UDPServerAddress 192.168.0.1 #Change to be the IP that you have the Aloha sending logs to which is on this box.
    $UDPServerRun 514
    # Log the date using the syslog tradio,al format.
    $ActionFileDefaultTemplate RSYSLOG_TraditionalFileFormat
    # Update '192.168.0.200' to be the IP of your Aloha boxes; you can add more as needed or use "startswith" to match a range of IPs
    if $fromhost-ip=='192.168.0.200' then /var/log/aloha.log
  2. Run service syslog restart to apply the changes.

  3. Make a request to your ALOHA and you should see the selected logs in /var/log/aloha.log.