Ir para o conteúdo principal

Métricas

Monitore dados métricos específicos para medir o desempenho de seus ativos quase em tempo real. Os dados de 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 do mercado estratégico fornecem a latência em milissegundos (ms) de um único código estratégico subscrito para outros mercados estratégicos e a latência entre todos os pares de mercados estratégicos.

  • 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 referência das métricas compatíveis para cada ativo.

Métricas de visualização​

Você pode ver as métricas de uma porta individual ou conexão virtual no Portal do Cliente. As métricas de uso e de descarte de pacotes estão disponíveis.

  1. Faça login no Portal do Cliente > Painel do Fabric.

  2. Navegue até o Inventário de portas ou Inventário de conexões .

  3. Selecione uma porta ou conexão virtual.

  4. Na página de detalhes da porta ou de detalhes da conexão, clique em Métricas.

Exemplo de tabela de métricas de uso da conexão

Visualizando métricas da API​

Você pode recuperar métricas de ativos individuais no Equinix API.

Latência Inter-Metro​

Para ver a latência entre dois mercados estratégicos, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal onde:

  • asset é metros
  • asset_id É o código estratégico de duas letras
  • e especificando name=equinix.fabric.metro.<origin_metro_code>_<destination_metro_code>.latency como o parâmetro de consulta para a solicitação.

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>'
Exemplo de resposta:
{
    "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 ver a latência em tempo real entre todos os pares de mercado estratégico, envie uma GET solicitação para o /fabric/v4/metrics terminal. Nos parâmetros de consulta, especifique:

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

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>'
Exemplo de resposta:
{
  "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 ver o uso da largura de banda de uma porta, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal onde:

  • asset é ports
  • asset_id é o uuid de uma porta específica

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 o parâmetro de consulta para a solicitação. 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>'
Exemplo de resposta:
{
    "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 ver uma contagem dos pacotes descartados de uma porta, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal onde:

  • asset é ports
  • asset_id é o uuid de uma porta específica

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 o parâmetro de consulta da solicitação. 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>'
Exemplo de resposta:
{
    "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 ver os erros de pacote de uma porta, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal

  • asset é ports
  • asset_id é o uuid de uma porta específica

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 para todos os erros de pacote, especifique name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count como o parâmetro de consulta da solicitação. 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>'
Exemplo de resposta:
{
    "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 ver o uso da largura de banda de uma conexão, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal onde:

  • asset é connections
  • asset_id é o uuid de uma conexão específica

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 o parâmetro de consulta para a solicitação. 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>'
Exemplo de resposta:
{
    "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 ver os pacotes descartados de uma conexão, envie uma GET solicitação para o /fabric/v4/<asset>/<asset_id>/metrics terminal onde:

  • asset é connections
  • asset_id é o uuid de uma conexão específica

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

Parâmetros de consulta:

  • A-Side de entrada - equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count
  • A-Side de saída - equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count
  • Z-Side de entrada - equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count
  • Z-Side de saída - equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count

Para ver 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 solicitação. 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>'
Exemplo de resposta:
{
    "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étrica

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

Depois de criar um stream e adicionar ativos a esse stream, você pode criar uma assinatura para que as métricas sejam enviadas ao coletor de dados terceirizado de sua preferência. As métricas são enviadas em um intervalo de 5 minutos.

Esta página foi útil?