Observa la reproducción reciente

Monitoring observa reproducción VOD reciente usando las muestras del collector. No implementa ingest ni emisión Live. Requiere recopilación activada y permiso data:read.

Series y grupos

const presence = await orilla.data.monitoring.timeseries(
  "current-concurrent-viewers",
);
const groups = await orilla.data.monitoring.breakdownTimeseries(
  "current-concurrent-viewers",
  {
    dimension: "video_title",
    timeframe: ["60:seconds"],
    limit: 10,
    order_by: "views",
    order_direction: "desc",
  },
);
for (const point of groups.data) console.log(point.date, point.values);

Las series por grupo admiten las seis métricas actuales de monitoring y dimensiones escalares recopiladas. Cada punto usa muestras de cinco segundos. Sin período consultan 60 segundos hasta 15 segundos antes del reloj actual; puedes pedir hasta diez minutos dentro de las últimas 24 horas. Solo se incluyen buckets completos.

limit es 10 por defecto y hasta 100 por punto. Los grupos se seleccionan para cada punto: no constituyen un Top N global fijo. order_by: 'value' ordena la métrica; views, espectadores concurrentes; field, etiqueta. Buckets sin grupos conservan values: []. No se admite ordenar por negative_impact.

Histograma de tiempo de inicio

const histogram = await orilla.data.monitoring.histogramTimeseries(
  "video-startup-time",
  { filters: ["video_title:Mi video"] },
);
console.log(histogram.meta.buckets, histogram.orilla.coverage);

El histograma devuelve 30 minutos UTC completos y solo acepta filtros. Cada vista con primer frame observado cuenta una vez en su minuto; no se deduce el tiempo de inicio a partir del tiempo visto. Los buckets van de 0–100 ms hasta 15.000 ms o más. end: null indica sin límite superior.

sum es cantidad de vistas, no suma de milisegundos. Promedio, mediana y p95 son milisegundos; porcentajes son razones de 0 a 1. Un minuto vacío muestra conteos cero y estadísticas null.

Interpreta la cobertura

Presencia caduca tras 30 segundos. Para contadores, se interpolan muestras adyacentes; huecos mayores de 30 segundos se excluyen. Buffering continuo superior a cinco minutos se excluye. Las tasas de fallo consideran solo resultados conocidos y son null sin población elegible. Consulta los denominadores y cobertura antes de comparar.

Las series por grupo e histogramas admiten hasta 5.000 vistas candidatas y cinco segundos por sentencia SQL. Un exceso o timeout devuelve 429: reduce período o población. Los metadatos de dimensión reflejan la vista corregida más reciente; no son un histórico de sus etiquetas.

Compatibilidad Real-Time

orilla.data.realtime.metrics(), dimensions(), timeseries(), breakdown() y histogramTimeseries() son alias heredados de estas consultas. Se conservan para integraciones existentes; usa monitoring en las nuevas. El catálogo heredado no ofrece un alias breakdown-timeseries ni añade otro pipeline.

Consulta comparaciones e insights para poblaciones históricas y alertas para recibir avisos de incidentes.