Saltar al contenido principal

Crear una suscripción

Una vez que haya creado una secuencia, cree una suscripción para enviar sus métricas y datos de eventos a su recopilador de datos.

Recopiladores de datos compatibles:

Recopilador de datosEventosMétricas
DatadogAdmitidoAdmitido
Pub/Sub de GoogleAdmitidoAdmitido
Webhook de GrafanaAdmitidoAdmitido
Equipos de MicrosoftAdmitidoAdmitido
PagerDutyAdmitidoNo se admite
Servicio AhoraAdmitidoAdmitido
Webhook de SlackAdmitidoAdmitido
Splunk HECAdmitidoAdmitido
Webhooks genéricosAdmitidoAdmitido

Formatos de datos​

Los eventos y las métricas de Equinix utilizan el formato de especificación de CloudEvents o el formato de especificación de Opentelemetría para todos los datos. Todos nuestros esquemas de datos de eventos, esquemas de datos de métricas y tipos de datos se publican en el /equinix/equinix-cloudeventsrepositorio de GitHub.

Ejemplos:

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

Cualquier variación de estos formatos para recopiladores de datos específicos se incluye a continuación.

Requisitos previos​

  • Para crear suscripciones, debe tener el Fabric Stream Subscription Managerrol (CREACIÓN Y LECTURA DE PERMISOS STRAM_SUBSCRIPTION). Póngase en contacto con el administrador de su empresa o con el administrador de IAM para gestionar el acceso y los roles.

El portal permite crear y gestionar suscripciones a Splunk, Datadog, Microsoft Teams y PagerDuty.

  1. Inicie sesión en el portal del cliente > Panel de control de Fabric .

  2. En el menú Observabilidad, seleccione Flujos de datos .

    Captura de pantalla del menú desplegable observabilidad

  3. En el menú desplegable Acciones, seleccione Añadir suscripciones .

    Captura de pantalla del menú desplegable Acciones

Datadog​

Una suscripción de Datadog requiere su API de Datadog y claves de aplicación al crear su suscripción.

Para obtener una guía de configuración para integrarse con Datadog, consulte Cómo configurar Datadog en la comunidad Equinix.

En la página Añadir suscripción, introduzca la información de su Datadog, que incluye:

  • a Nombre de la suscripción
  • su URL de host de Datadog
  • su clave API de Datadog
  • su clave de aplicación Datadog
  • y proporcione una descripción (opcional)

Captura de pantalla del cuadro de diálogo de suscripción de Datadog

Ejemplos de datos​

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

Una suscripción de Google Pub/Sub requiere lo siguiente:

  • Crear un tema.
  • Conceder permisos de IAM a una cuenta de servicio para PUB/Sub.
  • Proporcione el URI de su tema y las credenciales de su cuenta de servicio al crear su suscripción.

Para obtener una guía de configuración de Google Pub/Sub, consulta Cómo configurar Google Pub/Sub en la comunidad de Equinix.

En la página Añadir suscripción, introduzca la información de Google Cloud PubSub, que incluye:

  • Un nombre de suscripción
  • El token de acceso PubSub de Google Cloud
  • El URI de la suscripción de Google Cloud PubSub
  • Y proporcione una descripción (opcional)

Grafana Webhook​

Para crear una suscripción a Grafana, cree y configure Grafana para webhooks entrantes . Proporcione la URL y la clave API de su webhook de Grafana al crear su suscripción.

Para obtener una guía de configuración de Grafana, consulte Cómo configurar el webhook de Grafana en la comunidad de Equinix.

En la página Añadir suscripción, introduzca la información de Grafana, que incluye:

  • Un nombre de suscripción.
  • El URI de métricas de Grafana.
  • El URI de eventos de Grafana.
  • Su clave API de Grafana.
  • Una descripción opcional.

Equipos Microsoft​

Para crear una suscripción de Microsoft Teams, cree y configure un webhook para publicar mensajes cuando se reciba una solicitud de webhook. Una vez configurado el webhook, proporcione la URL de su HTTP POST al crear su suscripción.

Para obtener una guía de configuración para Microsoft Teams, consulte Cómo configurar Microsoft Teams en la comunidad de Equinix.

En la página Añadir suscripción, introduzca la información de Microsoft Teams, que incluye:

  • a Nombre de la suscripción
  • El URI del Webhook de su flujo de trabajo de Microsoft
  • y proporcione una descripción (opcional)

Cómo añadir un cuadro de diálogo de suscripción de Microsoft Teams Captura de pantalla

PagerDuty​

Para una suscripción de PagerDuty, cree un servicio y una integración deAPI de eventos 2 para gestionar sus eventos. Proporcione su URI de PagerDuty y la clave de integración al crear su suscripción.

Para obtener una guía de configuración de PagerDuty, consulte Cómo configurar PagerDuty en la Comunidad Equinix.

En la página Añadir suscripción, introduzca la información de su PagerDuty, que incluye:

  • a Nombre de la suscripción
  • Url de su host PagerDuty
  • su clave de integración con PagerDuty
  • y proporcione una descripción (opcional)

Captura de pantalla del cuadro de diálogo de suscripción de Pagerduty

Ejemplo de datos de 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​

Una suscripción de ServiceNow requiere su nombre de usuario y contraseña de ServiceNow .

En la página Añadir suscripción, introduzca la información de ServiceNow, que incluye:

  • Un nombre de suscripción.
  • La URL del host de ServiceNow.
  • Su nombre de usuario de ServiceNow.
  • Su contraseña de ServiceNow.
  • Una descripción opcional.

Ejemplos de datos de 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​

Una suscripción de Slack requiere la URL única de tu webhook. Consulte Crear y configurar una aplicación de Slack para webhooks entrantes .

Para obtener una guía de configuración para integrarse con Slack, consulte Cómo configurar Slack en la comunidad de Equinix.

En la página Añadir suscripción, introduzca la información de Slack, que incluye:

  • Nombre de la suscripción
  • URI de suscripción
  • Descripción (opcional)

Splunk​

Para crear una suscripción de Splunk, cree un índice de eventos para recibir eventos, un índice de métricas para recibir métricas o ambas y, a continuación, cree un recopilador de eventos HTTP. Proporcione su URI del recopilador de eventos HTTP, su token del recopilador de eventos HTTP y los nombres de sus índices al crear su suscripción.

Para obtener una guía de configuración para integrarse con Splunk, consulte Cómo configurar Splunk en la comunidad Equinix.

En la página Añadir suscripción, introduzca la información de Splunk, que incluye:

  • a Nombre de la suscripción
  • su URI del recolector de eventos HTTP de Splunk
  • su token de acceso a Splunk
  • su índice de eventos Splunk (obligatorio)
  • su índice de métricas Splunk, si planea ingestar métricas en Splunk
  • y proporcione una descripción (opcional)

Añadir un cuadro de diálogo de suscripción de Splunk Captura de pantalla

Ejemplos de datos de 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 genérico​

Equinix admite la creación de una suscripción a cualquier servicio genérico de webhook para eventos y métricas en formato de especificación de CloudEvent o formato de especificación de OpenTelemetría .

Debe incluir un URI del evento o un URI métrico. Para transmitir eventos y métricas, debe proporcionar un URI del evento y un URI de métrica. Si proporciona solo uno de estos campos, solo se envía el tipo de datos correspondiente (eventos o métricas) a la plataforma de destino.

En la página Añadir suscripción, introduzca la información de su Webhook, que incluye:

  • Un nombre de suscripción
  • Seleccione el formato CloudEvent o el formato Open Telemetry para sus datos de flujo.
  • El URI del evento
  • El URI métrico
  • Seleccione un tipo de autenticación entre las opciones Sin autorización, nombre de usuario/contraseña, token de acceso ni clave de API. Introduzca la información relevante en los campos proporcionados.
  • Y proporcione una descripción (opcional).

¿Le ha resultado útil esta página?