# サブスクリプションの作成 [ストリームを作成し](https://docs.equinix.com/ja/observability/streaming-data/api-managing-streams.md)たら、メトリクスとイベントデータをデータコレクタに送信するサブスクリプションを作成します。 サポートされるデータコレクタ: | データコレクタ | イベント | メトリクス | | -------------------------------------------- | ------------ | ---------------------- | | [Datadog](#datadog) | サポート対象 | サポート対象 | | [ディナトラケ](#dynatrace) | サポート対象 | サポート対象 | | [Google Pub/Sub](#google-pubsub) | サポート対象 | サポート対象 | | [グラファナ・ウェブフック](#grafana-webhook) | サポート対象 | サポート対象 | | [マイクロソフトチーム](#microsoft-teams) | サポート対象 | サポート対象 | | [PagerDuty](#pagerduty) | サポート対象 | サポートされていません | | [今すぐサービス](#servicenow) | サポート対象 | サポートされていません | | [Slack Webhook](#slack) | サポート対象 | サポート対象 | | [Splunk HEC](#splunk) | サポート対象 | サポート対象 | | [一般的なWebhook](#generic-webhook) | サポート対象 | サポート対象 | ## データ形式[​](#データ形式 "への直接リンクデータ形式") Equinixイベントとメトリクスは、すべてのデータにCloudEvents仕様形式またはOpenTelemetry仕様形式を使用します。イベントデータスキーマ、メトリクスデータスキーマ、データタイプはすべて、GitHubリポジトリで公開されています。[`/equinix/equinix-cloudevents`](https://github.com/equinix/equinix-cloudevents) 例: * CloudEvent * CloudEvents Metric * OpenTelemetry Log * OpenTelemetry Metric ``` --- 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 ``` ``` { "specversion": "1.0", "source": "https://api.equinix.com/fabric/v4/cloudevents", "id": "16c7e20a-d147-40c4-81ad-f60d25548aad", "time": "2026-06-24T20:20:59.000Z", "type": "equinix.fabric.metric", "subject": "/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688", "dataschema": "https://equinix.github.io/equinix-cloudevents/jsonschema/equinix/fabric/v1/MetricEvent.json", "datacontenttype": "application/json", "severitynumber": "9", "severitytext": "INFO", "equinixproject": "123", "data": { "message": "Metrics collected", "resource": { "href": "https://api.equinix.com/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688", "uuid": "956a86fb-d03d-436c-8d5d-30d1f51f7688", "type": "XF_PORT", "state": "PROVISIONED" }, "metrics": [ { "type": "GAUGE", "name": "equinix.fabric.port.bandwidth_rx.usage", "unit": "bit/s", "datapoints": [ { "endDateTime": "2026-06-24T20:20:59.000Z", "value": 179 } ] }, { "type": "GAUGE", "name": "equinix.fabric.port.bandwidth_tx.usage", "unit": "bit/s", "datapoints": [ { "endDateTime": "2026-06-24T20:20:59.000Z", "value": 1711 } ] } ] } } ``` ``` --- resourceLogs: - resource: attributes: - key: service.name value: stringValue: Equinix - key: equinix.event.specversion value: stringValue: '1.0' - key: equinix.event.source value: stringValue: https://api.equinix.com/fabric/v4/cloudevents - key: equinix.event.subject value: stringValue: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - key: equinix.event.equinixproject value: stringValue: 123 scopeLogs: - scope: logRecords: - timeUnixNano: '1719889941306000000' severityNumber: 9 severityText: Information body: stringValue: '{"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"}}' attributes: - key: equinix.event.id value: stringValue: 6c573287-9914-4202-8b6d-2d15e7da04b8 - key: equinix.event.type value: stringValue: equinix.fabric.port.status.up ``` ``` --- resourceMetrics: - resource: attributes: - key: service.name value: stringValue: Equinix - key: equinix.event.specversion value: stringValue: '1.0' - key: equinix.event.source value: stringValue: https://api.equinix.com/fabric/v4/cloudevents - key: equinix.event.subject value: stringValue: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - key: equinix.event.equinixproject value: stringValue: 123 scopeMetrics: - scope: metrics: - name: equinix.fabric.port.bandwidth_rx.usage description: Port inbound bandwidth utilization unit: 'bit/s' gauge: dataPoints: - attributes: - key: service.name value: stringValue: Equinix - key: equinix.event.source value: stringValue: https://api.equinix.com/fabric/v4/cloudevents - key: equinix.event.subject value: stringValue: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - key: equinix.event.equinixproject value: stringValue: 123 - key: equinix.event.resource.name value: stringValue: 'my-port-name' timeUnixNano: '1719889941306000000' asInt: 566 - name: equinix.fabric.port.packets_erred_tx.count description: Port error packets unit: packet sum: aggregationTemporality: 2 # required for sum https://github.com/open-telemetry/opentelemetry-proto/blob/v0.9.0/opentelemetry/proto/metrics/v1/metrics.proto#L230 dataPoints: - attributes: - key: service.name value: stringValue: Equinix - key: equinix.event.source value: stringValue: https://api.equinix.com/fabric/v4/cloudevents - key: equinix.event.subject value: stringValue: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - key: equinix.event.equinixproject value: stringValue: 123 - key: equinix.event.resource.name value: stringValue: 'my-port-name' startTimeUnixNano: '1719889641306000000' # optional timeUnixNano: '1719889941306000000' asInt: 10 ``` 特定のデータコレクタ向けにこれらの形式のバリエーションを以下に示します。 ## 前提条件[​](#前提条件 "への直接リンク前提条件") * サブスクリプションを作成するには、(STREAM\_SUBSCRIPTION権限の作成および読み取り)ロールが必要です。`Fabric Stream Subscription Manager`[アクセスと役割を管理する](https://docs.equinix.com/ja/iam/user-management/iam-users-access-roles.md)には、会社管理者またはIAM管理者にお問い合わせください。 - Portal - API ポータルは、Splunk、Datadog、Microsoft Teams、PagerDuty のサブスクリプションの作成と管理をサポートします。 1. [\[カスタマーポータル\]](https://portal.equinix.com/fabric)>\[\_ファブリックダッシュボード]\_にサインインします。 2. *[可視性*]メニューから[**データストリーム]を**選択します。 ![可視性ドロップダウンメニューのスクリーンショット](https://docs.equinix.com/ja/assets/images/observability-drop-down-7b9fce28b7a44d07b365263f69b94cc2.png) 3. \_アクションドロップダウンメニュー\_から、**サブスクリプションの追加を**選択します。 ![アクションドロップダウンメニューのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscriptions-drop-down-7922ca43aedec1062f921dbc68f600c1.png) * 認証します。ユーザー認証情報、クライアントID、およびクライアントシークレットを送信してOauth2認証を行います。Equinix APIへのリクエストを認証する方法の詳細については、[API認証を](https://docs.equinix.com/ja/equinix-api/api-authentication.md)参照してください。 > **メモ** > > Subscription API URI/host 値は HTTPS のみをサポートし、自己署名証明書はサポートしません。 ## Datadog[​](#datadog "への直接リンクDatadog") Datadogサブスクリプションを[作成する](https://docs.datadoghq.com/account_management/api-app-keys/)には、[サブスクリプションの作成](#datadog)時にDatadog [APIとアプリケーションキーが](https://docs.datadoghq.com/account_management/api-app-keys/)必要です。 Datadogと統合するためのセットアップガイドについては、Equinixコミュニティの[Datadogの設定方法を](https://community.equinix.com/kb/guides/how-to-set-up-datadog/3105)参照してください。 * Portal * API \_サブスクリプションの追加\_ページで、以下を含むDatadog情報を入力します。 * a サブスクリプション名 * DatadogホストのURL * Datadog API キー * Datadog アプリケーションキー * をクリックし、説明を入力してください(オプション)。 ![Datadogサブスクリプションの追加ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscription-datadog-6e6a53bf2fc5bbaf907256eac19dada7.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``DATADOG` * [Datadogサイト参照テーブルを](https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site)使用して、パラメータのサイトパラメータを検索します。`sink.host` * Datadog APIキーとアプリケーションキーを入力します サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://", "type": "DATADOG", "credential": { "type": "API_KEY", "apiKey": "" }, "settings": { "applicationKey": "" } } }' ``` ### Datadogデータの例[​](#datadogデータの例 "への直接リンクDatadogデータの例") * Event * Metric ``` --- date_happened: 1719864741 # in seconds source_type_name: Equinix 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/\",\"equinixproject\":\"123\",\"data\":{\"message\":\"Virtual port status changed to Up\",\"resource\":{}}}}" ``` ``` --- series: - type: 3 # 0(unspecified), 1(count), 2(rate), 3(gauge) metric: equinix.fabric.port.bandwidth_rx.usage resources: - type: subject name: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - type: equinixproject name: 123 unit: bit/s points: - timestamp: 1719889941 value: 440023 - type: 1 metric: equinix.fabric.port.packets_erred_tx.count resources: - type: subject name: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 - type: equinixproject name: 123 unit: packet interval: 300 # in seconds points: - timestamp: 1719889941 value: 10 ``` ## ディナトラケ[​](#ディナトラケ "への直接リンクディナトラケ") Dynatraceサブスクリプションを作成するには、イベントを受信するイベントインデックス、メトリクスを受信するメトリクスインデックス、またはその両方を作成してから、HTTPイベントコレクターを作成します。 * Portal * API \_[サブスクリプションの追加]\_ページで、次のようなDynatrace情報を入力します。 * a サブスクリプション名 * Dynatrace HTTPイベントコレクタのURI * Dynatraceアクセストークン * Dynatraceイベントインデックス(必須) * メトリクスをSplunkに取り込む予定の場合は、Dynatraceメトリクスインデックス * をクリックし、説明を入力してください(オプション)。 サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``DYNATRACE` * Dynatrace HTTPイベントコレクタのURLを入力します。 * Dynatraceイベントインデックス(必須)とDynatraceメトリクスインデックス(任意)を入力します。 * Dynatraceアクセストークンを入力してください。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "dynatrace-subscription", "description": "subscription-1", "enabled": true, "metricSelector": { "include": [ "equinix.fabric.connection.*" ] }, "sink": { "type": "DYNATRACE", "credential": { "type": "API_TOKEN", "apiToken": "" }, "settings": { "eventUri": "https://.live.dynatrace.com/platform/ingest/v1/events", "metricUri": "https://.live.dynatrace.com/api/v2/metrics/ingest" } } }' ``` ![Dynatraceサブスクリプションの追加ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscription-dynatrace-47f64acda243906d095eb1254986f50a.png) ## Google PubSub[​](#google-pubsub "への直接リンクGoogle PubSub") Google Pub/Subサブスクリプションには、以下が必要です。 * [トピックを作成します。](https://cloud.google.com/pubsub/docs/create-topic) * Pub/SubのサービスアカウントにIAM権限を付与します。 * [サブスクリプションを作成する](#google-pubsub)際に、トピックのURLとサービスアカウントの認証情報を入力してください。 Google Pub/Subの設定ガイドについては、Equinixコミュニティの「[Google Pub/Subの設定方法」を](https://community.equinix.com/observability-58/how-to-deploy-a-google-cloud-dataflow-980)参照してください。 * Portal * API \_[サブスクリプションの追加]\_ページで、以下を含むGoogle Cloud PubSub情報を入力します。 * サブスクリプション名 * Google Cloud PubSubアクセストークン * Google Cloud PubSubサブスクリプションのURI * 説明(オプション)を入力してください。 ![](https://docs.equinix.com/ja/assets/images/add-subscription-google-pubsub-be26fe60533e6b8f468ecc00df4dd22b.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``GOOGLE_PUBSUB` * Google Cloud PubSubアクセストークンとPubSubサブスクリプションのURLを入力します。 cURLリクエストのサンプル: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "https://pubsub.googleapis.com/v1/projects//topics/:publish", "type": "GOOGLE_PUBSUB", "credential": { "type": "ACCESS_TOKEN", "accessToken": "" } } }' ``` ## Grafana Webhook[​](#grafana-webhook "への直接リンクGrafana Webhook") Grafanaサブスクリプションを作成するには、[受信Webhook用にGrafanaを作成して設定します。](https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/#recommended-opentelemetry-setup-via-grafana-cloud-integrations)サブスクリプションを作成する際に、Grafana WebhookのURLとAPIキーを入力してください。 Grafanaの設定ガイドはEquinixコミュニティの[Grafana Webhookの設定方法を](https://community.equinix.com/kb/guides/how-to-set-up-a-webhook-in-grafana/3219)参照してください。 * Portal * API \_サブスクリプションの追加\_ページで、以下を含むGrafana情報を入力します。 * サブスクリプション名。 * Grafana Metrics URI。 * Grafana イベント URI。 * あなたのGrafana APIキー。 * 任意の説明 ![](https://docs.equinix.com/ja/assets/images/add-subscription-grafana-5bec5b974efeaee81abc603c351944b4.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``WEBHOOK` * GrafanaメトリクスのURI、イベントのURI、またはその両方を入力します。 * Grafana APIキーを入力してください。 サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "enabled": true, "sink": { "type": "WEBHOOK", "settings": { "metricUri": "https:///otlp/v1/metrics", "format": "OPENTELEMETRY" }, "credential": { "type": "API_KEY", "apiKey": ":" } } }' ``` ## Microsoft Teams[​](#microsoft-teams "への直接リンクMicrosoft Teams") Microsoft Teamsサブスクリプションを作成するには、Webhookリクエストを受信したときにメッセージを投稿するように[Webhookを作成して設定します。](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498)Webhookの設定が完了したら、サブスクリプションの作成時にHTTP POST URLを入力してください。 Microsoft Teamsのセットアップガイドについては、Equinixコミュニティで[Microsoft Teamsを設定する方法を](https://community.equinix.com/observability-58/how-to-set-up-microsoft-teams-982?tid=982\&fid=58)参照してください。 * Portal * API \[\_サブスクリプションの追加]\_ページで、以下を含むMicrosoft Teams情報を入力します。 * a サブスクリプション名 * Microsoft Workflow WebhookのURL * をクリックし、説明を入力してください(オプション)。 ![Microsoft Teamsサブスクリプションの追加ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscription-microsoft-teams-13d3f86bb4033faaf6bc1764bec888aa.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``TEAMS` * Microsoft Workflow WebhookのURLを入力します。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "", "type": "TEAMS" } }' ``` ## PagerDuty[​](#pagerduty "への直接リンクPagerDuty") PagerDutyサブスクリプションの場合は、イベントを処理するための[サービス](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-service)と[イベントAPIv2](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-generic-events-api-integration)インテグレーションを[作成します。](#pagerduty)[サブスクリプションの作成](#pagerduty)時に、PagerDutyのURLと連携キーを入力してください。 PagerDutyの設定ガイドについては、Equinixコミュニティの「[PagerDutyの設定方法」を](https://community.equinix.com/observability-58/how-to-set-up-pagerduty-983)参照してください。 * Portal * API \_[サブスクリプションの追加]\_ページで、以下のPagerDuty情報を入力します。 * a サブスクリプション名 * あなたのPagerDutyホストURL * PagerDuty統合キー * をクリックし、説明を入力してください(オプション)。 ![PagerDutyサブスクリプションの追加ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscription-pagerduty-2a32a11bebfc3bffe8f2e803577af8a9.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``PAGERDUTY` * PagerDutyホストのURLと連携キーを入力します。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://events.pagerduty.com", "type": "PAGERDUTY", "credential": { "type": "INTEGRATION_KEY", "integrationKey": "" } } }' ``` ### PagerDutyデータの例[​](#pagerdutyデータの例 "への直接リンクPagerDutyデータの例") * Event ``` --- routing_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: type: equinix.fabric.port.status.down subject: /fabric/v4/ports/ time: '2024-07-01T20:12:21.306Z' severitynumber: 21 severitytext: FATAL # or INFO equinixalert: raise/ equinixproject: 123 ``` ## 今すぐサービス[​](#今すぐサービス "への直接リンク今すぐサービス") ServiceNowサブスクリプションには、[ServiceNowのユーザー名とパスワードが](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/authentication/concept/local-authentication.html)必要です。 * Portal * API \_[サブスクリプションの追加]\_ページで、次のようなServiceNow情報を入力します。 * サブスクリプション名。 * ServiceNowホストURL。 * ServiceNowのユーザー名です。 * ServiceNowのパスワード * 任意の説明 ![](https://docs.equinix.com/ja/assets/images/add-subscription-servicenow-b90cbf326fcdc53c841762ef0b06efec.png) ServiceNowサブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``SERVICENOW` * ServiceNowホストのURL、ユーザー名、パスワードを入力します。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://.service-now.com", "type": "SERVICENOW", "settings": { "source": "" }, "credential": { "type": "USERNAME_PASSWORD", "username": "", "password": "" } } }' ``` ### ServiceNowデータの例[​](#servicenowデータの例 "への直接リンクServiceNowデータの例") * Event * Metric ``` --- 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":{}}}}' ``` ``` --- - timestamp: 1719889941306000. #mili sec source: Equinix resource_path: "/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7681" metric_type: equinix.fabric.port.bandwidth_rx.utilization value: 70.5 ci2metric_id: type: GAUGE subject: "/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7681" equinixproject: 123 unit: "%" - timestamp: 1719889941306000 #mili sec source: Equinix resource_path: "/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7681" metric_type: equinix.fabric.port.packets_erred_tx.count value: 70.5 ci2metric_id: type: GAUGE interval: PT5M subject: "/fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7681" equinixproject: 123 unit: "%" ``` ## Slack[​](#slack "への直接リンクSlack") Slackのサブスクリプションには、Webhook固有のURLが必要です。[受信Webhook用のSlackアプリを作成して設定するを](https://api.slack.com/messaging/webhooks)ご覧ください。 Slackと連携するための設定ガイドについては、Equinixコミュニティの「[Slackの設定方法」を](https://community.equinix.com/observability-58/how-to-set-up-slack-981?tid=981\&fid=58)参照してください。 * Portal * API \[\_サブスクリプションの追加]\_ページで、以下を含むSlack情報を入力します。 * サブスクリプション名 * サブスクリプションのURI * 説明(任意) ![](https://docs.equinix.com/ja/assets/images/add-subscription-slack-6dad51c6da1bc924ff6a54578ab88c14.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``SLACK` * SlackサブスクリプションのURLを入力します。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "", "type": "SLACK" } }' ``` ## Splunk[​](#splunk "への直接リンクSplunk") Splunkサブスクリプションを作成するには、イベントを受信するための[イベントインデックス](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_events_indexes)、メトリクスを受信するためのメトリクス[インデックス](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_metrics_indexes)、またはその両方を作成してから、HTTPイベントコレクタを作成します。サブスクリプションの作成時に、HTTPイベントコレクタのURI'HTTPイベントコレクタのトークン'およびインデックスの名前を入力します。 Splunkと連携するための設定ガイドについては、[](https://community.equinix.com/observability-58/how-to-set-up-splunk-979?tid=979\&fid=58)Equinixコミュニティの「Splunkの設定方法」を参照してください。 * Portal * API \_\[サブスクリプションの追加]\_ページで、以下を含むSplunk情報を入力します。 * a サブスクリプション名 * Splunk HTTP イベントコレクターの URI * Splunk アクセストークン * Splunk イベントインデックス (必須) * Splunk にメトリクスを取り込む場合は、Splunk Metrics Index を参照してください。 * をクリックし、説明を入力してください(オプション)。 ![Splunkサブスクリプションの追加ダイアログのスクリーンショット](https://docs.equinix.com/ja/assets/images/add-subscription-splunk-01ba475d1a4a6e0ce93aa5b2dd6aa78e.png) サブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` リクエスト本文のオブジェクト内`sink`: * としてを指定します。`type``SPLUNK_HEC` * Splunk HTTPイベントコレクタのURLを入力します。 * Splunkイベントインデックス(必須)とSplunkメトリクスインデックス(任意)を入力します。 * Splunkアクセストークンを入力してください。 サンプルcURLリクエスト: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "https://http-inputs-.splunkcloud.com:/services/collector/event", "type": "SPLUNK_HEC", "settings": { "eventIndex": "", "metricIndex": "", "source": "" }, "credential": { "type": "ACCESS_TOKEN", "accessToken": "Splunk " } } }' ``` ### Splunkデータの例[​](#splunkデータの例 "への直接リンクSplunkデータの例") * Event * Metric ``` --- 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 ``` ``` --- time: 1719889941.306 event: metric index: test-index-metric source: Equinix # Optional fields: subject: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688 equinixproject: 123 "metric_name:equinix.fabric.port.bandwidth_rx.usage": 440023 "metric_name:equinix.fabric.port.packets_erred_tx.count": 10 ``` ## 汎用Webhook[​](#汎用webhook "への直接リンク汎用Webhook") Equinixは[、CloudEvent仕様形式またはOpenTelemetry仕様形式の](#data-formats)いずれかで、イベントとメトリクスの汎用Webhookサービスへのサブスクリプションの作成をサポートしています。 イベントのURIまたはメトリクスのURIを含める必要があります。イベントとメトリクスの両方をストリーム配信するには、イベントURIとメトリクスの両方を提供する必要があります。これらのフィールドのいずれか1つだけを指定すると、対応するデータタイプ(イベントまたはメトリクス)のみが移行先プラットフォームに送信されます。 * Portal * API \_[サブスクリプションの追加]\_ページで、以下を含むWebhook情報を入力します。 * サブスクリプション名 * ストリーミング・データ用にCloudEvent形式またはOpen Telemetry形式のいずれかを選択します。 * イベントURI * メトリックURI * 認証タイプを、認証なし、ユーザー名/パスワード、アクセストークン、またはAPIキーのオプションから選択します。表示されたフィールドに関連情報を入力します。 * また、説明を入力してください(オプション)。 ![](https://docs.equinix.com/ja/assets/images/add-subscription-webhook-0ee372e097b1ac2978ab1825f86affd6.png) Webhookサブスクリプションを作成するには、エンドポイントにリクエストを[`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/ja/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)送信します。`POST`リクエストのパスでストリームIDを指定します。`stream` `sink`リクエスト本文のオブジェクトで、sinkタイプに必要なフィールドを入力します。以下を含む: * としてを指定します。`type``WEBHOOK` * イベントURI/メトリクスURI/またはその両方を入力します。形式を指定してください。 * ユーザー名/パスワード、アクセストークン、APIキーのオプションなど、関連する認証情報を提供します。認証が不要な場合は、オブジェクトを省略できます。`credentials` サンプルcURLリクエスト: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "enabled": true, "sink": { "type": "WEBHOOK", "settings": { "eventUri": "", "metricUri": "", "format": "" } } }' ```