# Créer un abonnement Une fois que vous avez [créé un flux](https://docs.equinix.com/fr-CA/observability/streaming-data/api-managing-streams.md), créez un abonnement pour envoyer vos métriques et vos données d'événement à votre collecteur de données. Collecteurs de données pris en charge : | Collecteur de données | Événements | Mesures | | --------------------------------------- | -------------- | ------------------ | | [Datadog](#datadog) | Pris en charge | Pris en charge | | [Dynatrace](#dynatrace) | Pris en charge | Pris en charge | | [Pub/Sub Google](#google-pubsub) | Pris en charge | Pris en charge | | [Grafana Webhook](#grafana-webhook) | Pris en charge | Pris en charge | | [Équipes Microsoft](#microsoft-teams) | Pris en charge | Pris en charge | | [PagerDuty](#pagerduty) | Pris en charge | Non pris en charge | | [ServiceNow](#servicenow) | Pris en charge | Non pris en charge | | [Mou Webhook](#slack) | Pris en charge | Pris en charge | | [Splunk HEC](#splunk) | Pris en charge | Pris en charge | | [Webhooks génériques](#generic-webhook) | Pris en charge | Pris en charge | ## Formats de données[​](#formats-de-données "Lien direct vers Formats de données") Les événements et métriques Equinix utilisent le format de spécification CloudEvents ou OpenTelemetry pour toutes les données. Tous nos schémas de données d'événements, schémas de données de métriques et types de données sont publiés dans le [`/equinix/equinix-cloudevents`](https://github.com/equinix/equinix-cloudevents)référentiel GitHub. Exemples : * 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 ``` Les variations de ces formats pour des collecteurs de données spécifiques sont indiquées ci-dessous. ## Conditions préalables[​](#conditions-préalables "Lien direct vers Conditions préalables") * Pour créer des abonnements, vous devez disposer du `Fabric Stream Subscription Manager`rôle (STREAM\_SUBSCRIPTION PERMISSION CREATE AND READ). Contactez l'administrateur de votre entreprise ou l'administrateur IAM pour [gérer les accès et les rôles](https://docs.equinix.com/fr-CA/iam/user-management/iam-users-access-roles.md). - Portal - API Le portail prend en charge la création et la gestion des abonnements à Splunk, Datadog, Microsoft Teams et PagerDuty. 1. Connectez-vous au [Portail client](https://portal.equinix.com/fabric) > *Tableau de bord Fabric* . 2. Dans le menu *observabilité*, sélectionnez **flux de données** . ![Capture d\'écran du menu déroulant observabilité](https://docs.equinix.com/fr-CA/assets/images/observability-drop-down-7b9fce28b7a44d07b365263f69b94cc2.png) 3. Dans le menu déroulant *actions* , sélectionnez **Ajouter des abonnements**. ![Capture d\'écran du menu déroulant actions](https://docs.equinix.com/fr-CA/assets/images/add-subscriptions-drop-down-7922ca43aedec1062f921dbc68f600c1.png) * Authentifier. Envoyez vos informations d’identification utilisateur, votre identifiant client et votre secret client pour l’authentification OAuth2. Pour plus d'informations sur la manière d'authentifier vos demandes auprès du Equinix API, reportez-vous à la section [authentification API](https://docs.equinix.com/fr-CA/equinix-api/api-authentication.md). > **Remarque** > > Les valeurs URI/hôte de l'API d'abonnement prennent uniquement en charge HTTPS et ne prennent pas en charge les certificats auto-signés. ## Datadog[​](#datadog "Lien direct vers Datadog") Un abonnement Datadog nécessite votre [API](https://docs.datadoghq.com/account_management/api-app-keys/) Datadog [et](#datadog) vos [clés d'application](https://docs.datadoghq.com/account_management/api-app-keys/) lors [de la création de votre abonnement](#datadog). Pour obtenir un guide de configuration à intégrer à Datadog, consultez [Comment configurer Datadog](https://community.equinix.com/kb/guides/how-to-set-up-datadog/3105) dans la communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Datadog, notamment : * un nom d'abonnement * URL de votre hôte Datadog * votre clé API Datadog * Votre clé d'application Datadog * et fournir une description (facultatif) ![Capture d\'écran de la boîte de dialogue d\'abonnement Datadog](https://docs.equinix.com/fr-CA/assets/images/add-subscription-datadog-6e6a53bf2fc5bbaf907256eac19dada7.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `DATADOG`. * Utilisez [le tableau de référence de site Datadog](https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site) pour trouver votre paramètre de site pour le `sink.host` paramètre. * Fournissez votre clé Datadog API et votre clé d'application Exemple de requête 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": "" } } }' ``` ### Exemples de données Datadog[​](#exemples-de-données-datadog "Lien direct vers Exemples de données 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 ``` ## Dynatrace[​](#dynatrace "Lien direct vers Dynatrace") Pour créer un abonnement Dynatrace, créez un index d’événements pour recevoir les événements, un index de métriques pour recevoir les métriques ou les deux, puis créez un collecteur d’événements HTTP. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Dynatrace, notamment : * un nom d'abonnement * Votre URI du collecteur d’événements HTTP Dynatrace * Votre jeton d’accès Dynatrace * Votre indice d’événements Dynatrace (obligatoire) * Votre indice de métriques Dynatrace, si vous prévoyez d’ingérer des métriques dans Splunk * et fournir une description (facultatif) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `DYNATRACE`. * Indiquez votre URI de collecteur d’événements HTTP Dynatrace. * Indiquez votre indice d’événements Dynatrace (obligatoire) et votre indice de métriques Dynatrace (facultatif). * Fournissez votre jeton d’accès Dynatrace. Exemple de requête 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" } } }' ``` ![Capture d’écran de la boîte de dialogue d’abonnement Dynatrace](https://docs.equinix.com/fr-CA/assets/images/add-subscription-dynatrace-47f64acda243906d095eb1254986f50a.png) ## Google PubSub[​](#google-pubsub "Lien direct vers Google PubSub") Un abonnement Google Pub/Sub nécessite les éléments suivants : * [Créer un sujet](https://cloud.google.com/pubsub/docs/create-topic). * Accorder des autorisations IAM à un compte de service pour Pub/Sub. * Lors de [la création de votre abonnement](#google-pubsub), indiquez votre URI de rubrique et vos identifiants de compte de service . Pour obtenir un guide de configuration sur Google Pub/Sub, consultez [Comment configurer Google Pub/Sub](https://community.equinix.com/observability-58/how-to-deploy-a-google-cloud-dataflow-980) dans la communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations PubSub Google Cloud, notamment : * Nom de l'abonnement * Jeton d'accès PubSub Google Cloud * URI d'abonnement Google Cloud PubSub * Et fournissez une description (facultatif) ![](https://docs.equinix.com/fr-CA/assets/images/add-subscription-google-pubsub-be26fe60533e6b8f468ecc00df4dd22b.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `GOOGLE_PUBSUB`. * Indiquez votre jeton d'accès PubSub Google Cloud et votre URI d'abonnement PubSub. Exemple de requête 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 Grafana[​](#webhook-grafana "Lien direct vers Webhook Grafana") Pour créer un abonnement Grafana, [créez et configurez Grafana pour les webhooks entrants](https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/#recommended-opentelemetry-setup-via-grafana-cloud-integrations) . Lors de la création de votre abonnement, indiquez l'URL et la clé API de votre Webhook Grafana. Pour obtenir un guide de configuration pour Grafana, consultez [Comment configurer Grafana Webhook](https://community.equinix.com/kb/guides/how-to-set-up-a-webhook-in-grafana/3219) dans la Communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Grafana, notamment : * Nom de l'abonnement. * L'URI des métriques Grafana. * L'URI des événements Grafana. * Votre clé API Grafana. * Description facultative. ![](https://docs.equinix.com/fr-CA/assets/images/add-subscription-grafana-5bec5b974efeaee81abc603c351944b4.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `WEBHOOK`. * Indiquez votre URI de métriques Grafana, votre URI d’événements ou les deux. * Fournissez votre clé Grafana API. Exemple de requête 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 "Lien direct vers Microsoft Teams") Pour créer un abonnement Microsoft Teams, [créez et configurez un webhook](https://support.microsoft.com/en-us/office/create-incoming-webhooks-with-workflows-for-microsoft-teams-8ae491c7-0394-4861-ba59-055e33f75498) pour publier des messages lorsqu'une demande de webhook est reçue. Une fois votre webhook configuré, indiquez votre URL POST HTTP lors de la création de votre abonnement. Pour obtenir un guide de configuration pour Microsoft Teams, consultez [Comment configurer Microsoft Teams](https://community.equinix.com/observability-58/how-to-set-up-microsoft-teams-982?tid=982\&fid=58) dans la communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Microsoft Teams, notamment : * un nom d'abonnement * Votre URI Webhook de flux de travail Microsoft * et fournir une description (facultatif) ![Capture d\'écran de la boîte de dialogue d\'abonnement Microsoft Teams](https://docs.equinix.com/fr-CA/assets/images/add-subscription-microsoft-teams-13d3f86bb4033faaf6bc1764bec888aa.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `TEAMS`. * Indiquez votre URI Webhook de flux de travail Microsoft. Exemple de requête 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 "Lien direct vers PagerDuty") Pour un abonnement PagerDuty, [créez un service](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-service) et une intégration[Events APIv2](https://support.pagerduty.com/main/docs/services-and-integrations#create-a-generic-events-api-integration) pour gérer vos événements. Indiquez votre URI PagerDuty et la clé d'intégration lors [de la création de votre abonnement](#pagerduty). Pour obtenir un guide de configuration pour PagerDuty, consultez [Comment configurer PagerDuty](https://community.equinix.com/observability-58/how-to-set-up-pagerduty-983) dans la Communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations PagerDuty, notamment : * un nom d'abonnement * URL de votre hôte PagerDuty * Votre clé d'intégration PagerDuty * et fournir une description (facultatif) ![Capture d\'écran de la boîte de dialogue d\'abonnement PagerDuty](https://docs.equinix.com/fr-CA/assets/images/add-subscription-pagerduty-2a32a11bebfc3bffe8f2e803577af8a9.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `PAGERDUTY`. * Indiquez votre URL d'hôte PagerDuty et votre clé d'intégration. Exemple de requête 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": "" } } }' ``` ### Exemple de données PagerDuty[​](#exemple-de-données-pagerduty "Lien direct vers Exemple de données 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 "Lien direct vers ServiceNow") Un abonnement ServiceNow nécessite votre [nom d'utilisateur et](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/authentication/concept/local-authentication.html) votre [mot de passe ServiceNow](https://www.servicenow.com/docs/bundle/zurich-platform-security/page/integrate/authentication/concept/local-authentication.html) . * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations ServiceNow, notamment : * Nom de l'abonnement. * URL de l'hôte ServiceNow. * Votre nom d'utilisateur ServiceNow. * Votre mot de passe ServiceNow. * Description facultative. ![](https://docs.equinix.com/fr-CA/assets/images/add-subscription-servicenow-b90cbf326fcdc53c841762ef0b06efec.png) Pour créer un abonnement ServiceNow, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)point final. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `SERVICENOW`. * Indiquez votre url d'hôte ServiceNow, votre nom d'utilisateur et votre mot de passe. Exemple de requête 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": "" } } }' ``` ### Exemples de données ServiceNow[​](#exemples-de-données-servicenow "Lien direct vers Exemples de données 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 "Lien direct vers Slack") Un abonnement Slack nécessite l'URL unique de votre webhook. Voir [créer et configurer une application Slack pour les webhooks entrants](https://api.slack.com/messaging/webhooks) . Pour obtenir un guide de configuration à intégrer à Slack, consultez [Comment configurer Slack](https://community.equinix.com/observability-58/how-to-set-up-slack-981?tid=981\&fid=58) dans la communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Slack, notamment : * Nom de l'abonnement * URI d'abonnement * Description (facultatif) ![](https://docs.equinix.com/fr-CA/assets/images/add-subscription-slack-6dad51c6da1bc924ff6a54578ab88c14.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `SLACK`. * Indiquez l'URI de l'abonnement Slack. Exemple de requête 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 "Lien direct vers Splunk") Pour créer un abonnement Splunk, créez un [index d'événements](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_events_indexes) pour recevoir les événements, un [index de mesures](https://docs.splunk.com/Documentation/Splunk/latest/Indexer/Setupmultipleindexes#Create_metrics_indexes) pour recevoir les mesures ou les deux, puis créez un collecteur d'événements HTTP. Lors de la création de votre abonnement, indiquez votre URI de collecteur d'événements HTTP, votre jeton de collecteur d'événements HTTP et les noms de vos index. Pour obtenir un guide de configuration à intégrer à Splunk, consultez [Comment configurer Splunk](https://community.equinix.com/observability-58/how-to-set-up-splunk-979?tid=979\&fid=58) dans la communauté Equinix. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Splunk, notamment : * un nom d'abonnement * URI de votre collecteur d'événements HTTP Splunk * votre jeton d'accès Splunk * Votre index d'événements Splunk (obligatoire) * votre indice de métriques Splunk, si vous prévoyez d'ingérer des métriques dans Splunk * et fournir une description (facultatif) ![Capture d\'écran de la boîte de dialogue d\'abonnement Splunk](https://docs.equinix.com/fr-CA/assets/images/add-subscription-splunk-01ba475d1a4a6e0ce93aa5b2dd6aa78e.png) Pour créer un abonnement, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande : * Spécifiez le `type` comme `SPLUNK_HEC`. * Indiquez votre URI de collecteur d’événements HTTP Splunk. * Indiquez votre index d’événements Splunk (obligatoire) et votre index de mesures Splunk (facultatif). * Fournissez votre jeton d’accès Splunk. Exemple de requête 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 " } } }' ``` ### Exemples de données Splunk[​](#exemples-de-données-splunk "Lien direct vers Exemples de données 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 générique[​](#webhook-générique "Lien direct vers Webhook générique") Equinix prend en charge la création d'un abonnement à n'importe quel service webhook générique pour les événements et les métriques au [format de spécification CloudEvent ou OpenTelemetry](#data-formats) . Vous devez inclure un URI d'événement ou un URI de mesure. Pour diffuser à la fois des événements et des mesures, vous devez fournir à la fois un URI d'événement et un URI de mesure. Si vous ne fournissez qu'un seul de ces champs, seul le type de données correspondant (événements ou mesures) est envoyé à la plateforme de destination. * Portal * API Sur la page *Ajouter un abonnement*, saisissez vos informations Webhook, notamment : * Nom de l'abonnement * Choisissez le format CloudEvent ou le format Open Telemetry pour vos données en flux continu. * L'URI de l'événement * L'URI métrique * Sélectionnez un type d'authentification parmi les options aucune autorisation, nom d'utilisateur/mot de passe, jeton d'accès ou clé API. Saisissez les informations pertinentes dans les champs prévus à cet effet. * Et fournissez une description (facultatif). ![](https://docs.equinix.com/fr-CA/assets/images/add-subscription-webhook-0ee372e097b1ac2978ab1825f86affd6.png) Pour créer un abonnement webhook, envoyez `POST` une demande au [`/fabric/v4/streams//subscriptions`](https://docs.equinix.com/fr-CA/api-catalog/fabricv4/stream-subscriptions/createstreamsubscriptions.md)terminal. Indiquez l'identifiant du flux dans le `stream` chemin de votre demande. Dans l'`sink`objet du corps de la demande, fournissez tous les champs nécessaires pour votre type de récepteur. Y compris : * Spécifiez le `type` comme `WEBHOOK`. * Indiquez un URI d'événement ou un URI de mesure, ou les deux. Spécifiez le format. * Fournissez les informations d'authentification pertinentes, y compris les options de nom d'utilisateur/mot de passe, jeton d'accès ou clé API. Si aucune authentification n'est requise, vous pouvez omettre l'`credentials`objet. Exemple de requête 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": "" } } }' ```