Chat now with support
Chat with Support

syslog-ng Store Box 5.3.0 - Administration Guide

Preface Introduction The concepts of SSB The Welcome Wizard and the first login Basic settings User management and access control Managing SSB Configuring message sources Storing messages on SSB Forwarding messages from SSB Log paths: routing and processing messages Configuring syslog-ng options Searching log messages Searching the internal messages of SSB Classifying messages with pattern databases The SSB RPC API Troubleshooting SSB Security checklist for configuring SSB About us Third-party contributions

Troubleshooting SSB

This section describes the tools to detect networking problems, and also how to collect core files and view the system logs of SSB.

To find the SSB appliance in the server room, you can use IPMI to control the front panel and back panel identify lights.

  1. On SSB T4 and SSB T10, navigate to Basic Settings > System > Hardware information > Blink system identification lights.

    NOTE:

    SSB T1 does not support identify lights.

  2. To blink the blue LEDs on the front and back of the SSB appliance, click On.

Alternatively, use the command line as follows:

  1. To start the blinking of the blue LEDs on the front and back of the SSB appliance, enter:

    ipmitool chassis identify force

  2. To stop the blinking of the blue LEDs on the front and back of the SSB appliance, enter:

    ipmitool chassis identify 0

Network troubleshooting

The Troubleshooting menu provides a number of diagnostic commands to resolve networking issues. Logfiles of SSB can also be displayed here — for details, see Viewing logs on SSB.

Figure 165: Basic Settings > Troubleshooting > System debug — Network troubleshooting with SSB

The following commands are available:

  • ping: Sends a simple message to the specified host to test network connectivity.

  • traceroute: Sends a simple message from SSB to the specified host and displays all hosts on the path of the message. It is used to trace the path the message travels between the hosts.

  • connect: Attempts to connect the specified host using the specified port. It is used to test the availability or status of an application on the target host.

To execute one of the above commands

  1. Navigate to Basic Settings > Troubleshooting.

  2. Enter the IP address or the hostname of the target host into the Hostname field of the respective command. For the Connect command, enter the target port into the Port field.

  3. Click the respective action button to execute the command.

  4. Check the results in the popup window. Log files are displayed in a separate browser window.

Gathering data about system problems

SSB automatically generates core files if an important software component (for example, syslog-ng, or the indexer) of the system crashes for some reason. These core files can be of great help to the One Identity Support Team to identify problems. To display a list of alerts, navigate to Search > Log Alerts.

To list and download the generated core files, navigate to Basic Settings > Troubleshooting > Core files.

By default, core files are deleted after 14 days. To change the deletion timeframe, navigate to Basic Settings > Management > Core files.

Viewing logs on SSB

The Troubleshooting menu provides an interface to view the logs generated by the various components of SSB. For details on how to browse the log messages received by SSB from its peers, see Searching log messages.

NOTE:

Because of performance reasons, log files larger than 2 Megabytes are not displayed in the web interface. To access these logs, download the file instead.

To view logs on SSB

  1. Navigate to Basic Settings > Troubleshooting > View log files.

  2. Use the Logtype roll-down menu to select the message type.

    • SSB: Logs of the SSB web interface.

    • syslog: All system logs of the SSB host.

    • syslog-ng: Internal log messages of the built-in syslog-ng server. These logs do not contain messages received from the peers.

    • To download the log file, click Download.

    • To follow the current log messages real-time, click Tail.

    • To display the log messages, click View.

  3. To display log messages of the last seven days, select the desired day from the Day: field and click View.

    TIP:

    To display only the messages of a selected host or process, enter the name of the host or process into the Message: field.

    The Message: field acts as a generic filter: enter a keyword or a POSIX (basic) regular expression to display only messages that contain the keyword or match the expression.

Related Documents