# コレクターとの統合 サブスクリプションAPIを使用すると、選択したアセットの環境および運用ステータスに関するイベントの通信チャネル宛先を確立できます。AWS IoTコア、Azureイベントハブ、Webhook通信チャネルをサポートしています。 > **メモ** > > サブスクリプションを作成して、Equinix APIのデータにアクセスすることもできます。手順については、「[Equinix APIからColocationデータをストリームする」を](https://docs.equinix.com/ja/smart-view/sv-api/getoperatinginformation.md)参照してください。 ## エクイニクスmTLS証明書[​](#エクイニクスmtls証明書 "への直接リンクエクイニクスmTLS証明書") MTLS証明書は、サーバとクライアントが相互認証するためのTLS(旧SSL)証明書の拡張として使用されます。Equinixは、当社のサービスが提供するものと同様に、クライアントからの信頼できる署名付き証明書を必要とします。当社のサブスクリプションサービスでは、接続検証の追加オプションを提供しています。通信試行ごとに新しいイベントのバッチが送信されると、当社のサブスクリプションサービスは、お客様から提供された証明書を使用して、データを送信するサービスが正しいものであることを検証します。 証明書を取得するには、エンドポイントにリクエストを[`/smartview/v2/streaming/subscriptions/certificate`](https://docs.equinix.com/ja/api-catalog/smartviewv2/streaming-subscription-api/getcertificate.md)送信します。`GET`チャネル接続先をクエリパラメータとして、またはのいずれかで指定します。`AWS_IOT_CORE``WEBHOOK` サンプルcURLリクエスト: ``` curl -X 'GET' 'https://api.equinix.com/smartview/v2/streaming/subscriptions/certificate?channelType=WEBHOOK' \ -H 'Authorization: Bearer ' ``` > **重要** > > サブスクリプションAPIは自己署名証明書を受け入れません。相互認証にはCA証明書を使用します。 ## AWS IoT[​](#aws-iot "への直接リンクAWS IoT") [サブスクリプションの作成](https://docs.aws.amazon.com/iot/latest/developerguide/http.html)時に[エンドポイントを](https://docs.equinix.com/ja/smart-view/sv-api/create-subscription.md#aws-iot-core)提供して、データをAWS IoTコアに送信します。 > **メモ** > > EquinixがAWS IoTコアの宛先にイベントを送信することを許可するには、[Equinix証明書を](#equinix-mtls-certificate)ダウンロードしてIoTコアコンソールに登録する必要があります。手順については、[AWS IoTコアのドキュメントを参照してください。](https://docs.aws.amazon.com/iot/latest/developerguide/manual-cert-registration.html) ## Azure イベントハブ[​](#azure-イベントハブ "への直接リンクAzure イベントハブ") Azureイベントハブにデータを送信するためのセルフサービス構成は利用できません。Azureへのデータ送信を有効にするには、[サポートにお問い合わせください。](https://docs.equinix.com/ja/customer-support/opening-support-case.md) ## Webhook[​](#webhook "への直接リンクWebhook") AWSまたはAzureをコレクタとして使用したくないが、ストリーミングデータを送信できるターゲットURLを提供できる場合、Equinixは[一般的なWebhook宛先にデータを送信するサブスクリプションを作成できます。](https://docs.equinix.com/ja/smart-view/sv-api/create-subscription.md#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[​](#電力量---kwh "への直接リンク電力量 - 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)としてのフィールドは、`messageRetried`DCIMデータが実際にリアルタイムに近いか、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 とブーリアン値の解釈[​](#enum-とブーリアン値の解釈 "への直接リンクENUM とブーリアン値の解釈") 以下のようなカラムを含むエクセルのスプレッドシートがプロバイダから提供される場合があります: | IBX | アセットタイプ | 資産分類 | アセットID | TAG\_SUFFIX | TAG\_ID | TAG\_DATA\_TYPE | TAG\_UOM | タグ\_表示名 | 状態テーブル名 | | --- | -------------- | -------- | ------------------- | ----------- | -------------------------------- | --------------- | -------- | ------------ | ---------------------------------- | | TR5 | 火災、煙探知 | 機械式 | TR5.FireAlarm\_001 | アラーム | TR5.FireAlarm\_001:アラーム | ブール | | アラーム | ノーマルアラーム | | TR5 | 漏れ検出 | 機械式 | tr5.ld\_tr5\_cable1 | リーク検出 | TR5.LD\_TR5\_CABLE1:leakdetected | ブール | | リークを検出 | ノーマルアラーム | | TR5 | UPS | 電気 | TR5.UPS\_2110 | 回復性 | TR5.UPS\_2110:resilient | ブール | | レジリエント | リデュースレシル\_レジラスデザイン | ブール値およびENUM値については、最初の値(,`REDUCEDRESIL`)がに対応し`0`、2番目の値(`ALARM`,`RESILASDESIGNED`)がに対応する場合は、を`NORMAL`参照してください。`STATE_TABLE_NAME``1` ## APIコール頻度[​](#apiコール頻度 "への直接リンクAPIコール頻度") Power APIでは、アジア太平洋地域のデータセンターでは5分ごとに、その他の地域では15分ごとに電話してください。上限は、1人のユーザーあたり1日あたり100,000件です。 サブスクリプションAPI (REST収集方法)の場合は、サブスクリプションIDごとに約30秒ごとに呼び出します。5分に1回まで電話すれば十分です。