SDK de JavaScript: analíticas, DNS y dominios

api.apps.network funciona solo con aplicaciones web. Todos los métodos reciben primero el id de la aplicación. Los ejemplos usan el cliente api de Crear el cliente. appId es el id de una de tus aplicaciones: api.account.me() las lista.

Ventanas de tiempo

analytics, errors, logs y performance reciben un start y un end, cada uno un string ISO 8601 o un Date. Una ventana abarca como máximo 7 días, y start se ajusta a la fecha de creación de la aplicación. Una ventana no válida da 400 INVALID_TIME_RANGE.

const end = new Date();
const start = new Date(end.getTime() - 24 * 60 * 60 * 1000); // last 24 h

Los resultados se almacenan en caché en intervalos de 5 minutos. Los fallos de caché de estos cuatro métodos comparten un límite de 20 peticiones cada 60 segundos por cuenta: superarlo da 429 RATE_LIMITED.

Analíticas

network.analytics(appId, start, end, filters?) devuelve los totales de tráfico y sus desgloses. Devuelve null para una ventana sin tráfico.

const analytics = await api.apps.network.analytics(appId, start, end);

if (analytics) {
    console.log(analytics.visits);    // [{ visits, requests, bytes, date }]
    console.log(analytics.countries); // [{ type: "BR", visits, requests, bytes }]
}

Los desgloses son countries, devices, os, browsers, protocols, methods, paths, referers, providers, ips, status_codes, bots y content_types. Cada grupo tiene type, visits, requests y bytes.

Filtros

Los filtros acotan todos los desgloses. Cada uno recibe el valor exacto de type de su desglose:

const brazil = await api.apps.network.analytics(appId, start, end, {
    country: "BR",
    path: "/api",
    provider: "GOOGLE (15169)",
});

Filtro	Ejemplo
`country`	`"BR"` (código de 2 letras)
`ip`	`"203.0.113.7"`
`path`	`"/api"` (prefijo de ruta)
`status`	`"404"`
`os`, `browser`, `protocol`, `bot`	El `type` del desglose
`referer`	`"Direct"` significa sin referer
`provider`	`"NAME (ASN)"`, p. ej. `"GOOGLE (15169)"`
`content_type`	El `type` del desglose

Un filtro no válido da 400 INVALID_FILTER.

Errores

network.errors(appId, start, end, { include_4xx }) devuelve las respuestas 5xx de la ventana, más las 4xx con include_4xx: true. Devuelve null para una ventana vacía.

const errors = await api.apps.network.errors(appId, start, end, { include_4xx: true });

if (errors) {
    console.log(errors.summary.total, errors.summary.by_class);
    console.log(errors.top_paths);
}

Logs de peticiones

network.logs(appId, start, end) devuelve peticiones individuales con detalles del cliente, la petición y la respuesta. Disponible en los planes Pro y Enterprise (en caso contrario, 403 UPGRADE_REQUIRED).

for (const log of await api.apps.network.logs(appId, start, end)) {
    console.log(log.timestamp, log.request.method, log.request.path, log.response.status);
}

Rendimiento

network.performance(appId, start, end) devuelve percentiles de latencia (p50, p95, p99, en ms) en el edge y en el origen, por país, por ubicación y para las rutas más lentas. Devuelve null para una ventana vacía. Disponible en los planes Pro y Enterprise.

const performance = await api.apps.network.performance(appId, start, end);

if (performance) {
    console.log(performance.summary.edge.p95, performance.summary.origin.p95);
}

DNS

network.dns(appId) devuelve los registros DNS que necesita tu dominio personalizado, con su estado. Sin un dominio personalizado da 400 NO_CUSTOM_DOMAIN.

for (const { type, name, value, status } of await api.apps.network.dns(appId)) {
    console.log(type, name, value, status); // type: "txt" | "cname"
}

Dominio personalizado

network.setDomain(appId, domain) asocia un dominio personalizado (plan Standard o superior). Pasa "@" para eliminarlo.

await api.apps.network.setDomain(appId, "www.example.com");

// Remove it
await api.apps.network.setDomain(appId, "@");

Estado	Código	Cuándo
400	`INVALID_DOMAIN`	No es un nombre de dominio válido
400	`RESERVED_DOMAIN`	Un dominio de Square Cloud
403	`UPGRADE_REQUIRED`	El plan no incluye dominios personalizados
403	`LOAD_BALANCER_LIMIT_REACHED`	Se alcanzó el límite del plan de aplicaciones en este dominio
409	`DOMAIN_ALREADY_EXISTS`	El dominio pertenece a una aplicación de otra cuenta
502	`DNS_FAILED`	El proveedor del edge rechazó el dominio

Purgar la caché

network.purgeCache(appId) borra la caché del edge de la aplicación. Está limitado a una purga cada 60 segundos (429 KEEP_CALM).

await api.apps.network.purgeCache(appId);

Errores de los métodos de analíticas

Estado	Código	Cuándo
400	`INVALID_TIME_RANGE`	`start`/`end` ausente, mal formado o invertido
400	`INVALID_FILTER`	Un filtro no respeta su formato (`analytics`)
403	`UPGRADE_REQUIRED`	`logs` y `performance` fuera de Pro y Enterprise
429	`RATE_LIMITED`	Se alcanzó el límite compartido de fallos de caché
500	`UNABLE_TO_FETCH_ANALYTICS`, `UNABLE_TO_FETCH_ERRORS`, `UNABLE_TO_FETCH_PERFORMANCE`	Falló el proveedor del edge
503	`ANALYTICS_BUSY`	Las analíticas del edge están ocupadas: se reintenta automáticamente

Próximos pasos

Tiempo real

Transmite logs y estado en vivo.

Referencia de la API de red

Los endpoints REST detrás de estos métodos.

Analíticas de edge desde la CLI

Las mismas acciones desde la terminal.

CLI

VS Code

SDKs

SDK de JavaScript: analíticas, DNS y dominios

Ventanas de tiempo

Analíticas

Filtros

Errores

Logs de peticiones

Rendimiento

DNS

Dominio personalizado

Purgar la caché

Errores de los métodos de analíticas

Próximos pasos

Tiempo real

Referencia de la API de red

Analíticas de edge desde la CLI

​Ventanas de tiempo

​Analíticas

​Filtros

​Errores

​Logs de peticiones

​Rendimiento

​DNS

​Dominio personalizado

​Purgar la caché

​Errores de los métodos de analíticas

​Próximos pasos

Tiempo real

Referencia de la API de red

Analíticas de edge desde la CLI

Ventanas de tiempo

Analíticas

Filtros

Errores

Logs de peticiones

Rendimiento

DNS

Dominio personalizado

Purgar la caché

Errores de los métodos de analíticas

Próximos pasos