Creating a Tracker
Scenario
You can create data trackers to record operations on data. Data trackers record data traces, which are operations performed by tenants on data in OBS buckets, such as upload and download.
When you enable CTS, a management tracker is created automatically. Only one management tracker can be created. The trackers you created are all data trackers.
- If you want to trace operations on OBS buckets, ensure that you create a data tracker in a project instead of a sub-project. Otherwise, tracing fails because there are no sub-projects in OBS.
- CTS records operations performed in the last seven days. To store traces for a longer time, configure a tracker. The tracker will store traces to your specified LTS log streams or OBS buckets.
Prerequisites
You have enabled CTS.
Procedure
- Log in to the management console.
- In the service list, choose Management & Deployment > Cloud Trace Service. The CTS console is displayed.
- Choose Tracker List in the left navigation pane. In the upper right corner of the displayed page, click Create Tracker.
- Set basic information. Enter a tracker name. Click Next.
- Tracker name contains only letters, digits, hyphens (-), and underscores (_), and must start with a letter or digit.
- Tracker name cannot be empty and contains a maximum of 32 characters.
- The name of the data tracker cannot be system or system-trace.
- Select a trace. Set parameters and click Next.
Table 1 Parameters for selecting a trace Parameter
Description
Data Trace Source
Container for storing data traces. Currently, OBS buckets are used.
OBS Bucket
Select an OBS bucket from the drop-down list.
Operation
- Select the operations to record.
- Options: Read and Write. Select at least one of them.
- Configure a transfer. Set parameters and click Next.
Table 2 Parameters for configuring a transfer Parameter
Description
Transfer to OBS
If you select Yes, select an existing OBS bucket or create one on the Configure Tracker page and set File Prefix.
When Transfer to OBS is disabled, no operation is required.
OBS Bucket
New: If this function is enabled, an OBS bucket will be created automatically with the name you enter.
Select Existing: Select an existing OBS bucket.
Select Bucket
When you select New, enter an OBS bucket name. The OBS bucket name cannot be empty. It can contain 3 to 63 characters, including only lowercase letters, digits, hyphens (-), and periods (.). It cannot contain two consecutive periods (for example, my..bucket). A period (.) and a hyphen (-) cannot be adjacent to each other (for example, my-.bucket and my.-bucket). Do not use an IP address as a bucket name.
When you select Existing, select an existing OBS bucket.
Retention Period
The duration for storing traces in the OBS bucket. This configuration will apply to the selected bucket and all files in it. Different compliance standards require different trace retention periods. You are advised to set the retention period to at least 180 days.- For a data tracker, you can set the duration to 30 days, 60 days, 90 days, 180 days, 3 years, or the same as that of OBS.
File Prefix
A prefix is used to mark a transferred trace file. Your specified prefix will be automatically added to the beginning of the name of a transferred file, helping you quickly filter files. Enter 0 to 64 characters. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed.
Transfer to LTS
When Transfer to LTS is enabled, traces are transferred to the log stream.
Log group name
When Transfer to LTS is enabled, the default log group name CTS is set. When Transfer to LTS is disabled, no operation is required.
- Preview the tracker information and click Create.
- Click OK.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.