Log Details¶
Click on the log list to bring up the details page of the current log, where you can view detailed information about the log, including the time it was generated, host, source, service, content, extended fields, and context.
View Complete Log¶
When logs are reported to TrueWatch, if a single log exceeds 1M, the system will split it into multiple logs according to the 1M standard. For example, a 2.5M log will be split into three logs: 1M, 1M, and 0.5M. The completeness of the split logs can be viewed through the following fields:
Field |
Type | Description |
|---|---|---|
__truncated_id |
string | Represents the unique identifier of the log. Multiple logs split from the same log will have the same __truncated_id, with the prefix LT_xxx. |
__truncated_count |
number | Represents the total number of logs split. |
__truncated_number |
number | Represents the order of the split log, starting from 0, where 0 indicates the first log. |
On the log details page, if the current log is split into multiple logs, a View Complete Log button will appear in the upper right corner. Clicking this button will open a new page listing all related logs in the order they were split. The page will also highlight the log selected before the jump for quick navigation to upstream and downstream logs.
TOBY AI Error Analysis¶
TrueWatch provides the ability to parse error logs with one click. It uses large models to automatically extract key information from logs, combines online search engines and operation knowledge bases, quickly analyzes possible fault causes, and provides initial solutions.
- Filter all logs with the status
error; - Click on a single data entry to expand the details page;
- Click TOBY AI Error Analysis in the upper right corner;
- Start the anomaly analysis.
Error Details¶
If the current log contains error_stack or error_message field information, the system will provide you with error details related to the log.
To view more log error information, go to Log Error Tracing.
Attribute Fields¶
Click on attribute fields for quick filtering and viewing, allowing you to view host, process, trace, and container data related to the log.
| Field | Description |
|---|---|
| Filter Field Value | Add this field to the log explorer to view all log data related to this field. |
| Reverse Filter Field Value | Add this field to the log explorer to view all log data except those related to this field. |
| Add to Display Columns | Add this field to the explorer list for viewing. |
| Copy | Copy this field to the clipboard. |
| View Related Containers | View all containers related to this host. |
| View Related Processes | View all processes related to this host. |
| View Related Traces | View all traces related to this host. |
| View Related Inspections | View all inspection data related to this host. |
Log Content¶
-
The log content automatically switches between JSON and text viewing modes based on the
messagetype. If themessagefield does not exist in the log, the log content section will not be displayed. The log content supports expanding and collapsing, with the default state being expanded. When collapsed, only one line of height is displayed. -
For logs with
source:bpf_net_l4_log, JSON and packet viewing modes are automatically provided. The packet mode displays client, server, time, and other information, and supports switching between absolute and relative time display, with the default being absolute time. The switched configuration is saved in the local browser.
JSON Search¶
In JSON-formatted logs, you can search for both key and value. After clicking, the explorer search bar will add the format @key:value for searching.
For multi-level JSON data, use . to represent hierarchical relationships. For example, @key1.key2:value indicates searching for the value corresponding to key2 under key1.
For more details, refer to JSON Search.
Extended Fields¶
-
In the search bar, you can enter field names or values for quick search and positioning;
-
After checking the field alias, you can view it after the field name;
-
Hover over an extended field, click the dropdown icon, and you can perform the following operations on the field:
- Filter Field Value
- Reverse Filter Field Value
- Add to Display Columns
- Perform Dimension Analysis: Click to jump to Analysis Mode > Time Series Chart
- Copy
Note
If you choose to add a field to the display columns, an icon will appear in the list for easy identification.
Context Logs¶
The context query function of the log service helps you trace related records before and after an abnormal log occurs through time clues, quickly locating the root cause of the problem.
- On the log details page, you can directly view the context logs of the current data content;
- You can sort the data by clicking the "Time" list;
- The left dropdown allows you to select an index to filter corresponding data;
- Click the button to jump to the new page of context logs.
Supplementary Logical Understanding
According to the returned data, 50 pieces of data are loaded each time you scroll.
How is the returned data queried?
Prerequisite: Does the log have the log_read_lines field? If it exists, follow logic a; if it does not exist, follow logic b.
a. Get the log_read_lines value of the current log and filter with log_read_lines >= {{log_read_lines.value-30}} and log_read_lines <= {{log_read_lines.value +30}}
DQL Example: Current log line number = 1354170
Then:
L::RE(`.*`):(`message`) { `index` = 'default' and `host` = "ip-172-31-204-89.cn-northwest-1" AND `source` = "kodo-log" AND `service` = "kodo-inner" AND `filename` = "0.log" and `log_read_lines` >= 1354140 and `log_read_lines` <= 1354200} sorder by log_read_lines
b. Get the current log time, and derive the query start and end times by moving forward/backward.
-
Start Time: Move 5 minutes back from the current log time;
-
End Time: Take the time of the 50th log after the current log (·). If
time= current log time, usetime+1 microsecondas the end time; iftime≠ current log time, usetimeas the end time.
Context Log Details Page¶
Click to jump to the details page. You can manage all current data through the following operations:
- Enter text in the search box to search and locate data;
- Click the button on the side to switch the system default auto-wrap to content overflow mode, where each log is displayed in one line, and you can scroll left and right to view as needed.
Correlation Analysis¶
The system supports correlation analysis of log data. In addition to error details, extended fields, and context logs, you can also understand the host, container, network, etc., related to the log in one stop.
Built-in Pages¶
For built-in pages such as hosts, containers, and Pods, you can perform the following operations:
(Taking the "Host" built-in page as an example)
- Edit the fields displayed on the current page, and the system will automatically match corresponding data based on the fields;
- Choose to jump to the metrics view or host details page;
- Filter the time range.
Note
Only workspace administrators can modify the fields displayed on built-in pages. It is recommended to configure common fields. If the page is shared by multiple explorers, field modifications will take effect in real time.
For example: Configuring the "index" field here will display it normally if the log contains this field. However, if the trace explorer lacks this field, the corresponding value will not be displayed.
Built-in Views¶
In addition to the views displayed by default by the system here, you can also bind user views.
- Enter the built-in view binding page;
- View the default associated fields. You can choose to keep or delete fields, or add new
key:valuefields; - Select a view;
- After completing the binding, you can view the bound built-in views in the host object details. You can click the jump button to go to the corresponding built-in view page.









