Métricas
La página Metrics (barra lateral > Metrics) te ofrece una vista analítica más profunda de tu uso. Contiene un panel, Usage, que divide tu tráfico en grupos y coloca los totales de todo el período encima de una página de filas.
Para tarjetas de resumen y gráficos temporales, usa la página Dashboard Overview.
Product
La página se abre con un selector de Product: API para las requests que envías a los endpoints de la API, Proxy para los túneles que tus propias herramientas abren a través de proxy.foura.ai. Cada producto tiene su propio panel de Usage con sus propias vistas, ámbitos y columnas, ya que un túnel no tiene recuento de requests ni créditos. El selector se recuerda y permite enlaces directos mediante #metrics/proxy.
Filters
Encima del panel: Product, Endpoints (solo API), Owner, luego Key (API) o Proxy user (Proxy), y después Period. Owner y Period son los mismos controles que en Overview y comparten su estado, por lo que cambiar entre las dos páginas nunca modifica lo que estás viendo.
Owner Filter
Everything, Personal o una de tus organizaciones. Solo aparece cuando perteneces al menos a una. Al elegir un propietario también se actualizan los menús desplegables de Key y Proxy user, evitando que una credencial del propietario anterior permanezca tras el cambio y devuelva datos vacíos de forma silenciosa.
Key and Proxy User Filters
Limita la página a una sola credencial. Solo aparecen las credenciales a las que tienes acceso: las tuyas y las de las organizaciones a las que perteneces.
Period
Ocho botones: 30M, 3H, 12H, 24H, 7D, 30D, 90D y 1Y, además de Custom para un mes natural, los últimos 6 meses, todo el historial o un rango exacto de fechas.
Endpoints
En el producto API, elige Single, Proxy Finder, Browser o Auto para limitar las tarjetas y la tabla a un solo endpoint. Una llamada Auto se contabiliza una vez, bajo Auto. El ámbito Concurrency no está disponible mientras se haya seleccionado un endpoint.
The Usage Panel
El panel responde a dos preguntas a la vez. Las tarjetas sobre la tabla describen todo el período: cuántos grupos contiene y los totales acumulados en todos ellos. La tabla inferior es una página de esos grupos, ordenada por la columna que elijas.
Ambas partes muestran siempre el mismo tráfico: las tarjetas aplican la misma ventana temporal y los mismos filtros que las filas. El recuento de grupos se muestra completo en lugar de redondeado, ya que un número exacto responde a "cuántos dominios alcanzamos este mes" y uno redondeado no.
Cambiar la vista, el ámbito o el período reinicia el conjunto de datos desde la primera página. La página 4 de dominios no equivale a la página 4 de client IPs.
Haz clic en el encabezado de una columna para ordenar. El orden se restablece al valor mayor primero cuando cambias de vista o recargas la página. Usa Ctrl o Cmd más clic en un encabezado para restablecerlo.
Usage, API Product
Tres vistas:
| View | Groups data by |
|---|---|
| API Key | Cada key a la que tienes acceso |
| Client IP | Direcciones de origen que realizan las requests |
| Domain | Dominios de destino en tus requests |
Las etiquetas de ámbito a la derecha cambian las columnas y las tarjetas:
| Scope | Qué muestra |
|---|---|
| Bandwidth | Cantidad de requests, bytes de entrada, bytes de salida y la proporción premium de esos bytes (tráfico servido mediante una salida premium, incluido dentro de los totales en lugar de sumarse a ellos) |
| Response Time | Cantidad de requests, latencia mínima, promedio y máxima |
| Concurrency | Cantidad de requests más recuentos de requests concurrentes (solo en la vista de API Key) |
| Outcomes | Cantidad de requests más un desglose por resultado, con el gráfico de dona de resultados |
| Budget | Cantidad de requests y créditos consumidos, con todos los resultados incluidos. Para ver un endpoint específico, selecciónalo en la fila de Endpoints |
El scope Budget lee la métrica de créditos que la API reporta en cada request (consulta Response Headers). Esas sumas representan el gasto medido sin procesar. La facturación solo cuenta el resultado success para tu plan, y la tarjeta Overview Credits muestra ambos valores en paralelo.
Outcome Donut
Bajo el scope Outcomes, se muestra un gráfico de dona dentro del panel con el desglose de éxitos y errores para el periodo seleccionado. Pasa el cursor sobre cualquier sección para ver la cantidad exacta de requests y el porcentaje. Solo se genera bajo ese scope, ya que mostrar una imagen de toda la ventana sobre una tabla que responde a otra consulta resultaría confuso.
Usage, Proxy Product
Cinco vistas:
| Vista | Agrupa los datos por |
|---|---|
| Proxy user | Cada usuario de proxy al que tienes acceso |
| Target | El host al que llegó cada túnel |
| Exit country | El país desde el que salió el túnel |
| Client IP | La dirección desde la que provino la conexión |
| Outcome | El resultado y su motivo |
Cuatro scopes:
| Scope | Columnas |
|---|---|
| Traffic | Tunnels, Bytes In, Bytes Out, Premium |
| Setup | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Outcomes | Tunnels más una columna por cada resultado, con el gráfico de dona de resultados |
| Budget | Tunnels, Standard, Premium, Total |
Setup es el tiempo de espera antes de entregar un túnel. Duration es el tiempo que permaneció abierto a continuación. Premium es la parte del tráfico que salió a través de la red premium, contabilizada dentro del total y nunca sumada a este.
Ningún scope incluye una columna de créditos ni un recuento de requests. Lo que viaja dentro de un CONNECT es tu propio tráfico cifrado, por lo que el puerto solo contabiliza túneles y bytes.
Outcome Types
Cada request de la API se clasifica en un único resultado. Solo se factura success.
| Outcome | Capa | Significado |
|---|---|---|
success |
n/a | La request devolvió una response válida. Sin reglas validate, esto significa HTTP 200. Con reglas validate, cualquier response que tus reglas hayan aceptado, sin importar el status. |
application_error |
target | El target devolvió HTTP 200, pero el body contenía un campo de error. |
application_fail |
target | El target devolvió un código non-2xx que tus reglas validate no aceptaron, o no devolvió ninguna response en absoluto. |
client_error |
caller | Tu request fue rechazada antes de salir de FourA: parámetros incorrectos, un valor de proxy malformado o una URL que resuelve a una dirección privada o reservada. |
rate_limit |
FourA | La request fue rechazada por tu límite de RPM o de concurrencia. Consulta Rate Limits. |
service_error |
FourA | El motor respondió con un error de servidor o con un body que no pudimos parsear. |
service_fail |
FourA | Un fallo de red: timeout, conexión rechazada, error de DNS, desconexión del cliente. |
La columna de capa te indica quién es el responsable. target significa el sitio al que llamaste, caller significa que tu request era incorrecta, FourA significa que no pudimos procesarla.
Si usas validate.status.accept para permitir códigos non-200 específicos (por ejemplo [200, 403]), estos se devuelven como success en lugar de application_fail. La clasificación sigue el veredicto del motor sobre tus reglas, no el código HTTP en bruto.
Un túnel a través del puerto proxy se clasifica con el mismo vocabulario, omitiendo los dos outcomes target: la respuesta de un túnel es tu propio tráfico cifrado, por lo que FourA nunca ve si el sitio detrás de él respondió correctamente. Para ver la taxonomía completa y cómo se mapea a la facturación, consulta Request Outcomes.
Relacionado
- Dashboard Overview: Tarjetas de resumen, gráficos de línea de tiempo, Period y Detail (Detail solo está disponible en Overview)
- Request Outcomes: Los valores de outcome explicados en detalle, para requests y túneles
- Response Headers: De dónde provienen los créditos
- Proxy Port: El producto sobre el que informan las vistas de Proxy
- Organizations: Qué cubre el filtro Owner
- API Errors: Cómo se devuelven los errores a través de la red