Passer au contenu principal

Indicateurs

Surveillez des données de mesure spécifiques pour mesurer les performances de vos équipements en temps quasi réel. Le streaming des données réseau inclut 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.

  • Les métriques de latence métropolitaine fournissent la latence en millisecondes (ms) entre un code métropolitain abonné unique et d'autres métros et la latence entre toutes les paires métropolitaines.

  • 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.

  • Les mesures relatives aux paquets abandonnés fournissent le nombre de paquets abandonnés sur une connexion en raison d'un dépassement des limites de la bande passante pour les données transmises (tx) ou reçues (rx). Disponible uniquement côté port d'une connexion.

Reportez-vous à la référence des indicateurs pris en charge pour chaque équipement.

Affichage des statistiques​

Vous pouvez afficher les mesures d'un port individuel ou d'une connexion virtuelle sur le Portail client. Des indicateurs d'utilisation et de perte de paquet sont disponibles.

  1. Connectez-vous au Portail client > Tableau de bord Fabric.

  2. Accédez à votre inventaire de ports ou à votre inventaire de connexions .

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

  4. Sur la page de détails du port ou de détails de la connexion, cliquez sur métriques.

Exemple de tableau des métriques d'utilisation de la connexion

Visualisation des mesures à partir de l'API​

Vous pouvez récupérer des métriques pour des équipements individuels à partir du Equinix API.

Temps de latence inter-métropole​

Pour afficher la latence entre deux métros, envoyez une GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final où :

  • asset est metros
  • asset_id Est le code Metro à deux lettres
  • et en spécifiant name=equinix.fabric.metro.<origin_metro_code>_<destination_metro_code>.latency comme paramètre de requête pour la demande.

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>'
Exemple de réponse :
{
    "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 métropolitaines, envoyez GETune demande au /fabric/v4/metricsterminal. Dans les paramètres de requête, spécifiez :

  • name=equinix.fabric.metro.*.latency et value=last.
  • Vous pouvez également inclure le paramètre limit=<limit> pour spécifier le nombre souhaité de types de mesures à renvoyer à partir des résultats.
  • Vous pouvez également 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>'
Exemple de réponse :
{
  "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 GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final où :

  • asset est ports
  • asset_id est l'uuid d'un port spécifique

Paramètres de requête :

  • Entrant - equinix.fabric.port.bandwidth_rx.usage
  • Sortant - equinix.fabric.port.bandwidth_tx.usage

Pour voir toute l'utilisation de la bande passante, spécifiez name=equinix.fabric.port.bandwidth_rx.usage&name=equinix.fabric.port.bandwidth_tx.usage comme paramètre de requête pour la demande. 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>'
Exemple de réponse :
{
    "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
                }
            ]
        }
    ]
}

Port Paquets abandonnés​

Pour afficher le nombre de paquets abandonnés d'un port, envoyez une GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final où :

  • asset est ports
  • asset_id est l'uuid d'un port spécifique

Paramètres de requête :

  • Entrant - equinix.fabric.port.packets_dropped_rx.count
  • Sortant - equinix.fabric.port.packets_dropped_tx.count

Pour obtenir le nombre de paquets abandonnés, spécifiez name=equinix.fabric.port.packets_dropped_rx.count&name=equinix.fabric.port.packets_dropped_tx.count comme paramètre de requête pour la demande. 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>'
Exemple de réponse :
{
    "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 du port​

Pour afficher les erreurs de paquet pour un port, envoyez une GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final

  • asset est ports
  • asset_id est l'uuid d'un port spécifique

Paramètres de requête :

  • Entrant - equinix.fabric.port.packets_erred_rx.count
  • Sortant - equinix.fabric.port.packets_erred_tx.count

Pour obtenir le nombre de toutes les erreurs de paquet, spécifiez name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count comme paramètre de requête pour la demande. 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>'
Exemple de réponse :
{
    "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 la connexion​

Pour afficher l'utilisation de la bande passante d'une connexion, envoyez une GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final où :

  • asset est connections
  • asset_id est l'uuid d'une connexion spécifique

Paramètres de requête :

  • Entrant - equinix.fabric.connection.bandwidth_rx.usage
  • Sortant - equinix.fabric.connection.bandwidth_tx.usage

Pour voir toute l'utilisation de la bande passante, spécifiez name=equinix.fabric.connection.bandwidth_rx.usage&name=equinix.fabric.connection.bandwidth_tx.usage comme paramètre de requête pour la demande. 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>'
Exemple de réponse :
{
    "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 supprimés d'une connexion, envoyez une GET demande au /fabric/v4/<asset>/<asset_id>/metricspoint final où :

  • asset est connections
  • asset_id est l'uuid d'une connexion spécifique

Les mesures sont disponibles pour les côtés a, z, entrant et sortant de la connexion.

Paramètres de requête :

  • Côté a entrant - equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count
  • Côté a sortant - equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count
  • Côté z entrant - equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count
  • Côté z sortant - equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count

Pour afficher tous les paquets abandonnés pour la connexion, spécifiez 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 pour la demande. Spécifiez 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>'
Exemple de réponse :
{
    "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 une valeur de seuil définie. Pour plus d'informations, reportez-vous à la rubrique gestion des règles d'alerte des métriques

Réception de métriques dans une intégration de puits​

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 au collecteur de données tiers de votre choix. Les mesures sont envoyées toutes les 5 minutes.

Cette page vous a-t-elle été utile ?