メインコンテンツに移動

サブスクリプションの作成

ストリームを作成したら、メトリクスとイベントデータをデータコレクタに送信するサブスクリプションを作成します。

サポートされるデータコレクタ：

データコレクタイベントメトリクス
Datadogサポート対象サポート対象
Google Pub/Subサポート対象サポート対象
グラファナ・ウェブフックサポート対象サポート対象
マイクロソフトチームサポート対象サポート対象
PagerDutyサポート対象サポートされていません
今すぐサービスサポート対象サポート対象
Slack Webhookサポート対象サポート対象
Splunk HECサポート対象サポート対象
一般的なWebhookサポート対象サポート対象

データ形式​

Equinixイベントとメトリクスは、すべてのデータにCloudEvents仕様形式またはOpenTelemetry仕様形式を使用します。イベントデータスキーマ、メトリクスデータスキーマ、データタイプはすべて、GitHubリポジトリで公開されています。/equinix/equinix-cloudevents

例：

---
specversion: '1.0'
source: https://api.equinix.com/fabric/v4/cloudevents
id: 6c573287-9914-4202-8b6d-2d15e7da04b8
type: equinix.fabric.metric
subject: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
time: '2024-07-01T20:12:21.306Z'
severitynumber: 9
severitytext: INFO
equinixproject: 123
dataschema: https://github.com/Fabric/.../ApiConfigEventData.json
datacontenttype: application/json
data:
  message: New metrics collected
  resource:
    href: https://api.equinix.com/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
    uuid: 956a86fb-d03d-436c-8d5d-30d1f51f7688
    name: my-test-port
    description: port description
  metrics:
  - type: GAUGE
    name: equinix.fabric.port.bandwidth_rx.usage
    description: Port inbound bandwidth utilization
    unit: bit/s
    datapoints:
    - endDateTime: '2024-07-01T20:12:21.000Z'
      value: 440023
  - type: SUM
    name: equinix.fabric.port.packets_erred_tx.count
    description: Port error packets
    interval: PT5M
    unit: packet
    datapoints:
    - endDateTime: '2024-07-01T20:12:21.000Z'
      value: 10

特定のデータコレクタ向けにこれらの形式のバリエーションを以下に示します。

前提条件​

  • サブスクリプションを作成するには、(STREAM_SUBSCRIPTION権限の作成および読み取り)ロールが必要です。Fabric Stream Subscription Managerアクセスと役割を管理するには、会社管理者またはIAM管理者にお問い合わせください。

ポータルは、Splunk、Datadog、Microsoft Teams、PagerDuty のサブスクリプションの作成と管理をサポートします。

  1. [カスタマーポータル]>[_ファブリックダッシュボード]_にサインインします。

  2. ［可視性］メニューから［データストリーム］を選択します。

    可視性ドロップダウンメニューのスクリーンショット

  3. _アクションドロップダウンメニュー_から、サブスクリプションの追加を選択します。

    アクションドロップダウンメニューのスクリーンショット

Datadog​

Datadogサブスクリプションを作成するには、サブスクリプションの作成時にDatadog APIとアプリケーションキーが必要です。

Datadogと統合するためのセットアップガイドについては、EquinixコミュニティのDatadogの設定方法を参照してください。

_サブスクリプションの追加_ページで、以下を含むDatadog情報を入力します。

  • a サブスクリプション名
  • DatadogホストのURL
  • Datadog API キー
  • Datadog アプリケーションキー
  • をクリックし、説明を入力してください（オプション）。

Datadogサブスクリプションの追加ダイアログのスクリーンショット

Datadogデータの例​

---
date_happened: 1719864741 # in seconds
source_type_name: Equinix
aggregation_key: <aggregation_key>
title: 'Virtual port status changed to Up'
status: info # INFO->info, WARN -> warn, ERROR->error, CRITICAL->warn, FATAL->error, default: info
text: "{\"cloudevent\":{\"specversion\":\"1.0\",\"source\":\"https://api.equinix.com/fabric/v4/cloudevents\",\"id\":\"6c573287-9914-4202-8b6d-2d15e7da04b8\",\"type\":\"equinix.fabric.port.status.up\",\"subject\":\"/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688\",\"time\":\"2024-07-01T20:12:21.306Z\",\"severitynumber\":9,\"severitytext\":\"INFO\",\"equinixalert\":\"clear/<aggregation_key>\",\"equinixproject\":\"123\",\"data\":{\"message\":\"Virtual port status changed to Up\",\"resource\":{}}}}"

Google PubSub​

Google Pub/Subサブスクリプションには、以下が必要です。

Google Pub/Subの設定ガイドについては、Equinixコミュニティの「Google Pub/Subの設定方法」を参照してください。

_［サブスクリプションの追加］_ページで、以下を含むGoogle Cloud PubSub情報を入力します。

  • サブスクリプション名
  • Google Cloud PubSubアクセストークン
  • Google Cloud PubSubサブスクリプションのURI
  • 説明（オプション）を入力してください。

Grafana Webhook​

Grafanaサブスクリプションを作成するには、受信Webhook用にGrafanaを作成して設定します。サブスクリプションを作成する際に、Grafana WebhookのURLとAPIキーを入力してください。

Grafanaの設定ガイドはEquinixコミュニティのGrafana Webhookの設定方法を参照してください。

_サブスクリプションの追加_ページで、以下を含むGrafana情報を入力します。

  • サブスクリプション名。
  • Grafana Metrics URI。
  • Grafana イベント URI。
  • あなたのGrafana APIキー。
  • 任意の説明

Microsoft Teams​

Microsoft Teamsサブスクリプションを作成するには、Webhookリクエストを受信したときにメッセージを投稿するようにWebhookを作成して設定します。Webhookの設定が完了したら、サブスクリプションの作成時にHTTP POST URLを入力してください。

Microsoft Teamsのセットアップガイドについては、EquinixコミュニティでMicrosoft Teamsを設定する方法を参照してください。

[_サブスクリプションの追加]_ページで、以下を含むMicrosoft Teams情報を入力します。

  • a サブスクリプション名
  • Microsoft Workflow WebhookのURL
  • をクリックし、説明を入力してください（オプション）。

Microsoft Teamsサブスクリプションの追加ダイアログのスクリーンショット

PagerDuty​

PagerDutyサブスクリプションの場合は、イベントを処理するためのサービスとイベントAPIv2インテグレーションを作成します。サブスクリプションの作成時に、PagerDutyのURLと連携キーを入力してください。

PagerDutyの設定ガイドについては、Equinixコミュニティの「PagerDutyの設定方法」を参照してください。

_［サブスクリプションの追加］_ページで、以下のPagerDuty情報を入力します。

  • a サブスクリプション名
  • あなたのPagerDutyホストURL
  • PagerDuty統合キー
  • をクリックし、説明を入力してください（オプション）。

PagerDutyサブスクリプションの追加ダイアログのスクリーンショット

PagerDutyデータの例​

---
routing_key: <routing_key>
dedup_key: <dedup_key>
event_action: trigger # or resolve
payload:
  source: Equinix
  timestamp: '2024-07-01T20:12:21.306Z'
  severity: critical
  summary: Virtual port status changed to Down
  custom_details:
    equinixsource: https://api.equinix.com/fabric/v4/cloudevents
    specversion: '1.0'
    id: <uuid>
    type: equinix.fabric.port.status.down
    subject: /fabric/v4/ports/<port_uuid>
    time: '2024-07-01T20:12:21.306Z'
    severitynumber: 21
    severitytext: FATAL # or INFO
    equinixalert: raise/<dedup_key>
    equinixproject: 123

今すぐサービス​

ServiceNowサブスクリプションには、ServiceNowのユーザー名とパスワードが必要です。

_［サブスクリプションの追加］_ページで、次のようなServiceNow情報を入力します。

  • サブスクリプション名。
  • ServiceNowホストURL。
  • ServiceNowのユーザー名です。
  • ServiceNowのパスワード
  • 任意の説明

ServiceNowデータの例​

---
source: Equinix
time_of_event: '2024-07-01T20:12:21.306Z'
description: Virtual port status changed to Down
severity: 1 # 1 for clear and 0 for clear
resolution_state: New # or Closing
message_key: NCAB543WC4lrLpET8nLX4Vd8
resource: fabric.port
node: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
type: equinix.fabric.port.status.down
additional_info: '{"cloudevent":{"specversion":"1.0","source":"https://api.equinix.com/fabric/v4/cloudevents","id":"6c573287-9914-4202-8b6d-2d15e7da04b8","type":"equinix.fabric.port.status.down","subject":"/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7681","time":"2024-07-01T20:12:21.306Z","severitynumber":13,"severitytext":"CRITICAL","equinixalert":"raise/NCAB543WC4lrLpET8nLX4Vd8","equinixproject":"123","data":{"message":"Virtual port named \'Test-port\' status changed to Down","resource":{}}}}'

Slack​

Slackのサブスクリプションには、Webhook固有のURLが必要です。受信Webhook用のSlackアプリを作成して設定するをご覧ください。

Slackと連携するための設定ガイドについては、Equinixコミュニティの「Slackの設定方法」を参照してください。

[_サブスクリプションの追加]_ページで、以下を含むSlack情報を入力します。

  • サブスクリプション名
  • サブスクリプションのURI
  • 説明(任意)

Splunk​

Splunkサブスクリプションを作成するには、イベントを受信するためのイベントインデックス、メトリクスを受信するためのメトリクスインデックス、またはその両方を作成してから、HTTPイベントコレクタを作成します。サブスクリプションの作成時に、HTTPイベントコレクタのURI'HTTPイベントコレクタのトークン'およびインデックスの名前を入力します。

Splunkと連携するための設定ガイドについては、Equinixコミュニティの「Splunkの設定方法」を参照してください。

_[サブスクリプションの追加]_ページで、以下を含むSplunk情報を入力します。

  • a サブスクリプション名
  • Splunk HTTP イベントコレクターの URI
  • Splunk アクセストークン
  • Splunk イベントインデックス (必須)
  • Splunk にメトリクスを取り込む場合は、Splunk Metrics Index を参照してください。
  • をクリックし、説明を入力してください（オプション）。

Splunkサブスクリプションの追加ダイアログのスクリーンショット

Splunkデータの例​

---
sourcetype: _json
index: test-event-index
source: equinix # optional
event:
  equinixsource: https://api.equinix.com/fabric/v4/cloudevents
  specversion: '1.0'
  id: 6c573287-9914-4202-8b6d-2d15e7da04b8
  type: equinix.fabric.port.status.up
  subject: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
  time: '2024-07-01T20:12:21.306Z'
  severitynumber: 9
  severitytext: INFO
  equinixalert: clear/NCAB543WC4lrLpET8nLX4Vd8
  equinixproject: 123
  data:
    message: Virtual port status changed to Up
    resource:
      href: https://api.equinix.com/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
      uuid: 956a86fb-d03d-436c-8d5d-30d1f51f7688
      name: my-test-port
      description: port description

汎用Webhook​

Equinixは、CloudEvent仕様形式またはOpenTelemetry仕様形式のいずれかで、イベントとメトリクスの汎用Webhookサービスへのサブスクリプションの作成をサポートしています。

イベントのURIまたはメトリクスのURIを含める必要があります。イベントとメトリクスの両方をストリーム配信するには、イベントURIとメトリクスの両方を提供する必要があります。これらのフィールドのいずれか1つだけを指定すると、対応するデータタイプ（イベントまたはメトリクス）のみが移行先プラットフォームに送信されます。

_［サブスクリプションの追加］_ページで、以下を含むWebhook情報を入力します。

  • サブスクリプション名
  • ストリーミング・データ用にCloudEvent形式またはOpen Telemetry形式のいずれかを選択します。
  • イベントURI
  • メトリックURI
  • 認証タイプを、認証なし、ユーザー名/パスワード、アクセストークン、またはAPIキーのオプションから選択します。表示されたフィールドに関連情報を入力します。
  • また、説明を入力してください（オプション）。

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