跳转到主要内容

创建订阅

创建数据流后,创建订阅,将指标和事件数据发送给数据收集器。

支持的数据收集器:

数据收集器事件指标
数据记录支持支持
Google Pub/Sub支持支持
Grafana Webhook支持支持
Microsoft Teams支持支持
PagerDuty支持不支持
上线支持支持
Slack Webhook支持支持
Splunk HEC支持支持
通用网络钩支持支持

数据格式​

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

特定数据收集器的这些格式的任何变体如下所示。

先决条件​

  • 要创建订阅,您必须具有Fabric Stream Subscription Manager(STREAM_SUBSCRIPTION)权限。请联系贵公司管理员或IAM管理员以管理访问权限和角色。

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

  1. 登录客户门户网站> Fabric控制面板。

  2. 从“可观测性”菜单中,选择数据流。

    观察性下拉菜单屏幕截图

  3. 从_操作_下拉菜单中,选择添加订阅。

    操作下拉菜单屏幕截图

数据记录​

在创建订阅时,数据记录订阅需要您的数据记录API和应用密钥。

有关与数据文件集成的设置指南,请参阅如何在Equinix社区中设置数据文件。

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

  • 订阅名称
  • 您的 Datadog 主机 URL
  • 您的 Datadog API 密钥
  • 您的 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订阅要求满足以下条件:

  • 创建主题。
  • 授予IAM对Pub/Sub.服务账户的权限。
  • 创建订阅时,请提供您的主题URI和服务账户凭据。

Google Pub/Sub的设置指南,请参阅如何在Equinix社区中设置Google Pub/Sub。

在_添加订阅_页面中,输入您的Google Cloud PubSub信息,包括:

  • 订阅名称
  • Google Cloud PubSub 访问令牌
  • Google Cloud PubSub 订阅 URI
  • 并提供描述(可选)

Grafana Webhook​

创建Grafana订阅, 请为传入的webhooks创建并配置Grafana。在创建订阅时,请提供您的Grafana Webhook的URL和API密钥。

有关Grafana的设置指南, 请参阅如何在Equinix社区中设置Grafana Webhook。

在_添加订阅_页面中,输入您的Grafana信息,包括:

  • 订阅名称。
  • Grafana 指标 URI。
  • Grafana 事件 URI。
  • 您的 Grafana API 密钥。
  • (可选)描述。

微软团队​

创建Microsoft Teams订阅,请创建并配置webhook,以便在收到webhook请求时发布消息。webhook配置完毕后,请在创建订阅时提供HTTP帖子URL。

有关Microsoft Teams的设置指南,请参阅如何在Equinix社区中设置Microsoft Teams。

在_添加订阅_页面中,输入您的Microsoft Teams信息,包括:

  • 订阅名称
  • 您的 Microsoft Workflow Webhook URI
  • 并提供描述(可选)

添加Microsoft Teams订阅对话框屏幕截图

PagerDuty​

对于PagerDuty订阅,请创建服务和事件APIv2集成来处理您的事件。在创建订阅时,提供您的PagerDuty URI和集成密钥。

有关PagerDuty的设置指南,请参阅如何在Equinix社区中设置PagerDuty。

在_添加订阅_页面中,输入您的PagerDuty信息,包括:

  • 订阅名称
  • 您的 PagerDuty 主机 URL
  • 您的 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信息,包括:

  • 订阅名称。
  • 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订阅需要webhook的唯一URL。请参阅为传入webhooks创建和配置Slack应用程序。

有关与Slack集成的设置指南,请参阅如何在Equinix社区中设置Slack。

在_添加订阅_页面上,输入您的可宽延信息,包括:

  • 订阅名称
  • 订阅URI
  • 描述(可选)

Splunk​

要创建Splunk订阅,请创建接收事件的事件索引,接收指标的指标索引或两者,然后创建HTTP事件收集器。在创建订阅时,提供您的HTTP事件收集器URI,HTTP事件收集器令牌和索引名称。

有关与Splunk集成的设置指南,请参阅如何在Equinix社区中设置Splunk。

在_添加订阅_页面上,输入您的Splunk信息,包括:

  • 订阅名称
  • 您的 Splunk HTTP 事件收集器 URI
  • 您的 Splunk 访问令牌
  • 您的 Splunk 事件索引(必填)
  • 如果您计划将指标导入 Splunk,则需要配置您的 Splunk 指标索引。
  • 并提供描述(可选)

添加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或Metric URI。同时提供事件URI和指标,您必须同时提供事件URI和指标URI。如果您仅提供这些字段中的一个字段,则仅会将相应的数据类型(事件或指标)发送至目标平台。

在_添加订阅_页面中,输入您的Webhook信息,包括:

  • 订阅名称
  • 选择 CloudEvent 格式或 Open Telemetry 格式作为您的流数据格式。
  • 事件 URI
  • 指标 URI
  • 从“无授权”,“用户名/密码”,“访问令牌”或“API密钥”选项中选择身份验证类型。在提供的字段中输入相关信息。
  • 并提供描述(可选)。

这个页面对您有帮助吗?