Log Search

Follow the directions below to search logs by keyword and time range:

On the LTS console, choose Log Management in the navigation pane on the left.
In the log group list, click on the left of a log group name.
In the log stream list, click a log stream name.
Above the search box, select a time range.
There are three types of time range: relative time from now, relative time from last, and specified time. Select a time range as required.
- From now: queries log data generated in a time range that ends with the current time, such as the previous 1, 5, or 15 minutes. For example, if the current time is 19:20:31 and 1 hour is selected as the relative time from now, the charts on the dashboard display the log data that is generated from 18:20:31 to 19:20:31.
- From last: queries log data generated in a time range that ends with the current time, such as the previous 1 or 15 minutes. For example, if the current time is 19:20:31 and 1 hour is selected as the relative time from last, the charts on the dashboard display the log data that is generated from 18:00:00 to 19:00:00.
- Specified: queries log data that is generated in a specified time range.
On the log stream details page, you can search for logs using the following methods:
1. In the search area, click the search box, enter a keyword or select a field or keyword from the drop-down list, and click Search.
  Logs that contain the keyword are displayed on the Raw Logs tab page.
  - The structuring fields are displayed in key:value format.
2. On the Raw Logs page, click a field in blue in the log content. You can select Copy, Add To Search, and Exclude from Search from the displayed drop-down list.
3. Click a field for which quick analysis has been created to add it to the search box.
  
  If the field you click already exists in the search box, it will be replaced by this newly added one. If the field is added for the first time, fields in the search box are searched using the AND operator.
4. In the search area, press the up and down arrows on the keyboard to select a keyword or search syntax from the drop-down list, press Tab or Enter to select a keyword or syntax, and click Query.

Common Log Search Operations

Log search operations include sharing logs and refreshing logs.

**Table 1** Common operations
Operation	Description
Creating quick search criteria	Click to create a quick search.
Sharing logs	Click to copy the link of the current log search page to share the logs that you have searched.
Refreshing logs	You can click to refresh logs in two modes: manual refresh and automatic refresh. Manual refresh: Select Refresh Now from the drop-down list. Automatic refresh: Select an interval from the drop-down list to automatically refresh logs. The interval can be 15 seconds, 30 seconds, 1 minute, or 5 minutes.
Copying logs	Click to copy the log content.
Viewing context of a log	Click to view the log context.
Simplifying field details	Click to view the simplified field details.
Unfold/Fold	Click to display all the log content. Click to fold the log content. NOTE: Unfold is enabled by default.
Downloading logs	Click . On the displayed Download Logs page, click Direct Download. Direct Download: Download log files to the local PC. Up to 5,000 logs can be downloaded at a time. Select .csv or .txt from the drop-down list and click Download to export logs to the local PC. NOTE: If you select Export .csv, logs are exported as a table. If you select Export .txt, logs are exported as a .txt file.
Collapse all/Expand all	Click to set the number of lines displayed in the log content. Click to close it. NOTE: By default, logs are not collapsed, and two rows of logs are shown after collapsing. You can display up to six rows.
Layout	Move the cursor over and choose Layout from the drop-down list. On the displayed Layout page, specify whether to simplify field display and show fields. Simple View: If this is enabled, the fields are displayed in a simplified manner. Show/Hide: When the visibility of a field is disabled, the field is not displayed in the log content.
JSON	Move the cursor over , click JSON, and set JSON formatting. NOTE: Formatting is enabled by default. The default number of expanded levels is 2. Formatting enabled: Set the default number of expanded levels. Maximum value: 10. Formatting disabled: JSON logs will not be formatted for display.
Invisible fields ()	This list displays the invisible fields configured in the layout settings. The button is unavailable for log streams without layout settings configured. If the log content is CONFIG_FILE and layout settings are not configured, the default invisible fields include appName, clusterId, clusterName, containerName, hostIPv6, NameSpace, podName, and serviceID.

Syntax and Examples of Searching

Search syntax:

**Table 2** Search syntax
Filter	Description
Exact search by keyword	LTS searches for logs containing the exact keyword (case-sensitive) that you specify. A keyword is the word between two adjacent delimiters.
Exact search by phrase	LTS searches for logs containing the exact phrase (case-sensitive) that you specify.
&&	Intersection of search results
\|\|	Union of search results
AND	Intersection of search results
and	Intersection of search results
OR	Union of search results
or	Union of search results
NOT	Logs that contain the keyword after NOT are excluded.
not	Logs that contain the keyword after not are excluded.
?	Fuzzy search. The question mark (?) can be put in the middle or at the end of a keyword to replace a character.
>	Search for structured long or float fields with values greater than a specified number. For example, num > 10.
<	Search for structured long or float fields with values less than a specified number. For example, num < 10.
=	Search for structured long or float fields with values equal to a specified number. For example, num = 10.
>=	Search for structured long or float fields with values greater than or equal to a specified number. For example, num >= 10.
<=	Search for structured long or float fields with values less than or equal to a specified number. For example, num <= 10.
:	Search for a specified field (key:value). For example, request_method:GET. Use double quotation marks ("") to enclose a field name or value that contains reserved characters, such as spaces and colons (:). For example, "file info":apsara.
""	Enclose a syntax keyword to convert it into common characters. For example, "and". This "and" means searching for logs that contain this word. It is not an operator. All words enclosed in double quotation marks ("") are considered as a whole.
\	Escape double quotation marks (""). The escaped quotation marks indicate the symbol itself. For example, to search for instance_id:nginx"01", use instance_id:nginx\"01\".
*	An asterisk () can be placed only after the keyword and can match zero, one, or multiple characters. For example, host:abcdc**. NOTE: LTS will find 100 words that meet the search criteria in all logs and return these logs.
in	Query logs whose field values are in a specified range. Brackets indicate a closed interval, and parentheses indicate an open interval. Numbers are separated with spaces. Example: request_time in [100 200] and request_time in (100 200] NOTE: Enter in in lowercase and use only long or float fields.
()	Specify fields that should be matched with higher priority. Use and, or, and not to connect fields. Example: (request_method:GET or request_method:POST) and status:200
key:#"abc def"	Search for specified field names and values (key:value) after field indexing is configured.
#"abc def"	Full text search. LTS splits an entire log into multiple words based on the delimiter you set. Search for logs using specified keywords (field name and value) and rules.

Operators (such as &&, ||, AND, OR, NOT, *, ?, :, ", >, <, =, >=, and <=) contained in raw logs cannot be used to search for logs.

Search rules:

Fuzzy search is supported.
For example, if you enter error*, all logs containing error will be displayed and those start with error will be highlighted.
You can use a combination of multiple search criteria in the key and value format: key1:value1 AND key2:value2 or key1:value1 OR key2:value2. After entering or selecting key1:value1, you need to add AND or OR before entering or selecting key2:value2 in the search box.
Click a keyword and select one of the three operations from the displayed drop-down list: Copy, Add To Search, and Exclude from Search.
Copy: Copy the field.

Add To Search: Add AND field: value to the search statement.

Exclude from Search: Add NOT field: value to the query statement.

Searching sample

Search for logs containing start: Enter start.
Search for logs containing start to refresh: Enter start to refresh.
Search for the logs containing both keywords start and unexpected: Enter start && unexpected.
Search for the logs containing both keywords start and unexpected: Enter start AND unexpected.
Search for the logs containing keyword start or unexpected: Enter start || unexpected.

Search for the logs containing keyword start or unexpected: Enter start OR unexpected.
Log data that does not contain query1: NOT content: query1.
error*: logs that contain error.
er?or: logs that start with er, is followed by any single character, and end with or.
If your keyword contains a colon (:), use the content: Keyword format. Example: content: "120.46.138.115:80" or content: 120.46.138.115:80.
query1 AND query2 AND NOT content: query3: logs that contain both query1 and query2 but not query3.

When you enter a keyword to query logs, the keyword is case-sensitive. Log contents you queried are case-sensitive but the highlighted log contents are case-sensitive.
The asterisk (*) and question mark (?) do not match special characters such as hyphens (-) and spaces.
For fuzzy match, the question mark (?) or asterisk (*) can only go in the middle or at the end of a keyword. For example, you can enter ER?OR or ER*R.
When you search logs by keyword, if a single log contains more than 255 characters, exact search may fail.

Parent topic: Log Search and Analysis

Previous topic: Log Search and Analysis

Next topic: Built-in Reserved Fields