Métriques

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

• Les mesures d'utilisation de la bande passante des ports 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 en 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 en nuage et un port, et entre un routeur en nuage et un fournisseur de services en nuage.

• Metro Latency Metrics fournit la latence en millisecondes (ms) d'un seul code métro souscrit vers d'autres métros et la latence entre toutes les paires de métros.

• Les mesures d'erreur et d'abandon de port indiquent le nombre de paquets rejetés sur un port donné en raison du format du paquet, d'erreurs de transmission ou même lorsque le port n'a pas la largeur de bande nécessaire pour accepter le paquet.

• Connection Packet Dropped Metrics fournit le nombre de paquets abandonnés sur une connexion en raison du dépassement des limites de la bande passante pour les données transmises (tx) ou reçues (rx). Uniquement disponible du côté du port d'une connexion.

Reportez-vous à la [référence des mesures prises en charge] (https://github.com/equinix/equinix-cloudevents?tab=readme-ov-file#metrics) pour chaque actif.

Affichage des statistiques

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

1. Connectez-vous au [Customer Portal] (http://portal.equinix.com) > Fabric Dashboard.

2. Accédez à votre Inventaire des ports ou Inventaire des connexions.

3. Sélectionnez un port ou une connexion virtuelle.

4. Sur la page port detail ou connection detail, cliquez sur Metrics.

Visualisation des mesures à partir de l'API

Vous pouvez récupérer des mesures pour des ressources individuelles à partir de l'API d'Equinix. Pour que les données d'événement soient disponibles dans l'API, vous devez d'abord créer un flux et attacher des actifs à ce flux.

Temps de latence inter-métropole

Pour visualiser 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 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 métro, envoyez une requête GET au point de terminaison /fabric/v4/metrics. Dans les paramètres de la requête, spécifiez :

• name=equinix.fabric.metro.*.latency and value=last.
• Vous pouvez inclure le paramètre limit=<limit> pour spécifier le nombre souhaité de types de métriques à renvoyer dans les résultats.
• Vous pouvez inclure 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
        }
      ]
    }
  ]
}