Events Log

System log is an internal registry of users activities which influence system state (login information, administrative actions, etc.). Please refer to the Log Messages section for a list of key log messages.


To display system log contents, select Settings > Events log.

../../_images/6-1-event-log.png

Filtering Logs by Date and Time

Logs can be filtered by date and time directly from the date bar located above the log list. Additionally, there is a set of commonly used date range filters, such as Today, Last 24 Hours, This Week, Last 1 Hour, Last 1 Year, etc., accessible through the calendar icon.

../../_images/6-1-event-log-date.png

External Syslog Servers

Fudo Enterprise can forward event log entries to external Syslog servers. Configured servers are managed in the dedicated Syslog Servers view, available under Settings > Events log. The view lists each configured server together with its name, host, port, connection type, TLS status, log format, whether debug logs and object names are included, and whether the server is enabled.

Note

  • Fudo Enterprise can communicate with syslog servers over the UDP or TCP transport. TLS encryption is available for connections that use the TCP transport.

  • Event log entries can be forwarded in the RFC 3164 (BSD, default) or the RFC 5424 format. The log format is selected individually for each server.

  • Messages are sent to the syslog server through the network interface that has the Admin Panel purpose selected in the network configuration. The IP address used must either be able to reach the target host’s network directly or use the default gateway. For more information, refer to the Network Interfaces Configuration section.

  • During an upgrade from version 6.0 or earlier, an existing syslog configuration is automatically migrated to the new syslog server model as UDP syslog servers using the RFC 3164 log format.


../../_images/6-2-event-log-syslog.png

Adding a Syslog Server

To add a Syslog server, proceed as follows.

  1. Select Settings > Events log.

  2. Open the Syslog Servers tab and click Add Syslog Server.

  3. In the Name field, enter a unique name for the server.

  4. Provide the server’s Host and Port (the default port is 514 for UDP and 6514 for TCP connections).

  5. Set Connection type to UDP or TCP.

  6. For a TCP connection, select TLS enabled to encrypt the transmission. Under Server verification, select CA Certificate to secure the connection with a certificate and paste or upload it in the field below, or select None to connect without verification.

  7. Under Log Format, select RFC 3164 to send messages in the BSD format, or RFC 5424 to send them in the RFC 5424 format.

  8. Optionally, under Log settings, select Include debug logs and Include object names.

  9. Make sure the Enabled option is selected to activate log forwarding to this server.

  10. Click Save.

../../_images/6-2-event-log-syslog-add.png

Note

  • Log entries sent to syslog servers that use the RFC 3164 log format are formatted as follows:

    [level] TIMESTAMP TAG[PID]: MESSAGE

    where:

    • level – log level (optional),

    • TIMESTAMP – time of the log entry,

    • TAG – application name, always fudo,

    • PID – process ID,

    • MESSAGE – the actual log message, preceded by the component or module name.

  • Example:

    May 29 05:51:08 fudo[49411]: [INFO] (api) (type: admin) (subject: 9034220852505214977) (fudo_user: 9034220852505214977) (fudo_safe: 9034220852505214977) FAI0876 Administrator admin connected safe main to user admin at position 0.

  • For servers that use the RFC 5424 log format, the message header is built according to RFC 5424:

    <PRI>VERSION TIMESTAMP HOSTNAME APP-NAME PROCID MSGID SD MESSAGE

    where:

    • PRI – priority value derived from the local7 facility and the log level,

    • VERSION – format version, always 1,

    • TIMESTAMP – time of the log entry in UTC, in the RFC 3339 format with microsecond precision,

    • HOSTNAME – Fudo Enterprise host name,

    • APP-NAME – application name, always fudo,

    • PROCID – process ID,

    • MSGID – message identifier, always -,

    • SD – structured data field, always empty (-),

    • MESSAGE – the actual log message, preceded by the component or module name.

  • The message content is identical for both log formats. In the RFC 5424 format, Fudo Enterprise context data (object IDs and names) stays in the message content and is not moved to the structured data field.

  • For detailed list of log messages, refer to the Log Messages topic.

Editing Syslog Server Definition

To edit a Syslog server definition, proceed as follows.

  1. Select Settings > Events log.

  2. Open the Syslog Servers tab and click the name of the server you want to edit.

  3. Modify the server definition as needed.

  4. Click Save.


Deleting Syslog Server Definition

To delete a Syslog server definition, proceed as follows.

  1. Select Settings > Events log.

  2. Open the Syslog Servers tab.

  3. Select the checkbox next to the server you want to remove.

  4. Click Delete selected and confirm the deletion.


Exporting Events Log

To export events log entries, proceed as follows.

  1. Select Settings > Events log.

  2. Click Export and select where to save exported log entries.

../../_images/6-1-event-log-export.png

Related topics: