Querying Transferred Traces

Scenarios

CTS periodically sends trace files to OBS buckets. A trace file is a collection of traces. CTS generates trace files based on services and transfer cycle, and adjusts the number of traces contained in each trace file as needed. CTS can also save audit logs to LTS log streams.

This section describes how to view historical operation records in trace files downloaded from OBS buckets and in LTS log streams.

Constraints

For global services, you must configure trackers on the CTS console in the central region (CN-Hong Kong). This configuration enables the function of transferring traces to OBS or LTS. The preceding function will not take effect if you perform the configuration on the CTS console in any region outside the central region.

For details about Huawei Cloud global services, see Constraints.

Prerequisites

You have configured a tracker in CTS and enabled Transfer to OBS or Transfer to LTS. For details about how to configure a transfer, see Configuring a Tracker.

Querying Traces Transferred to OBS

If you enable Transfer to OBS when configuring the tracker, traces will be periodically transferred to a specified OBS bucket as trace files for long-term storage.

1. Log in to the management console.
2. Click in the upper left corner and choose Management & Governance > Cloud Trace Service. The CTS console is displayed.
3. Choose Tracker List in the navigation pane.
4. Click a bucket in the OBS Bucket column.
   Figure 1 Selecting an OBS bucket
   

5. In the OBS bucket, locate the file storage path to view the desired trace, and click Download on the right to download the file to the default download path of the browser. If you need to save it to a custom path, click More > Download As on the right.
   • The trace file storage path is as follows:

     OBS bucket name > CloudTraces > Region > Year > Month > Day > Tracker name > Service directory

     An example is User-defined name > CloudTraces > region > 2016 > 5 > 19 > system > ECS.

   • The trace file naming format is as follows:

     Trace file prefix_CloudTrace_Region/Region-project_Time when the trace file was uploaded to OBS: Year-Month-DayTHour-Minute-SecondZ_Random characters.json.gz

     Example: File prefix_CloudTrace_region-project_2016-05-30T16-20-56Z_21d36ced8c8af71e.json.gz

   

   The OBS bucket name and trace file prefix are user-defined, and other parameters are automatically generated.

   Downloading the file will incur request fees and traffic fees.

   For details about key fields in the CTS trace structure, see Trace Structure and Example Traces.

   Figure 2 Viewing trace file content
   

6. Decompress the downloaded package to obtain a JSON file with the same name as the package, as shown in Figure 3. Open the JSON file using a text file editor to view traces.
   Figure 3 JSON file
   

Querying Traces Transferred to LTS

If you enable Transfer to LTS when configuring a tracker, traces will be transferred to the CTS/{Tracker Name} log stream for long-term storage. {Tracker Name} indicates the name of the current tracker. For example, the log stream path of the management tracker is CTS/system-trace.

1. Log in to the management console.
2. Click in the upper left corner and choose Management & Governance > Cloud Trace Service. The CTS console is displayed.
3. Choose Tracker List in the navigation pane.
4. Click an LTS log stream in the Storage column.
   Figure 4 Selecting an LTS log stream
   

5. On the Log Stream tab page in the CTS log group page, select the {Tracker name} log stream to view trace logs.

   For details about key fields in the CTS trace structure, see Trace Structure and Example Traces.

6. Click to download the log file to your local PC.
   

   Each time you can download up to 5,000 log events. If the number of selected log events exceeds 5000, you cannot download them directly from LTS. Transfer them to OBS and then download them from OBS.