Live Tail
Without the Log Read role, you cannot enter the menu.
Home > Select Project > Log > Live Tail
In Live Tail, you can easily check the log data stream on the monitoring screen without accessing the server console. You can select necessary logs from numerous logs and quickly recognize the desired logs through the highlight function.
In Live Tail, complex logs can be easily accessed. You can search the logs in real time by using the functions such as Filter or Highlight, if necessary. The log data search cycle is 2 seconds.
The major terms are as follows:
- Category: Unit for log collection and inquiry
- Content: Log messages
- Search Key: It is generated through the log parser settings.
- Tag: Key to search the collected logs
Agent option
If the agent option is set, the log levels are collected and the colors for each log level appear as follows:
Setting the agent options
-
The agent options are as follows:
# whatap.conf
weaving=log4j-2.17
weaving=logback-1.2.8 -
In Java agent 2.2.22 or later, it can be used when setting log4j-2.17 or logback-1.2.8 in the weaving setting. It is required to restart the agent.
-
The log level is determined based on the
level
andtype
among the parsed keywords. When there are keys parsed aslevel
andtype
, and the parsed values have FATAL, CRITICAL, ERROR, WARN, WARNING, and INFO, the log level color appears.
Filter area
Apply Filter
When a filter is applied, the logs that match the specified conditions are filtered. You can enter multiple filters. OR (||
) if the filters have the same tags, otherwise AND (&&
).
You can specify a filter by directly entering a value in the input field or clicking the Filter field. Filter tags are entered in the following order: Search key
, Operator
, and Search value
. If you select Search, the data with the filter applied can be viewed in the area.
Guide UI
The Guide UI is provided under the input field as follows:
Entry of the search key, operator, and search value
-
Upon entry of the
search key
, recommended values are provided by distinguishing for general index, reserved word index, and numeric index. -
When entering an
operator
, for a general index search key,==
and!=
options are provided at the bottom. In case of the numeric index, the>
,<
,<=
,>=
,==
, and!=
options are provided. -
Upon entry of the
search value
for matched search (>
,<
,<=
,>=
,==
), it is highlighted in blue, In case of excluded search (!=
), it is highlighted in red. -
Upon entry of the
search value
, you can search using the case-sensitive option.
If the filter tags exceed 2 lines, you can fold it by selecting the Fold icon.
Adding filter tags
-
You can enter text in the input field and add more items by using the Enter and Tab keys on your keyboard.
-
You can add recommended values by clicking them in the Guide UI below the input field.
-
In the Guide UI below the input field, you can select recommended values with the up/down arrow keys on the keyboard and add tags by using the Enter and Tab keys.
Deleting filter tags
-
A tag can be deleted with the Backspace key.
-
You can delete a tag by selecting the X icon for it.
-
You can delete all tags by selecting the Delete All X icon in the input field.
Exceptional cases for application of filters
-
In the tag with a numeric index (
search key
that ends with.n
), only numbers can be input for thesearch value
. -
Duplicate ‘search key’ and ‘search value’ cannot be entered.
-
Searching is not possible if there is a tag whose
search key
orsearch value
is missing. Invalid tags appear in gray.
-
You cannot enter a
category
with the Live Tailsearch key
. -
The expression under the entered filter value is a preview of the filter expression for querying the log data.
Applying non-parsing keyword filters
You can search the logs containing keywords that have not been parsed, or for which no index has been created. In this case, all logs in the specified range are fully scanned. Therefore, the search speed may be slower compared to the indexed key. For standardized log data, it is recommended to search using the index key through Log parser setting.
-
Select Category.
-
In the Filter field, enter a desired keyword for a search after leaving spaces on the
content
basis.e.g.
content *select*
-
Click Search to view the logs.
- In case of Live Tail, all logs can be viewed. Thus, the category is not required to be specified.
-
For more information about the parser configuration, see the following.