# 事件和对象类型 这些是流API提供的事件和对象类型。有关数据收集器特定格式的信息,请参见[与收集器集成](https://docs.equinix.com/zh-Hans/smart-view/sv-api/integrating-with-collector.md#object-formats-for-collectors)页面。 ## 事件类型[​](#事件类型 "直接链接至事件类型") ### 警报已更新[​](#警报已更新 "直接链接至警报已更新") 此`alarm_updated`事件表示已更新警报。`alarm_active`激活报警时发送事件。它将发送到与警报连接的所有用户帐户。`alarm`属性是包含警报信息的[警报对象](#alarm)。 ``` { "name": "alarm_active", "alarm": { ... } } ``` ### 心跳通知[​](#心跳通知 "直接链接至心跳通知") Heartbeat事件每周发送一次,并在所有订阅的警报上提供Heartbeat通知的详细信息。它们使流式传输客户端和Equinix流式传输事件提供商之间的有效沟通成为可能。 心跳通知示例 - 系统警报 ``` ‌‌"@type" : "Alarm", "data" : { "sysAlertDefinitionId" : "PA4.Generator-C:summary:Multi-State:Alarm:3", "assetid" : "PA4.Generator-C", "ibx" : "PA4", "tagdisplayname" : "Summary", "sysAlertTriggerRule" : "STOPPED, NOT IN AUTO, ALARM", "heartbeat" : "true" }, "name" : "alarm_updated" } ``` 示例Heartbeat通知-自定义警报 ‌‌ ``` "@type" : "Alert", "data" : { "alertid" : "513709-15960581055100.6171420183265794", "timetriggered" : "1596058401201", "alerttype" : "electrical", "customerid" : "1000006198", "ibx" : "PA4", "heartbeat" : "true", "thresholdvalue" : "0" } ``` ### 环境更新[​](#环境更新 "直接链接至环境更新") 环境数据已更新或接收。 `environment_updated`事件在更新或计算环境数据时发送。它对在与环境信息相关的位置中具有固定框架或机柜的所有帐户都可见。 该`environmentData`属性是包含环境信息的[EnvironmentData对象](#environmentdata)。 ``` { "name": "environment_updated", "data": { ... } } ``` ### 环境传感器[​](#环境传感器 "直接链接至环境传感器") 这通过与IBX中的固定框架相关的分类,提供环境传感器可用的温度和湿度事件的更新,如中所示`tag_id`。这些传感器读数(值,计量单位)来自IBX的特定区域内的帐户,可以使用时间戳获取。 示例: ``` Received message 1410591350247580: Data: {"@type":"Tagpoint","data":{"value":"45","tagId":"PA4.Environmental.DH-10:humidity","tagDisplayName":"Humidity","uom":"%","readingTime":1596831714128,"oid":"1.3.6.1.2.1.299.37.7.1191.24"},"name":"tagpoint_updated"} Attributes: [object Object] ``` ### 电源已更新[​](#电源已更新 "直接链接至电源已更新") 已更新或接收功耗数据。 `power_updated`接收或计算功耗数据时发送事件。它对拥有与功耗数据相关的电路的帐户的用户可见。 该`powerData`属性是包含功耗信息的[PowerData对象](#powerdata) ``` { "name": "power_updated", "data": { ... } } ``` ### Tagpoint 已更新[​](#tagpoint-已更新 "直接链接至Tagpoint 已更新") 标记点值已更新。 `tagpoint_updated`更新标记点数据时发送事件。它将发送给对标签点具有可见性的所有用户。 该`tagPointData`属性是包含有关tagPoint的最新信息的[TagPointData对象](#tagpointdata)。 ``` { "name": "tagpoint_updated", "data": { ... } } ``` ## 对象类型[​](#对象类型 "直接链接至对象类型") ### 警报[​](#警报 "直接链接至警报") ``` { "type": "object", "description": "alarm object - properties of the alarm", "properties": { "timetriggered": { "type": "string", "description": "time when the criteria for the alarm was met, in epoch (ms)" }, "valuetype": { "type": "string", "description": "data type for the alarm data point value", "enum": [ "Float", "Bool", "Int" ] }, "severity": { "type": "integer", "description": "integer value which describes the severity of the alarm. higher values indicate higher severity\n• 800-899 – Urgent\n• 600-699 – High \n• 400-499 – Low \n• 200-299 – Informational\n" }, "timenormalprocessed": { "type": "string", "description": "time alarm was cleared in the system. \n" }, "circuit": { "type": "string", "description": "circuit number applicable to power alarms" }, "alarmtype": { "type": "string", "description": "alarm type indicates the type of alarm", "enum": [ "digital", "absolute", "deviation", "multi-state" ] }, "tagid": { "type": "string", "description": "tag id linked to the alarm. available for alarms on infra assets. unique identifier for the tag\n" }, "uom": { "type": "string", "description": "unit of measure for the alarm value" }, "cage": { "type": "string", "description": "cage us id linked to the alarm. available with power alarms or environmental alarms\n" }, "timeprocessed": { "type": "string", "description": "time when the alarm was created in the system." }, "assetid": { "type": "string", "description": "asset id linked to the alarm" }, "metro": { "type": "string", "description": "metro id linked to the alarm" }, "accountno": { "type": "string", "description": "customer account number" }, "conditionname": { "type": "string", "description": "condition name for the alarm" }, "region": { "type": "string", "description": "region linked to the alarm" }, "value": { "type": "string", "description": "data point value at which the alarm was triggered" }, "cabinet": { "type": "string", "description": "cabinet us id. applicable for power alarms" }, "assettype": { "type": "string", "description": "Will contain\n• template name for alarms linked to infra assets.\n• \"environmental\" for environmental alarms.\n• \"CIRCUIT\" for power alarms \n" }, "ibx": { "type": "string", "description": "ibx code" }, "status": { "type": "boolean", "description": "indicator whether an alarm is active" }, "assetclassification": { "type": "string", "description": "asset classification", "enum": [ "Electrical", "Mechanical", "Environmental", "Power" ] } } } ``` ### 警报[​](#警报-1 "直接链接至警报") ``` "AlertCondition": { "type": "object", "properties": { "affectedCustomerAsset": { "type": "null" }, "alertType": { "type": "null" }, "asset": { "type": "string" }, "assetname": { "type": "string" }, "assettype": { "type": "string" }, "condalerttypeid": { "type": "string" }, "condassetclassification": { "type": "string" }, "condassetid": { "type": "string" }, "condcurrentvalue": { "type": "string" }, "condeventtype": { "type": "string" }, "condtagid": { "type": "string" }, "customerAssets": { "type": "null" }, "ibx": { "type": "string" }, "infraAssets": { "type": "null" }, "measurementType": { "type": "null" }, "region": { "type": "null" }, "section": { "type": "string" }, "thresholdUnit": { "type": "string" }, "thresholdValue": { "type": "string" }, "thresholdValueMax": { "type": "string" }, "thresholdValueMin": { "type": "string" }, "uom": { "type": "string" } } }, "AlertType": { "type": "object", "properties": { "defaultValue": { "type": "null" }, "eventType": { "type": "string" }, "id": { "type": "string" }, "tagId": { "type": "null" }, "type": { "type": "string" }, "unit": { "type": "string" }, "value": { "type": "string" } } }, "Alert": { "type": "object", "properties": { "accountNo": { "type": "string" }, "acknowledge": { "type": "boolean" }, "affectedCustomerAsset": { "type": "null" }, "alertType": { "": "#/definitions/AlertType" }, "alertTypeName": { "type": "string" }, "asset": { "type": "string" }, "assetclassification": { "type": "string" }, "assetname": { "type": "string" }, "assettype": { "type": "string" }, "conditionalAlert": { "$ref": "#/definitions/AlertCondition" }, "country": { "type": "string" }, "createdOn": { "type": "null" }, "currentvalue": { "type": "string" }, "eventtype": { "type": "string" }, "ibx": { "type": "string" }, "id": { "type": "string" }, "lastmaintenance": { "type": "string" }, "metro": { "type": "string" }, "modifiedOn": { "type": "null" }, "notificationType": { "type": "string" }, "region": { "type": "string" }, "relatedincidents": { "type": "string" }, "resiliency": { "type": "string" }, "section": { "type": "string" }, "severity": { "type": "string" }, "tagid": { "type": "string" }, "thresholdUnit": { "type": "string" }, "thresholdValue": { "type": "string" }, "thresholdValueMax": { "type": "string" }, "thresholdValueMin": { "type": "string" }, "timeZone": { "type": "string" }, "timeacknowledged": { "type": "string" }, "timeprocessed": { "type": "string" }, "timetriggeredMilisec": { "type": "string" }, "triggeredOn": { "type": "integer" }, "type": { "type": "string" }, "uom": { "type": "string" }, "year": { "type": "string" } } } ``` ### 环境数据[​](#环境数据 "直接链接至环境数据") ``` "EnvironmentData": { "type": "object", "properties": { "ibx": { "type": "string", "description": "ibx code" }, "accountNo": { "type": "string", "description": "account number" }, "zone": { "type": "string", "description": "zone unique space id" }, "cage": { "type": "string", "description": "cage unique space id" }, "cabinet": { "type": "string", "description": "cabinet unique space id" }, "sensor": { "type": "string", "description": "sensor id" }, "temperature": { "type": "string", "description": "current temperature" }, "humidity": { "type": "string", "description": "current humidity" }, "timestamp": { "type": "string", "description": "epoch timestamp when the current reading was read" }, "temperatureUom": { "type": "string", "description": "unit of measure for temperature values" }, "humidityUom": { "type": "string", "description": "unit of measure for humidity" }, "minTemperature": { "type": "string", "description": "minimum temperature for last x(?) hours" }, "maxTemperature": { "type": "string", "description": "maximum temperature for last x(?) hours" }, "minHumidity": { "type": "string", "description": "minimum humidity for last x(?) hours" }, "maxHumidity": { "type": "string", "description": "maximum humidity for last x(?) hours" } } } ``` ### 电力数据[​](#电力数据 "直接链接至电力数据") ``` "PowerData": { "type": "object", "properties": { "ibx": { "type": "string", "description": "ibx code" }, "accountNo": { "type": "string", "description": "customer account number" }, "levelType": { "type": "string", "description": "power hierarchy node levelType linked to the power data", "enum": [ "ibx", "cage", "cabinet", "circuit" ] }, "levelValue": { "type": "string", "description": "power hierarchy node levelValue linked to the power data. ibx code, \ncage unique space id, cabinet unique space id and circuit id for \nlevelType ibx, cage, cabinet, circuit resp.\n" }, "isAlarm": { "type": "string" }, "kva": { "type": "number", "description": "power consumption in kva" }, "amps": { "type": "number", "description": "instantaneous current amp reading on circuits" }, "cage": { "type": "string", "description": "cage unique space id" }, "cabinet": { "type": "string", "description": "cabinet unique space id" }, "soldKva": { "type": "number", "description": "maximum amp draw allowable on a circuit" }, "cabinetRating": { "type": "number", "description": "maximum kVA draw allowed for the cabinet" }, "contractualKva": { "type": "number", "description": "The maximum power draw contractually allowable in a \nprivate cage. \n" }, "percentageKva": { "type": "number", "description": "calculated field kva / contractualKva" }, "peakKvaLastSevenDays": { "type": "number" }, "peakKvaLastSevenDaysPercentage": { "type": "number" }, "peakKvaLastSevenDaysContractualKva": { "type": "number" }, "peakKvaLastSevenDaysTime": { "type": "integer" }, "type": { "type": "string", "description": "value to be IBX, CAGE, CABINET, primary or redundant for levelType\nibx, cage, cabinet, circuit resp.\n", "enum": [ "IBX", "CAGE", "CABINET", "primary", "redundant" ] }, "description": { "type": "string", "description": "circuit description when the levelType is circuit. null otherwise. \n" }, "soldAmps": { "type": "integer" }, "primaryKva": { "type": "number", "description": "the sum of instantaneous power draw reading on all the primary \ncircuits within the levelType.\n" }, "redundantKva": { "type": "number", "description": "the sum of instantaneous power draw reading on all the redundant \ncircuits within the levelType.\n" }, "kw": { "type": "string", "description": "measure of real power expressed in kilowatt applicable for ibxs\nthat have capability of energy meter reading\n" }, "powerFactor": { "type": "string", "description": "The ratio between real power and apparent power in a circuit.(kW/kVA)\n" }, "readingTime": { "type": "string", "description": "date-time when the latest value was read in (epoc - milliseconds). \n" }, "lastUpdatedTime": { "type": "string", "description": "date-time when the latest value was updated (epoc - milliseconds).\n" }, "customerName": { "type": "string" } } } ``` ### 计量功率[​](#计量功率 "直接链接至计量功率") ``` "MeteredPower": { "type": "object", "properties": { "ibx": { "type": "string" }, "assetId": { "type": "string" }, "assetSerialNumber": { "type": "string" }, "assetType": { "type": "string" }, "cage": { "type": "string" }, "cageSerialNo": { "type": "string" }, "accountNumber": { "type": "string" }, "customerName": { "type": "string" }, "readingTime": { "type": "string" }, "dataQuality": { "type": "integer" }, "ucid": { "type": "string" }, "kilowattHour": { "type": "number" }, "realPower": { "type": "number" }, "apparentPower": { "type": "number" }, "powerFactor": { "type": "number" }, "current": { "type": "number" } } } ``` ### 标签点数据[​](#标签点数据 "直接链接至标签点数据") ``` "TagPointData": { "type": "object", "description": "Tag Point is a property of the Asset it is linked to.\n", "properties": { "value": { "type": "string", "description": "Current data value for the tag point\n" }, "tagId": { "type": "string", "description": "ID for the tagPoint - Unique Identifier for the Tag Point\n" }, "tagDisplayName": { "type": "string", "description": "Generic label for the tag point\n" }, "uom": { "type": "string", "description": "Unit of measure for the data value for the tag point\n" }, "alarmStatus": { "type": "string", "description": "Indicates whether there are any alarms currently active for the tag\npoint\n" }, "readingTime": { "type": "string", "format": "date-time", "description": "date time when the tag point value was read from the device. \n" } } } ```