Métrique

Surveillez des données métriques spécifiques pour mesurer la performance de vos actifs en quasi-temps réel. Les données réseau en streaming incluent les métriques suivantes:

Les mesures d'utilisation de la bande passante du port fournissent une sortie en bits par seconde (bit/s) pour les données transmises (tx) ou reçues (rx) par le port.
L'utilisation de la bande passante de connexion fournit une sortie de bits par seconde (bit/s) pour les données transmises (tx) ou reçues (rx) sur une connexion où un port est le côté A, entre un routeur cloud et un port, et entre un routeur cloud et un fournisseur de services cloud.
Les mesures de latence métropolitaine fournissent la latence en millisecondes (ms) d'un seul code métropolitain abonné vers d'autres métros et la latence entre toutes les paires de métros.

Les indicateurs d'erreurs de port et de paquets abandonnés fournissent le nombre de paquets rejetés sur un port donné en raison du format du paquet, des erreurs de transmission ou même lorsque le port n'a pas la bande passante nécessaire pour accepter le paquet.
Les mesures de paquets perdus indiquent le nombre de paquets perdus sur une connexion en raison d'un dépassement des limites de bande passante, tant pour les données transmises (tx) que reçues (rx). Disponible seulement côté port d'une connexion.

Reportez-vous à la [référence des mesures prises en charge pour chaque ressource.

Affichage des métriques

Vous pouvez consulter les métriques d'un port ou d'une connexion virtuelle dans le portail client. Les mesures d'utilisation et de perte de paquets sont disponibles.

Connectez-vous au [Portail client Tableau de bord Fabric.
Allez à votre Inventaire des ports ou à votre Inventaire des connexions.
Sélectionnez un port ou une connexion virtuelle.
Depuis la page détail du port ou détail de la connexion, cliquez sur Metrics.

Example Connection Usage Metrics Table

Affichage des métriques à partir de l'API

Vous pouvez récupérer les métriques de chaque actif via l'API Equinix. Pour que les données d'événements soient disponibles dans l'API, vous devez d'abord créer un flux et associer les actifs à ce flux.

Latence inter-métro

Pour afficher la latence entre deux métros, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics où:

asset is metros
asset_id is the two-letter Metro code
et en spécifiant name=equinix.fabric.metro.<origin_metro_code>_<destination_metro_code>.latency comme paramètre de requête pour la requête.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/metros/SV/metrics?name=equinix.fabric.metro.sv_am.latency' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 3,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "GAUGE",
            "name": "equinix.fabric.metro.sv_am.latency",
            "unit": "ms",
            "resource": {
                "href": "https://uatapi.equinix.com/fabric/v4/metros/SV",
                "type": "XF_METRO",
                "description": "Silicon Valley to Amsterdam intermetro latency, average in milliseconds"
            },
            "summary": {
                "mean": 136.9,
                "max": 137
            },
            "datapoints": [
                {
                    "endDateTime": "2025-06-05T18:50:03Z",
                    "value": 137
                },
                {
                    "endDateTime": "2025-06-05T18:55:03Z",
                    "value": 137
                },
                {
                    "endDateTime": "2025-06-05T19:00:03Z",
                    "value": 137
                },
                {
                    "endDateTime": "2025-06-05T19:05:03Z",
                    "value": 137
                }
            ]
        }
    ]
}

Pour afficher la latence en temps réel entre toutes les paires de stations de métro, envoyez une requête GET au point de terminaison /fabric/v4/metrics. Dans les paramètres de requête, précisez:

name=equinix.fabric.metro.*.latency and value=last.
Inclure éventuellement le paramètre limit=<limit> pour spécifier le nombre souhaité de types de métriques à retourner à partir des résultats.
Inclure éventuellement le paramètre offset=<offset> pour spécifier le nombre de résultats à ignorer.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/metrics?value=last&limit=3&name=equinix.fabric.metro.*.latency' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
  "pagination": {
    "offset": 0,
    "limit": 3,
    "total": 4112,
    "next": "/metrics?offset=3&limit=3&fromDateTime=2026-01-29T18:05:44.041Z&name=equinix.fabric.metro.*.latency&toDateTime=2026-01-30T18:05:44.041Z"
  },
  "data": [
    {
      "type": "GAUGE",
      "name": "equinix.fabric.metro.am_at.latency",
      "unit": "ms",
      "resource": {
        "href": "https://api.equinix.com/fabric/v4/metros/AM",
        "type": "XF_METRO",
        "code": "AM",
        "description": "Amsterdam to Atlanta intermetro latency, average in milliseconds"
      },
      "datapoints": [
        {
          "endDateTime": "2026-01-30T18:05:00Z",
          "value": 94.7
        }
      ]
    },
    {
      "type": "GAUGE",
      "name": "equinix.fabric.metro.am_ba.latency",
      "unit": "ms",
      "resource": {
        "href": "https://api.equinix.com/fabric/v4/metros/AM",
        "type": "XF_METRO",
        "code": "AM",
        "description": "Amsterdam to Barcelona intermetro latency, average in milliseconds"
      },
      "datapoints": [
        {
          "endDateTime": "2026-01-30T18:05:00Z",
          "value": 28.8
        }
      ]
    },
    {
      "type": "GAUGE",
      "name": "equinix.fabric.metro.am_bg.latency",
      "unit": "ms",
      "resource": {
        "href": "https://api.equinix.com/fabric/v4/metros/AM",
        "type": "XF_METRO",
        "code": "AM",
        "description": "Amsterdam to Bogota intermetro latency, average in milliseconds"
      },
      "datapoints": [
        {
          "endDateTime": "2026-01-30T18:05:00Z",
          "value": 159
        }
      ]
    }
  ]
}

Utilisation de la bande passante du port

Pour afficher l'utilisation de la bande passante d'un port, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics où:

asset is ports
asset_id is the uuid of a specific port

Paramètres de requête:

Entrée - equinix.fabric.port.bandwidth_rx.usage
Sortie - equinix.fabric.port.bandwidth_tx.usage

Pour afficher l'ensemble de la consommation de bande passante, spécifiez name=equinix.fabric.port.bandwidth_rx.usage&name=equinix.fabric.port.bandwidth_tx.usage comme paramètre de requête. Spécifiez une période avec fromDateTime et toDateTime.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports/<port_id>/metrics?name=equinix.fabric.port.bandwidth_rx.usage&name=equinix.fabric.port.bandwidth_tx.usage&fromDateTime=2025-05-12T19%3A18%3A00Z&toDateTime=2025-05-13T19%3A18%3A00Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 2,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "GAUGE",
            "name": "equinix.fabric.port.bandwidth_rx.usage",
            "unit": "bit/s",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 198.7,
                "max": 219
            },
            "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:20:47.000Z",
                    "value": 202
                },
                {
                    "endDateTime": "2025-05-12T19:25:51.000Z",
                    "value": 192
                },
                {
                    "endDateTime": "2025-05-12T19:30:51.000Z",
                    "value": 203
                },
                {
                    "endDateTime": "2025-05-12T19:35:53.000Z",
                    "value": 194
                }
            ]
        },
        {
            "type": "GAUGE",
            "name": "equinix.fabric.port.bandwidth_tx.usage",
            "unit": "bit/s",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
            "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:20:47.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:25:51.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:30:51.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:35:53.000Z",
                    "value": 0
                }
            ]
        }
    ]
}

Paquets de port abandonnés

Pour afficher le nombre de paquets rejetés par un port, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics où:

asset is ports
asset_id is the uuid of a specific port

Paramètres de requête:

Entrée - equinix.fabric.port.packets_dropped_rx.count
Sortie - equinix.fabric.port.packets_dropped_tx.count

Pour obtenir le nombre total de paquets perdus, précisez name=equinix.fabric.port.packets_dropped_rx.count&name=equinix.fabric.port.packets_dropped_tx.count comme paramètre de requête. Spécifiez une période avec fromDateTime et toDateTime.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports/<portId>/metrics?name=equinix.fabric.port.packets_dropped_rx.count&name=equinix.fabric.port.packets_dropped_tx.count&fromDateTime=2025-05-12T19%3A18%3A00Z&toDateTime=2025-05-13T19%3A18%3A00Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 2,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "SUM",
            "name": "equinix.fabric.port.packets_dropped_rx.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            }
        },
        {
            "type": "SUM",
            "name": "equinix.fabric.port.packets_dropped_tx.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            }
        }
    ]
}

Erreurs de paquets de port

Pour afficher les erreurs de paquets d'un port, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics.

asset is ports
asset_id is the uuid of a specific port

Paramètres de requête:

Entrée - equinix.fabric.port.packets_erred_rx.count
Sortie - equinix.fabric.port.packets_erred_tx.count

Pour obtenir le nombre total d'erreurs de paquets, précisez name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count comme paramètre de requête. Spécifiez une période avec fromDateTime et toDateTime.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports/<portId>/metrics?name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count&fromDateTime=2025-05-12T19%3A18%3A00Z&toDateTime=2025-05-13T19%3A18%3A00Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 2,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "SUM",
            "name": "equinix.fabric.port.packets_erred_rx.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            }
        },
        {
            "type": "SUM",
            "name": "equinix.fabric.port.packets_erred_tx.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/ports/<portId>",
                "type": "XF_PORT",
                "uuid": "<portId>",
                "state": "PROVISIONED",
                "name": "TEST-PORT-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            }
        }
    ]
}

Utilisation de la bande passante de connexion

Pour afficher l'utilisation de la bande passante d'une connexion, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics où:

asset is connections
asset_id is the uuid of a specific connection

Paramètres de requête:

Entrée - equinix.fabric.connection.bandwidth_rx.usage
Sortie - equinix.fabric.connection.bandwidth_tx.usage

Pour afficher l'ensemble de la consommation de bande passante, spécifiez name=equinix.fabric.connection.bandwidth_rx.usage&name=equinix.fabric.connection.bandwidth_tx.usage comme paramètre de requête. Spécifiez une période avec fromDateTime et toDateTime.

Exemple de requête cURL:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/connections/<connectionId>/metrics?name=equinix.fabric.connection.bandwidth_rx.usage&name=equinix.fabric.connection.bandwidth_tx.usage&fromDateTime=2025-05-12T19%3A18%3A00Z&toDateTime=2025-05-13T19%3A18%3A00Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 2,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "GAUGE",
            "name": "equinix.fabric.connection.bandwidth_rx.usage",
            "unit": "bit/s",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
            "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:22:48.000Z",
                    "value": 202
                },
                {
                    "endDateTime": "2025-05-12T19:27:50.000Z",
                    "value": 192
                },
                {
                    "endDateTime": "2025-05-12T19:31:51.000Z",
                    "value": 203
                },
                {
                    "endDateTime": "2025-05-12T19:37:45.000Z",
                    "value": 194
                }
            ]
        },
        {
            "type": "GAUGE",
            "name": "equinix.fabric.connection.bandwidth_tx.usage",
            "unit": "bit/s",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
            "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:22:48.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:27:50.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:31:51.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:37:45.000Z",
                    "value": 0
                }
            ]
        }
    ]
}

Paquets de connexion abandonnés

Pour afficher les paquets abandonnés lors d'une connexion, envoyez une requête GET au point de terminaison /fabric/v4/<asset>/<asset_id>/metrics où:

asset is connections
asset_id is the uuid of a specific connection

Des mesures sont disponibles pour le côté A, le côté Z, l'entrée et la sortie de la connexion.

Paramètres de requête:

Entrée côté A - equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count
Débit sortant côté A - equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count
Entrée côté z - equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count
Sortie côté z - equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count

Pour afficher tous les paquets perdus pour cette connexion, précisez name=equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count comme paramètre de requête. Indiquez une période avec fromDateTime et toDateTime.

curl -X 'GET' 'https://api.equinix.com/fabric/v4/connections/<connectionId>/metrics?name=equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count&name=equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count&fromDateTime=2025-05-12T19%3A18%3A00Z&toDateTime=2025-05-13T19%3A18%3A00Z' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <Bearer Token>'

Sample Response:

{
    "pagination": {
        "offset": 0,
        "limit": 10,
        "total": 2,
        "next": null,
        "previous": null
    },
    "data": [
        {
            "type": "SUM",
            "name": "equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
             "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:28:59.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:34:01.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:36:16.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:42:12.000Z",
                    "value": 0
                }
            ]
        },
        {
            "type": "SUM",
            "name": "equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
             "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:28:59.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:34:01.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:36:16.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:42:12.000Z",
                    "value": 0
                }
            ]
        },
               {
            "type": "SUM",
            "name": "equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
             "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:28:59.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:34:01.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:36:16.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:42:12.000Z",
                    "value": 0
                }
            ]
        },
        {
            "type": "SUM",
            "name": "equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count",
            "unit": "packet",
            "resource": {
                "href": "https://api.equinix.com/fabric/v4/connections/<connectionId>",
                "type": "EVPL_VC",
                "uuid": "<connectionId>",
                "state": "PROVISIONED",
                "name": "TEST-CONNECTION-NAME"
            },
            "summary": {
                "mean": 0,
                "max": 0
            },
             "datapoints": [
                {
                    "endDateTime": "2025-05-12T19:28:59.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:34:01.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:36:16.000Z",
                    "value": 0
                },
                {
                    "endDateTime": "2025-05-12T19:42:12.000Z",
                    "value": 0
                }
            ]
        }
    ]
}

Création d'alertes métriques

Utilisez les API de gestion des règles d'alerte de flux pour créer des événements lorsqu'une mesure dépasse un seuil défini. Pour plus d'informations, consultez Gestion des règles d'alerte de métrique.

Réception de métriques dans une intégration de récepteur

Une fois que vous avez créé un flux et ajouté des ressources à ce flux, vous pouvez créer un abonnement pour que les métriques soient envoyées à votre collecteur de données tiers de votre choix en vous abonnant au flux.

Une fois que vous créez un abonnement aux métriques de l'actif, celui-ci reçoit les métriques à un intervalle de 5 minutes.

Affichage des métriques​

Affichage des métriques à partir de l'API​

Latence inter-métro​

Utilisation de la bande passante du port​

Paquets de port abandonnés​

Erreurs de paquets de port​

Utilisation de la bande passante de connexion​

Paquets de connexion abandonnés​

Création d'alertes métriques​

Réception de métriques dans une intégration de récepteur​

Affichage des métriques

Affichage des métriques à partir de l'API

Latence inter-métro

Utilisation de la bande passante du port

Paquets de port abandonnés

Erreurs de paquets de port

Utilisation de la bande passante de connexion

Paquets de connexion abandonnés

Création d'alertes métriques

Réception de métriques dans une intégration de récepteur