# Métricas Supervise datos métricos específicos para medir el rendimiento de sus activos casi en tiempo real. Los datos de red de streaming incluyen las siguientes métricas: * Las métricas de uso de ancho de banda del puerto proporcionan una salida de bits por segundo (bit/s) para los datos transmitidos (tx) o recibidos (rx) por el puerto. * El uso del ancho de banda de la conexión proporciona una salida de bits por segundo (bit/s) para los datos transmitidos (tx) o recibidos (rx) a través de una conexión donde un puerto es el lado A, entre un enrutador en la nube y un puerto, y entre un enrutador en la nube y un proveedor de servicios en la nube. * Las métricas de latencia del área metropolitana proporcionan la latencia en milisegundos (ms) de un único [código metropolitano suscrito](https://docs.equinix.com/es/observability/streaming-data/api-managing-assets.md#metros) a otras áreas metropolitanas y la latencia entre todos los pares metropolitanos. * Las métricas de errores y caídas de puerto proporcionan el número de descartes de paquetes en un puerto determinado debido al formato del paquete, errores de transmisión o incluso cuando el puerto no tiene ancho de banda para aceptar el paquete. * La métrica de paquetes perdidos de conexión proporciona el número de paquetes perdidos en una conexión debido a que se han superado los límites de ancho de banda tanto para los datos transmitidos (tx) como para los recibidos (rx). Solo disponible en el lado del puerto de una conexión. Consulte la [referencia de las métricas admitidas](https://github.com/equinix/equinix-cloudevents?tab=readme-ov-file#metrics) para cada activo. ## Visualización de métricas[​](#visualización-de-métricas "Enlace directo a Visualización de métricas") Puede ver las métricas de un puerto individual o una conexión virtual en el portal del cliente. Las métricas de uso y entrega de paquetes están disponibles. 1. Inicie sesión en el [portal del cliente](http://portal.equinix.com) > Panel de control de Fabric. 2. Vaya a su *inventario de puertos* o *inventario de conexiones* . 3. Seleccione un puerto o conexión virtual. 4. En la página de [detalles del puerto](https://docs.equinix.com/es/fabric/ports/fabric-port-utilization.md#metrics) o [detalles de la conexión](https://docs.equinix.com/es/fabric/managing-connections/fabric-connection-traffic.md#metrics), haga clic en *Métricas*. ![Ejemplo de tabla de métricas de uso de conexión](https://docs.equinix.com/es/assets/images/example-metrics-connection-usage-f8277d85775d287d816ecfc676393ebe.png) ## Visualización de métricas desde la API[​](#visualización-de-métricas-desde-la-api "Enlace directo a Visualización de métricas desde la API") Puede recuperar métricas para activos individuales desde Equinix API. ### Latencia inter-metro[​](#latencia-inter-metro "Enlace directo a Latencia inter-metro") Para ver la latencia entre dos áreas metropolitanas, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md)punto final donde: * `asset` es `metros` * `asset_id` Es el código metropolitano de dos letras * y especificando `name=equinix.fabric.metro._.latency` como parámetro de consulta para la solicitud. Ejemplo de solicitud 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 ' ``` Respuesta de muestra: ``` { "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 la latencia en tiempo real entre todos los pares metropolitanos, envíe una `GET` solicitud al [`/fabric/v4/metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyname.md) punto final. En los parámetros de la consulta, especifique: * `name=equinix.fabric.metro.*.latency` y `value=last`. * Opcionalmente, incluya el parámetro `limit=` para especificar el número deseado de tipos de métricas para devolver de los resultados. * Opcionalmente, incluya el parámetro `offset=` para especificar el número de resultados a omitir. Ejemplo de solicitud 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 ' ``` Respuesta de muestra: ``` { "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 del ancho de banda del puerto[​](#uso-del-ancho-de-banda-del-puerto "Enlace directo a Uso del ancho de banda del puerto") Para ver el uso del ancho de banda de un puerto, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md)punto final donde: * `asset` es `ports` * `asset_id` es el uuid de un puerto específico Parámetros de la consulta: * Entrante - `equinix.fabric.port.bandwidth_rx.usage` * Saliente - `equinix.fabric.port.bandwidth_tx.usage` Para ver todo el uso del ancho de banda, especifique `name=equinix.fabric.port.bandwidth_rx.usage&name=equinix.fabric.port.bandwidth_tx.usage` como parámetro de consulta para la solicitud. Especifique un período de tiempo con `fromDateTime` y `toDateTime`. Ejemplo de solicitud cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports//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 ' ``` Respuesta de muestra: ``` { "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/", "type": "XF_PORT", "uuid": "", "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/", "type": "XF_PORT", "uuid": "", "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 } ] } ] } ``` ### Puerto Paquetes perdidos[​](#puerto-paquetes-perdidos "Enlace directo a Puerto Paquetes perdidos") Para ver un recuento de los paquetes descartados de un puerto, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md) punto final donde: * `asset` es `ports` * `asset_id` es el uuid de un puerto específico Parámetros de la consulta: * Entrante - `equinix.fabric.port.packets_dropped_rx.count` * Saliente - `equinix.fabric.port.packets_dropped_tx.count` Para obtener un recuento de todos los paquetes descartados, especifíquelo `name=equinix.fabric.port.packets_dropped_rx.count&name=equinix.fabric.port.packets_dropped_tx.count` como parámetro de consulta para la solicitud. Especifique un período de tiempo con `fromDateTime` y `toDateTime`. Ejemplo de solicitud cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports//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 ' ``` Respuesta de muestra: ``` { "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/", "type": "XF_PORT", "uuid": "", "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/", "type": "XF_PORT", "uuid": "", "state": "PROVISIONED", "name": "TEST-PORT-NAME" }, "summary": { "mean": 0, "max": 0 } } ] } ``` ### Errores en los paquetes del puerto[​](#errores-en-los-paquetes-del-puerto "Enlace directo a Errores en los paquetes del puerto") Para ver los errores de paquete de un puerto, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md) punto final * `asset` es `ports` * `asset_id` es el uuid de un puerto específico Parámetros de la consulta: * Entrante - `equinix.fabric.port.packets_erred_rx.count` * Saliente - `equinix.fabric.port.packets_erred_tx.count` Para obtener un recuento de todos los errores de paquete, especifíquelo `name=equinix.fabric.port.packets_erred_rx.count&name=equinix.fabric.port.packets_erred_tx.count` como parámetro de consulta para la solicitud. Especifique un período de tiempo con `fromDateTime` y `toDateTime`. Ejemplo de solicitud cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/ports//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 ' ``` Respuesta de muestra: ``` { "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/", "type": "XF_PORT", "uuid": "", "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/", "type": "XF_PORT", "uuid": "", "state": "PROVISIONED", "name": "TEST-PORT-NAME" }, "summary": { "mean": 0, "max": 0 } } ] } ``` ### Uso del ancho de banda de la conexión[​](#uso-del-ancho-de-banda-de-la-conexión "Enlace directo a Uso del ancho de banda de la conexión") Para ver el uso del ancho de banda de una conexión, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md)punto final donde: * `asset` es `connections` * `asset_id` es el uuid de una conexión específica Parámetros de la consulta: * Entrante - `equinix.fabric.connection.bandwidth_rx.usage` * Saliente - `equinix.fabric.connection.bandwidth_tx.usage` Para ver todo el uso del ancho de banda, especifique `name=equinix.fabric.connection.bandwidth_rx.usage&name=equinix.fabric.connection.bandwidth_tx.usage` como parámetro de consulta para la solicitud. Especifique un período de tiempo con `fromDateTime` y `toDateTime`. Ejemplo de solicitud cURL: ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/connections//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 ' ``` Respuesta de muestra: ``` { "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/", "type": "EVPL_VC", "uuid": "", "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/", "type": "EVPL_VC", "uuid": "", "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 } ] } ] } ``` ### Paquetes de conexión perdidos[​](#paquetes-de-conexión-perdidos "Enlace directo a Paquetes de conexión perdidos") Para ver los paquetes eliminados de una conexión, envíe una `GET` solicitud al [`/fabric/v4///metrics`](https://docs.equinix.com/es/api-catalog/fabricv4/metrics/getmetricbyassetid.md)punto final donde: * `asset` es `connections` * `asset_id` es el uuid de una conexión específica Las métricas están disponibles para el A-Side, z-Side, entrante y saliente de la conexión. Parámetros de la consulta: * A-Side entrante - `equinix.fabric.connection.packets_dropped_rx_aside_rateexceeded.count` * A-Side de salida - `equinix.fabric.connection.packets_dropped_tx_aside_rateexceeded.count` * Z-Side entrante - `equinix.fabric.connection.packets_dropped_rx_zside_rateexceeded.count` * Z-Side de salida - `equinix.fabric.connection.packets_dropped_tx_zside_rateexceeded.count` Para ver todos los paquetes descartados para la conexión, especifíquelo `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 parámetro de consulta para la solicitud. Especifique un período de tiempo con `fromDateTime` y `toDateTime`. ``` curl -X 'GET' 'https://api.equinix.com/fabric/v4/connections//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 ' ``` Respuesta de muestra: ``` { "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/", "type": "EVPL_VC", "uuid": "", "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/", "type": "EVPL_VC", "uuid": "", "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/", "type": "EVPL_VC", "uuid": "", "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/", "type": "EVPL_VC", "uuid": "", "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 } ] } ] } ``` ## Creación de alertas métricas[​](#creación-de-alertas-métricas "Enlace directo a Creación de alertas métricas") Utilice las API de gestión de reglas de alerta de transmisión para crear eventos cuando una métrica cruce un valor de umbral definido. Para obtener más información, consulte [Gestión de reglas de alertas métricas](https://docs.equinix.com/es/observability/streaming-data/api-managing-metric-alert-rules.md) ## Recepción de métricas en una integración de sumideros[​](#recepción-de-métricas-en-una-integración-de-sumideros "Enlace directo a Recepción de métricas en una integración de sumideros") Una vez que haya creado una secuencia y añadido activos a esa secuencia, puede [crear una suscripción](https://docs.equinix.com/es/observability/streaming-data/create-subscription.md) para que se envíen métricas a su recopilador de datos de terceros de elección. Las métricas se envían en un intervalo de 5 minutos.