Ir 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
Dínatrace CompatívelCompatível
Google Pub/SubCompatívelCompatível
Webhook da GrafanaCompatívelCompatível
Microsoft TeamsCompatívelCompatível
PagerDutyCompatívelNão suportado
ServiceNowCompatívelNão suportado
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\":{}}}}"

Dínatrace​

Para criar uma assinatura Dynatrace, crie um índice de eventos para receber eventos, um índice de métricas para receber métricas ou ambos e, em seguida, crie um coletor de eventos HTTP.

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

  • um nome de assinatura
  • Seu URI do coletor de eventos HTTP Dynatrace
  • Seu token de acesso Dynatrace
  • Seu índice de eventos Dynatrace (obrigatório)
  • Seu Dynatrace Metrics Index, se você planeja incluir métricas no Splunk
  • e forneça uma descrição (opcional)

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

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?