DIS UMN 20231124 version

Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com>
Co-authored-by: Xiong, Chen Xiao <chenxiaoxiong@huawei.com>
Co-committed-by: Xiong, Chen Xiao <chenxiaoxiong@huawei.com>

docs/dis/umn/dis_01_0010.html

@@ -10,6 +10,10 @@
 </li>
 <li class="ulchildlink"><strong><a href="dis_01_0050.html">Managing Stream Tags</a></strong><br>
 </li>
+<li class="ulchildlink"><strong><a href="dis_01_0076.html">Managing Applications</a></strong><br>
+</li>
+<li class="ulchildlink"><strong><a href="dis_01_0401.html">Scaling Up/Down a Stream</a></strong><br>
+</li>
 <li class="ulchildlink"><strong><a href="dis_01_0013.html">Deleting a Stream</a></strong><br>
 </li>
 </ul>

docs/dis/umn/dis_01_0011.html

@@ -2,9 +2,9 @@
 
 <h1 class="topictitle1">Listing DIS Streams</h1>
 <div id="body1493022272990"><p id="dis_01_0011__p46736664121012">The <strong id="dis_01_0011__b2068322215377">Stream Management</strong> page displays all DIS streams created. After clicking a stream, you can view the following information about this stream:</p>
-<div class="fignone" id="dis_01_0011__fig1657418112911"><span class="figcap"><b>Figure 1 </b>Stream Management</span><br><span><img id="dis_01_0011__image97294991710" src="en-us_image_0000001403086902.gif"></span></div>
+<div class="fignone" id="dis_01_0011__fig1657418112911"><span class="figcap"><b>Figure 1 </b>Stream Management</span><br><span><img id="dis_01_0011__image1153572822810" src="en-us_image_0000001835382181.png" title="Click to enlarge" class="imgResize"></span></div>
 <ul id="dis_01_0011__ul31495006113939"><li id="dis_01_0011__lf419419f6a094720981fd7e28332154e"><strong id="dis_01_0011__b7522958141418">Name/ID</strong>: Unique name of the DIS stream to be created. A stream name is 1 to 64 characters long. Only letters, digits, hyphens (-), and underscores (_) are allowed.</li><li id="dis_01_0011__li60941563175422"><strong id="dis_01_0011__b27460177153911">Status</strong>: Stream status.</li><li id="dis_01_0011__li6614401195218"><strong id="dis_01_0011__b59292158153920">Stream Type</strong>: <strong id="dis_01_0011__b37935460153920">Common</strong> and <strong id="dis_01_0011__b52873419153920">Advanced</strong>.<ul id="dis_01_0011__u2b3f8278e59e49da94989a4c963e9a13"><li id="dis_01_0011__lafdd26e566fe4d7fb0ab1db0bdbcbebc"><strong id="dis_01_0011__b1988943501820">Common</strong>: Each partition supports a maximum read speed of 2 MB/s and a maximum write speed of 1 MB/s or 1,000 records/s.</li><li id="dis_01_0011__l9df050c26351412ba117351b3761c052"><strong id="dis_01_0011__b5734961911">Advanced</strong>: Each partition supports a maximum read speed of 10 MB/s and a maximum write speed of 5 MB/s or 2,000 records/s.</li></ul>
-</li><li id="dis_01_0011__li2737457515395"><strong id="dis_01_0011__b1488461672311">Partitions</strong>: The number of partitions into which data records in the newly created DIS stream will be distributed. Multiple partitions of a stream can concurrently transmit data to improve efficiency.</li><li id="dis_01_0011__li4148713110517"><strong id="dis_01_0011__b18144118142818">Data Retention (hours)</strong>: The maximum number of hours for DIS to preserve data. Data will be deleted when the retention period expires. Value range: an integer ranging from 24 to 72. Unit: hour</li><li id="dis_01_0011__li33906238175544"><strong id="dis_01_0011__b62919478154123">Created</strong>: Time at which the DIS stream is created. The creation time is in the <em id="dis_01_0011__i10988722174412">yyyy/MM/dd HH:mm:ss</em> <strong id="dis_01_0011__b3207112814442">GMT</strong> format. For example, 2017/05/09 08:00:00 GMT+08:00.</li><li id="dis_01_0011__li65182377175740"><strong id="dis_01_0011__b125444211658">Operation</strong>: Supported operations include <strong id="dis_01_0011__b176104012479">Delete</strong>, and <strong id="dis_01_0011__b31815119500">View Dump Task</strong>.</li></ul>
+</li><li id="dis_01_0011__li2737457515395"><strong id="dis_01_0011__b1488461672311">Partitions</strong>: The number of partitions into which data records in the newly created DIS stream will be distributed. Multiple partitions of a stream can concurrently transmit data to improve efficiency.</li><li id="dis_01_0011__li4148713110517"><strong id="dis_01_0011__b18144118142818">Data Retention (hours)</strong>: The maximum number of hours for DIS to preserve data. Data will be deleted when the retention period expires. Value range: an integer ranging from 24 to 72. Unit: hour</li><li id="dis_01_0011__li33906238175544"><strong id="dis_01_0011__b62919478154123">Created</strong>: Time at which the DIS stream is created. The creation time is in the <em id="dis_01_0011__i10988722174412">yyyy/MM/dd HH:mm:ss</em> <strong id="dis_01_0011__b3207112814442">GMT</strong> format. For example, 2017/05/09 08:00:00 GMT+08:00.</li><li id="dis_01_0011__li65182377175740"><strong id="dis_01_0011__b125444211658">Operation</strong>: Supported operations include <strong id="dis_01_0011__b176104012479">Delete</strong>, and <strong id="dis_01_0011__b31815119500">View Dump Task</strong>. </li></ul>
 </div>
 <div>
 <div class="familylinks">
@@ -12,3 +12,10 @@
 </div>
 </div>
 
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dis/umn/dis_01_0012.html

@@ -2,7 +2,7 @@
 
 <h1 class="topictitle1">Viewing Stream Monitoring Metrics</h1>
 <div id="body1493022272990"><p id="dis_01_0012__p465711711267">You can view stream monitoring information on the console and monitor the data consumed by applications in the stream.</p>
-<ol id="dis_01_0012__ol12431334121516"><li id="dis_01_0012__li15698020121516"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0012__li820627292052"><span>Click <span><img id="dis_01_0012__image01970275396" src="en-us_image_0120206196.png"></span> in the upper left corner and select a region and a project.</span></li><li id="dis_01_0012__li15493172951416"><span>In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0012__parmvalue68691459184519"><b>Stream Management</b></span>.</span></li><li id="dis_01_0012__li3041782121655"><span>In the stream list, click the name of the DIS stream whose monitoring metrics you want to view.</span><p><div class="fignone" id="dis_01_0012__fig20331141119419"><span class="figcap"><b>Figure 1 </b>Monitoring page</span><br><span><img id="dis_01_0012__image1066412017203" src="en-us_image_0000001453327325.gif"></span></div>
+<ol id="dis_01_0012__ol12431334121516"><li id="dis_01_0012__li15698020121516"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0012__li820627292052"><span>Click <span><img id="dis_01_0012__image01970275396" src="en-us_image_0120206196.png"></span> in the upper left corner and select a region and a project.</span></li><li id="dis_01_0012__li15493172951416"><span>In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0012__parmvalue68691459184519"><b>Stream Management</b></span>.</span></li><li id="dis_01_0012__li3041782121655"><span>In the stream list, click the name of the DIS stream whose monitoring metrics you want to view.</span><p><div class="fignone" id="dis_01_0012__fig20331141119419"><span class="figcap"><b>Figure 1 </b>Monitoring page</span><br><span><img id="dis_01_0012__image637893262917" src="en-us_image_0000001788903274.png" title="Click to enlarge" class="imgResize"></span></div>
 </p></li><li id="dis_01_0012__li41810086164916"><span>On the <span class="wintitle" id="dis_01_0012__wintitle17741204819219"><b>Monitoring</b></span> page, click the <strong id="dis_01_0012__b311911732212">Streams</strong> or <strong id="dis_01_0012__b830213092218">Partitions</strong> tab to view stream or partition monitoring metrics. <a href="#dis_01_0012__table2942144318834">Table 1</a> describes the monitoring parameters. For details about basic stream information, see <a href="dis_01_0601.html#dis_01_0601__table1518745742610">Table 1</a>.</span><p>
 <div class="tablenoborder"><a name="dis_01_0012__table2942144318834"></a><a name="table2942144318834"></a><table cellpadding="4" cellspacing="0" summary="" id="dis_01_0012__table2942144318834" frame="border" border="1" rules="all"><caption><b>Table 1 </b>DIS monitoring information</caption><thead align="left"><tr id="dis_01_0012__row6686704018834"><th align="left" class="cellrowborder" valign="top" width="30%" id="mcps1.3.2.5.2.1.2.3.1.1"><p id="dis_01_0012__p4752119818834">Parameter</p>
 </th>
@@ -14,6 +14,7 @@
 </td>
 <td class="cellrowborder" valign="top" width="70%" headers="mcps1.3.2.5.2.1.2.3.1.2 "><ul id="dis_01_0012__ul210231152417"><li id="dis_01_0012__li1101031122413">Monitoring time range.<p id="dis_01_0012__p502247718834"><a name="dis_01_0012__li1101031122413"></a><a name="li1101031122413"></a>Values:</p>
 <ul id="dis_01_0012__ul4520229418834"><li id="dis_01_0012__li416746518834">1h</li><li id="dis_01_0012__li3750719218834">3h</li><li id="dis_01_0012__li202041018834">12h</li></ul>
+</li><li id="dis_01_0012__li1869889254">You can customize the time range for viewing monitoring information.<ul id="dis_01_0012__ul16772475349"><li id="dis_01_0012__li8677104711345">Click <span><img id="dis_01_0012__image10677547103413" src="en-us_image_0127307205.jpg"></span> next to <span class="wintitle" id="dis_01_0012__wintitle13677547123415"><b>Custom</b></span>, and then set the start time and end time.</li><li id="dis_01_0012__li4677104717349">The end time cannot be later than the current system time.</li><li id="dis_01_0012__li96777473347">The difference between the start time and end time cannot exceed 72 hours.</li></ul>
 </li></ul>
 </td>
 </tr>
@@ -74,3 +75,10 @@
 </div>
 </div>
 
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dis/umn/dis_01_0013.html

@@ -3,8 +3,8 @@
 <h1 class="topictitle1">Deleting a Stream</h1>
 <div id="body1493022272990"><div class="note" id="dis_01_0013__note1891164345819"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dis_01_0013__p1893674685816">A deleted stream will not be charged and cannot be restored. Exercise caution when performing this operation.</p>
 </div></div>
-<ol id="dis_01_0013__ol12431334121516"><li id="dis_01_0013__li11931210353"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0013__li5720339992121"><span>Click <span><img id="dis_01_0013__image11686217981" src="en-us_image_0120206196.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0013__li17808203718103"><span>In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0013__parmvalue12880911195711"><b>Stream Management</b></span>.</span><p><div class="fignone" id="dis_01_0013__fig175341921174517"><span class="figcap"><b>Figure 1 </b>Managing DIS streams</span><br><span><img id="dis_01_0013__image1534336182420" src="en-us_image_0000001402769822.gif"></span></div>
+<ol id="dis_01_0013__ol12431334121516"><li id="dis_01_0013__li11931210353"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0013__li5720339992121"><span>Click <span><img id="dis_01_0013__image11686217981" src="en-us_image_0120206196.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0013__li17808203718103"><span>In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0013__parmvalue12880911195711"><b>Stream Management</b></span>.</span><p><div class="fignone" id="dis_01_0013__fig175341921174517"><span class="figcap"><b>Figure 1 </b>Stream Management</span><br><span><img id="dis_01_0013__dis_01_0011_image1153572822810" src="en-us_image_0000001835382181.png" title="Click to enlarge" class="imgResize"></span></div>
-</p></li><li id="dis_01_0013__li3041782121655"><span>Click <strong id="dis_01_0013__b67061953152815">Delete</strong> in the <strong id="dis_01_0013__b1523515414299">Operation</strong> column of the stream that you want to delete. The <span class="wintitle" id="dis_01_0013__wintitle137401525153110"><b>Delete Stream</b></span> dialog box is displayed.</span><p><div class="fignone" id="dis_01_0013__fig9378152944611"><span class="figcap"><b>Figure 2 </b>Deleting a stream</span><br><span><img id="dis_01_0013__image97971818122519" src="en-us_image_0000001453010069.gif"></span></div>
+</p></li><li id="dis_01_0013__li3041782121655"><span>Click <strong id="dis_01_0013__b67061953152815">Delete</strong> in the <strong id="dis_01_0013__b1523515414299">Operation</strong> column of the stream that you want to delete. The <span class="wintitle" id="dis_01_0013__wintitle137401525153110"><b>Delete Stream</b></span> dialog box is displayed.</span><p><div class="fignone" id="dis_01_0013__fig9378152944611"><span class="figcap"><b>Figure 2 </b>Deleting a stream</span><br><span><img id="dis_01_0013__image1952916567307" src="en-us_image_0000001835503737.png" title="Click to enlarge" class="imgResize"></span></div>
 </p></li><li id="dis_01_0013__li14467764121924"><span>Click <span class="uicontrol" id="dis_01_0013__uicontrol59221846133114"><b>OK</b></span> to delete the selected stream.</span></li></ol>
 </div>
 <div>
@@ -13,3 +13,10 @@
 </div>
 </div>
 
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dis/umn/dis_01_0014.html

@@ -8,7 +8,24 @@
 </th>
 </tr>
 </thead>
-<tbody><tr id="dis_01_0014__row15370151119340"><td class="cellrowborder" valign="top" width="36.480000000000004%" headers="mcps1.3.1.1.3.1.1 "><p id="dis_01_0014__p837121117341">2023-03-30</p>
+<tbody><tr id="dis_01_0014__row6546050104010"><td class="cellrowborder" valign="top" width="36.480000000000004%" headers="mcps1.3.1.1.3.1.1 "><p id="dis_01_0014__p18663158194010">2024-01-30</p>
+</td>
+<td class="cellrowborder" valign="top" width="63.519999999999996%" headers="mcps1.3.1.1.3.1.2 "><p id="dis_01_0014__p464544734115">Replaced unclear figures in the document with clear ones.</p>
+</td>
+</tr>
+<tr id="dis_01_0014__row1979133985910"><td class="cellrowborder" valign="top" width="36.480000000000004%" headers="mcps1.3.1.1.3.1.1 "><p id="dis_01_0014__p45402425591">2023-11-24</p>
+</td>
+<td class="cellrowborder" valign="top" width="63.519999999999996%" headers="mcps1.3.1.1.3.1.2 "><p id="dis_01_0014__p11791193915591">Added the following sections:</p>
+<ul id="dis_01_0014__ul158285112017"><li id="dis_01_0014__li1582871900"><a href="dis_01_0076.html">Managing Applications</a></li><li id="dis_01_0014__li86562129011"><a href="dis_01_0401.html">Scaling Up/Down a Stream</a></li></ul>
+</td>
+</tr>
+<tr id="dis_01_0014__row19568339125320"><td class="cellrowborder" valign="top" width="36.480000000000004%" headers="mcps1.3.1.1.3.1.1 "><p id="dis_01_0014__p9919649185310">2023-09-20</p>
+</td>
+<td class="cellrowborder" valign="top" width="63.519999999999996%" headers="mcps1.3.1.1.3.1.2 "><p id="dis_01_0014__p056815390535">Added the following section:</p>
+<p id="dis_01_0014__p1850202605915"><a href="dis_01_0051.html">Notifying Events</a></p>
+</td>
+</tr>
+<tr id="dis_01_0014__row15370151119340"><td class="cellrowborder" valign="top" width="36.480000000000004%" headers="mcps1.3.1.1.3.1.1 "><p id="dis_01_0014__p837121117341">2023-03-30</p>
 </td>
 <td class="cellrowborder" valign="top" width="63.519999999999996%" headers="mcps1.3.1.1.3.1.2 "><p id="dis_01_0014__p8371131116347">Modified the following sections:</p>
 <ul id="dis_01_0014__ul41579258367"><li id="dis_01_0014__li17158525103610"><a href="dis_01_0009.html">General Procedure</a></li><li id="dis_01_0014__li121581125133610"><a href="dis_01_0601.html">Step 1: Creating a DIS Stream</a></li><li id="dis_01_0014__li141581225183620"><a href="dis_01_0012.html">Viewing Stream Monitoring Metrics</a></li><li id="dis_01_0014__li315872510364"><a href="dis_06_0013.html">Configuring Sample Projects</a></li></ul>

docs/dis/umn/dis_01_0076.html

@@ -0,0 +1,31 @@
+<a name="dis_01_0076"></a><a name="dis_01_0076"></a>
+
+<h1 class="topictitle1">Managing Applications</h1>
+<div id="body1554814073688"><p id="dis_01_0076__p2048719503124">An application is a program identifier. Multiple applications can access data in the same stream. Checkpoints generated for each application are used to record the consumed data in the stream by each application.</p>
+<p id="dis_01_0076__p971216467145">You can create applications and view details about existing application on the DIS console.</p>
+<div class="section" id="dis_01_0076__section163216145244"><h4 class="sectiontitle">Creating an Application</h4><ol id="dis_01_0076__ol8575153220243"><li id="dis_01_0076__li783171811411"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0076__li820627292052"><span>Click <span><img id="dis_01_0076__ib73142d003bb4d1b9b6937ab203bac01" src="en-us_image_0165093532.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0076__li2051710541255"><span>In the navigation tree, select <strong id="dis_01_0076__b395995768">App Management</strong>.</span><p><p id="dis_01_0076__p5311143912611">On the <strong id="dis_01_0076__b151667549245">Applications</strong> page, click <span class="uicontrol" id="dis_01_0076__uicontrol1349061172513"><b>Create App</b></span> and enter an application name.</p>
+</p></li></ol>
+</div>
+<div class="section" id="dis_01_0076__section1152824522716"><h4 class="sectiontitle">Viewing an Application</h4><ol id="dis_01_0076__ol050552672816"><li id="dis_01_0076__li15698020121516"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0076__li1362313333288"><span>Click <span><img id="dis_01_0076__image11623133102812" src="en-us_image_0165094364.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0076__li33202991121523"><span>In the navigation tree on the left, choose <span class="uicontrol" id="dis_01_0076__uicontrol573194518506"><b>Stream Management</b></span>.</span></li><li id="dis_01_0076__li3041782121655"><span>Click the name of a stream that you want to view.</span></li><li id="dis_01_0076__li72425132917"><span>Click <span class="wintitle" id="dis_01_0076__wintitle32915364298"><b>Applications</b></span> to view all applications that access the stream.</span><p><p id="dis_01_0076__p7221016422">You can view the names, IDs, and creation time of the applications that access the stream.</p>
+<p id="dis_01_0076__p13227642626">After you click <span class="uicontrol" id="dis_01_0076__uicontrol3479534836"><b>Remove All Checkpoints</b></span>, all checkpoints of the application will be deleted.</p>
+<div class="note" id="dis_01_0076__note1746412615911"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dis_01_0076__p104651461493">When an application consumes data, the latest SN of the consumed data is recorded as a checkpoint. When the data is reconsumed, the consumption can be continued based on this checkpoint.</p>
+</div></div>
+<div class="p" id="dis_01_0076__p12176163795"><div class="fignone" id="dis_01_0076__fig101995125216"><span class="figcap"><b>Figure 1 </b>Viewing applications</span><br><span><img id="dis_01_0076__image219917123216" src="en-us_image_0165229968.jpg" title="Click to enlarge" class="imgResize"></span></div>
+</div>
+</p></li><li id="dis_01_0076__li5120040101612"><span>Click a specific application to view its consumption details about the stream.</span><p><div class="fignone" id="dis_01_0076__fig095212497205"><span class="figcap"><b>Figure 2 </b>Viewing stream consumption details</span><br><span><img id="dis_01_0076__image14952184912017" src="en-us_image_0165286917.jpg" title="Click to enlarge" class="imgResize"></span></div>
+</p></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dis_01_0010.html">Managing DIS Streams</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dis/umn/dis_01_0401.html

@@ -0,0 +1,44 @@
+<a name="dis_01_0401"></a><a name="dis_01_0401"></a>
+
+<h1 class="topictitle1">Scaling Up/Down a Stream</h1>
+<div id="body1524626570944"><p id="dis_01_0401__p14537121495">After a stream is created successfully, you can scale up or down a stream by adding or reducing partitions to meet capacity change requirements. Streams can be scaled automatically or manually.</p>
+<div class="section" id="dis_01_0401__section12681451535"><h4 class="sectiontitle">Constraints</h4><ul id="dis_01_0401__ul26721371842"><li id="dis_01_0401__li126021438267">A maximum of 10 automatic scale-up, 10 manual scale-up, and 1 scale-down operations can be performed for each stream within one hour.</li><li id="dis_01_0401__li024914287119">After scaling up or down a stream, pay attention to the following:<ul id="dis_01_0401__ul728111341864"><li id="dis_01_0401__li14642142611106">When uploading data, you are not advised to set PartitionKey. DIS automatically uploads data to multiple partitions based on the number of partitions in the stream. If you set PartitionKey, data skew and throttling may occur in the stream.</li><li id="dis_01_0401__li510718448105">When downloading data, you need to periodically use the descriptStream API to check the partition quantity change so that DIS can download data from all partitions.</li></ul>
+</li></ul>
+</div>
+<div class="section" id="dis_01_0401__section156236268106"><h4 class="sectiontitle">Auto Scaling</h4><div class="p" id="dis_01_0401__p163623589"><strong id="dis_01_0401__b49940341143">Auto Scaling Mechanism</strong><ul id="dis_01_0401__ul1371511576812"><li id="dis_01_0401__li22041553346">If throttling is triggered in the last minute (that is, the maximum throughput of the partitions in the stream has been reached) and the upload traffic of the stream is greater than 80% of the stream bandwidth, an automatic scale-up is triggered. The number of target partitions is equal to the number of current partitions divided by 0.6 and rounded up.<p id="dis_01_0401__p15136121715106"><a name="dis_01_0401__li22041553346"></a><a name="li22041553346"></a>For example, a stream has five common partitions, and the upload bandwidth of the stream is 5 Mbit/s. If throttling is triggered in the last minute and the upload traffic of the stream exceeds 4 Mbit/s, an automatic scale-up is triggered to add four more partitions. The number of target partitions is 8.3 (5/0.6), which is rounded up to 9.</p>
+</li><li id="dis_01_0401__li117166571587">If the upload traffic and download traffic of a stream are both less than 30% of the stream bandwidth, an auto scale-down is triggered. The number of target partitions is equal to the number of current partitions divided by 2 and rounded down.<p id="dis_01_0401__p0965151291420"><a name="dis_01_0401__li117166571587"></a><a name="li117166571587"></a>For example, a stream has five common partitions, and its upload and download bandwidth is 5 Mbit/s and 10 Mbit/s, respectively. If the upload traffic of the stream is less than 1.5 Mbit/s and the download traffic is less than 3 Mbit/s, an automatic scale-down is triggered to remove three partitions. The number of target partitions is 2.5 (5/2), which is rounded down to 2.</p>
+</li></ul>
+</div>
+<div class="p" id="dis_01_0401__p20640126161017"><strong id="dis_01_0401__b128811340448">Auto Scaling Rules</strong><ul id="dis_01_0401__ul13781151121018"><li id="dis_01_0401__li482505374715">The interval between performing automatic scale-up and scale-down must be greater than 1 minute. Automatic scale-down cannot be triggered within 2 minutes after automatic or manual scale-up is performed, and meanwhile automatic scale-up cannot be triggered within 2 minutes after automatic or manual scale-down is performed.</li><li id="dis_01_0401__li14779351141017">When scaling up a stream, restore the <span class="parmvalue" id="dis_01_0401__parmvalue11779651181010"><b>DELETED</b></span> and <span class="parmvalue" id="dis_01_0401__parmvalue577919515101"><b>EXPIRED</b></span> partitions to the <span class="parmvalue" id="dis_01_0401__parmvalue077935115107"><b>ACTIVE</b></span> partitions to make the partitions accessible. If the stream capacity is still insufficient, the system will create new partitions.</li><li id="dis_01_0401__li1381012127012">The partitions that have been scaled down will not be charged or occupy the quota. Data on those partitions is readable but is not writable during <span class="parmname" id="dis_01_0401__parmname146542435489"><b>Data Retention</b></span> configured in <a href="dis_01_0601.html">Step 1: Creating a DIS Stream</a>. Once <span class="parmname" id="dis_01_0401__parmname118661723134920"><b>Data Retention</b></span> is expired, the data will become inaccessible.</li></ul>
+</div>
+<p id="dis_01_0401__p14392037121618"><strong id="dis_01_0401__b18244416153312">Enabling Auto Scaling</strong></p>
+<ol id="dis_01_0401__ol1228674155118"><li id="dis_01_0401__li15698020121516"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0401__li728618415511"><span>Click <span><img id="dis_01_0401__image228617410518" src="en-us_image_0000001623208020.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0401__li20284191283913"><span>Perform the following steps to automatically scale up or down a stream:</span><p><div class="p" id="dis_01_0401__p1522335217816">In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0401__parmvalue1317920516578"><b>Stream Management</b></span>.<ol type="a" id="dis_01_0401__ol20284151273913"><li id="dis_01_0401__li62841612173916">On the <span class="wintitle" id="dis_01_0401__wintitle82867425111"><b>Stream Management</b></span> page, click the name of the stream to be scaled.</li><li id="dis_01_0401__li328417129391">Click <span><img id="dis_01_0401__image1807381477" src="en-us_image_0000001671447933.png"></span> next to <span class="wintitle" id="dis_01_0401__wintitle13901353103313"><b>Auto Scaling</b></span>.</li><li id="dis_01_0401__li132844127392">In the displayed <span class="wintitle" id="dis_01_0401__wintitle2644111812553"><b>Edit Auto-Scaling Parameter</b></span> dialog box, enable <strong id="dis_01_0401__b460943154918">Auto-Scaling</strong>.<div class="fignone" id="dis_01_0401__fig1073713481486"><span class="figcap"><b>Figure 1 </b>Edit Auto-Scaling Parameter</span><br><span><img id="dis_01_0401__image1915017311684" src="en-us_image_0000001671647961.png" title="Click to enlarge" class="imgResize"></span></div>
+</li><li id="dis_01_0401__li13302640514">Set the upper and lower thresholds for automatic scaling and click <span class="uicontrol" id="dis_01_0401__uicontrol14302194105120"><b>OK</b></span>.</li></ol>
+</div>
+</p></li></ol>
+</div>
+<div class="section" id="dis_01_0401__section171845509519"><h4 class="sectiontitle">Manual Scaling</h4><div class="p" id="dis_01_0401__p83051010312"><strong id="dis_01_0401__b16193413346">Manual Scaling Rules</strong><ul id="dis_01_0401__ul103111106312"><li id="dis_01_0401__li1331101015314">When scaling up a stream, ensure that the number of target partitions is greater than the number of the current partitions but is not greater than the total number of the remaining quotas and current partitions.</li><li id="dis_01_0401__li193131015315">When scaling up a stream, restore the <span class="parmvalue" id="dis_01_0401__dis_01_0401_parmvalue11779651181010"><b>DELETED</b></span> and <span class="parmvalue" id="dis_01_0401__dis_01_0401_parmvalue577919515101"><b>EXPIRED</b></span> partitions to the <span class="parmvalue" id="dis_01_0401__dis_01_0401_parmvalue077935115107"><b>ACTIVE</b></span> partitions to make the partitions accessible. If the stream capacity is still insufficient, the system will create new partitions.</li><li id="dis_01_0401__li23210101837">When scaling down a stream, ensure that the number of target partitions is smaller than the number of current partitions but is not smaller than <span class="parmvalue" id="dis_01_0401__parmvalue1768265310350"><b>1</b></span>.</li><li id="dis_01_0401__li93211103317">The partitions that have been scaled down will not be charged or occupy the quota. Data on those partitions is readable but is not writable during <span class="parmname" id="dis_01_0401__dis_01_0401_parmname146542435489"><b>Data Retention</b></span> configured in <a href="dis_01_0601.html">Step 1: Creating a DIS Stream</a>. Once <span class="parmname" id="dis_01_0401__dis_01_0401_parmname118661723134920"><b>Data Retention</b></span> is expired, the data will become inaccessible.</li></ul>
+</div>
+<p id="dis_01_0401__p14736199141913"><strong id="dis_01_0401__b1842453915366">Manually Scaling Up/Down a Stream</strong></p>
+<ol id="dis_01_0401__ol12431334121516"><li id="dis_01_0401__li143408451346"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0401__li5720339992121"><span>Click <span><img id="dis_01_0401__image11686217981" src="en-us_image_0120206196.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0401__li1546122043718"><span>Perform either of the following operations to manually scale up or down a stream:</span><p><ul id="dis_01_0401__ul1284816192415"><li id="dis_01_0401__li384111611243">In the navigation tree on the left, choose <strong id="dis_01_0401__b1898614119210">Stream Management</strong>.<ol type="a" id="dis_01_0401__ol946192014377"><li id="dis_01_0401__li194611720143720">On the <span class="wintitle" id="dis_01_0401__wintitle17798646191612"><b>Stream Management</b></span> page, click the name of the stream to be scaled.</li><li id="dis_01_0401__li114617201377">In the upper right corner of the displayed page, click <span class="uicontrol" id="dis_01_0401__uicontrol7383731121815"><b>Scale Up/Down</b></span>. The <span class="wintitle" id="dis_01_0401__wintitle6384731141814"><b>Scale Up/Down Stream</b></span> dialog box is displayed.</li><li id="dis_01_0401__li16365055114020">Change the number of target partitions and click <span class="uicontrol" id="dis_01_0401__uicontrol77165732013"><b>Yes</b></span>.</li></ol>
+</li></ul>
+<ul id="dis_01_0401__ul11953161842412"><li id="dis_01_0401__li2095317186244">In the navigation tree on the left, choose <strong id="dis_01_0401__b1071011494201">Stream Management</strong>.<ol type="a" id="dis_01_0401__ol17461220113712"><li id="dis_01_0401__li1546162023717">In the <strong id="dis_01_0401__b36559868162031">Operation</strong> column of the stream to be scaled, click <strong id="dis_01_0401__b8559365162031">More</strong> and choose <strong id="dis_01_0401__b22219970162031">Scale Up/Down</strong> from the drop-down list.</li><li id="dis_01_0401__li7461120163714">The <span class="wintitle" id="dis_01_0401__wintitle28042272014"><b>Scale Up/Down Partition</b></span> dialog box is displayed.</li><li id="dis_01_0401__li14467764121924">Change the number of target partitions and click <span class="uicontrol" id="dis_01_0401__uicontrol1409137264"><b>Yes</b></span>.</li></ol>
+</li></ul>
+</p></li></ol>
+</div>
+<div class="section" id="dis_01_0401__section336645117567"><h4 class="sectiontitle">Viewing Scale-Up/Down Logs</h4><ol id="dis_01_0401__ol571372551716"><li id="dis_01_0401__li28871131518"><span>Use the account to log in to the DIS console.</span></li><li id="dis_01_0401__li820627292052"><span>Click <span><img id="dis_01_0401__image3451154313219" src="en-us_image_0120396589.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0401__li8281205935611"><span>In the navigation tree on the left, choose <span class="parmvalue" id="dis_01_0401__parmvalue28151412105819"><b>Stream Management</b></span>.</span></li><li id="dis_01_0401__li3041782121655"><span>Click the name of a stream to access its details page.</span></li><li id="dis_01_0401__li168514053111"><span>On the displayed page, click the <span class="wintitle" id="dis_01_0401__wintitle166811742239"><b>Scale-Up/Down Logs</b></span> tab. View the scaling details of the stream.</span></li></ol>
+</div>
+</div>
+<div>
+<div class="familylinks">
+<div class="parentlink"><strong>Parent topic:</strong> <a href="dis_01_0010.html">Managing DIS Streams</a></div>
+</div>
+</div>
+
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>

docs/dis/umn/dis_01_0601.html

@@ -2,7 +2,7 @@
 
 <h1 class="topictitle1">Step 1: Creating a DIS Stream</h1>
 <div id="body1523161881728"><p class="MsoNormal" id="dis_01_0601__p17890920">You can create a DIS stream on the DIS management console.</p>
-<div class="section" id="dis_01_0601__section39878449"><h4 class="sectiontitle">Procedure</h4><ol id="dis_01_0601__ol5583857"><li id="dis_01_0601__li44100051"><span>Use the account to log in to the DIS console.</span><p><div class="fignone" id="dis_01_0601__fig12690164612212"><span class="figcap"><b>Figure 1 </b>DIS management console</span><br><span><img id="dis_01_0601__image46631718216" src="en-us_image_0000001403080926.gif"></span></div>
+<div class="section" id="dis_01_0601__section39878449"><h4 class="sectiontitle">Procedure</h4><ol id="dis_01_0601__ol5583857"><li id="dis_01_0601__li44100051"><span>Use the account to log in to the DIS console.</span><p><div class="fignone" id="dis_01_0601__fig12690164612212"><span class="figcap"><b>Figure 1 </b>DIS management console</span><br><span><img id="dis_01_0601__image96591647172519" src="en-us_image_0000001788900822.png" title="Click to enlarge" class="imgResize"></span></div>
 </p></li><li id="dis_01_0601__li9660575153718"><span>Click <span><img id="dis_01_0601__image109908414311" src="en-us_image_0120206164.png"></span> in the upper left corner of the page and select a region and project.</span></li><li id="dis_01_0601__li23032735111458"><span>Click Create Stream and set related parameters.</span><p>
 <div class="tablenoborder"><a name="dis_01_0601__table1518745742610"></a><a name="table1518745742610"></a><table cellpadding="4" cellspacing="0" summary="" id="dis_01_0601__table1518745742610" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Stream parameters</caption><thead align="left"><tr id="dis_01_0601__row9168357142612"><th align="left" class="cellrowborder" valign="top" width="17.169999999999998%" id="mcps1.3.2.2.3.2.1.2.4.1.1"><p id="dis_01_0601__p13168125714262">Parameter</p>
 </th>
@@ -102,3 +102,10 @@
 </div>
 </div>
 
+
+<script language="JavaScript">
+<!--
+image_size('.imgResize');
+var msg_imageMax = "view original image";
+var msg_imageClose = "close";
+//--></script>