Crear widgets personalizados para dashboards de streaming

Los widgets personalizados le permiten ampliar el dashboard de Media Streaming con visualizaciones de gráficos a medida creadas a partir de sus propias consultas NRQL. Los widgets personalizados aparecen en el desplegable Quality Metrics junto a las métricas predefinidas, en una categoría Custom Metrics separada. Persisten en todas las sesiones y se escalan dentro del dashboard existente.

Antes de que empieces

Los widget personalizados se crean desde dentro del nerdpack de Media Streaming. Necesita acceso a una cuenta de New Relic con el agente de Streaming Video & Ads instalado. Consulte Instalar el agente de Streaming Video & Ads si aún no lo ha configurado.

Crear un widget personalizado

1. Abra el dashboard de Media Streaming y navegue hasta la sección Quality Metrics.
2. Haga clic en + Add Custom Widget.
3. Ingrese un título para el widget.
4. Escribe tu consulta NRQL en el editor de NRQL. Consulta Escribir consultas para obtener orientación sobre la sintaxis, los marcadores de posición de filtro y ejemplos.
5. Haga clic en Run Query para obtener una vista previa de los resultados antes de guardar.
6. Haga clic en Save. El widget se agrega a la sección Custom Metrics del desplegable Quality Metrics y se renderiza en el dashboard.

Escribir consultas

El editor de NRQL acepta cualquier consulta NRQL SELECT o FROM válida. Escribe tu consulta completa directamente en el editor — el editor proporciona resaltado de sintaxis, autocompletado y validación en tiempo real.

Requisitos de la consulta

• La consulta debe comenzar con SELECT o FROM y contener ambas cláusulas.
• No incluya una cláusula SINCE o UNTIL codificada de forma rígida. El selector de tiempo del dashboard inyecta el rango de tiempo automáticamente en el momento de la ejecución.
• Para responder a las selecciones de la barra de filtros a nivel del dashboard, incluya un marcador de posición de filtro en su consulta.

Marcador de posición de filtro

Los marcadores de posición de filtro son tokens de comentarios de NRQL que se reemplazan en tiempo de ejecución con las condiciones de filtro aplicadas en la barra de filtros del dashboard. Agréguelos manualmente a su consulta.

Ejemplo — sin cláusula WHERE existente:

SELECT uniqueCount(viewId) AS 'Total Views'
FROM VideoAction /* {whereClause} */
TIMESERIES

Cuando un filtro para asn = '14618' está activo:

SELECT uniqueCount(viewId) AS 'Total Views'
FROM VideoAction WHERE asn = '14618'
TIMESERIES SINCE 30 minutes ago UNTIL now

Ejemplo — cláusula WHERE existente:

SELECT count(*) AS 'Error Count'
FROM VideoErrorAction, VideoAction
WHERE actionName = 'CONTENT_ERROR' /* {andWhereClause} */
TIMESERIES

Ejemplo — filtro dentro de una función de agregador:

FROM VideoAction
SELECT (
  filter(sum(timeSinceBufferBegin),
    WHERE actionName = 'CONTENT_BUFFER_END'
    AND bufferType = 'connection' /* {aggregatorWhereClause} */
  ) /
  filter(sum(elapsedTime) OR 1,
    WHERE actionName = 'CONTENT_HEARTBEAT' /* {aggregatorWhereClause} */
  )
) AS 'Connection-induced rebuffering ratio'
TIMESERIES

Palabras clave y caracteres bloqueados

Para evitar la modificación accidental o maliciosa de datos, lo siguiente está bloqueado en el editor de NRQL:

Palabras clave bloqueadas:

• DROP
• DELETE
• INSERT
• UPDATE
• CREATE
• ALTER

Caracteres bloqueados:

• Punto y coma (;) — bloqueado para evitar la cadena de consulta o el ataque de inyección.

Las consultas que contengan cualquiera de estos fallarán la validación y no se podrán guardar ni previsualizar.

Ejemplos de consulta

Serie temporal básica — inicios totales de video:

SELECT count(*) AS 'Video Starts'
FROM VideoAction
WHERE actionName = 'CONTENT_START' /* {andWhereClause} */
TIMESERIES

Recuento de espectadores únicos con integración de filtros:

SELECT uniqueCount(viewId) AS 'Unique Viewers'
FROM VideoAction /* {whereClause} */
TIMESERIES

Tasa de errores en todos los tipos de evento:

SELECT count(*) AS 'Error Count'
FROM VideoErrorAction, VideoAction
WHERE actionName = 'CONTENT_ERROR' /* {andWhereClause} */
TIMESERIES

Tasa de recarga de búfer inducida por la conexión (avanzado):

FROM VideoAction
SELECT (
  filter(sum(timeSinceBufferBegin),
    WHERE actionName = 'CONTENT_BUFFER_END'
    AND bufferType = 'connection' /* {aggregatorWhereClause} */
  ) /
  filter(sum(elapsedTime) OR 1,
    WHERE actionName = 'CONTENT_HEARTBEAT' /* {aggregatorWhereClause} */
  )
) AS 'Connection-induced rebuffering ratio'
TIMESERIES

Para obtener más inspiración para consultas, consulte el Diccionario de datos de métricas de tasa de bits para ver ejemplos de NRQL prediseñados que usan VideoAction y VideoErrorAction.

Vista previa de un widget

Haga clic en Run Query antes de guardar para ejecutar la consulta con datos en vivo y ver un gráfico renderizado. Esto no guarda el widget.

Use la previsualización para:

• Confirme que el gráfico renderiza los datos que espera.
• Verifique que los marcadores de posición de filtro se resuelvan correctamente cuando un filtro está activo en la barra de filtros.
• Detecte errores de sintaxis o lógica antes de que el widget se confirme en el dashboard.

Editar un widget personalizado

1. En la sección Quality Metrics, ubique el widget personalizado que desea cambiar.
2. Haga clic en el icono de lápiz en la tarjeta del widget.
3. El editor se abre en modo de edición con todos los campos rellenados previamente — título y consulta NRQL existente.
4. Realiza tus cambios, haz clic en Run Query para verificar y luego haz clic en Save.

Al guardar:

• El timestamp updatedAt se actualiza; el createdAt original y el widget id se conservan.
• El widget se vuelve a renderizar inmediatamente con la consulta actualizada.
• Si cambió el título, se actualiza en el desplegable de métricas de calidad.

Eliminar un widget personalizado

1. En la sección Quality Metrics, haga clic en el icono en la tarjeta del widget.
2. Seleccione Delete.
3. Confirma en el símbolo: "¿Estás seguro de que deseas eliminar '[Título del widget]'? Esta acción no se puede deshacer."

Cuando se elimina:

• El widget se elimina de NerdStorage y desaparece permanentemente.
• La tarjeta del widget se elimina inmediatamente del dashboard.
• El título se elimina del desplegable de métricas de calidad.
• Si el widget estaba seleccionado, se deselecciona automáticamente.

Límite de widget

El límite flexible de 50 widgets por cuenta se basa en la capacidad de documentos de NerdStorage. Con 50 widgets, el uso de almacenamiento es de aproximadamente 21 KB — alrededor del 33 % del límite de 64 KB por documento, lo que proporciona un margen seguro.

Si alcanza el límite, la creación de widgets se bloquea hasta que se elimine un widget personalizado existente. Los widgets existentes siguen funcionando normalmente.

Resolución de problemas