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 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 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 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 de connexion abandonnés fournissent le nombre de paquets abandonnés sur une connexion en raison du dépassement des limites de 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 métriques​

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

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

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

Latence inter-métro​

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
                }
            ]
        }
    ]
}

Paquets de port 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 de 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 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

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:

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