Métricas

Monitore dados métricos específicos para medir o desempenho dos seus ativos quase em tempo real. Os dados da rede de streaming incluem as seguintes métricas:

As métricas de uso de largura de banda da porta fornecem uma saída de bits por segundo (bit/s) para os dados transmitidos (tx) ou recebidos (rx) pela porta.
O uso da largura de banda da conexão fornece uma saída de bits por segundo (bit/s) para os dados transmitidos (tx) ou recebidos (rx) por meio de uma conexão em que uma porta é o lado A, entre um roteador de nuvem e uma porta, e entre um roteador de nuvem e um provedor de serviços de nuvem.
As métricas de latência Metro fornecem a latência em milissegundos (ms) de um único código metro assinado para outros metros e a latência entre todos os pares de metros.

As métricas de erros de porta e pacotes descartados fornecem o número de pacotes descartados em uma determinada porta devido ao formato do pacote, erros de transmissão ou mesmo quando a porta não tem largura de banda suficiente para aceitar o pacote.
As métricas de pacotes de conexão descartados fornecem o número de pacotes descartados em uma conexão devido à ultrapassagem dos limites de largura de banda para dados transmitidos (tx) ou recebidos (rx). Disponível apenas no lado da porta de uma conexão.

Consulte a [lista de métricas suportadas para cada recurso.

Métricas de visualização

Você pode visualizar as métricas de uma porta ou conexão virtual individual no Portal do Cliente. Métricas de Uso e Descarte de Pacotes estão disponíveis.

Faça login no [Portal do Cliente > Painel de controle em tecido.
Acesse seu Inventário de Portas ou Inventário de Conexões.
Selecione uma porta ou conexão virtual.
Na página detalhes da porta ou detalhes da conexão, clique em Métricas.

Example Connection Usage Metrics Table

Visualizando métricas da API

Você pode recuperar métricas para ativos individuais da API da Equinix. Para que os dados do evento estejam disponíveis na API, você precisa primeiro criar um fluxo e associar ativos a esse fluxo.

Latência Inter-Metro

Para visualizar a latência entre duas áreas metropolitanas, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics onde:

asset is metros
asset_id is the two-letter Metro code
e especificando name=equinix.fabric.metro.<origin_metro_code>_<destination_metro_code>.latency como o parâmetro de consulta para a solicitar.

Exemplo de solicitação 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
                }
            ]
        }
    ]
}

Para visualizar a latência em tempo real entre todos os pares de redes metropolitanas, envie uma solicitação GET para o endpoint /fabric/v4/metrics. Nos parâmetros da consulta, especifique:

name=equinix.fabric.metro.*.latency and value=last.
Opcionalmente, inclua o parâmetro limit=<limit> para especificar o número desejado de tipos de métricas a serem retornados dos resultados.
Opcionalmente, inclua o parâmetro offset=<offset> para especificar o número de resultados a serem ignorados.

Exemplo de solicitação 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
        }
      ]
    }
  ]
}

Uso da largura de banda da Porta

Para visualizar o uso de largura de banda de uma porta, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics onde:

asset is ports
asset_id is the uuid of a specific port

Parâmetros de consulta:

Entrada - equinix.fabric.port.bandwidth_rx.usage
Saída - equinix.fabric.port.bandwidth_tx.usage

Para ver todo o uso de largura de banda, especifique name=equinix.fabric.port.bandwidth_rx.usage&name=equinix.fabric.port.bandwidth_tx.usage como parâmetro de consulta para a solicitar. Especifique um período de tempo com fromDateTime e toDateTime.

Exemplo de solicitação 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
                }
            ]
        }
    ]
}

Pacotes de Porta descartados

Para visualizar a contagem de pacotes descartados de uma porta, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics onde:

asset is ports
asset_id is the uuid of a specific port

Parâmetros de consulta:

Entrada - equinix.fabric.port.packets_dropped_rx.count
Saída - equinix.fabric.port.packets_dropped_tx.count

Para obter uma contagem de todos os pacotes descartados, especifique name=equinix.fabric.port.packets_dropped_rx.count&name=equinix.fabric.port.packets_dropped_tx.count como parâmetro de consulta para a solicitar. Especifique um período de tempo com fromDateTime e toDateTime.

Exemplo de solicitação 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
            }
        }
    ]
}

Erros de pacote de Porta

Para visualizar os erros de pacote para uma porta, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics

asset is ports
asset_id is the uuid of a specific port

Parâmetros de consulta:

Entrada - equinix.fabric.port.packets_erred_rx.count
Saída - equinix.fabric.port.packets_erred_tx.count

Para obter uma contagem de todos os erros de pacote, especifique name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count como parâmetro de consulta para a solicitar. Especifique um período de tempo com fromDateTime e toDateTime.

Exemplo de solicitação 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
            }
        }
    ]
}

Uso da largura de banda de conexão

Para visualizar o uso de largura de banda de uma conexão, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics onde:

asset is connections
asset_id is the uuid of a specific connection

Parâmetros de consulta:

Entrada - equinix.fabric.connection.bandwidth_rx.usage
Saída - equinix.fabric.connection.bandwidth_tx.usage

Para ver todo o uso de largura de banda, especifique name=equinix.fabric.connection.bandwidth_rx.usage&name=equinix.fabric.connection.bandwidth_tx.usage como parâmetro de consulta para a solicitar. Especifique um período de tempo com fromDateTime e toDateTime.

Exemplo de solicitação 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
                }
            ]
        }
    ]
}

Pacotes de conexão perdidos

Para visualizar os pacotes descartados de uma conexão, envie uma solicitar GET para o endpoint /fabric/v4/<asset>/<asset_id>/metrics onde:

asset is connections
asset_id is the uuid of a specific connection

As métricas estão disponíveis para o lado A, lado Z, entrada e saída da conexão.

Parâmetros de consulta:

Lado A de entrada - equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count
Lado A de saída - equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count
Entrada z-side - equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count
Saída z-side - equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count

Para visualizar todos os pacotes descartados para a conexão, especifique 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 como o parâmetro de consulta para a solicitar. Especifique um período de tempo com fromDateTime e 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
                }
            ]
        }
    ]
}

Criando alertas de métricas

Use as APIs de Gerenciamento de Regras de Alerta de Fluxo para criar eventos quando uma métrica ultrapassar um valor limite definido. Para obter mais informações, consulte Gerenciando Regras de Alerta de Métricas.

Recebendo Métricas em uma Integração de Sink

Depois de criar um fluxo e adicionar ativos a esse fluxo, você pode criar uma assinatura para que as métricas sejam enviadas ao seu coletor de dados de terceiros de sua escolha assinando o fluxo.

Depois de criar uma assinatura para as métricas do(s) ativo(s), ela receberá métricas em um intervalo de 5 minutos.

Métricas de visualização​

Visualizando métricas da API​

Latência Inter-Metro​

Uso da largura de banda da Porta​

Pacotes de Porta descartados​

Erros de pacote de Porta​

Uso da largura de banda de conexão​

Pacotes de conexão perdidos​

Criando alertas de métricas​

Recebendo Métricas em uma Integração de Sink​

Métricas de visualização

Visualizando métricas da API

Latência Inter-Metro

Uso da largura de banda da Porta

Pacotes de Porta descartados

Erros de pacote de Porta

Uso da largura de banda de conexão

Pacotes de conexão perdidos

Criando alertas de métricas

Recebendo Métricas em uma Integração de Sink