Retrieve logs

Note:

Logs are only functional when Symphony is installed.

Cluster administrators and consumer administrators can retrieve logs that contain system, daemon, or host information that helps troubleshoot a cluster. You can choose to either retrieve an entire log file or just the last x number of lines of that log file.

Logs with a size of up to 2 MB are supported.

Note:

Depending on what you have installed, all of these options may not be available.

Download logs for an application

You must configure log location and naming before you can download logs for applications.

You can retrieve logs for an application.

  1. Find the application you want to retrieve logs for.

    Click Symphony Workload > Monitor Workload.

  2. Navigate to the leaf consumer where your application is registered.
  3. Click Actions > Retrieve application system logs for the application you want.

    The log properties and log retrieval parameters display.

  4. Select the logs you want from this host and click Retrieve Log List.

    A list of logs displays.

  5. Specify the volume of data:
    • Complete log

    • Last number of lines

  6. If you selected last number of lines, enter the number of lines you want retrieved.

    The number of lines is counted from the latest event back through the log to the limit you specify.

  7. Click the log file name.
  8. Open the log file immediately or save the log file locally and open with a text editor.
Related concepts
About logs
Tasks

Download logs for a task

You must configure log location and naming before you can download logs for tasks. Consult the Symphony documentation for information on configuring log retrieval.

You can retrieve the logs for a task.

  1. Click Symphony Workload > Monitor Workload.

    A list of applications displays.

  2. Click the name of the application to which the session or task belongs.

    A list of open sessions displays.

  3. Click the session ID and locate the task in the session it belongs.
  4. For that task, select Actions > Retrieve Task Log.
  5. Specify whether you want the log to be compressed or not.
  6. Click the log file name.
  7. Open the log file immediately or save the log file locally, uncompress if necessary, and open with a text editor.

Download logs by host

If you want one or more logs for one specific host, download the logs by host.

  1. Click Resources > Hosts (List View).

    A list of hosts displays.

  2. For the host you want logs for, click Actions > Retrieve Logs.

    The log retrieval parameters display.

  3. Select the logs you want from this host.
  4. Click Retrieve Log List.

    A list of logs displays.

  5. Specify the volume of data:
    • Complete log

    • Last number of lines

  6. If you selected last number of lines, enter the number of lines you want retrieved.

    The number of lines is counted from the latest event back through the log to the limit you specify.

  7. Click the log file name.
  8. Open the log file immediately or save the log file locally and open with a text editor.

Download a log for selected hosts

You can retrieve one type of log for one or more hosts at the same time.

  1. Click System Logs.

    A list of logs displays.

  2. Select a log type you want to download.

    The log properties and log retrieval parameters display.

  3. Filter by host name, select the hosts that you want the log for, and click Add.
  4. Click Retrieve Log List.

    A list of logs displays.

  5. Specify the volume of data:
    • Complete log

    • Last number of lines

  6. If you selected last number of lines, enter the number of lines you want retrieved.

    The number of lines is counted from the latest event back through the log to the limit you specify.

  7. Click the log file name.
  8. Open the log file immediately or save the log file locally and open with a text editor.

Download logs for a blocked host

You can retrieve the logs for a blocked host.

  1. Click Symphony Workload > Monitor Workload.

    A list of applications displays.

  2. Click the name of the application to which the blocked host belongs.

    A list of open sessions displays.

  3. Click Blocked Hosts.

    A list of all blocked hosts for that application displays.

  4. Click the host name link.

    The host properties display.

  5. Click Host Logs.

    The log retrieval parameters display.

  6. Select the logs you want from this host.
  7. Click Retrieve Log List.

    A list of logs displays.

  8. Specify the volume of data to be retrieved:
    • Complete log

    • Last number of lines

  9. If you selected last number of lines, enter the number of lines you want retrieved.

    The number of lines is counted from the latest event back through the log to the limit you specify.

  10. Click the log file name.
  11. Open the log file immediately or save the log file locally and open with a text editor.

Download logs for a service

Binding failures

You can retrieve the logs for a service in the event of a session binding failure in the service. The SSM lists up to five of the last binding failures.

  1. Click Symphony Workload > Monitor Workload.

    A list of applications displays.

  2. Click the name of the application.

    A list of sessions displays.

  3. Consult the Binding Failures column for your session.
  4. Click the SI host name that has logged the session binding failure.

    The Host Logs page displays.

  5. Click Retrieve Log List.

    A list of log files displays.

  6. Click the file name with the matching host name and pid of the service instance.
  7. Save the log file locally, uncompress if necessary, and open with any text editor.

SI start-up failures

You can retrieve the logs for a service in the event of a service instance start-up failure. The SSM lists up to five of the last service start-up failures.

Note:

If a task fails (where a control code for task failure is set) or a session aborts, the SSM will list the host name and pid of the service instance.

  1. Click Symphony Workload > Monitor Workload.

    A list of applications displays.

  2. Consult the SI Startup Failures column for your application.
  3. Click the SI host name that has logged the SI start-up failure.

    The Host Logs page displays.

  4. Click Retrieve Log List.

    A list of log files displays.

  5. Click the file name with the matching host name and pid of the service instance.
  6. Save the log file locally, uncompress if necessary, and open with any text editor.