forked from docs/doc-exports
Liu, Siying
df92dd687a
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com> Co-authored-by: Liu, Siying <liusiying@noreply.gitea.eco.tsi-dev.otc-service.com> Co-committed-by: Liu, Siying <liusiying@noreply.gitea.eco.tsi-dev.otc-service.com>
72 lines
10 KiB
HTML
72 lines
10 KiB
HTML
<a name="cts_03_0002"></a><a name="cts_03_0002"></a>
|
|
|
|
<h1 class="topictitle1">Configuring a Tracker</h1>
|
|
<div id="body8662426"><div class="section" id="cts_03_0002__en-us_topic_0170932828_section44745431173049"><h4 class="sectiontitle">Scenario</h4><p id="cts_03_0002__en-us_topic_0170932828_ae0731f4d0fbb4d4fa9375617d2732bd7">You can configure the file prefix of trackers on the CTS console no matter whether the trackers are enabled or not. For enabled trackers, you can also configure OBS buckets for trace transfer and LTS dumps.</p>
|
|
<ul id="cts_03_0002__en-us_topic_0170932828_ul197861137025"><li id="cts_03_0002__en-us_topic_0170932828_li3343910095343">You can select an existing OBS bucket for trace transfer. CTS will automatically attach a required policy to the OBS bucket.</li><li id="cts_03_0002__en-us_topic_0170932828_li078793710213">If you modify the trace file prefix of a tracker, the OBS bucket policy will not be affected.</li></ul>
|
|
<div class="note" id="cts_03_0002__en-us_topic_0170932828_note1944845171413"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="cts_03_0002__en-us_topic_0170932828_p1394494541411">There are three storage classes of OBS buckets, Standard, Infrequent Access, and Archive. You must use Standard OBS buckets for trace transfer because CTS needs to frequently access the OBS buckets.</p>
|
|
</div></div>
|
|
<p id="cts_03_0002__en-us_topic_0170932828_p33867259112732">The configuration will take effect immediately after it is complete.</p>
|
|
</div>
|
|
<div class="section" id="cts_03_0002__en-us_topic_0170932828_section13948718173426"><h4 class="sectiontitle">Prerequisites</h4><p id="cts_03_0002__en-us_topic_0170932828_p47704382173428">You have enabled CTS.</p>
|
|
</div>
|
|
<div class="section" id="cts_03_0002__en-us_topic_0170932828_section3571284110915"><h4 class="sectiontitle">Procedure</h4><ol id="cts_03_0002__en-us_topic_0170932828_ol5994761510915"><li id="cts_03_0002__en-us_topic_0170932828_li2952081710915">Log in to the management console.</li><li id="cts_03_0002__en-us_topic_0170932828_li913677210915">Click <span><img id="cts_03_0002__en-us_topic_0170932828_image8849822132811" src="en-us_image_0000001187949118.png"></span> in the upper left corner and choose <strong id="cts_03_0002__en-us_topic_0170932828_b068516527285">Management & Deployment</strong> > <strong id="cts_03_0002__en-us_topic_0170932828_b4849172214285">Cloud Trace Service</strong>. The CTS console is displayed.</li><li id="cts_03_0002__en-us_topic_0170932828_li5130618410915">Choose <strong id="cts_03_0002__en-us_topic_0170932828_b598117737">Tracker List</strong> in the navigation pane on the left.</li><li id="cts_03_0002__en-us_topic_0170932828_li590643495529">On the right of the tracker information, click <strong id="cts_03_0002__en-us_topic_0170932828_b1763794182016">Configure</strong>.</li><li id="cts_03_0002__en-us_topic_0170932828_li9235823153311">Configure a transfer.
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="cts_03_0002__en-us_topic_0170932828_table1810015091011" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameters for configuring a transfer</caption><thead align="left"><tr id="cts_03_0002__en-us_topic_0170932828_row171006071017"><th align="left" class="cellrowborder" valign="top" width="20.46%" id="mcps1.3.3.2.5.1.2.3.1.1"><p id="cts_03_0002__en-us_topic_0170932828_p710015012109">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="79.54%" id="mcps1.3.3.2.5.1.2.3.1.2"><p id="cts_03_0002__en-us_topic_0170932828_p1510040131019">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="cts_03_0002__en-us_topic_0170932828_row141003081019"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p71001706106">Transfer to OBS</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p171001407104">If you select <strong id="cts_03_0002__en-us_topic_0170932828_b34218171817">Yes</strong>, select an existing OBS bucket and set <strong id="cts_03_0002__en-us_topic_0170932828_b0423181710810">File Prefix</strong>.</p>
|
|
<p id="cts_03_0002__en-us_topic_0170932828_p510014019100">When <strong id="cts_03_0002__en-us_topic_0170932828_b11747149172111">Transfer to OBS</strong> is disabled, no operation is required.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row610080161014"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p61001207106">OBS Bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p310010161012"><strong id="cts_03_0002__en-us_topic_0170932828_b181040181011">New</strong>: If this function is enabled, an OBS bucket will be created automatically with the name you enter.</p>
|
|
<p id="cts_03_0002__en-us_topic_0170932828_p141001201107">Select <strong id="cts_03_0002__en-us_topic_0170932828_b188601648191713">Existing</strong>: Select an existing OBS bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row15100106102"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p610012014108">Select Bucket</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p31001061012">When you select <strong id="cts_03_0002__en-us_topic_0170932828_b4625175782016">New</strong>, 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, <strong id="cts_03_0002__en-us_topic_0170932828_b01671207236">my..bucket</strong> is not allowed.</p>
|
|
<p id="cts_03_0002__en-us_topic_0170932828_p210010111012">When you select <strong id="cts_03_0002__en-us_topic_0170932828_b92201628142511">Existing</strong>, select an existing OBS bucket.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row510019016103"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p1110090111014">Retention Period</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p71001403108">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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row10100100201017"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p41018017109">File Prefix</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p14101130151020">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.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row167008581753"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p169941638613">Transfer to LTS</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p69941231761">When <strong id="cts_03_0002__en-us_topic_0170932828_b994115815417">Transfer to LTS</strong> is enabled, traces are transferred to the log stream.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="cts_03_0002__en-us_topic_0170932828_row11889858558"><td class="cellrowborder" valign="top" width="20.46%" headers="mcps1.3.3.2.5.1.2.3.1.1 "><p id="cts_03_0002__en-us_topic_0170932828_p1499483960">Log group name</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="79.54%" headers="mcps1.3.3.2.5.1.2.3.1.2 "><p id="cts_03_0002__en-us_topic_0170932828_p49941336616">When <strong id="cts_03_0002__en-us_topic_0170932828_b28495297511">Transfer to LTS</strong> is enabled, the default log group name is <strong id="cts_03_0002__en-us_topic_0170932828_b113401545356">CTS</strong>. When <strong id="cts_03_0002__en-us_topic_0170932828_b5208203716279">Transfer to LTS</strong> is disabled, no operation is required.</p>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</li><li id="cts_03_0002__en-us_topic_0170932828_li36839883314">Click <strong id="cts_03_0002__en-us_topic_0170932828_b544912752919">OK</strong> to complete the configuration.<p id="cts_03_0002__en-us_topic_0170932828_p3261874810915">You can then view the tracker details on the <strong id="cts_03_0002__en-us_topic_0170932828_b842352706152452">Tracker List</strong> page.</p>
|
|
<div class="note" id="cts_03_0002__en-us_topic_0170932828_note5225481917328"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="cts_03_0002__en-us_topic_0170932828_p1187630417331">Traces recorded by CTS are delivered periodically to the OBS bucket for storage. If you configure an OBS bucket for a tracker, traces generated during the current cycle (usually several minutes) will be delivered to the configured OBS bucket. For example, if the current cycle is from 12:00:00 to 12:05:00 and you configure an OBS bucket for a tracker at 12:02:00, traces received from 12:00:00 to 12:02:00 will also be delivered to the configured OBS bucket for storage at 12:05:00.</p>
|
|
</div></div>
|
|
</li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="cts_03_0000.html">Tracker Management</a></div>
|
|
</div>
|
|
</div>
|
|
|