Searching for Logs

AOM enables you to quickly query logs, and use log source information and context to locate faults.

1. In the navigation pane, choose Log > Log Search.
2. On the Log Search page, click the Component, System, or Host tab and set filter criteria as prompted.
   

   1. You can search for logs by component, system, or host.
      • For component logs, you can set filter criteria such as Cluster, Namespace, and Component. You can also click Advanced Search and set filter criteria such as Instance, Host, and File Name, and choose whether to enable Hide System Component.
      • For system logs, you can set filter criteria such as Cluster and Host.
      • For host logs, you can set filter criteria such as Cluster and Host.
   2. Enter a keyword in the search box. Rules are as follows:
      • Enter a case-sensitive keyword.
      • Enter a keyword for exact search. A keyword refers to a word between two adjacent delimiters.
      • Enter a keyword containing an asterisk (*) or a question mark (?) for fuzzy search. For example, enter ER?OR, *ROR, or ER*R.
      • Enter a phrase for exact search. For example, enter Start to refresh or Start-to-refresh. Note that hyphens (-) are delimiters.
      • Enter a keyword containing AND (&&) or OR (||) for search. For example, enter query logs&&error* or query logs||error.
      • If no log is found, you are advised to narrow down the search scope and add an asterisk (*) before and after the keyword for fuzzy match.
      • Entering both Chinese and English to search logs is not allowed.

3. View the search results of logs.

   The search results are sorted based on the log collection time, and keywords in them are highlighted. You can click in the Time column to change the order. indicates the default order. indicates the ascending order of time (that is, the latest log is displayed at the end of the list). indicates the descending order of time (that is, the latest log is displayed at the beginning of the list).

   1. Click on the left of the log list to view details.
   2. AOM allows you to view the surrounding logs of a specified log by clicking View Context in the Operation column, facilitating fault locating. Therefore, you do not need to search for logs in raw log files.
      • In the Display Rows drop-down list, set the number of rows that display raw context data of the log.
        

        For example, select 200 from the Display Rows drop-down list.

        • If there are more than or equal to 100 logs printed prior to a log and more than or equal to 99 logs printed following the log, the preceding 100 logs and following 99 logs are displayed as the context.
        • If there are fewer than 100 logs (for example, 90) printed prior to a log and fewer than 99 logs (for example, 80) printed following the log, the preceding 90 logs and following 80 logs are displayed as the context.
      • Click Export Current Page to export displayed raw context data of the log to a local PC.
   

   To ensure that tenant hosts and services run properly, some components (for example, kube-dns) provided by the system will run on the tenant hosts. The logs of these components are also queried during tenant log query.

4. (Optional) Click on the right of the Log Search page, select an export format, and export the search result to a local PC.

   Logs are sorted according to the order set in 3 and a maximum of 5000 logs can be exported. For example, when 6000 logs in the search result are sorted in the descending order, only the first 5000 logs can be exported.

   Logs can be exported in CSV or TXT format. You can select a format as required. If you select the CSV format, detailed information, such as log content, host IP address, and source can be exported, as shown in Figure 1. If you select the TXT format, only log content can be exported, as shown in Figure 2. Each row represents a log. If a log contains a large amount of content, view the log using Notepad++.

   Figure 1 Exporting logs in CSV format
   
   Figure 2 Exporting logs in TXT format