Rendimiento de la aplicación

GET

apps

{id}

analytics

performance

curl -G "https://api.vertracloud.app/v1/apps/app-abc123def456/analytics/performance" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  --data-urlencode "start=2026-11-02T18:00:00Z" \
  --data-urlencode "end=2026-11-03T18:00:00Z" \
  --data-urlencode "country=BR" \
  --data-urlencode "limit=5"

{
  "response": {
    "start": "2026-11-02T18:00:00Z",
    "end": "2026-11-03T18:00:00Z",
    "hosts": [
      "my-app.vertraweb.app",
      "www.example.com"
    ],
    "web_published": true,
    "sampled": false,
    "stale": false,
    "generated_at": "2026-11-03T18:01:12Z",
    "history_days": 7,
    "interval": "1h",
    "summary": {
      "requests": 18420,
      "edge": {
        "avg_ms": 188,
        "p50_ms": 96,
        "p75_ms": 170,
        "p90_ms": 310,
        "p95_ms": 412,
        "p99_ms": 880,
        "p999_ms": 2100
      },
      "container": {
        "avg_ms": 141,
        "p50_ms": 70,
        "p75_ms": 128,
        "p90_ms": 240,
        "p95_ms": 330,
        "p99_ms": 720,
        "p999_ms": 1800
      }
    },
    "series": [
      {
        "time": "2026-11-02T18:00:00Z",
        "requests": 702,
        "edge": {
          "avg_ms": 180,
          "p50_ms": 92,
          "p95_ms": 400,
          "p99_ms": 860
        },
        "container": {
          "avg_ms": 135,
          "p50_ms": 66,
          "p95_ms": 320,
          "p99_ms": 700
        }
      },
      {
        "time": "2026-11-02T19:00:00Z",
        "requests": 731,
        "edge": {
          "avg_ms": 195,
          "p50_ms": 101,
          "p95_ms": 430,
          "p99_ms": 910
        },
        "container": null
      }
    ],
    "previous": null,
    "countries": [
      {
        "value": "BR",
        "label": null,
        "requests": 14210,
        "edge": {
          "avg_ms": 160,
          "p50_ms": 88,
          "p95_ms": 350,
          "p99_ms": 760
        },
        "container": {
          "avg_ms": 120,
          "p50_ms": 60,
          "p95_ms": 280,
          "p99_ms": 620
        }
      },
      {
        "value": "US",
        "label": null,
        "requests": 2105,
        "edge": {
          "avg_ms": 310,
          "p50_ms": 170,
          "p95_ms": 640,
          "p99_ms": 1300
        },
        "container": {
          "avg_ms": 130,
          "p50_ms": 64,
          "p95_ms": 300,
          "p99_ms": 650
        }
      }
    ],
    "edge_locations": [
      {
        "value": "GRU",
        "label": null,
        "requests": 11800,
        "edge": {
          "avg_ms": 150,
          "p50_ms": 85,
          "p95_ms": 330,
          "p99_ms": 700
        },
        "container": {
          "avg_ms": 118,
          "p50_ms": 58,
          "p95_ms": 270,
          "p99_ms": 600
        }
      }
    ],
    "slow_paths": [
      {
        "value": "/api/report",
        "label": null,
        "requests": 210,
        "edge": {
          "avg_ms": 1210,
          "p50_ms": 980,
          "p95_ms": 2600,
          "p99_ms": 4100
        },
        "container": {
          "avg_ms": 1180,
          "p50_ms": 950,
          "p95_ms": 2540,
          "p99_ms": 4020
        }
      }
    ],
    "path_issues": [
      {
        "path": "/api/checkout",
        "requests": 412,
        "errors": 6,
        "error_rate": 0.0146,
        "avg_ms": 402,
        "p99_ms": 1900
      }
    ]
  }
}

Devuelve cuánto tardan las peticiones, en dos relojes: la borde es todo el tiempo que esperó el visitante el primer byte, y el contenedor es la parte que tardó tu aplicación en responder. Cada uno trae el promedio y los percentiles p50, p75, p90, p95, p99 y p99.9. La respuesta también trae los tiempos por país y por ubicación de borde, las rutas más lentas y la salud de las rutas más pedidas. Son los datos de Rendimiento y requiere un plan con los detalles de rendimiento (Pro y superiores).

string

requerido

El ID de la aplicación. Si pertenece a un workspace, pasa su ID en el query parameter workspace_id.

string

Si la aplicación pertenece a un workspace, el ID del workspace. Obligatorio para miembros del workspace que actúan sobre una aplicación que no es suya.

string

Inicio de la ventana (ISO 8601). Por defecto: 24 horas antes de end.

string

Fin de la ventana (ISO 8601). Por defecto: ahora. No puede estar en el futuro.

boolean

predeterminado:"false"

Envía también el período anterior, de la misma duración y justo antes de la ventana, en previous. Por defecto false.

string

Inicio del periodo a comparar (ISO 8601). El periodo comparado tiene la misma duración que la ventana (end menos start) y empieza aquí; previous.start y previous.end en la respuesta muestran cuál fue. Implica compare=true y no se puede enviar con compare=false. Sin él, compare=true compara con el periodo justo antes de la ventana.

integer

predeterminado:"10"

Entradas en countries, edge_locations, slow_paths y path_issues, de 1 a 25. Por defecto 10.

La ventana dura como máximo 30 días y no puede empezar antes del historial del plan (7 o 30 días, ver Planes y límites).

Filtros

Cada dimensión de abajo también es un filtro, y todos se pueden combinar: cada uno restringe todas las partes de la respuesta. Cada filtro recibe un valor, exactamente como aparece en una entrada de breakdown o en una petición del registro, así que un valor leído en una respuesta se puede reenviar sin cambios. Envía (none) para quedarte solo con las peticiones que no tienen nada en la dimensión.

string

País del visitante, ISO 3166-1 alfa-2 (BR).

string

Código IATA de la ubicación de borde que respondió (GRU).

string

Hostname que pidió el visitante: el subdominio de la aplicación o uno de sus dominios. Solo se aceptan hosts de la aplicación.

string

Ruta de la petición, sin la query string. Es un prefijo: /api coincide con /api, /api/users y /apix.

string

Método HTTP (GET, POST…).

string

Estado HTTP que recibió el visitante (404), o una clase: 2xx, 3xx, 4xx o 5xx.

string

Versión de HTTP: HTTP/1.1, HTTP/2 o HTTP/3.

string

Tipo de dispositivo: desktop, mobile o tablet.

string

Sistema operativo del visitante (Windows, iOS…).

string

Navegador del visitante (Chrome, Safari…).

string

Host de la página que llevó a la petición (google.com). (none) es una visita directa, sin referer.

string

Número del sistema autónomo de la red del visitante (28573).

string

Dirección IP del visitante.

string

Tipo de contenido respondido (html, json, css, js, png…).

string

Si la borde respondió desde su caché: hit, miss, dynamic, bypass, expired, revalidated…

string

Categoría de un bot verificado (Search Engine Crawler…). (none) es un visitante que no es un bot verificado.

Respuesta

object

Mostrar Toggle object

string

Inicio de la ventana realmente leída (ISO 8601). Puede estar redondeado respecto al que enviaste.

string

Fin de la ventana realmente leída (ISO 8601).

string[]

Hostnames que se leyeron: el subdominio de la aplicación y sus dominios activos.

boolean

false cuando la aplicación no tiene sitio publicado. La respuesta es entonces un estado vacío, no un error: hosts viene vacío y los datos también.

boolean

true cuando el tráfico es lo bastante alto como para que los números se estimen a partir de una muestra.

boolean

true cuando no se pudieron leer los datos más recientes y esta es una respuesta anterior. Ver generated_at.

string

Cuándo se leyeron los datos (ISO 8601).

integer

Cuántos días hacia atrás puede leer el plan del dueño de la aplicación.

string

Tamaño de cada punto de series: 1m, 5m, 15m o 1h. La API lo elige según la duración de la ventana: cuanto más corta, más finos los puntos.

object | null

Tiempos de la ventana. null cuando no hubo peticiones en la ventana. container viene null cuando ninguna petición llegó a la aplicación (todas las respondió la caché).

object[]

Puntos de la serie temporal; time es el inicio de cada punto, con requests y los tiempos edge y container (avg_ms, p50_ms, p95_ms, p99_ms). container viene null en un punto sin peticiones que llegaran a la aplicación.

object | null

El período anterior, solo con compare=true; si no, null. Tiene start, end, un summary (null cuando no hubo peticiones en él) y una series con el mismo interval y el mismo número de puntos que la actual, en el mismo orden.

object[]

Tiempos por país del visitante, mayor requests primero. Cada entrada tiene value (envíalo como el filtro country), label, requests, edge y container.

object[]

Tiempos por ubicación de borde, mayor requests primero. Misma entrada que countries.

object[]

Rutas más lentas por el percentil 95 del tiempo de borde, la más lenta primero. Las rutas con muy pocas peticiones se omiten. Misma entrada que countries; value es la ruta.

object[]

Las rutas más pedidas con su salud, mayor requests primero. Cada entrada tiene path (envíalo como el filtro path), requests, errors (5xx), error_rate (0 a 1), avg_ms y p99_ms del tiempo de borde.

Campos de summary.edge y summary.container, todos en milisegundos:

number

Tiempo promedio.

number

Mediana: la mitad de las peticiones fue más rápida.

number

Percentil 75.

number

Percentil 90.

number

Percentil 95.

number

Percentil 99.

number

Percentil 99,9.

{
  "response": {
    "start": "2026-11-02T18:00:00Z",
    "end": "2026-11-03T18:00:00Z",
    "hosts": [
      "my-app.vertraweb.app",
      "www.example.com"
    ],
    "web_published": true,
    "sampled": false,
    "stale": false,
    "generated_at": "2026-11-03T18:01:12Z",
    "history_days": 7,
    "interval": "1h",
    "summary": {
      "requests": 18420,
      "edge": {
        "avg_ms": 188,
        "p50_ms": 96,
        "p75_ms": 170,
        "p90_ms": 310,
        "p95_ms": 412,
        "p99_ms": 880,
        "p999_ms": 2100
      },
      "container": {
        "avg_ms": 141,
        "p50_ms": 70,
        "p75_ms": 128,
        "p90_ms": 240,
        "p95_ms": 330,
        "p99_ms": 720,
        "p999_ms": 1800
      }
    },
    "series": [
      {
        "time": "2026-11-02T18:00:00Z",
        "requests": 702,
        "edge": {
          "avg_ms": 180,
          "p50_ms": 92,
          "p95_ms": 400,
          "p99_ms": 860
        },
        "container": {
          "avg_ms": 135,
          "p50_ms": 66,
          "p95_ms": 320,
          "p99_ms": 700
        }
      },
      {
        "time": "2026-11-02T19:00:00Z",
        "requests": 731,
        "edge": {
          "avg_ms": 195,
          "p50_ms": 101,
          "p95_ms": 430,
          "p99_ms": 910
        },
        "container": null
      }
    ],
    "previous": null,
    "countries": [
      {
        "value": "BR",
        "label": null,
        "requests": 14210,
        "edge": {
          "avg_ms": 160,
          "p50_ms": 88,
          "p95_ms": 350,
          "p99_ms": 760
        },
        "container": {
          "avg_ms": 120,
          "p50_ms": 60,
          "p95_ms": 280,
          "p99_ms": 620
        }
      },
      {
        "value": "US",
        "label": null,
        "requests": 2105,
        "edge": {
          "avg_ms": 310,
          "p50_ms": 170,
          "p95_ms": 640,
          "p99_ms": 1300
        },
        "container": {
          "avg_ms": 130,
          "p50_ms": 64,
          "p95_ms": 300,
          "p99_ms": 650
        }
      }
    ],
    "edge_locations": [
      {
        "value": "GRU",
        "label": null,
        "requests": 11800,
        "edge": {
          "avg_ms": 150,
          "p50_ms": 85,
          "p95_ms": 330,
          "p99_ms": 700
        },
        "container": {
          "avg_ms": 118,
          "p50_ms": 58,
          "p95_ms": 270,
          "p99_ms": 600
        }
      }
    ],
    "slow_paths": [
      {
        "value": "/api/report",
        "label": null,
        "requests": 210,
        "edge": {
          "avg_ms": 1210,
          "p50_ms": 980,
          "p95_ms": 2600,
          "p99_ms": 4100
        },
        "container": {
          "avg_ms": 1180,
          "p50_ms": 950,
          "p95_ms": 2540,
          "p99_ms": 4020
        }
      }
    ],
    "path_issues": [
      {
        "path": "/api/checkout",
        "requests": 412,
        "errors": 6,
        "error_rate": 0.0146,
        "avg_ms": 402,
        "p99_ms": 1900
      }
    ]
  }
}

curl -G "https://api.vertracloud.app/v1/apps/app-abc123def456/analytics/performance" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  --data-urlencode "start=2026-11-02T18:00:00Z" \
  --data-urlencode "end=2026-11-03T18:00:00Z" \
  --data-urlencode "country=BR" \
  --data-urlencode "limit=5"

Notas

Requiere el scope apps:read cuando se llama con una API key. Los miembros de un workspace necesitan permiso para leer la aplicación.
Pro y superiores. En Starter la llamada falla con PLAN_DOES_NOT_SUPPORT_WEB_ANALYTICS_PERFORMANCE. El flag del plan es features.web_analytics_performance en Listar planes. El número único de velocidad p95 de todos los planes está en summary.edge_time_p95_ms de Tráfico de la aplicación.
Muestreo. Con tráfico alto los números se estiman a partir de una muestra y sampled viene true. Ver Muestreo y retraso.
Retraso. Los datos se actualizan cada unos 5 minutos, así que las peticiones más nuevas pueden tardar unos minutos en aparecer. Si los datos más recientes no se pueden leer ahora, puede volver una respuesta anterior con stale: true (revisa generated_at); de lo contrario, la llamada falla con ANALYTICS_BUSY.
Privacidad. Vertra Cloud no guarda nada de los visitantes; guarda solo totales por app (recuentos, visitas, bytes, tasas de error y tiempos de respuesta) hasta 31 días, borrados con la app. No se guarda ninguna IP, ruta, query string ni user agent. ip y query vuelven sin máscara; enmascararlos es decisión del cliente que los muestra. Ver Privacidad.

Respuestas de error

Status	Código	Cuándo
401	`AUTH_TOKEN_MISSING` / `API_KEY_INVALID` / `SESSION_REVOKED`	Falta el header `Authorization`, la API key es inválida o la sesión del panel fue revocada.
403	`API_KEY_IP_DENIED` / `API_KEY_SCOPE_DENIED`	La API key se usa desde una IP fuera de su lista permitida, o no tiene el scope `apps:read`.
403	`ACCESS_DENIED`	La aplicación pertenece a otra cuenta, o no tienes el permiso de workspace para leerla.
403	`PLAN_REQUIRED`	La cuenta no tiene plan activo.
403	`PLAN_DOES_NOT_SUPPORT_WEB_ANALYTICS_PERFORMANCE`	El plan no incluye los detalles de rendimiento (Starter). Pasa a Pro o superior.
404	`APP_NOT_FOUND`	La aplicación no existe.
400	`VALIDATION_ERROR`	Un parámetro falló la validación, como `limit` fuera de rango, un `cursor` inválido o una fecha `start`/`end` mal formada; `details.path` nombra el campo. También cuando `compare_start` está mal formado o se envía con `compare=false`.
400	`INVALID_RANGE`	`start` es posterior a `end`, `end` está en el futuro o la ventana supera los 30 días. También cuando el periodo que empieza en `compare_start` termina después de `start`, lo que solaparía la ventana.
400	`ANALYTICS_RANGE_EXCEEDS_PLAN`	`start` es anterior a lo que el plan puede leer. `details.history_days` trae el límite en días y `details.earliest` el `start` más antiguo aceptado ahora. También cuando `compare_start` es anterior a lo que el plan puede leer.
429	`RATE_LIMIT_EXCEEDED`	Demasiadas consultas seguidas. `details.retry_after` indica la espera en segundos; la cabecera `Retry-After` viene siempre con ella.
503	`ANALYTICS_BUSY`	Momento de alta demanda y sin respuesta reciente disponible para la consulta. Espera `details.retry_after` segundos e inténtalo de nuevo.

Última modificación el 3 de noviembre de 2026

curl -G "https://api.vertracloud.app/v1/apps/app-abc123def456/analytics/performance" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  --data-urlencode "start=2026-11-02T18:00:00Z" \
  --data-urlencode "end=2026-11-03T18:00:00Z" \
  --data-urlencode "country=BR" \
  --data-urlencode "limit=5"

{
  "response": {
    "start": "2026-11-02T18:00:00Z",
    "end": "2026-11-03T18:00:00Z",
    "hosts": [
      "my-app.vertraweb.app",
      "www.example.com"
    ],
    "web_published": true,
    "sampled": false,
    "stale": false,
    "generated_at": "2026-11-03T18:01:12Z",
    "history_days": 7,
    "interval": "1h",
    "summary": {
      "requests": 18420,
      "edge": {
        "avg_ms": 188,
        "p50_ms": 96,
        "p75_ms": 170,
        "p90_ms": 310,
        "p95_ms": 412,
        "p99_ms": 880,
        "p999_ms": 2100
      },
      "container": {
        "avg_ms": 141,
        "p50_ms": 70,
        "p75_ms": 128,
        "p90_ms": 240,
        "p95_ms": 330,
        "p99_ms": 720,
        "p999_ms": 1800
      }
    },
    "series": [
      {
        "time": "2026-11-02T18:00:00Z",
        "requests": 702,
        "edge": {
          "avg_ms": 180,
          "p50_ms": 92,
          "p95_ms": 400,
          "p99_ms": 860
        },
        "container": {
          "avg_ms": 135,
          "p50_ms": 66,
          "p95_ms": 320,
          "p99_ms": 700
        }
      },
      {
        "time": "2026-11-02T19:00:00Z",
        "requests": 731,
        "edge": {
          "avg_ms": 195,
          "p50_ms": 101,
          "p95_ms": 430,
          "p99_ms": 910
        },
        "container": null
      }
    ],
    "previous": null,
    "countries": [
      {
        "value": "BR",
        "label": null,
        "requests": 14210,
        "edge": {
          "avg_ms": 160,
          "p50_ms": 88,
          "p95_ms": 350,
          "p99_ms": 760
        },
        "container": {
          "avg_ms": 120,
          "p50_ms": 60,
          "p95_ms": 280,
          "p99_ms": 620
        }
      },
      {
        "value": "US",
        "label": null,
        "requests": 2105,
        "edge": {
          "avg_ms": 310,
          "p50_ms": 170,
          "p95_ms": 640,
          "p99_ms": 1300
        },
        "container": {
          "avg_ms": 130,
          "p50_ms": 64,
          "p95_ms": 300,
          "p99_ms": 650
        }
      }
    ],
    "edge_locations": [
      {
        "value": "GRU",
        "label": null,
        "requests": 11800,
        "edge": {
          "avg_ms": 150,
          "p50_ms": 85,
          "p95_ms": 330,
          "p99_ms": 700
        },
        "container": {
          "avg_ms": 118,
          "p50_ms": 58,
          "p95_ms": 270,
          "p99_ms": 600
        }
      }
    ],
    "slow_paths": [
      {
        "value": "/api/report",
        "label": null,
        "requests": 210,
        "edge": {
          "avg_ms": 1210,
          "p50_ms": 980,
          "p95_ms": 2600,
          "p99_ms": 4100
        },
        "container": {
          "avg_ms": 1180,
          "p50_ms": 950,
          "p95_ms": 2540,
          "p99_ms": 4020
        }
      }
    ],
    "path_issues": [
      {
        "path": "/api/checkout",
        "requests": 412,
        "errors": 6,
        "error_rate": 0.0146,
        "avg_ms": 402,
        "p99_ms": 1900
      }
    ]
  }
}

Visión general

Endpoints

Rendimiento de la aplicación

Filtros

Respuesta

Notas

Respuestas de error

​Filtros

​Respuesta

​Notas

​Respuestas de error

Filtros

Respuesta

Notas

Respuestas de error