メインコンテンツにスキップ

コレクターとの統合

サブスクリプションAPIを使用すると、選択したアセットの環境および運用ステータスに関するイベントの通信チャネル宛先を確立できます。AWS IoTコア、Azureイベントハブ、Webhook通信チャネルをサポートしています。

メモ

サブスクリプションを作成して、Equinix APIのデータにアクセスすることもできます。手順については、「Equinix APIからColocationデータをストリームする」を参照してください。

エクイニクスmTLS証明書​

MTLS証明書は、サーバとクライアントが相互認証するためのTLS(旧SSL)証明書の拡張として使用されます。Equinixは、当社のサービスが提供するものと同様に、クライアントからの信頼できる署名付き証明書を必要とします。当社のサブスクリプションサービスでは、接続検証の追加オプションを提供しています。通信試行ごとに新しいイベントのバッチが送信されると、当社のサブスクリプションサービスは、お客様から提供された証明書を使用して、データを送信するサービスが正しいものであることを検証します。

証明書を取得するには、エンドポイントにリクエストを/smartview/v2/streaming/subscriptions/certificate送信します。GETチャネル接続先をクエリパラメータとして、またはのいずれかで指定します。AWS_IOT_CORE``WEBHOOK

サンプルcURLリクエスト:

curl -X 'GET' 'https://api.equinix.com/smartview/v2/streaming/subscriptions/certificate?channelType=WEBHOOK' \
-H 'Authorization: Bearer <Bearer Token>'
重要

サブスクリプションAPIは自己署名証明書を受け入れません。相互認証にはCA証明書を使用します。

AWS IoT​

サブスクリプションの作成時にエンドポイントを提供して、データをAWS IoTコアに送信します。

メモ

EquinixがAWS IoTコアの宛先にイベントを送信することを許可するには、Equinix証明書をダウンロードしてIoTコアコンソールに登録する必要があります。手順については、AWS IoTコアのドキュメントを参照してください。

Azure イベントハブ​

Azureイベントハブにデータを送信するためのセルフサービス構成は利用できません。Azureへのデータ送信を有効にするには、サポートにお問い合わせください。

Webhook​

AWSまたはAzureをコレクタとして使用したくないが、ストリーミングデータを送信できるターゲットURLを提供できる場合、Equinixは一般的なWebhook宛先にデータを送信するサブスクリプションを作成できます。

コレクターのためのオブジェクト・フォーマット​

AWS IoTコアチャネルとAzureイベントハブチャネルのメッセージ形式により、メッセージが読みやすくなります。APIプラスのサブスクリプションで送信されるメッセージの例をいくつか紹介します。

環境-温度​

{
"type": "environmental",
"data": {
"ibx": "CH2",
"asset": {
"id": "asset1",
"level": "ZONE"
},
"reading": {
"value": "23.300",
"unit": "CELSIUS"
},
"tag": {
"id": "temperature",
"displayName": "Temperature"
},
"readingTime": "2020-08-24T09:21:00.000Z"
}
}

環境 - 湿度​

{
"type": "environmental",
"data": {
"ibx": "CH1",
"asset": {
"id": "asset1",
"level": "ZONE"
},
"reading": {
"value": "66.120",
"unit": "PERCENT"
},
"tag": {
"id": "humidity",
"displayName": "Humidity"
},
"readingTime": "2020-07-28T12:35:14.615Z"
}
}

電源​

{
"type": "power",
"data": {
"ibx": "SP2",
"asset": {
"id": "0210:469593",
"type": "CIRCUIT"
},
"cage": "ssxxxxsss",
"cabinet": "SP2:01:021470:0210",
"accountNumber": "1000659151",
"realPower": {
"value": "0.522",
"unit": "kW"
},
"apparentPower": {
"value": "1.070",
"unit": "kVA"
},
"contractualPower": {
"value": "60.000",
"unit": "kVA"
},
"current": {
"value": "1.500",
"unit": "A"
},
"powerFactor": {
"value": "0.48",
"unit": "pf"
},
"soldCurrent": {
"value": "15.000",
"unit": "A"
},
"soldPower": {
"value": "2.880",
"unit": "kVA"
},
"powerConsumptionToContractual": {
"value": "32.151",
"unit": "PERCENT"
},
"cabinetRating": {
"value": "123.300",
"unit": "kVA"
},
"peakLastSevenDays": {
"value": "1.146",
"unit": "kVA"
},
"peakLastSevenDaysRatio": {
"value": "34.424",
"unit": "PERCENT"
},
"peakLastSevenDaysContractualPower": {
"value": "3.329",
"unit": "kVA"
},
"peakLastSevenDaysTime": "2020-07-29T07:00:00.000Z",
"lastUpdated": "2020-07-24T11:46:00.000Z",
"readingTime": "2020-07-24T11:45:00.000Z",
"description": "test description",
"oid": "1.3.6.1.2.1.299.2.10.6846",
"circuitType": "primary",
"customerName": "test customer"
}
}

電力量 - kWh​

{
"type": "metered-power",
"data": {
"ibx": "LD9",
"asset": {
"id": "LD9.CBM-PDU-17-99",
"type": "Customer Billing Meter"
},
"cage": "LD9:0G:00Z13Z",
"cageSerialNo": "00Z13B-21010567",
"accountNumber": "1000006212",
"customerName": "ABC Company",
"kilowattHour": {
"value": "304574.323",
"unit": "kWh"
},
"readingTime": "2023-04-24T11:45:00.000Z",
"dataQuality": "Good"
}
}

注:電力従量制の測定値は、kWh、kW、kVA、a、pf(力率)単位で利用できます。

タグポイント​

{
"type": "tag-point",
"data": {
"ibx": "LA1",
"reading": {
"value": "33406.6",
"unit": "l/s"
},
"tag": {
"id": "LA1.Air-Handler-7-4-4:totalsupplyairflow",
"displayName": "Total Supply Air Flow"
},
"readingTime": "2020-08-24T09:21:00.000Z"
}
}

カスタムアラート​

{
"type": "alert",
"data": {
"ibx": "SG2",
"region": "APAC",
"asset": {
"id": "CH1.Colo.CH1_05_000550_0105",
"type": "ENVIRONMENTAL",
"classification": "Environmental"
},
"tag": {
"id": "temperature"
},
"threshold": {
"unit": "CELSIUS",
"maxValue": "-6.67",
"minValue": "-12.22"
},
"id": "zhe-15603221441540.3171591127612322145",
"triggeredTime": "2019-09-23T23:01:30.655Z",
"type": "environmental",
"typeId": "Absolute",
"conditional": "N",
"eventType": "Out of Range",
"heartbeat": false
}
}

システムアラート​

{
"type": "system-alert",
"data": {
"ibx": "SG2",
"region": "APAC",
"metro": "SG",
"country": "SG",
"currentValue": {
"unit": "kWh",
"value": "2.650479E7",
"type": "float"
},
"asset": {
"id": "9SG2.ELEC4AUPSR-A10ASBF0",
"type": "Circuit Breaker with Metering",
"classification": "Electrical"
},
"tag": {
"id": "SG2.ELEC5BUPSR-B14UAH2Q:breaker",
"displayName": "Bypass Not Available"
},
"conditionName": "Low",
"status": {
"acknowledged": true,
"acknowledgementTime": "2020-07-28T12:35:14.615Z",
"cleared": false,
"active": false
},
"threshold": {
"unit": "kWh",
"stateLimit": "80",
"message": "Drive not in Auto"
},
"severity": 820,
"triggeredTime": "2020-07-28T12:35:14.615Z",
"processedTime": "2020-07-28T12:35:14.615Z",
"normalProcessedTime": "2020-07-28T12:35:14.615Z",
"normalTriggeredTime": "2020-07-28T12:35:14.615Z",
"type": "Digital",
"heartbeat": false
}
}

データ品質指標​

このフィールドには、dataQualityデータポイントとアラート(システムおよびカスタム)のデータ品質インジケータ(DQI)がデータ自体の一部として提供されます。これは、DCIMアセットのデータが有効であり、確実に収集されていることをAPIクライアントに保証し、通知するために使用されます。DQIの追加により、受信データの品質に関する透明性が確保されます。

ストア&フォワード・インジケータ​

ストアアンドフォワードインジケータ(SNFI)としてのフィールドは、messageRetriedDCIMデータが実際にリアルタイムに近いか、NRTチャネルを介した接続の中断により遅延して後で送信されるかを通信するために使用されます。サブスクリプションクライアントとパブリッシャ間の接続に問題がある場合、パブリッシャはストアアンドフォワード(SNF)メカニズムを使用して、パブリッシャ側にメッセージを保存します。接続が再確立されると、これらの保存されたメッセージとNRTイベントは、確立された接続時間後にクライアントに送信されます。SNFI方式のために後から送信されたデータは、他の通常のデータと比較してNRTデータではなくなったため、マークされている。

APIアプリケーションは、この2つの指標に基づいてビジネスルールと意思決定を行い、データの透明性とソリューション効率を向上させることができます。

{
"messageRetried": true,
"type": "tag-point",
"data": {
"ibx": "SG2",
"reading": {
"value": "54.0",
"unit": "s"
},
"tag": {
"id": "SG2.UPS-5-RM A22-04:batterytimeremaining",
"displayName": "Battery Time Remaining"
},
"readingTime": "2021-03-25T03:48:00.510Z",
"dataQuality": "Good"
}
}

ENUM とブーリアン値の解釈​

以下のようなカラムを含むエクセルのスプレッドシートがプロバイダから提供される場合があります:

IBXアセットタイプ資産分類アセットIDTAG_SUFFIXTAG_IDTAG_DATA_TYPETAG_UOMタグ_表示名状態テーブル名
TR5火災、煙探知機械式TR5.FireAlarm_001アラームTR5.FireAlarm_001:アラームブールアラームノーマルアラーム
TR5漏れ検出機械式tr5.ld_tr5_cable1リーク検出TR5.LD_TR5_CABLE1:leakdetectedブールリークを検出ノーマルアラーム
TR5UPS電気TR5.UPS_2110回復性TR5.UPS_2110:resilientブールレジリエントリデュースレシル_レジラスデザイン

ブール値およびENUM値については、最初の値(,REDUCEDRESIL)がに対応し0、2番目の値(ALARM,RESILASDESIGNED)がに対応する場合は、をNORMAL参照してください。STATE_TABLE_NAME``1

APIコール頻度​

Power APIでは、アジア太平洋地域のデータセンターでは5分ごとに、その他の地域では15分ごとに電話してください。上限は、1人のユーザーあたり1日あたり100,000件です。

サブスクリプションAPI (REST収集方法)の場合は、サブスクリプションIDごとに約30秒ごとに呼び出します。5分に1回まで電話すれば十分です。

このページは役に立ちましたか?