Métricas
La página Métricas (barra lateral > Métricas) te ofrece una vista analítica más detallada de tu uso. Contiene un panel, Uso, que divide tu tráfico en grupos y coloca los totales de todo el período encima de una página de filas.
Para ver tarjetas de resumen y gráficos de línea de tiempo, consulta la página Información general del panel.
Producto
La página se abre con un selector de Producto: API para las solicitudes 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 Uso con sus propias vistas, alcances y columnas, ya que un túnel no tiene recuento de solicitudes ni créditos. La selección se recuerda y admite enlaces directos mediante #metrics/proxy.
Filtros
Encima del panel: Producto, Endpoints (solo API), Propietario, luego Clave (API) o Usuario de proxy (Proxy), y después Período. Propietario y Período son los mismos controles que en Información general y comparten su estado, por lo que alternar entre ambas páginas nunca cambia lo que estás viendo.
Filtro de propietario
Todo, Personal o una de tus organizaciones. Solo aparece cuando perteneces al menos a una. Al seleccionar un propietario también se actualizan los menús desplegables de Clave y Usuario de proxy, evitando que una credencial del propietario anterior permanezca activa tras el cambio y no devuelva resultados en silencio.
Cuando el propietario seleccionado no tiene ninguna clave de API, incluidas las claves detenidas, la línea debajo del período muestra Aún no tienes claves de API aquí. Crea una para ver su uso. Los paneles muestran ceros porque no hay nada que contabilizar. Consulta Gestión de claves de API.
Filtros de Clave y Usuario de proxy
Limitan el alcance de la página a una sola credencial. Solo aparecen las credenciales a las que tienes acceso: las tuyas propias y las de las organizaciones a las que perteneces.
Período
Ocho botones: 30M, 3H, 12H, 24H, 7D, 30D, 90D y 1Y, además de Personalizado para un mes natural, los últimos 6 meses, todo el historial o un rango exacto de fechas.
Endpoints
En el producto API, selecciona Individual, 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 alcance Concurrencia no está disponible mientras haya un endpoint seleccionado.
El panel de Uso
El panel responde a dos preguntas a la vez. Las tarjetas sobre la tabla describen el período completo: cuántos grupos contiene y los totales de todos ellos. La tabla inferior muestra una página de esos grupos, ordenada por la columna que elijas.
Ambos elementos nunca muestran tráfico distinto: las tarjetas aplican la misma ventana temporal y los mismos filtros que las filas. El recuento de grupos se muestra completo en lugar de redondearse, ya que un número exacto responde a "cuántos dominios alcanzamos este mes" y uno redondeado no.
Al cambiar la vista, el alcance o el período, el conjunto de datos vuelve a comenzar desde la primera página. La página 4 de dominios no equivale a la página 4 de IP de clientes.
Haz clic en el encabezado de una columna para ordenar. En las vistas Domain y Client IP del producto API, la ordenación se aplica sobre la lista completa antes de paginarla, por lo que la primera fila es realmente la mayor y la tabla vuelve a empezar desde la primera página. La vista API Key mantiene todas las claves en una sola lista y las ordena en el lugar. La ordenación vuelve al orden propio del scope cuando cambias de vista o de scope, o cuando recargas la página: la mayor cantidad de requests primero, o bajo Routes la mayor cantidad de intentos de navegador realizados por Auto. Haz Ctrl o Cmd clic en un encabezado para restablecerlo. El encabezado de la primera columna también incluye un cuadro de filtro (Filter API Keys..., Filter IPs... o Filter Domains...) que filtra las filas por nombre. En las vistas Client IP y Domain solo busca en la página en la que estás, por lo que un grupo ubicado en otra página no aparecerá. Esc lo limpia.
Uso, API Product
Tres vistas:
| Vista | Agrupa los datos por |
|---|---|
| API Key | Cada clave a la que tienes acceso |
| Client IP | Direcciones de origen que realizan las requests |
| Domain | Dominios de destino en tus requests |
Los chips de scope cambian las columnas y las tarjetas:
| Scope | Qué muestra |
|---|---|
| Bandwidth | Cantidad de requests, bytes de entrada, bytes de salida y la porción premium de esos bytes (tráfico servido mediante una salida premium, incluido dentro de los totales y no sumado a ellos) |
| Response Time | Cantidad de requests, latencia mínima, media y máxima |
| Concurrency | Cantidad de requests más recuentos de requests concurrentes (solo en la vista API Key) |
| Outcomes | Cantidad de requests más un desglose por resultado, con el gráfico de dona de resultados |
| Budget | Cantidad de requests, créditos facturados y créditos consumidos. Para ver un endpoint, elígelo en la fila Endpoints |
| Routes | Cantidad de requests, tus requests por ruta, lo que Auto ejecutó detrás de sus llamadas y el paso que respondió cada llamada de Auto (ver abajo) |
El scope Budget mantiene separados los créditos facturados y los consumidos. Los créditos facturados contabilizan solo las requests con el resultado success: eso es lo que cubre tu plan. Los créditos consumidos son los créditos que la API informa en cada request (consulta Response Headers), incluidas las requests fallidas, y nunca se facturan.
Las tarjetas de Budget muestran Billed credits con of N spent debajo, y Per request, el promedio de créditos facturados por request. La tabla cuenta con una columna Billed credits y otra Spent credits, y puedes ordenar por cualquiera de las dos.
Scope Routes
Routes divide las requests de cada clave, IP de cliente o dominio por ruta y muestra lo que hizo Auto en sus llamadas. Sus columnas se dividen en tres grupos, cada uno con un encabezado descriptivo encima:
| Grupo | Columnas | Qué cuentan |
|---|---|---|
| Solicitudes por ruta | Single, Proxy Finder, Browser, Auto | Tus solicitudes, según la ruta a la que las enviaste. Juntas forman Solicitudes. Una llamada Auto cuenta una vez, bajo Auto. Debajo de cada número: su porcentaje de Solicitudes. |
| Intentos de Auto | Single, Proxy Finder, Browser | Las solicitudes que Auto ejecutó en cada motor detrás de sus llamadas, incluidas las fallidas. Debajo de cada número: intentos por llamada Auto. |
| Auto respondido por | Saved session, Plain request, Proxy Finder, Browser, Failed | El paso que entregó cada llamada Auto. Juntos forman Auto. Debajo de cada número: su porcentaje de Auto. |
Saved session es una sesión que Auto ya tenía para el host. Browser incluye las llamadas donde un navegador abrió la página primero y una repetición de su sesión la entregó. Failed incluye llamadas rechazadas antes de que Auto se ejecutara.
Para ver dónde usa Auto un navegador real, consulta la columna Browser bajo Intentos de Auto. Un navegador suele abrir una página una vez, y Auto luego reutiliza esa sesión con solicitudes más ligeras, por lo que esta columna suele ser mucho mayor que Browser bajo Auto respondido por. Routes se abre ordenado por ella, de modo que los dominios que más necesitan un navegador aparecen primero; los grupos sin intentos de navegador siguen por recuento de solicitudes.
Las tarjetas encima de la tabla muestran los intentos de Auto en el período con los intentos por llamada Auto, y cada navegador abierto, directamente o por Auto.
Los intentos de Auto nunca cuentan en Solicitudes ni en la tasa de éxito. Sí cuentan contra los límites de concurrencia y tasa de Single, Proxy Finder y Browser de tu plan, como en la tarjeta Intentos de Auto del Overview. Con un endpoint seleccionado en la fila Endpoints, Routes muestra solo esa ruta: Browser lista entonces las solicitudes de navegador que enviaste tú mismo, y las que ejecutó Auto permanecen bajo Auto.
Donut de resultados
Bajo el alcance Resultados, un gráfico de donut se ubica dentro del panel y muestra el desglose de éxitos y errores para el período seleccionado. Pasa el cursor sobre cualquier sector para ver el recuento exacto de solicitudes y el porcentaje. Se muestra solo bajo ese alcance, ya que una imagen de toda la ventana sobre una tabla que responde a una pregunta diferente se lee como dos cosas no relacionadas.
Uso, Producto Proxy
Cinco vistas:
| Vista | Agrupa los datos por |
|---|---|
| Usuario proxy | Cada usuario proxy al que tienes acceso |
| Destino | El host al que llegó cada túnel |
| País de salida | El país desde donde salió el túnel |
| IP del cliente | La dirección desde la que provino la conexión |
| Resultado | Resultado y su motivo |
Cuatro alcances:
| Alcance | Columnas |
|---|---|
| Tráfico | Tunnels, Bytes In, Bytes Out, Premium |
| Configuración | Tunnels, Setup Min, Setup Avg, Setup Max, Duration Avg, Duration Max |
| Resultados | Tunnels más una columna por resultado, con el donut de resultados |
| Presupuesto | Tunnels, Standard, Premium, Total |
Configuración es la espera antes de que se entregara un túnel. Duración es cuánto tiempo permaneció abierto después. Premium es la parte del tráfico que salió a través de la red premium, contabilizada dentro del total y nunca sumada a él.
Ningún ámbito tiene 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 cuenta túneles y bytes y nada más.
Tipos de resultado
Cada request a la API se clasifica exactamente en un resultado. Solo se factura success.
| Outcome | Capa | Significado |
|---|---|---|
success |
n/d | El request entregó una respuesta válida. Sin reglas de validate, eso significa HTTP 200. Con reglas de validate, cualquier respuesta que tus reglas hayan aceptado, sin importar el estado. Una página de verificación o una página de rechazo que FourA reconozca nunca es un éxito. |
application_error |
destino | El destino devolvió HTTP 200, pero el cuerpo contenía un campo de error, o el cuerpo era una página de verificación o de rechazo que FourA reconoce. |
application_fail |
destino | El destino devolvió un código distinto de 2xx que tus reglas de validate no aceptaron, o ninguna respuesta en absoluto. |
client_error |
emisor | Tu request fue rechazada antes de salir de FourA: parámetros incorrectos, un valor de proxy mal formado o una URL que resuelve en una dirección privada o reservada. |
rate_limit |
FourA | El request fue rechazado por tu límite de RPM o de concurrencia. Consulta Límites de tasa. |
service_error |
FourA | El motor respondió con un error de servidor o con un cuerpo que no pudimos procesar. |
service_fail |
FourA | Un fallo de red: tiempo de espera agotado, conexión rechazada, error de DNS, desconexión del cliente. |
La columna de capa te indica quién es responsable. target significa el sitio al que llamaste, caller significa que tu request era incorrecto, FourA significa que no pudimos procesarlo.
Si usas validate.status.accept para permitir códigos específicos distintos de 200 (por ejemplo, [200, 403]), esos 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 sin procesar.
Un túnel a través del puerto proxy se clasifica con el mismo vocabulario, menos los dos resultados de 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ó satisfactoriamente. Para conocer la taxonomía completa y cómo se asigna a la facturación, consulta Resultados de request.
Relacionado
- Visión general del panel: Tarjetas de resumen, gráficos de cronología, Período y Detalle (Detalle está solo en Visión general)
- Resultados de request: Los valores de resultado explicados en detalle, para requests y túneles
- Cabeceras de respuesta: De dónde proceden los créditos
- Puerto proxy: El producto sobre el que informan las vistas de Proxy
- Organizaciones: Qué cubre el filtro Propietario
- Errores de la API: Cómo se devuelven los errores a través de la red