管理订阅

使用订阅管理API管理遥测数据传输至数据收集器。

前提条件

调用订阅管理API之前，请参阅Data Collector设置以设置您选择的接收器类型。
要创建订阅，您必须具有Fabric Stream Subscription Manager(stream_subscription权限创建和读取)角色。请与您的公司管理员或IAM管理员联系以管理访问权限和角色。
如果您使用的是API，请提交您的用户凭据，客户端ID和用于OAuth2身份验证的客户端机密。有关如何验证对Equinix API的请求的详细信息，请参阅API身份验证。

创建订阅

Portal
API

该门户支持创建和管理Splunk，Datadog，Microsoft Teams和PagerDuty的订阅。

登录客户门户>Fabric Dashboard。
从_Observability_菜单中，选择数据流。
从_Actions_下拉菜单中，选择添加订阅。
从下拉菜单中选择订阅的数据收集器。有关支持的数据收集器，请参阅以下示例。

要创建订阅，请向端点发送POST请求/fabric/v4/streams/<streamId>/subscriptions。在对象中指定流ID，在请求正文中的对象中指定stream数据收集器的设置和验证信息sink。

请参阅下面的示例，为支持的数据收集器创建流订阅。

注意

订阅API URI/HOST值仅支持HTTPS，不支持自签名证书。

数据记录

Portal
API
Event
Metric

在_添加订阅_页上，输入您的数据记录信息，包括：

订阅名称
您的Datadog主机URL
您的Datadog API密钥
您的数据记录应用程序密钥
并提供说明(可选)

Adding a Datadog Subscription Dialog Screenshot

使用Datadog站点引用表查找参数的站点参数sink.host。

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
  "type": "STREAM_SUBSCRIPTION",
  "name": "<datadog_subscription_name>",
  "description": "<datadog_subscription_desc>",
  "sink": {
    "host": "https://<datadog_site_parameter>",
    "type": "DATADOG",
    "credential": {
      "type": "API_KEY",
      "apiKey": "<datadog_api_key>"
    },
    "settings": {
      "applicationKey": "<datadog_application_key>"
    }
  }
}'

示例响应：

{
  "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/1a39648d-c407-4470-b08b-454965f31bf4",
  "uuid": "1a39648d-c407-4470-b08b-454965f31bf4",
  "type": "STREAM_SUBSCRIPTION",
  "name": "datadog_subscription",
  "description": "datadog_subscription_desc",
  "state": "PROVISIONED",
  "enabled": true,
  "sink": {
    "host": "https://<datadog_site_parameter>",
    "type": "DATADOG",
    "credential": {
      "type": "API_KEY",
      "apiKey": "<encrypted_datadog_api_key>"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
      "metricUri": "https://<datadog_site_parameter>/api/v2/series",
      "eventUri": "https://<datadog_site_parameter>/api/v1/events"
    }
  },
  "changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-10-07T06:48:45.861755Z",
    "updatedDateTime": "2024-10-07T06:48:51.514474Z"
  }
}

---
date_happened: 1719864741 # in seconds
source_type_name: Equinix
aggregation_key: NCAB543WC4lrLpET8nLX4Vd8
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/NCAB543WC4lrLpET8nLX4Vd8\",\"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

Google PubSub

Portal
API

在添加订阅页面上，输入您的Google Cloud PubSub信息，包括：

订阅名称
Google Cloud PubSub访问令牌
Google Cloud PubSub订阅URI
并提供说明(可选)

curl -X POST 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
    "type": "STREAM_SUBSCRIPTION",
    "name": "<gcp_pubsub_subscription_name>",
    "description": "<gcp_pubsub_subscription_desc>",
    "sink": {
    "uri": "https://pubsub.googleapis.com/v1/projects/<gcp_project_name>/topics/<gcp_topic_name>:publish",
    "type": "GOOGLE_PUBSUB",
    "credential": {
        "type": "ACCESS_TOKEN",
        "accessToken": "<encoded_base64_service_account_json>"
    }
    }
}'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/12190e7d-a486-4a77-ba56-fecdab616837",
"uuid": "12190e7d-a486-4a77-ba56-fecdab616837",
"type": "STREAM_SUBSCRIPTION",
"name": "<gcp_pubsub_subscription_name>",
"description": "<gcp_pubsub_subscription_desc>",
"state": "PROVISIONED",
"enabled": true,
"sink": {
    "uri": "https://pubsub.googleapis.com/v1/projects/<gcp_project_name>/topics/<gcp_topic_name>:publish",
    "type": "GOOGLE_PUBSUB",
    "credential": {
    "type": "ACCESS_TOKEN"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2025-04-28T21:23:02.006057019Z"
}
}

Grafana Webhook

在_添加订阅_页上，输入您的Grafana信息，包括：

订阅名称。
Grafana Metrics URI。
Grafana事件URI。
您的Grafana API密钥。
可选说明。

卷曲请求示例：

curl -X POST 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"type": "STREAM_SUBSCRIPTION",
"name": "<webhook_subscription_name>",
"description": "<webhook_subscription_desc>",
"enabled": true,
"sink": {
    "type": "WEBHOOK"
    "settings": {
    "eventUri": "https://<grafana_oltp_endpoint>/otlp/v1/logs",
    "metricUri": "https://<grafana_oltp_endpoint>/otlp/v1/metrics",
    "format": "OPENTELEMETRY"
    },
    "credential": {
    "type": "API_KEY",
    "apiKey": "<granfana_instance_id>:<grafana_api_key>",
    }
}
}'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/1a39648d-c407-4470-b08b-454965f31bf4",
"uuid": "1a39648d-c407-4470-b08b-454965f31bf4",
"type": "STREAM_SUBSCRIPTION",
"name": "datadog_subscription",
"description": "datadog_subscription_desc",
"state": "PROVISIONED",
"enabled": true,
"sink": {
    "host": "https://<datadog_site_parameter>",
    "type": "DATADOG",
    "credential": {
    "type": "API_KEY",
    "apiKey": "<encrypted_datadog_api_key>"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
    "metricUri": "https://<datadog_site_parameter>/api/v2/series",
    "eventUri": "https://<datadog_site_parameter>/api/v1/events"
    }
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-10-07T06:48:45.861755Z",
    "updatedDateTime": "2024-10-07T06:48:51.514474Z"
}
}

---
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

Microsoft Teams

Portal
API

在_添加订阅_页上，输入您的Microsoft Teams信息，包括：

订阅名称
您的Microsoft工作流Webhook URI
并提供说明(可选)

Adding a Microsoft Teams Subscription Dialog Screenshot

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
  "type": "STREAM_SUBSCRIPTION",
  "name": "<ms_teams_subscription>",
  "description": "<ms_teams_subscription_desc>",
  "sink": {
    "uri": "<teams_webhook_uri>",
    "type": "TEAMS"
  }
}'

示例响应：

{
  "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/12190e7d-a486-4a77-ba56-fecdab616837",
  "uuid": "12190e7d-a486-4a77-ba56-fecdab616837",
  "type": "STREAM_SUBSCRIPTION",
  "name": "ms_teams_subscription",
  "description": "ms_teams_subscription_desc",
  "state": "PROVISIONED",
  "enabled": true,
  "sink": {
    "uri": "****",
    "type": "TEAMS",
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5
  },
  "changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-10-04T13:20:40.127727Z"
  }
}

PagerDuty

Portal
API
Event

在_添加订阅_页上，输入PagerDuty信息，包括：

订阅名称
您的PagerDuty主机URL
您的PagerDuty集成密钥
并提供说明(可选)

Adding a Pagerduty Subscription Dialog Screenshot

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
  "type": "STREAM_SUBSCRIPTION",
  "name": "<pagerduty_subscription_name>",
  "description": "<pagerduty_subscription_desc>",
  "sink": {
    "host": "https://events.pagerduty.com",
    "type": "PAGERDUTY",
    "credential": {
      "type": "INTEGRATION_KEY",
      "integrationKey": "<pagerduty_integration_key>"
    }
  }
}'

示例响应：

{
  "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/dae0726a-87f0-4c5f-8662-ccbcf44a0de2",
  "uuid": "dae0726a-87f0-4c5f-8662-ccbcf44a0de2",
  "type": "STREAM_SUBSCRIPTION",
  "name": "pagerduty-subscription",
  "description": "pagerduty-subscription-desc",
  "state": "PROVISIONED",
  "enabled": true,
  "sink": {
    "host": "https://events.pagerduty.com",
    "type": "PAGERDUTY",
    "credential": {
      "type": "INTEGRATION_KEY",
      "integrationKey": "<encrypted_integration_key>"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
      "source": "equinix",
      "changeUri": "https://events.pagerduty.com/v2/change/enqueue",
      "alertUri": "https://events.pagerduty.com/v2/enqueue"
    }
  },
  "changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-09-18T22:04:58.664523Z"
  }
}

---
routing_key: routingKey
dedup_key: NCAB543WC4lrLpET8nLX4Vd8
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: 6c573287-9914-4202-8b6d-2d15e7da04b8
    type: equinix.fabric.port.status.down
    subject: /fabric/v4/ports/956a86fb-d03d-436c-8d5d-30d1f51f7688
    time: '2024-07-01T20:12:21.306Z'
    severitynumber: 21
    severitytext: FATAL # or INFO
    equinixalert: raise/NCAB543WC4lrLpET8nLX4Vd8
    equinixproject: 123

ServiceNow

Portal
API
Event
Metric

在_添加订阅_页上，输入ServiceNow信息，包括：

订阅名称。
ServiceNow主机URL。
请输入您的用户名。
您的ServiceNow密码。
可选说明。

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"type": "STREAM_SUBSCRIPTION",
"name": "<servicenow_subscription_name>",
"description": "<servicenow_subscription_desc>",
"sink": {
    "host": "https://<host>.service-now.com",
    "type": "SERVICENOW",
    "settings": {
    "source": "<source_name>"
    },
    "credential": {
    "type": "USERNAME_PASSWORD",
    "username": "<servicenow-username>",
    "password": "<servicenow-password>"
    }
}
}'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/9b503760-b30f-4eb8-a681-aab1cfa9db1f",
"uuid": "9b503760-b30f-4eb8-a681-aab1cfa9db1f",
"type": "STREAM_SUBSCRIPTION",
"name": "servnow_subscription",
"description": "servnow_subscription_desc",
"state": "PROVISIONING",
"enabled": true,
"sink": {
    "host": "https://<host>.service-now.com",
    "type": "SERVICENOW",
    "credential": {
    "type": "USERNAME_PASSWORD"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
    "source": "source_name",
    "metricUri": "https://<host>.service-now.com/api/mid/sa/metrics",
    "eventUri": "https://<host>.service-now.com/api/global/em/jsonv2"
    }
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2025-01-22T18:09:20.894582046Z"
}
}

---
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: "%"

松弛

Portal
API
CloudEvent
CloudEvent Metric

在_添加订阅_页上，输入您的可宽延信息，包括：

订阅名称
订阅URI
说明（可选）

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
"type": "STREAM_SUBSCRIPTION",
"name": "<slack_subscription_name>",
"description": "<slack_subscription_desc>",
"sink": {
    "uri": "<slack_webhook_uri>",
    "type": "SLACK"
}
}'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/12190e7d-a486-4a77-ba56-fecdab616837",
"uuid": "12190e7d-a486-4a77-ba56-fecdab616837",
"type": "STREAM_SUBSCRIPTION",
"name": "slack_subscription",
"description": "slack_subscription_desc",
"state": "PROVISIONED",
"enabled": true,
"sink": {
    "uri": "****",
    "type": "SLACK",
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-10-04T13:20:40.127727Z"
}
}

---
cloudevent:
  source: 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

---
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/equinixapis/.../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

Splunk

Portal
API
Event
Metric

在_添加订阅_页上，输入您的Splunk信息，包括：

订阅名称
您的Splunk HTTP事件收集器URI
您的Splunk访问令牌
您的Splunk事件索引(必填)
您的Splunk指标索引(如果您计划将指标导入到Splunk中)
并提供说明(可选)

Adding a Splunk Subscription Dialog Screenshot

卷曲请求示例：

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
  "type": "STREAM_SUBSCRIPTION",
  "name": "<splunk_subscription_name>",
  "description": "<splunk_subscription_desc>",
  "sink": {
    "uri": "https://http-inputs-<host>.splunkcloud.com:<port>/services/collector/event"
    "type": "SPLUNK_HEC",
    "settings": {
      "eventIndex": "<name_of_eventIndex>",
      "metricIndex": "<name_of_metricIndex>",
      "source": "<name_of_splunk_hec>"
    },
    "credential": {
      "type": "ACCESS_TOKEN",
      "accessToken": "Splunk <Splunk AccessToken>"
    }
  }
}'

示例响应：

{
  "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/958a9854-dc49-4ded-87bd-be4d0099355e",
  "uuid": "958a9854-dc49-4ded-87bd-be4d0099355e",
  "type": "STREAM_SUBSCRIPTION",
  "name": "eq-splunk ",
  "description": "subscription1",
  "state": "PROVISIONING",
  "enabled": true,
  "sink": {
    "uri": "https://http-inputs-<host>.splunkcloud.com:<port>/services/collector/event",
    "type": "SPLUNK_HEC",
    "credential": {
      "type": "ACCESS_TOKEN"
    },
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
      "eventIndex": "<name_of_eventIndex>",
      "metricIndex": "<name_of_metricIndex>",
      "source": "<name_of_splunk_hec>"
    }
  },
  "changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-08-12T21:49:21.761029359Z"
  }
}

---
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。您必须包含事件URI或Metric URI。要流式传输事件和指标，您必须同时提供事件URI和指标URI。如果仅提供其中一个字段，则仅将相应的数据类型(事件或指标)发送到目标平台。

Portal
API

在_添加订阅_页上，输入Webhook信息，包括：

订阅名称
为流数据选择CloudEvent格式或Open Telemetry格式。
事件URI
度量URI
从无身份验证，用户名/密码，访问令牌或API密钥选项中选择身份验证类型。在提供的字段中输入相关信息。
并提供说明(可选)。

卷曲请求示例：

curl -X POST 'https://api.equinix.com/fabric/v4/streams/<streamId>/subscriptions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>' \
-d '{
  "type": "STREAM_SUBSCRIPTION",
  "name": "<webhook_subscription_name>",
  "description": "<webhook_subscription_desc>",
  "enabled": true,
  "sink": {
    "type": "WEBHOOK",
    "settings": {
      "eventUri": "<webhook_uri>",
      "metricUri": "<webhook_uri>",
      "format": "<format>"
    }
  }
}'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/12190e7d-a486-4a77-ba56-fecdab616837",
"uuid": "12190e7d-a486-4a77-ba56-fecdab616837",
"type": "STREAM_SUBSCRIPTION",
"name": "<webhook_subscription_name>",
"description": "<webhook_subscription_desc>",
"state": "PROVISIONED",
"enabled": true,
"sink": {
    "type": "WEBHOOK",
    "batchEnabled": false,
    "batchSizeMax": 50,
    "batchWaitTimeMax": 5,
    "settings": {
    "eventUri": "<webhook_uri>",
    "format": "CLOUDEVENT"
    }
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2025-04-30T15:31:34.528915714Z"
}
}

查看订阅

Portal
API

从_Observability_菜单中，单击数据流。
从_流库存_中选择流。
在_流详细信息_页上，单击订阅。

要检索订阅的详细信息，请向终结点发送GET请求/fabric/v4/streams/{streamId}/subscriptions/{subscriptionId}。

卷曲请求示例：

curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/557400f8-d360-11e9-bb65-2a2ae2dbcce4' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

示例响应：

{
  "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/958a9854-dc49-4ded-87bd-be4d0099355e",
  "uuid": "958a9854-dc49-4ded-87bd-be4d0099355e",
  "type": "STREAM_SUBSCRIPTION",
  "name": "eq-splunk",
  "description": "subscription1",
  "state": "PROVISIONED",
  "enabled": true,
  "sink": {
    "uri": "https://http-inputs-<host>.splunkcloud.com:<port>/<endpoint>",
    "type": "SPLUNK_HEC",
    "credential": {
      "type": "ACCESS_TOKEN"
    },
    "settings": {
      "eventIndex": "<name_of_eventIndex>",
      "metricIndex": "<name_of_metricIndex>",
      "source": "<name_of_splunk_hec>"
    }
  },
  "changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-08-12T21:49:21.761029Z"
  }
}

删除订阅

Portal
API

从_Observability_菜单中，单击数据流。
从_流库存_中选择流。
在_流详细信息_页上，单击订阅。
在_Subscription Details_中，单击选项菜单...，然后单击删除订阅。

要删除订阅，请向端点发送DELETE请求/fabric/v4/streams/{streamId}/subscriptions/{subscriptionId}。

卷曲请求示例：

curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/557400f8-d360-11e9-bb65-2a2ae2dbcce4' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

示例响应：

{
"href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4/subscriptions/958a9854-dc49-4ded-87bd-be4d0099355e",
"uuid": "958a9854-dc49-4ded-87bd-be4d0099355e",
"type": "STREAM_SUBSCRIPTION",
"name": "eq-splunk",
"description": "subscription1",
"state": "DEPROVISIONING",
"enabled": true,
"sink": {
    "uri": "<protocol>://http-inputs-<host>.splunkcloud.com:<port>/<endpoint>",
    "type": "SPLUNK_HEC",
    "credential": {
    "type": "ACCESS_TOKEN"
    },
    "settings": {
    "eventIndex": "<name_of_eventIndex>",
    "metricIndex": "<name_of_metricIndex>",
    "source": "<name_of_splunk_hec>"
    }
},
"changeLog": {
    "createdBy": "user1",
    "createdDateTime": "2024-08-12T21:49:21.761029Z"
}
}

前提条件​

创建订阅​

数据记录​

Google PubSub​

Grafana Webhook​

Microsoft Teams​

PagerDuty​

ServiceNow​

松弛​

Splunk​

通用Webhook​

查看订阅​

删除订阅​

前提条件

创建订阅

数据记录

Google PubSub

Grafana Webhook

Microsoft Teams

PagerDuty

ServiceNow

松弛

Splunk

通用Webhook

查看订阅

删除订阅