Pular para o conteúdo principal

Criar uma assinatura

Depois de criar um fluxo, crie uma assinatura para enviar suas métricas e dados de eventos ao seu coletor de dados.

Coletores de dados compatíveis:

Coletor de dadosEventosMétricas
DatacadogCompatívelCompatível
Google Pub/SubCompatívelCompatível
Webhook da GrafanaCompatívelCompatível
Microsoft TeamsCompatívelCompatível
PagerDutyCompatívelNão suportado
ServiceNowCompatívelCompatível
Slack WebhookCompatívelCompatível
Splunk HECCompatívelCompatível
Webhooks genéricosCompatívelCompatível

Formatos de dados​

Os eventos e métricas do Equinix usam o formato de especificação do CloudEvents ou o formato de especificação OpenTelemetry para todos os dados. Todos os nossos esquemas de dados de eventos, esquemas de dados de métricas e tipos de dados são publicados no /equinix/equinix-cloudeventsrepositório GitHub.

Exemplos:

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

As variações desses formatos para coletores de dados específicos estão incluídas abaixo.

Pré-requisitos​

  • Para criar assinaturas, você deve ter a Fabric Stream Subscription Managerfunção (STREAM_SUBSCRIPTION PERMISSION CREATE AND READ). Contate o Administrador da sua empresa ou o Administrador do IAM para gerenciar o acesso e as funções.

O portal permite criar e gerenciar assinaturas do Splunk, Datadog, Microsoft Teams e PagerDuty.

  1. Faça login no Portal do Cliente > Painel do Fabric .

  2. No menu Observabilidade, selecione Fluxos de Dados .

    Captura de tela do menu suspenso Observabilidade

  3. No menu suspenso Ações, selecione Adicionar assinaturas.

    Captura de tela do menu suspenso Ações

Datadog​

Uma assinatura da Datadog requer seu API e chaves de aplicativo da Datadog ao criar sua assinatura.

Para obter um guia de configuração para integração com o Datadog, consulte Como configurar o Datadog na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações do Datadog, incluindo:

  • um nome de assinatura
  • URL do seu host Datadog
  • sua chave de API do Datadog
  • sua chave de aplicativo Datadog
  • e forneça uma descrição (opcional)

Adicionar uma captura de tela da caixa de diálogo de assinatura do Datadog

Exemplos de dados do 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​

Uma assinatura do Google Pub/Sub requer o seguinte:

Para obter um guia de configuração sobre o Google Pub/Sub, consulte Como configurar o Google Pub/Sub na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações de pubsub do Google Cloud, incluindo:

  • Nome da assinatura
  • Token de acesso do Google Cloud PubSub
  • URI de assinatura do Google Cloud PubSub
  • E forneça uma descrição (opcional)

Webhook do Grafana​

Para criar uma assinatura Grafana, crie e configure o Grafana para webhooks recebidos . Informe o URL e a chave API do seu Grafana Webhook ao criar sua assinatura.

Para obter um guia de configuração do Grafana, consulte Como configurar o Grafana Webhook na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações do Grafana, incluindo:

  • Nome da assinatura.
  • O URI de métricas do Grafana.
  • O URI de eventos do Grafana.
  • Sua chave de API do Grafana.
  • Descrição opcional.

Microsoft Teams​

Para criar uma assinatura do Microsoft Teams, crie e configure um webhook para publicar mensagens quando uma solicitação dewebhook for recebida. Quando o webhook estiver configurado, forneça o URL HTTP POST ao criar sua assinatura.

Para obter um guia de configuração para o Microsoft Teams, consulte Como configurar o Microsoft Teams na Comunidade Equinix.

Na página Adicionar assinatura, insira as informações do Microsoft Teams, incluindo:

  • um nome de assinatura
  • URI do seu webhook do Microsoft Workflow
  • e forneça uma descrição (opcional)

Adicionar uma captura de tela da caixa de diálogo de assinatura do Microsoft Teams

PagerDuty​

Para uma assinatura do PagerDuty, crie um serviço e uma integração doEvents APIv2 para lidar com seus eventos. Forneça o URI do PagerDuty e a Chave de Integração ao criar sua assinatura.

Para obter um guia de configuração do PagerDuty, consulte Como configurar o PagerDuty na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações do PagerDuty, incluindo:

  • um nome de assinatura
  • URL do seu host PagerDuty
  • Sua chave de integração do PagerDuty
  • e forneça uma descrição (opcional)

Adicionar uma captura de tela da caixa de diálogo Assinatura Pagerduty

Exemplo de dados do 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​

Uma assinatura do ServiceNow requer seu nome de usuário e senha do ServiceNow .

Na página Adicionar assinatura, insira suas informações do ServiceNow, incluindo:

  • Nome da assinatura.
  • O URL do host do ServiceNow.
  • Seu nome de usuário do ServiceNow.
  • Sua senha do ServiceNow.
  • Descrição opcional.

Exemplos de dados do 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​

Uma assinatura do Slack requer o URL exclusivo do webhook. Consulte Criar e configurar um aplicativo Slack para webhooks recebidos .

Para obter um guia de configuração para integrar-se ao Slack, consulte Como configurar o Slack na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações do Slack, incluindo:

  • Nome da assinatura
  • URI da assinatura
  • Descrição (opcional)

Splunk​

Para criar uma assinatura Splunk, crie um índice de eventos para receber eventos, um índice de métricas para receber métricas ou ambos e crie um coletor de eventos HTTP. Forneça o URI do coletor de eventos HTTP, o token do coletor de eventos HTTP e os nomes dos seus índices ao criar sua assinatura.

Para obter um guia de configuração para integrar com o Splunk, consulte Como configurar o Splunk na Comunidade Equinix.

Na página Adicionar assinatura, insira suas informações do Splunk, incluindo:

  • um nome de assinatura
  • URI do seu coletor de eventos HTTP do Splunk
  • seu token de acesso Splunk
  • Seu índice de eventos do Splunk (obrigatório)
  • seu índice de métricas do Splunk, caso você planeje ingerir métricas no Splunk.
  • e forneça uma descrição (opcional)

Adicionar uma captura de tela da caixa de diálogo de assinatura Splunk

Exemplos de dados 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​

A Equinix oferece suporte à criação de uma assinatura para qualquer serviço de webhook genérico para eventos e métricas no formato de especificação CloudEvent ou no formato de especificação OpenTelemetry .

Você deve incluir um URI de evento ou um URI de métrica. Para transmitir eventos e métricas, você deve fornecer um URI de evento e um URI de métrica. Se você fornecer apenas um desses campos, apenas o tipo de dados correspondente (eventos ou métricas) será enviado para a plataforma de destino.

Na página Adicionar assinatura, insira suas informações do Webhook, incluindo:

  • Nome da assinatura
  • Selecione o formato CloudEvent ou o formato Open Telemetry para seus dados de streaming.
  • O URI do evento
  • O URI da métrica
  • Selecione um tipo de autenticação entre as opções Sem autenticação, Nome de usuário/senha, Token de acesso ou Chave API. Insira as informações relevantes nos campos fornecidos.
  • E forneça uma descrição (opcional).

Esta página foi útil?