forked from docs/doc-exports
qiujiandong1
e9265fb6b0
Reviewed-by: Ziuzko, Alevtina <alevtina.ziuzko@t-systems.com> Co-authored-by: qiujiandong1 <qiujiandong1@huawei.com> Co-committed-by: qiujiandong1 <qiujiandong1@huawei.com>
408 lines
35 KiB
HTML
408 lines
35 KiB
HTML
<a name="en-us_topic_0109034020"></a><a name="en-us_topic_0109034020"></a>
|
||
|
||
<h1 class="topictitle1">Reporting Events</h1>
|
||
<div id="body1524732199456"><div class="section" id="en-us_topic_0109034020__section366675881818"><h4 class="sectiontitle">Function</h4><p id="en-us_topic_0109034020__p11689595189">An API for reporting custom events is provided, which helps you collect and report abnormal events or important change events to Cloud Eye.</p>
|
||
</div>
|
||
<div class="section" id="en-us_topic_0109034020__section466795818180"><h4 class="sectiontitle">URI</h4><p id="en-us_topic_0109034020__p96915941813">POST /V1.0/{project_id}/events</p>
|
||
<ul id="en-us_topic_0109034020__ul1869659131811"><li id="en-us_topic_0109034020__li8691459151818">Parameter description
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table968175851812" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0109034020__row773175951818"><th align="left" class="cellrowborder" valign="top" width="17.93%" id="mcps1.3.2.3.1.1.2.5.1.1"><p id="en-us_topic_0109034020__p67318593183">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="18.88%" id="mcps1.3.2.3.1.1.2.5.1.2"><p id="en-us_topic_0109034020__p57375911813">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="13.63%" id="mcps1.3.2.3.1.1.2.5.1.3"><p id="en-us_topic_0109034020__en-us_topic_0000001646899038_p102912031124414">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="49.559999999999995%" id="mcps1.3.2.3.1.1.2.5.1.4"><p id="en-us_topic_0109034020__p5731559181818">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row07325991818"><td class="cellrowborder" valign="top" width="17.93%" headers="mcps1.3.2.3.1.1.2.5.1.1 "><p id="en-us_topic_0109034020__p147311599186">project_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="18.88%" headers="mcps1.3.2.3.1.1.2.5.1.2 "><p id="en-us_topic_0109034020__p147385911180">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13.63%" headers="mcps1.3.2.3.1.1.2.5.1.3 "><p id="en-us_topic_0109034020__en-us_topic_0000001646899038_p829123117449">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="49.559999999999995%" headers="mcps1.3.2.3.1.1.2.5.1.4 "><p id="en-us_topic_0109034020__p42316702175455">Specifies the project ID.</p>
|
||
<p id="en-us_topic_0109034020__p191415137612">For details about how to obtain the project ID, see <a href="ces_03_0057.html">Obtaining a Project ID</a>.</p>
|
||
<p id="en-us_topic_0109034020__en-us_topic_0000001646899046_p18100524114814">Minimum: <strong id="en-us_topic_0109034020__b139025137543837">1</strong></p>
|
||
<p id="en-us_topic_0109034020__en-us_topic_0000001646899046_p81001524104817">Maximum: <strong id="en-us_topic_0109034020__b85582026883244">64</strong></p>
|
||
<p id="en-us_topic_0109034020__p4697184133915"><strong id="en-us_topic_0109034020__b166430971025043">Regular expression matching</strong>: ^[a-zA-Z0-9-]{1,64}$</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li><li id="en-us_topic_0109034020__li1573205911186">Example<pre class="screen" id="en-us_topic_0109034020__screen1988021814918">POST https://{Cloud Eye endpoint}/V1.0/{project_id}/events</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="en-us_topic_0109034020__section16971858161816"><h4 class="sectiontitle">Request</h4><div class="note" id="en-us_topic_0109034020__note1246553375914"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="en-us_topic_0109034020__p44661833155915">Events with the same <strong id="en-us_topic_0109034020__b1678094291314">time</strong>, <strong id="en-us_topic_0109034020__b527254510132">project_id</strong>, <strong id="en-us_topic_0109034020__b9659124813135">event_source</strong>, <strong id="en-us_topic_0109034020__b19399145141311">event_name</strong>, <strong id="en-us_topic_0109034020__b1540654161314">event_type</strong>, <strong id="en-us_topic_0109034020__b218715571133">event_state</strong>, <strong id="en-us_topic_0109034020__b35127081412">event_level</strong>, <strong id="en-us_topic_0109034020__b4409919191511">event_user</strong>, <strong id="en-us_topic_0109034020__b17216134314158">resource_id</strong> and <strong id="en-us_topic_0109034020__b1913184981519">resource_name</strong> fields are considered as the same event.</p>
|
||
</div></div>
|
||
<ul id="en-us_topic_0109034020__ul1574659181817"><li id="en-us_topic_0109034020__li167417595186">Request parameters
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table69011263247" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0109034020__row1990162672413"><th align="left" class="cellrowborder" valign="top" width="20.830000000000002%" id="mcps1.3.3.3.1.1.2.5.1.1"><p id="en-us_topic_0109034020__p7901112618245">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="14.35%" id="mcps1.3.3.3.1.1.2.5.1.2"><p id="en-us_topic_0109034020__p156351519585">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="9.16%" id="mcps1.3.3.3.1.1.2.5.1.3"><p id="en-us_topic_0109034020__p20901226192419">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="55.66%" id="mcps1.3.3.3.1.1.2.5.1.4"><p id="en-us_topic_0109034020__p16901182616246">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row12901726192414"><td class="cellrowborder" valign="top" width="20.830000000000002%" headers="mcps1.3.3.3.1.1.2.5.1.1 "><p id="en-us_topic_0109034020__p490182682418">[Array element]</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.35%" headers="mcps1.3.3.3.1.1.2.5.1.2 "><p id="en-us_topic_0109034020__p96355193820">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="9.16%" headers="mcps1.3.3.3.1.1.2.5.1.3 "><p id="en-us_topic_0109034020__p6399215102813">Array of <a href="#en-us_topic_0109034020__table3736458191816">EventItem</a> objects</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="55.66%" headers="mcps1.3.3.3.1.1.2.5.1.4 "><p id="en-us_topic_0109034020__p164509304268">Specifies the event list.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><a name="en-us_topic_0109034020__table3736458191816"></a><a name="table3736458191816"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table3736458191816" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Parameter description of the <strong id="en-us_topic_0109034020__b355984113547">EventItem</strong> field</caption><thead align="left"><tr id="en-us_topic_0109034020__row1674165961815"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.3.1.2.2.5.1.1"><p id="en-us_topic_0109034020__p774759181818">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.3.3.1.2.2.5.1.2"><p id="en-us_topic_0109034020__p57435981816">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.3.1.2.2.5.1.3"><p id="en-us_topic_0109034020__p274759201818">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="57.99999999999999%" id="mcps1.3.3.3.1.2.2.5.1.4"><p id="en-us_topic_0109034020__p4741759141819">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row1974125911814"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p18289164174513">event_name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p177425911812">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p11119150134018">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p8741959191810">Specifies the event name.</p>
|
||
<p id="en-us_topic_0109034020__p106265144614">Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row18741759121812"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p574185991810">event_source</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p37412599182">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p552994614611">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p1274165911813">Specifies the event source. This parameter can be left empty. An empty value indicates all sources.</p>
|
||
<p id="en-us_topic_0109034020__p461714934420">The format is service.item. Set this parameter based on the service needs.</p>
|
||
<p id="en-us_topic_0109034020__p15543145912461"><strong id="en-us_topic_0109034020__b166631229115018">service</strong> and <strong id="en-us_topic_0109034020__b166342935012">item</strong> each must start with a letter and contain only letters, digits, and underscores (_). The value can contain 0 to 32 characters.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row77425951819"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p17768203574712">time</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p137415598189">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p1832720106403">Long</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p47415981815">Specifies when the event occurred, which is a UNIX timestamp (ms).</p>
|
||
<div class="note" id="en-us_topic_0109034020__note878755532811"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0109034020__p1050315220496">Since there is a latency between the client and the server, the timestamp when data was inserted must be within the time range [Current time – 1h + 20s, Current time + 10 mins – 20s]. In this way, the data will be inserted to the database without being affected by the latency.</p>
|
||
<p id="en-us_topic_0109034020__p1737655783613">For example, if the current time is 2020.01.30 12:00:30, the timestamp inserted must be within the range [2020.01.30 11:00:50, 2020.01.30 12:10:10]. The corresponding UNIX timestamp is [1580353250, 1580357410].</p>
|
||
</div></div>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row154242222184"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p8426722131811">detail</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p2426102271819">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p2083313141820">Detail object</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p3426622181814">Specifies the event details.</p>
|
||
<p id="en-us_topic_0109034020__p146201626185112">For details, see <a href="#en-us_topic_0109034020__table181310172506">Table 4</a>.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><a name="en-us_topic_0109034020__table181310172506"></a><a name="table181310172506"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table181310172506" frame="border" border="1" rules="all"><caption><b>Table 4 </b><strong id="en-us_topic_0109034020__b05271052163814">detail</strong> data structure description</caption><thead align="left"><tr id="en-us_topic_0109034020__row1312419174508"><th align="left" class="cellrowborder" valign="top" width="15%" id="mcps1.3.3.3.1.3.2.5.1.1"><p id="en-us_topic_0109034020__p19124121713500">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="14.000000000000002%" id="mcps1.3.3.3.1.3.2.5.1.2"><p id="en-us_topic_0109034020__p612417174500">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="13%" id="mcps1.3.3.3.1.3.2.5.1.3"><p id="en-us_topic_0109034020__p9124181714502">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="57.99999999999999%" id="mcps1.3.3.3.1.3.2.5.1.4"><p id="en-us_topic_0109034020__p71241817145019">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row912981712509"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p4129101718503">content</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p012921715011">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p4129317175015">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p19129181712505">Specifies the event content. Enter up to 4,096 characters.</p>
|
||
<div class="note" id="en-us_topic_0109034020__note12840525112920"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="en-us_topic_0109034020__p118401225202911">In some scenarios, this field does not support <strong id="en-us_topic_0109034020__b342320113383">\n</strong>. When this happens, <strong id="en-us_topic_0109034020__b20701155011385">\n</strong> is preferentially converted to <strong id="en-us_topic_0109034020__b5796315153814">\\n</strong>.</p>
|
||
</div></div>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row1612981711508"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p111293178505">group_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p212901775017">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p112941765014">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p01291317165019">Specifies the resource group the event belongs to.</p>
|
||
<p id="en-us_topic_0109034020__p941572992219">This ID must be an existing resource group ID.</p>
|
||
<p id="en-us_topic_0109034020__p912931765014">To query the group ID, perform the following steps:</p>
|
||
<ol id="en-us_topic_0109034020__ol93711310164215"><li id="en-us_topic_0109034020__li248114314176">Log in to the management console.</li><li id="en-us_topic_0109034020__en-us_topic_0114572230_li1690812410511">Click <strong id="en-us_topic_0109034020__b7980131214466">Cloud Eye</strong>.</li><li id="en-us_topic_0109034020__li92795169114">Choose <strong id="en-us_topic_0109034020__b75583497196">Resource Groups</strong>.<p id="en-us_topic_0109034020__p9953201610113">Obtain the resource group ID in the <strong id="en-us_topic_0109034020__b149044615207">Name /ID</strong> column.</p>
|
||
</li></ol>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row8130717115019"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p51291717165011">resource_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p7130217165017">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p15130101765014">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p9130171765017">Specifies the resource ID. Enter up to 128 characters, including letters, digits, underscores (_), hyphens (-), and colon (:).</p>
|
||
<p id="en-us_topic_0109034020__p17827352102213">Example: 6a69bf28-ee62-49f3-9785-845dacd799ec</p>
|
||
<p id="en-us_topic_0109034020__p17838730112219">To query the resource ID, perform the following steps:</p>
|
||
<ol id="en-us_topic_0109034020__ol63049455437"><li id="en-us_topic_0109034020__li9304745154311">Log in to the management console.</li><li id="en-us_topic_0109034020__li2304134518435">Under <strong id="en-us_topic_0109034020__b147242812119">Computing</strong>, select <strong id="en-us_topic_0109034020__b12871228132113">Elastic Cloud Server</strong>.<p id="en-us_topic_0109034020__p1085063617224">On the <strong id="en-us_topic_0109034020__b14935163872016">Resource Overview</strong> page, obtain the resource ID.</p>
|
||
</li></ol>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row141301617175017"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p513015171504">resource_name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p191301017165017">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p1913091755010">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p913011174505">Specifies the resource name. Enter up to 128 characters, including letters, digits, underscores (_), hyphens (-), and periods (.).</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row14130131719503"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p181302017135012">event_state</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p51301117135013">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p107761916164111">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p111301317205011">Specifies the event status.</p>
|
||
<p id="en-us_topic_0109034020__p5130917145019">The value can be <strong id="en-us_topic_0109034020__b842352706154129">normal</strong>, <strong id="en-us_topic_0109034020__b842352706154133">warning</strong>, or <strong id="en-us_topic_0109034020__b842352706154144">incident</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row6131121775010"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p713031710506">event_level</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p161313177506">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p813111705013">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p9131101725011">Specifies the event severity.</p>
|
||
<p id="en-us_topic_0109034020__p15131141713507">The value can be <strong id="en-us_topic_0109034020__b84235270619531">Critical</strong>, <strong id="en-us_topic_0109034020__b84235270619534">Major</strong>, <strong id="en-us_topic_0109034020__b84235270619538">Minor</strong>, or <strong id="en-us_topic_0109034020__b842352706195318">Info</strong>.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row1131517175017"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p81311179509">event_user</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p913131785015">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p199518228417">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p12131201765018">Specifies the event user.</p>
|
||
<p id="en-us_topic_0109034020__p14131201735016">Enter up to 64 characters, including letters, digits, underscores (_), hyphens (-), slashes (/), and spaces.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row16131151720502"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p41310177506">event_type</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p141316176507">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p513101716506">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p11316171506">Specifies the event type.</p>
|
||
<p id="en-us_topic_0109034020__p313151715505">Its value can be <strong id="en-us_topic_0109034020__b842352706195725">EVENT.SYS</strong> or <strong id="en-us_topic_0109034020__b842352706195733">EVENT.CUSTOM</strong>. <strong id="en-us_topic_0109034020__b842352706195737">EVENT.SYS</strong> indicates system events that cannot be reported by users. Only custom events can be reported.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row14635174413418"><td class="cellrowborder" valign="top" width="15%" headers="mcps1.3.3.3.1.3.2.5.1.1 "><p id="en-us_topic_0109034020__p2274101492813">dimensions</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="14.000000000000002%" headers="mcps1.3.3.3.1.3.2.5.1.2 "><p id="en-us_topic_0109034020__p812931573416">No</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="13%" headers="mcps1.3.3.3.1.3.2.5.1.3 "><p id="en-us_topic_0109034020__p175441335175318">Array of objects</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="57.99999999999999%" headers="mcps1.3.3.3.1.3.2.5.1.4 "><p id="en-us_topic_0109034020__p2039735441913">Specifies the event dimension. Currently, a maximum of four dimensions are supported. Resource information is described by dimension.</p>
|
||
<p id="en-us_topic_0109034020__p193971254101916">Event alarm rules can be configured by dimension to monitor resources and resource groups.</p>
|
||
<p id="en-us_topic_0109034020__p1494844185613">For parameter details, see <a href="#en-us_topic_0109034020__table12602145312184">Table 5</a>.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><a name="en-us_topic_0109034020__table12602145312184"></a><a name="table12602145312184"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table12602145312184" frame="border" border="1" rules="all"><caption><b>Table 5 </b><strong id="en-us_topic_0109034020__b1785441717452">dimensions</strong> data structure description</caption><thead align="left"><tr id="en-us_topic_0109034020__row0603753121814"><th align="left" class="cellrowborder" valign="top" width="9.15%" id="mcps1.3.3.3.1.4.2.5.1.1"><p id="en-us_topic_0109034020__p9603553141814">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="12.870000000000001%" id="mcps1.3.3.3.1.4.2.5.1.2"><p id="en-us_topic_0109034020__p4603165319187">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="15.43%" id="mcps1.3.3.3.1.4.2.5.1.3"><p id="en-us_topic_0109034020__p1603753111813">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="62.55%" id="mcps1.3.3.3.1.4.2.5.1.4"><p id="en-us_topic_0109034020__p176031553191818">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row17603195321814"><td class="cellrowborder" valign="top" width="9.15%" headers="mcps1.3.3.3.1.4.2.5.1.1 "><p id="en-us_topic_0109034020__p17603253111810">name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="12.870000000000001%" headers="mcps1.3.3.3.1.4.2.5.1.2 "><p id="en-us_topic_0109034020__p176031153151810">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.3.3.3.1.4.2.5.1.3 "><p id="en-us_topic_0109034020__p116031653201817">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="62.55%" headers="mcps1.3.3.3.1.4.2.5.1.4 "><p id="en-us_topic_0109034020__p1762314581237">Specifies the monitoring dimension name. For example, the ECS dimension is <strong id="en-us_topic_0109034020__b1743475970103544">instance_id</strong>. For details about the dimension of each monitored object, see the documentation of a specific cloud service. You can navigate there directly from the <a href="ces_03_0059.html">Services Interconnected with Cloud Eye</a> page. </p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row16603175381813"><td class="cellrowborder" valign="top" width="9.15%" headers="mcps1.3.3.3.1.4.2.5.1.1 "><p id="en-us_topic_0109034020__p1260415314185">value</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="12.870000000000001%" headers="mcps1.3.3.3.1.4.2.5.1.2 "><p id="en-us_topic_0109034020__p1604105313189">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="15.43%" headers="mcps1.3.3.3.1.4.2.5.1.3 "><p id="en-us_topic_0109034020__p460405316187">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="62.55%" headers="mcps1.3.3.3.1.4.2.5.1.4 "><p id="en-us_topic_0109034020__p166047531186">Specifies the dimension value, for example, an ECS ID.</p>
|
||
<p id="en-us_topic_0109034020__p156045533181">The value contains 1 to 256 characters.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li></ul>
|
||
<ul id="en-us_topic_0109034020__ul1877159201814"><li id="en-us_topic_0109034020__li18771759101810">Example request<pre class="screen" id="en-us_topic_0109034020__screen2038781418341">[
|
||
{
|
||
"event_name": "systemInvaded",
|
||
"event_source": "financial.System",
|
||
"time": 1742264993000,
|
||
"detail": {
|
||
"content": "The financial system was invaded",
|
||
"group_id": "rg15221211517051YWWkEnVd",
|
||
"resource_id": "1234567890sjgggad",
|
||
"resource_name": "ecs001",
|
||
"event_state": "normal",
|
||
"event_level": "Major",
|
||
"event_user": "xiaokong",
|
||
"event_type": "EVENT.CUSTOM",
|
||
"dimensions": [
|
||
{
|
||
"name": "instance_id",
|
||
"value": "instance_xxx"
|
||
}
|
||
]
|
||
}
|
||
}
|
||
]</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="en-us_topic_0109034020__section3695195811812"><h4 class="sectiontitle">Response</h4><ul id="en-us_topic_0109034020__ul39862682184830"><li id="en-us_topic_0109034020__li23219822184830">Response parameters
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table10858193319314" frame="border" border="1" rules="all"><caption><b>Table 6 </b>Parameter description</caption><thead align="left"><tr id="en-us_topic_0109034020__row18858123353116"><th align="left" class="cellrowborder" valign="top" width="19.99%" id="mcps1.3.4.2.1.1.2.4.1.1"><p id="en-us_topic_0109034020__p4858193316317">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="20.93%" id="mcps1.3.4.2.1.1.2.4.1.2"><p id="en-us_topic_0109034020__p68586335318">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="59.08%" id="mcps1.3.4.2.1.1.2.4.1.3"><p id="en-us_topic_0109034020__p10858103303117">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row13858193343116"><td class="cellrowborder" valign="top" width="19.99%" headers="mcps1.3.4.2.1.1.2.4.1.1 "><p id="en-us_topic_0109034020__p785813319311">Array elements</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="20.93%" headers="mcps1.3.4.2.1.1.2.4.1.2 "><p id="en-us_topic_0109034020__p188582335313">Array of objects</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="59.08%" headers="mcps1.3.4.2.1.1.2.4.1.3 "><p id="en-us_topic_0109034020__p985963363111">Specifies the event list.</p>
|
||
<p id="en-us_topic_0109034020__p1920014475576">For details, see <a href="#en-us_topic_0109034020__table7651809184830">Table 7</a>.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
|
||
<div class="tablenoborder"><a name="en-us_topic_0109034020__table7651809184830"></a><a name="table7651809184830"></a><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table7651809184830" frame="border" border="1" rules="all"><caption><b>Table 7 </b>Response parameters</caption><thead align="left"><tr id="en-us_topic_0109034020__row11265298184830"><th align="left" class="cellrowborder" valign="top" width="18%" id="mcps1.3.4.2.1.2.2.5.1.1"><p id="en-us_topic_0109034020__p40073906184830">Parameter</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="17%" id="mcps1.3.4.2.1.2.2.5.1.2"><p id="en-us_topic_0109034020__p24760926184830">Mandatory</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="16%" id="mcps1.3.4.2.1.2.2.5.1.3"><p id="en-us_topic_0109034020__p59478015184830">Type</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="49%" id="mcps1.3.4.2.1.2.2.5.1.4"><p id="en-us_topic_0109034020__p52989949184830">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row64327487184830"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p99051018912">event_id</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p5001649184830">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p2480433184830">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p66697365184830">Specifies the event ID.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row1136183616448"><td class="cellrowborder" valign="top" width="18%" headers="mcps1.3.4.2.1.2.2.5.1.1 "><p id="en-us_topic_0109034020__p148048373444">event_name</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="17%" headers="mcps1.3.4.2.1.2.2.5.1.2 "><p id="en-us_topic_0109034020__p1280683712444">Yes</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="16%" headers="mcps1.3.4.2.1.2.2.5.1.3 "><p id="en-us_topic_0109034020__p1811123764418">String</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="49%" headers="mcps1.3.4.2.1.2.2.5.1.4 "><p id="en-us_topic_0109034020__p198141375444">Specifies the event name.</p>
|
||
<p id="en-us_topic_0109034020__p1781416375446">Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li></ul>
|
||
<ul id="en-us_topic_0109034020__ul33777478184830"><li id="en-us_topic_0109034020__li35561846184830">Example response<pre class="screen" id="en-us_topic_0109034020__screen2358389810228">[
|
||
{
|
||
"event_id":"evdgiqwgedkkcvhdjcdu346",
|
||
"event_name":"systemInvaded"
|
||
}
|
||
]</pre>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="en-us_topic_0109034020__section13823158141819"><h4 class="sectiontitle">Returned Values</h4><ul id="en-us_topic_0109034020__ul10781759141820"><li id="en-us_topic_0109034020__li8784595186">Normal<p id="en-us_topic_0109034020__p167865914187"><a name="en-us_topic_0109034020__li8784595186"></a><a name="li8784595186"></a>201</p>
|
||
</li><li id="en-us_topic_0109034020__li17812590185">Abnormal
|
||
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="en-us_topic_0109034020__table10364173623214" frame="border" border="1" rules="all"><thead align="left"><tr id="en-us_topic_0109034020__row03645369329"><th align="left" class="cellrowborder" valign="top" width="32.1%" id="mcps1.3.5.2.2.1.1.3.1.1"><p id="en-us_topic_0109034020__p1849030182924">Returned Value</p>
|
||
</th>
|
||
<th align="left" class="cellrowborder" valign="top" width="67.9%" id="mcps1.3.5.2.2.1.1.3.1.2"><p id="en-us_topic_0109034020__p15553712182924">Description</p>
|
||
</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody><tr id="en-us_topic_0109034020__row236413368320"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p581987519168">400 Bad Request</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p164784039168">Request error.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row1736413365328"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p2691669168">401 Unauthorized</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p218024949168">The authentication information is not provided or is incorrect.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row16364113663218"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p563264059168">403 Forbidden</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p661449719168">Access to the requested page is forbidden.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row9364103633216"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p355199299168">408 Request Timeout</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p585420329168">The request timed out.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row173648363321"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p630127129168">429 Too Many Requests</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p37560249168">Concurrent requests are excessive.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row1736483643220"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p537873819168">500 Internal Server Error</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p618106189168">Failed to complete the request because of an internal service error.</p>
|
||
</td>
|
||
</tr>
|
||
<tr id="en-us_topic_0109034020__row2036473613329"><td class="cellrowborder" valign="top" width="32.1%" headers="mcps1.3.5.2.2.1.1.3.1.1 "><p id="en-us_topic_0109034020__p298930079168">503 Service Unavailable</p>
|
||
</td>
|
||
<td class="cellrowborder" valign="top" width="67.9%" headers="mcps1.3.5.2.2.1.1.3.1.2 "><p id="en-us_topic_0109034020__p54144829168">The service is currently unavailable.</p>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</div>
|
||
</li></ul>
|
||
</div>
|
||
<div class="section" id="en-us_topic_0109034020__section282724211478"><h4 class="sectiontitle">Error Codes</h4><p id="en-us_topic_0109034020__en-us_topic_0171212585_p91851023153416">See <a href="ErrorCode.html">Error Codes</a>.</p>
|
||
</div>
|
||
</div>
|
||
<div>
|
||
<div class="familylinks">
|
||
<div class="parentlink"><strong>Parent topic:</strong> <a href="ces_03_0038.html">Event Monitoring</a></div>
|
||
</div>
|
||
</div>
|
||
|