# Criar uma assinatura Depois de [criar um fluxo](https://docs.equinix.com/pt-BR/observability/streaming-data/api-managing-streams.md), crie uma assinatura para enviar suas métricas e dados de eventos ao seu coletor de dados. Coletores de dados compatíveis: | Coletor de dados | Eventos | Métricas | | -------------------------------------- | ---------- | ------------- | | [Datacadog](#datadog) | Compatível | Compatível | | [Dínatrace](#dynatrace) | Compatível | Compatível | | [Google Pub/Sub](#google-pubsub) | Compatível | Compatível | | [Webhook da Grafana](#grafana-webhook) | Compatível | Compatível | | [Microsoft Teams](#microsoft-teams) | Compatível | Compatível | | [PagerDuty](#pagerduty) | Compatível | Não suportado | | [ServiceNow](#servicenow) | Compatível | Não suportado | | [Slack Webhook](#slack) | Compatível | Compatível | | [Splunk HEC](#splunk) | Compatível | Compatível | | [Webhooks genéricos](#generic-webhook) | Compatível | Compatível | ## Formatos de dados[​](#formatos-de-dados "Link direto para 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-cloudevents`](https://github.com/equinix/equinix-cloudevents)repositório GitHub. Exemplos: * CloudEvent * CloudEvents Metric * OpenTelemetry Log * OpenTelemetry Metric ``` --- 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 ``` As variações desses formatos para coletores de dados específicos estão incluídas abaixo. ## Pré-requisitos[​](#pré-requisitos "Link direto para Pré-requisitos") * Para criar assinaturas, você deve ter a `Fabric Stream Subscription Manager`funçã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](https://docs.equinix.com/pt-BR/iam/user-management/iam-users-access-roles.md). - Portal - API O portal permite criar e gerenciar assinaturas do Splunk, Datadog, Microsoft Teams e PagerDuty. 1. Faça login no [Portal do Cliente](https://portal.equinix.com/fabric) > *Painel do Fabric* . 2. No menu *Observabilidade*, selecione **Fluxos de Dados** . ![Captura de tela do menu suspenso Observabilidade](https://docs.equinix.com/pt-BR/assets/images/observability-drop-down-7b9fce28b7a44d07b365263f69b94cc2.png) 3. No menu suspenso *Ações*, selecione **Adicionar assinaturas**. ![Captura de tela do menu suspenso Ações](https://docs.equinix.com/pt-BR/assets/images/add-subscriptions-drop-down-7922ca43aedec1062f921dbc68f600c1.png) * Autenticar. Envie suas credenciais de usuário, ID do cliente e segredo do cliente para autenticação OAuth2. Consulte [Autenticação API](https://docs.equinix.com/pt-BR/equinix-api/api-authentication.md) para obter mais informações sobre como autenticar suas solicitações no Equinix API. > **Observação** > > Os valores de URI/host da API de Assinatura suportam apenas HTTPS e não suportam certificados autoassinados. ## Datadog[​](#datadog "Link direto para Datadog") Uma assinatura da Datadog requer seu [API e chaves de aplicativo](https://docs.datadoghq.com/account_management/api-app-keys/) da Datadog ao [criar sua assinatura](#datadog). Para obter um guia de configuração para integração com o Datadog, consulte [Como configurar o](https://community.equinix.com/kb/guides/how-to-set-up-datadog/3105) Datadog na Comunidade Equinix. * Portal * API 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](https://docs.equinix.com/pt-BR/assets/images/add-subscription-datadog-6e6a53bf2fc5bbaf907256eac19dada7.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `DATADOG`. * Use [a tabela de referência de site do Datadog](https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site) para encontrar o parâmetro de site para o `sink.host` parâmetro. * Forneça sua chave API do Datadog e a chave do aplicativo Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://", "type": "DATADOG", "credential": { "type": "API_KEY", "apiKey": "" }, "settings": { "applicationKey": "" } } }' ``` ### Exemplos de dados do Datadog[​](#exemplos-de-dados-do-datadog "Link direto para Exemplos de dados do Datadog") * Event * Metric ``` --- date_happened: 1719864741 # in seconds source_type_name: Equinix 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/\",\"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 ``` ## Dínatrace[​](#dínatrace "Link direto para 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. * Portal * API 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) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `DYNATRACE`. * Forneça o URI do coletor de eventos HTTP Dynatrace. * Informe o Dynatrace Event Index (obrigatório) e o Dynatrace Metrics Index (opcional). * Forneça seu token de acesso Dynatrace. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "dynatrace-subscription", "description": "subscription-1", "enabled": true, "metricSelector": { "include": [ "equinix.fabric.connection.*" ] }, "sink": { "type": "DYNATRACE", "credential": { "type": "API_TOKEN", "apiToken": "" }, "settings": { "eventUri": "https://.live.dynatrace.com/platform/ingest/v1/events", "metricUri": "https://.live.dynatrace.com/api/v2/metrics/ingest" } } }' ``` ![Adicionar uma captura de tela da caixa de diálogo de assinatura Dynatrace](https://docs.equinix.com/pt-BR/assets/images/add-subscription-dynatrace-47f64acda243906d095eb1254986f50a.png) ## Google PubSub[​](#google-pubsub "Link direto para Google PubSub") Uma assinatura do Google Pub/Sub requer o seguinte: * [Criar um tópico](https://cloud.google.com/pubsub/docs/create-topic). * Conceda permissões IAM a uma conta de serviço para Pub/Sub. * Forneça o URI do tópico e as credenciais da sua conta de serviço ao [criar sua assinatura](#google-pubsub). Para obter um guia de configuração sobre o Google Pub/Sub, consulte [Como configurar o Google Pub/Sub](https://community.equinix.com/observability-58/how-to-deploy-a-google-cloud-dataflow-980) na Comunidade Equinix. * Portal * API 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) ![](https://docs.equinix.com/pt-BR/assets/images/add-subscription-google-pubsub-be26fe60533e6b8f468ecc00df4dd22b.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `GOOGLE_PUBSUB`. * Forneça seu token de acesso pubsub do Google Cloud e o URI da assinatura pubsub. Exemplo de requisição cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "https://pubsub.googleapis.com/v1/projects//topics/:publish", "type": "GOOGLE_PUBSUB", "credential": { "type": "ACCESS_TOKEN", "accessToken": "" } } }' ``` ## Webhook do Grafana[​](#webhook-do-grafana "Link direto para Webhook do Grafana") Para criar uma assinatura Grafana, [crie e configure o Grafana para webhooks recebidos](https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/#recommended-opentelemetry-setup-via-grafana-cloud-integrations) . 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](https://community.equinix.com/kb/guides/how-to-set-up-a-webhook-in-grafana/3219) na Comunidade Equinix. * Portal * API 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. ![](https://docs.equinix.com/pt-BR/assets/images/add-subscription-grafana-5bec5b974efeaee81abc603c351944b4.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `WEBHOOK`. * Forneça seu URI de métricas Grafana, URI de eventos ou ambos. * Forneça sua chave Grafana API. Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "enabled": true, "sink": { "type": "WEBHOOK", "settings": { "metricUri": "https:///otlp/v1/metrics", "format": "OPENTELEMETRY" }, "credential": { "type": "API_KEY", "apiKey": ":" } } }' ``` ## Microsoft Teams[​](#microsoft-teams "Link direto para Microsoft Teams") Para criar uma assinatura do Microsoft Teams, [crie e configure um webhook](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498) para publicar mensagens quando uma solicitação de[webhook](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498) 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](https://community.equinix.com/observability-58/how-to-set-up-microsoft-teams-982?tid=982\&fid=58) na Comunidade Equinix. * Portal * API 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](https://docs.equinix.com/pt-BR/assets/images/add-subscription-microsoft-teams-13d3f86bb4033faaf6bc1764bec888aa.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `TEAMS`. * Forneça o URI do Webhook do Microsoft Workflow. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "", "type": "TEAMS" } }' ``` ## PagerDuty[​](#pagerduty "Link direto para PagerDuty") Para uma assinatura do PagerDuty, [crie um serviço](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-service) e uma integração do[Events APIv2](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-generic-events-api-integration) para lidar com seus eventos. Forneça o URI do PagerDuty e a Chave de Integração ao [criar sua assinatura](#pagerduty). Para obter um guia de configuração do PagerDuty, consulte [Como configurar o PagerDuty](https://community.equinix.com/observability-58/how-to-set-up-pagerduty-983) na Comunidade Equinix. * Portal * API 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](https://docs.equinix.com/pt-BR/assets/images/add-subscription-pagerduty-2a32a11bebfc3bffe8f2e803577af8a9.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `PAGERDUTY`. * Forneça o URL do host do PagerDuty e a chave de integração. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://events.pagerduty.com", "type": "PAGERDUTY", "credential": { "type": "INTEGRATION_KEY", "integrationKey": "" } } }' ``` ### Exemplo de dados do PagerDuty[​](#exemplo-de-dados-do-pagerduty "Link direto para Exemplo de dados do PagerDuty") * Event ``` --- routing_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: type: equinix.fabric.port.status.down subject: /fabric/v4/ports/ time: '2024-07-01T20:12:21.306Z' severitynumber: 21 severitytext: FATAL # or INFO equinixalert: raise/ equinixproject: 123 ``` ## ServiceNow[​](#servicenow "Link direto para ServiceNow") Uma assinatura do ServiceNow requer seu [nome de usuário e senha do ServiceNow](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/authentication/concept/local-authentication.html) . * Portal * API 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. ![](https://docs.equinix.com/pt-BR/assets/images/add-subscription-servicenow-b90cbf326fcdc53c841762ef0b06efec.png) Para criar uma assinatura do ServiceNow, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `SERVICENOW`. * Forneça o url, o nome de usuário e a senha do host ServiceNow. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "host": "https://.service-now.com", "type": "SERVICENOW", "settings": { "source": "" }, "credential": { "type": "USERNAME_PASSWORD", "username": "", "password": "" } } }' ``` ### Exemplos de dados do ServiceNow[​](#exemplos-de-dados-do-servicenow "Link direto para Exemplos de dados do ServiceNow") * Event * Metric ``` --- 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: "%" ``` ## Slack[​](#slack "Link direto para Slack") Uma assinatura do Slack requer o URL exclusivo do webhook. Consulte [Criar e configurar um aplicativo Slack para webhooks recebidos](https://api.slack.com/messaging/webhooks) . Para obter um guia de configuração para integrar-se ao Slack, consulte [Como configurar o Slack](https://community.equinix.com/observability-58/how-to-set-up-slack-981?tid=981\&fid=58) na Comunidade Equinix. * Portal * API Na página *Adicionar assinatura*, insira suas informações do Slack, incluindo: * Nome da assinatura * URI da assinatura * Descrição (opcional) ![](https://docs.equinix.com/pt-BR/assets/images/add-subscription-slack-6dad51c6da1bc924ff6a54578ab88c14.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `SLACK`. * Forneça o URI da assinatura do Slack. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "", "type": "SLACK" } }' ``` ## Splunk[​](#splunk "Link direto para Splunk") Para criar uma assinatura Splunk, crie um [índice de eventos](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_events_indexes) para receber eventos, um [índice de métricas](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_metrics_indexes) 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](https://community.equinix.com/observability-58/how-to-set-up-splunk-979?tid=979\&fid=58) na Comunidade Equinix. * Portal * API 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](https://docs.equinix.com/pt-BR/assets/images/add-subscription-splunk-01ba475d1a4a6e0ce93aa5b2dd6aa78e.png) Para criar uma assinatura, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação: * Especifique o `type` como `SPLUNK_HEC`. * Forneça o URI do coletor de eventos HTTP Splunk. * Forneça seu Splunk Event Index (obrigatório) e Splunk Metrics Index (opcional). * Forneça seu token de acesso Splunk. Exemplo de solicitação cURL: ``` curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "sink": { "uri": "https://http-inputs-.splunkcloud.com:/services/collector/event", "type": "SPLUNK_HEC", "settings": { "eventIndex": "", "metricIndex": "", "source": "" }, "credential": { "type": "ACCESS_TOKEN", "accessToken": "Splunk " } } }' ``` ### Exemplos de dados Splunk[​](#exemplos-de-dados-splunk "Link direto para Exemplos de dados Splunk") * Event * Metric ``` --- 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 genérico[​](#webhook-genérico "Link direto para 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](#data-formats) . 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. * Portal * API 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). ![](https://docs.equinix.com/pt-BR/assets/images/add-subscription-webhook-0ee372e097b1ac2978ab1825f86affd6.png) Para criar uma assinatura webhook, envie uma `POST` solicitação para o [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/pt-BR/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md) terminal. Especifique o ID do fluxo no `stream`caminho da solicitação. No `sink`objeto do corpo da solicitação, forneça os campos necessários para o seu tipo de depósito. Incluindo: * Especifique o `type` como `WEBHOOK`. * Forneça um URI de evento ou URI de métrica ou ambos. Especifique o formato. * Forneça informações de autenticação relevantes; incluindo nome de usuário/senha, token de acesso ou opções de chave API. Se nenhuma autenticação for necessária, você pode omitir o `credentials` objeto. Exemplo de solicitação cURL: ``` curl -X POST 'https://api.equinix.com/fabric/v4/streams//subscriptions' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer ' \ -d '{ "type": "STREAM_SUBSCRIPTION", "name": "", "description": "", "enabled": true, "sink": { "type": "WEBHOOK", "settings": { "eventUri": "", "metricUri": "", "format": "" } } }' ```