Logs

Application Logs

The Application tab enables you search for application logs in your cluster. Application logs can be used to debug applications that might not work as expected. The log files contain events that occur during the application run.

Searching Application Logs

You can search for logs of applications and associated services installed in your cluster. These logs are displayed within the timeline you select.

To search for application logs, do the following:

1. From the left panel, you can apply the following criteria for searching a log file:

   • Services: Displays the list of services used in the integrated applications. These services display the time stamp at which the associated logs were last captured at.
   • Filters: Displays the list of following filters for a better search: host.name and source.

2. Click the search icon placed near the search text box at the top of the page. Alternatively, you can also type your search query manually and click the search icon.

The filtered logs are displayed in the log details pane below the search bar.

Time Histograms

This panel displays the logs in the form of a histogram where you can see the number of records for a particular time frame. You can view the histogram by Severity and Service.

Click the drop-down located in the top right of the Time Histograms tile and choose a view.

The Severity view displays number of records of the following: Error, Info, Warn, Debug, Trace. The following image is an example of Severity view.

Severity View

The Services view displays number of records of services. You can add or remove a service from appearing in the histogram. Click the drop-down in the top left corner of the Time Histograms tile and select or deselect services. The following image is an example of Services view.

Services View

Dashboard

This panel displays the aggregated values of severity in services. Click the drop-down located in the top right of the Time Histograms tile and choose the severity level of the service whose aggregated value you want to view. The following image is an example of the Dashboard panel.

Dashboard Panel

Log Details Panel

This panel displays details of the following tabs:

• Messages
• Patterns

Messages

The Messages tab displays the following details of a log file:

The logs are divided in the following severity levels:

• Error
• Info
• Warn
• Debug
• Trace

Note You can click a label to view the log of that severity level.

Log Context

The Log Context window displays the following details:

• Message
• Timestamp
• Source file
• Host
• A table with up to ten logs from the same source before and after the selected log. A total of 20 logs is displayed. The selected log is highlighted.

By clicking on Lines and selecting the desired number of logs, you can change the number of logs displayed in the table.

To copy the message click the icon next to the message. The message is copied to clipboard.

Patterns

With Patterns, you can search for a specific pattern of messages in a log file and can also view the occurrence of a message within that log file. You can view the following details in Patterns.

• % Occurrence: The occurrence of a pattern (in %). This is sorted in descending order by default.
• Pattern: The common message pattern appearing in log files. The <*> indicates a value that is not common within that pattern. Click the message to edit the pattern and add values to <*> to refine your search.
• Count: The number of times the similar pattern appears.

Log Pattern Details

Log Pattern Details lets you edit a message pattern for a refined search of a log pattern. This window displays the following:

• Log Pattern: The log message pattern that you want to add values to.
• Log Pattern Count Graph: A graph that displays the count of the log pattern for a time period.
• Log Pattern Table: Displays detailed information of the log pattern with all possible values. The log patter your selected displays the following.
• Log Time: The time at which the log was captured.
• Service: The service whose log is captured.
• Message: The message attached to the log. This contains all those messages of the pattern you selected, with possible values.

Features

Editing a Log Pattern

You can edit a log pattern for a refined search of log messages. To edit a log pattern in Log Pattern Details, perform the following.

1. Click the edit icon in the right of the log message pattern.
2. From the drop-down in the message pattern, select a value to place in the log pattern.
3. Click Submit.

Searching by Phrase

To search a word or phrase in a log, do the following.

1. Click Highlight Text in the top-right corner of the Audit screen. A text box is displayed.
2. Provide a string in the search box using either of the following ways.
   • Type the phrase or word in the text box and press the enter key.

3. Select and copy the text from the log window that you want to search, and paste it in the search box and press the enter key.

4. The written or pasted text if found, is highlighted in the log messages. You can also search for multiple phrases or words.

Saving a Search Query

To save a search query, do the following.

1. Type the query in the search box and click the icon. A Save Search window is displayed.
2. Type a name for the search query in the Name text box.
3. Click Save. The search query is saved.

Loading a Saved Query

To load a query from the search queries you saved, do the following.

1. Click the Search button in the left side of the search box. The list of saved queries is displayed.
2. From the available list of saved queries, click the query you want to load.

The query is loaded and associated logs are displayed.

Grouping Logs

You can group the logs by Trace, Severity, or Host. Click the Group By drop-down label in the top left corner of the log details panel and select a grouping criteria.

Filtering and Viewing the Logs

Once the logs are displayed on the page, you can filter them using various parameters such as services, hosts, severity, and page numbers.

Downloading Logs

To download the logs, click the icon in the top right corner of the table. The logs can be downloaded in the -.xlsx or _.logs format. Note The option to download the logs in _.logs format is only displayed if the feature is enabled.

The following example shows how to change the number of rows before you download the logs.

Log Download