Vista general del panel
El Dashboard de FourA es el lugar donde administras tus API keys y usuarios de proxy, ejecutas solicitudes de prueba, monitoreas el rendimiento, gestionas la facturación y configuras tu cuenta. Esta página recorre la pantalla principal de Overview y las secciones de la barra lateral.
Acceso al Dashboard
Inicia sesión en foura.ai/dashboard. Necesitas una cuenta de FourA: regístrate aquí si no tienes una.
Dos productos, un solo conjunto de páginas
Overview, Metrics y Activity se abren con un selector de Product que tiene dos opciones:
| Product | Qué contabiliza | Unidad |
|---|---|---|
| API | Las solicitudes que envías a /api/single, /api/proxy, /api/browser y /api/auto |
Solicitudes y créditos |
| Proxy | Los túneles que tus propias herramientas abren a través de proxy.foura.ai |
Túneles y bytes |
Un túnel transporta todo lo que tu cliente envíe a través de él, y lo que ocurre dentro de un CONNECT es tu propio tráfico cifrado. Por lo tanto, las vistas de Proxy contabilizan túneles y bytes, nunca solicitudes ni créditos. Lee Proxy Port para conocer el producto en sí.
El selector siempre está en una de las dos opciones, se recuerda entre visitas y aparece en la dirección como #overview/proxy, #metrics/proxy o #activity/proxy. Si pegas uno de esos enlaces, la página se abrirá directamente en ese producto.
No confundas el producto Proxy con la etiqueta del endpoint Proxy Finder. Proxy Finder es POST /api/proxy/, uno de los cuatro endpoints de la API. El producto Proxy es el puerto proxy.
Página Overview, producto API
La página de inicio tras iniciar sesión muestra tus cifras principales para el período que elijas. La página se actualiza automáticamente cada 60 segundos, y el botón de recarga junto al título muestra la cuenta regresiva y actualiza de inmediato.
Antes de tu primera solicitud
Hasta que llegue tu primera solicitud, la vista de API muestra datos de ejemplo, con una etiqueta de Sample en cada panel y gráfico, bajo un banner de This is sample data. con dos pasos: Create API key, cuya nueva clave se abre con un comando de prueba, y Open Playground para enviar una solicitud. En un teléfono o tablet los pasos te dirigen al Playground, ya que un teléfono no puede ejecutar el comando. Tu primera solicitud real reemplaza los datos de muestra de forma definitiva.
La vista de Proxy tiene su propio banner de No traffic yet. con Create proxy user y Open Proxy, que se muestra hasta que uno de tus usuarios de proxy transporte tráfico o llegue tu primera solicitud real a la API. Si cierras cualquiera de los dos banners, se ocultarán ambos.
Tarjetas de resumen
Seis paneles en la parte superior:
| Panel | Qué muestra |
|---|---|
| Concurrencia | Requests que se ejecutan al mismo tiempo en este momento, más el promedio y el máximo para el período |
| Requests | Total de llamadas, luego Single, Proxy, Browser y Auto, cada una con su porcentaje del total debajo. Una llamada Auto cuenta una sola vez, dentro de Auto. |
| Intentos de Auto | Se muestran siempre, con ceros cuando Auto no ejecutó nada en el período. Los requests Single, Proxy y Browser que Auto realizó detrás de tus llamadas Auto, con los intentos por llamada Auto. Nunca cuentan como requests ni en la tasa de éxito, y sus créditos están incluidos dentro de los créditos de Auto. Sí cuentan para tus límites de rate limit y concurrencia de Single, Proxy y Browser. |
| Créditos | Créditos facturados como el valor principal, créditos consumidos debajo, para el total y para cada producto, incluyendo Auto |
| Bytes | Datos transferidos: In es lo que enviaste, Out es lo que se recibió y Premium es la parte de ese tráfico que pasó por una salida premium, sin importar si esa salida entregó la página o no. Premium está incluido dentro de los dos totales y nunca se suma a ellos. |
| Tiempo de respuesta | Promedio, mín. y máx. a lo largo del período |
Facturado y consumido son números distintos. Solo se factura un request exitoso, por lo que lo facturado es lo que pagas. Lo consumido incluye todos los resultados, porque un request fallido igual consume un proxy o un browser. Confundir uno con el otro hace que una misma cuenta parezca dos cuentas distintas en dos páginas. Consulta Resultados de los requests para ver qué resultados se facturan.
Los paneles de Requests y Créditos etiquetan los cuatro endpoints como Single, Proxy, Browser y Auto. La fila de filtros Endpoints arriba de ellos llama a Proxy Proxy Finder, que es exactamente lo mismo: POST /api/proxy/.
Los cuatro no siempre suman el total. Una pequeña cantidad de llamadas no corresponde a ninguno de ellos; se cuentan en el total y en ningún endpoint.
Gráficos temporales
Debajo de los paneles, seis gráficos temporales muestran el volumen de requests, el gasto de créditos, el desglose de resultados, el tiempo de respuesta, el ancho de banda y la concurrencia. Cada gráfico tiene un selector en su encabezado que cambia la visualización por la tabla correspondiente.
Página de información general, producto Proxy
Cambia Product a Proxy y la misma página responderá en términos de túneles. Cuatro paneles:
| Panel | Qué muestra |
|---|---|
| Túneles simultáneos | Túneles abiertos al mismo tiempo. Actual cubre los últimos segundos y se actualiza cada cinco; Prom. y Máx. cubren el período. Tu plan limita esto sumando todos tus usuarios de proxy. |
| Túneles | Exitosos y Fallidos, cada uno con su porcentaje del total. Fallido representa cualquier otro resultado, y la fila Resultado indica cuál. |
| Tráfico | In es lo que enviaron tus herramientas, Out es lo que se recibió y Premium es la parte que salió a través de la red premium, contabilizada dentro de los totales en lugar de sumarse a ellos. |
| Tiempo de configuración | Espera promedio, mín. y máx. antes de que se entregara un túnel, únicamente en túneles exitosos. Es la espera antes de tu primer byte, no la velocidad del sitio detrás del túnel. |
Cinco gráficos de línea de tiempo se ubican debajo: Tunnel Timeline, Outcome Timeline, Setup Time Timeline, Traffic Timeline y Tunnels at Once Timeline. Cada uno incluye el mismo selector de gráfico o tabla que los gráficos de la API.
Tres paneles y sus gráficos de línea de tiempo se atenúan cuando una píldora de Outcome está activa, y la razón en cada caso es que la cifra no existe para ese resultado. Tunnels at Once se atenúa con cualquier resultado, y su gráfico muestra una insignia Not filterable. Setup Time y Traffic se atenúan con un resultado de fallo, y sus gráficos muestran una insignia Success only, ya que un túnel fallido nunca se entregó y no transportó nada.
Período y detalle
Period indica qué tan atrás estás mirando. Ocho píldoras más Custom:
| Píldora | Ventana |
|---|---|
| 30M | Últimos 30 minutos |
| 3H | Últimas 3 horas |
| 12H | Últimas 12 horas |
| 24H | Últimas 24 horas |
| 7D | Últimos 7 días |
| 30D | Últimos 30 días |
| 90D | Últimos 90 días |
| 1Y | Últimos 12 meses |
Custom abre un diálogo con cuatro valores predefinidos, This month, Last month, Last 6 months y All time, además de un par de fechas From y To. Un rango de fechas se extiende hasta el final del día que elegiste, nunca más allá de este momento.
Detail define el ancho de cada barra: por minuto, cada 5 minutos, cada 30 minutos, por hora, cada 6 horas, diario, semanal o mensual. El valor predeterminado es Auto, que selecciona el intervalo más amplio que aún coloque al menos quince barras en el gráfico, de modo que un año se interprete como una forma en lugar de 365 líneas finas. La opción Auto indica el intervalo que eligió.
Period y Detail se aplican a ambos productos.
Los intervalos de Detail que van más atrás del tiempo durante el cual FourA conserva esa resolución se muestran en gris en lugar de ocultarse:
| Resolución | Alcance hacia atrás |
|---|---|
| Por request | 7 días |
| 5 minutos | 30 días |
| Por hora | 12 meses |
| Diario | Todo el historial |
Elige un período anterior al que permite un nivel y las opciones más detalladas se desactivarán en gris. Auto nunca selecciona una de ellas, por lo que un gráfico nunca se queda vacío debido a la agregación de datos.
Filtros
Los filtros se acumulan y se combinan, y Period y Detail se sitúan junto a ellos.
| Filtro | Producto | Qué hace |
|---|---|---|
| Product | ambos | API o Proxy |
| Endpoints | API | Limita a un único endpoint: Single, Proxy Finder, Browser o Auto. Una llamada Auto cuenta una vez, bajo Auto; los requests Single, Proxy y Browser que su secuencia ejecutó por detrás se muestran por nombre en el panel de intentos de Auto, nunca como requests independientes. |
| Outcome | ambos | Aísla una categoría. La API ofrece las siete; el producto Proxy ofrece las cinco en las que puede terminar un túnel. |
| Owner | ambos | Everything, Personal o una de tus organizaciones. Solo aparece cuando perteneces al menos a una. |
| Key | API | Restringe a una sola API key |
| Proxy user | Proxy | Restringe a un único proxy user |
El panel y el gráfico de Concurrency en la parte de la API no admiten los filtros Endpoints ni Outcome. Ambos se atenúan mientras cualquiera de ellos esté activo, y el gráfico lo indica en su encabezado.
El filtro Owner
El menú desplegable Owner responde a "de quién es el tráfico que estoy viendo". Ofrece Todo, Personal y una entrada por cada organización a la que perteneces, y el mismo control en Metrics, Activity, API Keys y Proxy sigue tu elección, para que las páginas nunca discrepen.
Usage & Limits y Facturación no lo incluyen deliberadamente. Responden a "qué se me factura", que para ti son tus claves personales y usuarios de proxy, además de los de las organizaciones que posees. Consulta Organizaciones.
Secciones de la barra lateral
Once páginas y un enlace a Docs, divididos en cuatro grupos: Dashboard, Tools, Access y Account.
Panel: Información general, Métricas, Actividad
Las tres páginas que responden a "qué ocurrió". Las tres incluyen el selector de producto.
Información general es la página mostrada arriba y siempre es el punto de partida tras iniciar sesión.
Métricas contiene el panel Usage: un desglose agrupado por clave de API, IP de cliente o dominio en la parte de la API, y por usuario de proxy, destino, país de salida, IP de cliente o resultado en la parte de Proxy, con tarjetas para el periodo completo sobre una tabla paginada. Consulta la guía de Métricas.
Actividad muestra la última hora de tráfico. Se carga al abrir la página y su botón de actualización obtiene las filas más recientes. En el lado de la API, cada fila es una petición: método, dominio de destino, estado, resultado, duración, tamaño de transferencia y créditos. En el lado de Proxy, cada fila es un túnel: usuario de proxy, destino, salida, resultado, configuración, duración, bytes e IP de cliente. Consulta el Registro de actividad.
Herramientas: Playground, Extensión, Documentación
Prueba peticiones en tiempo real con tu clave de API real sin escribir código. Elige Auto, Single, Proxy o Browser, define una URL, ajusta parámetros y tiempos de espera, y pulsa Enviar. Guarda configuraciones comunes como ajustes predefinidos y vuelve a ejecutar cualquiera de tus últimas 20 ejecuciones desde el Historial.
El uso se descuenta de la cuota de la clave, del mismo modo que una llamada en producción. Consulta la guía del Playground.
En Extensión, marcada como Beta, es donde descargas la extensión de Chrome de FourA. Su ventana emergente enruta Chrome a través de uno de tus usuarios de proxy, y su pestaña FourA en DevTools convierte cualquier petición que realice una página en una llamada a la API lista para usar. Consulta Extensión de Chrome.
Docs abre esta documentación en una nueva pestaña, para que la página del panel en la que te encuentres no cambie.
El botón de tema en la parte superior de la barra lateral alterna entre la configuración de tu dispositivo, claro y oscuro. La elección se comparte con foura.ai y la documentación, por lo que el tema seleccionado en cualquiera de ellos se aplica al panel.
Acceso: Claves de API, Proxy
En Claves de API es donde creas, consultas y administras las claves que tus aplicaciones utilizan para llamar a la API. Las claves usan el prefijo pk_live_. Consulta Administración de claves de API.
Proxy es donde creas usuarios de proxy y copias una cadena de conexión para cualquier cliente que acepte una URL de proxy. Los túneles y el tráfico a través del puerto cuentan para tu plan, igual que la API. Consulta Proxy Users y la referencia de Proxy Port.
Cuenta: Organizaciones, Uso y límites, Facturación, Configuración
Organizaciones comparte claves de API y usuarios de proxy con colegas bajo un único propietario. Agrega personas por correo electrónico, define su rol y transfiere la organización cuando sea necesario cambiar de dueño. El uso en una credencial de la organización cuenta para el plan del propietario de la organización. Consulta Organizations.
Uso y límites muestra tu plan, lo que has consumido en este periodo de facturación y cada límite con el que se te evalúa, con un desglose por clave, por endpoint y por usuario de proxy. Consulta Usage & Limits.
Facturación administra tu suscripción, compra más créditos o tráfico, guarda métodos de pago y facturas, y muestra los créditos, el tráfico y el tráfico premium de este periodo frente a tu plan. Consulta Billing & Subscriptions.
Configuración contiene tu nombre para mostrar, contraseña, sesiones activas y proveedores de inicio de sesión conectados. Los cambios de correo electrónico no están disponibles en el panel: contacta a soporte.
Consejos
- Usa el Playground antes de escribir código. Si no sabes qué motor necesita un sitio nuevo, empieza con Auto y deja que elija.
- Compara lo facturado frente a lo consumido en la tarjeta de Créditos. Un endpoint donde ambos valores estén muy distantes está fallando a menudo, y el informe de intentos explica el motivo.
- En el producto Proxy, un bloque de Rate Limited en la línea de tiempo de resultados corresponde al número de tu plan, no al objetivo rechazándote. La vista de resultados en Metrics especifica cuál es.
- Mantén seguras tus claves de API y usuarios de proxy. Deshabilita cualquiera de ellos de inmediato si sospechas que han sido expuestos.
Pasos siguientes
- Autenticación: detalles de creación y gestión de claves de API
- Guía rápida: haz tu primera request desde la CLI
- Cómo se mide tu plan: créditos, tráfico y qué límite aplica a tu caso
- Uso y límites: monitorea créditos y tráfico en comparación con tu plan
- Endpoints de la API: usa la API directamente