Log Details¶
In the log list, click the expand icon on the left side of a single log to display the details page for that log. You can view detailed information, including the log timestamp, host, source, service, content, extended fields, and view the context.
View Full Log¶
When a log is reported to Guance, if a single log entry exceeds 1 MB, the system splits it into multiple entries of up to 1 MB each. For example, a 2.5 MB log is split into three entries: 1 MB, 1 MB, and 0.5 MB. You can use the following fields to check the integrity of the split log:
Field |
Type | Description |
|---|---|---|
__truncated_id |
string | Unique identifier for the log. All split entries share the same __truncated_id, with the ID prefix LT_xxx. |
__truncated_count |
number | Total number of split entries. |
__truncated_number |
number | Sequence number of the split entry, starting from 0. 0 indicates the first entry. |
On the log details page, if the current log has been split into multiple entries, the View Full Log button appears in the upper-right corner. Clicking this button opens a new page listing all related log entries in split order. The log entry that was selected before navigation is color-coded for quick identification of upstream and downstream logs.
Obsy Copilot Error Analysis¶
Guance provides one-click error log analysis. It uses a large language model to automatically extract key information from logs, combined with online search engines and an operations knowledge base, to quickly analyze possible root causes and provide initial solutions.
- Filter all logs with status
error; - Click a single log entry to expand the details page;
- Click the Obsy Copilot Error Analysis button in the upper-right corner;
- The anomaly analysis begins.
Error Details¶
If the current log contains error_stack or error_message fields, the system provides error details related to that log entry.
For more log error information, see Log Error Tracking.
Attributes¶
Click on an attribute field to quickly filter and view host, process, trace, and container data related to the log.
| Field | Description |
|---|---|
| Filter by field value | Add this field to the Log Explorer to view all log data related to this field value. |
| Exclude field value | Add this field to the Log Explorer to view all log data except this field value. |
| Add to display columns | Add this field to the explorer list for display. |
| 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¶
Log content automatically switches between JSON and text viewing modes based on the message type. The log details display the content according to the index mode and log fields:
- When
messageexists in the log, themessagecontent is displayed first, and the view mode switches between JSON or text based on the content type. - When
messagedoes not exist in a full-text-indexed log, the system combines the log's business fields to display the content. - System fields are not included as part of the full-text-indexed log content.
- Log content supports expand and collapse; it is expanded by default and collapses to a single line.
Log content supports expand and collapse; it is expanded by default, collapsing to a single line height.
For logs with source:bpf_net_l4_log, the system automatically provides JSON and packet viewing modes. The packet mode displays client, server, time, and other information, and supports switching between absolute time and relative time display. The default is 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. Clicking adds the search term in the format @key:value to the explorer search bar.
For multi-level JSON data, use . to indicate the hierarchy. For example, @key1.key2:value searches for the value of key2 under key1.
For more details, see JSON Search.
Extended Fields¶
- In the search bar, you can enter field names or values to quickly search and locate.
- After checking a field alias, it can be viewed after the field name.
-
Hover over an extended field and click the dropdown icon to perform the following operations on that field:
- Filter by field value
- Exclude field value
- Add to display columns
- Perform dimension analysis: click to navigate to the analysis mode > time series chart
- Copy
Note
If you add a field to the display columns, an icon appears in the list for easy identification.
Context Logs¶
The context query feature of the log service helps you trace records before and after an anomaly log, quickly locating the root cause.
- On the log details page, you can directly view the context logs of the current data.
- Use the dropdown on the left to select an index and filter the corresponding data.
- Sort the data.
- Jump directly from the current details page to a new Log Explorer page.
- Display configuration
- Settings
Supplementary Logic
Each scroll loads 50 data entries.
How are the returned data queried?
Prerequisite: Does the log have a log_read_lines field? If yes, follow logic a; if not, 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 timestamp, and derive the query start and end times by going backward/forward.
- Start time: 5 minutes before the current log timestamp.
- End time: Get the 50th entry after the current log, take its time (·). If
timeequals the current log timestamp, usetime + 1 microsecondas the end time. Iftimedoes not equal the current log timestamp, usetimeas the end time.
Log Context Page¶
Click to jump to the log context page. You can manage all current data with the following actions:
- Enter text in the search box to search and locate data.
- Click the button on the side to switch from the default word wrap mode to content overflow mode, where each log entry is displayed in a single line and you can scroll horizontally as needed.
- Go to top/bottom.
- Load 100 entries upward/downward.
- Click the export icon to export the current log context data.
Related Analysis¶
The system supports related analysis of log data. In addition to error details, extended fields, and context logs, you can also get a one-stop view of the host, containers, network, and more associated with the log.
Built-in Pages¶
For built-in pages such as host, container, and Pod, you can perform the following operations:
(Using the "Host" built-in page as an example)
- Edit the display fields of the current page; the system automatically matches corresponding data based on the fields.
- Select to jump to the metric view or host details page.
- Filter the time range.
Note
Only workspace administrators can modify the display fields of built-in pages. It is recommended to configure common fields. If the page is shared by multiple explorers, field modifications take effect synchronously in real time.
For example: If you configure the "index" field here, logs containing this field will display normally. However, if the trace explorer lacks this field, the corresponding value will not be displayed.
Built-in Views¶
In addition to the default views displayed by the system, you can also bind user views.
- Navigate to the built-in view binding page.
- View the default associated fields. You can choose to keep or delete fields, and add new
key:valuefields. - Select a view.
- After binding, the bound built-in view can be viewed in the host object details. You can click the jump button to go to the corresponding built-in view page.








