Créer des widgets personnalisés pour les dashboards de streaming

Les widgets personnalisés vous permettent d’étendre le dashboard Media Streaming avec des visualisations graphiques sur mesure créées à partir de vos propres requêtes NRQL. Les widgets personnalisés apparaissent dans la liste déroulante Quality Metrics aux côtés des métriques prédéfinies, dans une catégorie Custom Metrics distincte. Ils persistent entre les sessions et s’adaptent au dashboard existant.

Important

Chaque compte prend en charge une limite souple de 50 widgets personnalisés. Cette limite est basée sur la capacité de NerdStorage. Si vous l’atteignez, supprimez un widget personnalisé existant avant d’en ajouter un nouveau.

Avant de commencer

Les widgets personnalisés sont créés à partir du nerdpack Media Streaming. Vous avez besoin d’accéder à un compte New Relic avec l’agent Streaming vidéo et publicitaire installé. Consultez Installer l’agent Streaming vidéo et publicitaire si vous ne l’avez pas encore configuré.

Créer un widget personnalisé

Ouvrez le dashboard Media Streaming et accédez à la section Quality Metrics.
Cliquez sur + Add Custom Widget.
Saisissez un titre pour le widget.
Écrivez votre requête NRQL dans l’éditeur NRQL. Consultez Écriture de requêtes pour obtenir des conseils sur la syntaxe, les espaces réservés de filtre et des exemples.
Cliquez sur Run Query pour prévisualiser les résultats avant d’enregistrer.
Cliquez sur Save. Le widget est ajouté à la section Custom Metrics de la liste déroulante Quality Metrics et affiché dans le dashboard.

Rédaction de requêtes

L’éditeur NRQL accepte toute requête NRQL SELECT ou FROM valide. Écrivez votre requête complète directement dans l’éditeur — la coloration syntaxique, la saisie semi-automatique et la validation en temps réel sont fournies par l’éditeur.

Exigences de la requête

Les requêtes doivent commencer par SELECT ou FROM et contenir les deux clauses.
N’incluez pas de clause SINCE ou UNTIL codée en dur. Le sélecteur d’intervalle de temps du dashboard injecte automatiquement la plage de temps au moment de l’exécution.
Pour répondre aux sélections de la barre de filtres au niveau du dashboard, incluez un espace réservé de filtre dans votre requête.

Espaces réservés de filtrage

Les espaces réservés de filtre sont des jetons de commentaire NRQL qui sont remplacés à l’exécution par les conditions de filtre appliquées dans la barre de filtre du dashboard. Ajoutez-les manuellement à votre requête.

Espace réservé	Quand l'utiliser
`/* {whereClause} */`	Votre requête n’a aucune clause `WHERE` existante. L’espace réservé est remplacé par une condition `WHERE ...` complète.
`/* {andWhereClause} */`	Votre requête a déjà une clause `WHERE` . L'espace réservé est ajouté comme condition `AND ...` supplémentaire.
`/* {aggregatorWhereClause} */`	Dans une fonction `filter()` qui contient déjà une clause `WHERE`. Ajoute une condition `AND ...` supplémentaire dans la portée de l'agrégateur.

Exemple — aucune clause WHERE existante :

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

Lorsqu’un filtre pour asn = '14618' est actif :

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

Exemple — clause WHERE existante :

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

Exemple — filtre à l’intérieur d’une fonction d’agrégateur :

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

Conseil

Lorsqu’un filtre est actif dans la barre de filtres du dashboard, les trois types d’espaces réservés se résolvent aux mêmes conditions de filtre sous-jacentes — la différence est uniquement syntaxique, pour produire un NRQL valide en fonction de la structure de votre requête.

Mots-clés et caractères bloqués

Pour empêcher toute modification accidentelle ou malveillante des données, les éléments suivants sont bloqués dans l'éditeur NRQL :

Mots-clés bloqués :

DROP
DELETE
INSERT
UPDATE
CREATE
ALTER

Caractères bloqués :

Points-virgules (;) — bloqués pour empêcher les requêtes en chaîne ou les attaques par injection.

Les requêtes contenant l’un de ces éléments échoueront à la validation et ne pourront pas être enregistrées ou prévisualisées.

Exemples de requêtes

Série chronologique de base — nombre total de lancements de vidéos :

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

Nombre de spectateurs uniques avec intégration de filtre :

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

Taux d’erreur sur l’ensemble des types d’événements :

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

Ratio de rebuffering induit par la connexion (avancé) :

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

Pour plus d’inspiration de requêtes, consultez le Dictionnaire de données des métriques de débit binaire pour des exemples NRQL prédéfinis utilisant VideoAction et VideoErrorAction.

Prévisualiser un widget

Cliquez sur Run Query avant d’enregistrer pour exécuter la requête sur des données en direct et voir un graphique rendu. Cela n’enregistre pas le widget.

Utilisez l'aperçu pour :

Confirmez que le graphique affiche les données que vous attendez.
Vérifiez que les espaces réservés de filtre se résolvent correctement lorsqu’un filtre est actif dans la barre de filtres.
Détectez les erreurs de syntaxe ou de logique avant que le widget ne soit validé dans le dashboard.

Modifier un widget personnalisé

Dans la section Quality Metrics, localisez le widget personnalisé que vous souhaitez modifier.
Cliquez sur l'icône en forme de crayon sur la carte du widget.
L’éditeur s’ouvre en mode édition avec tous les champs préremplis — le titre et la requête NRQL existante.
Apportez vos modifications, cliquez sur Run Query pour vérifier, puis cliquez sur Save.

Lors de l’enregistrement :

L’horodatage updatedAt est mis à jour ; le createdAt d’origine et le widget id sont conservés.
le widget se réaffiche immédiatement avec la requête mise à jour.
Si vous avez modifié le titre, il se met à jour dans la liste déroulante des Métriques de qualité.

Supprimer un widget personnalisé

Dans la section Quality Metrics, cliquez sur l’icône sur la carte du widget.
Sélectionnez Delete.
Confirmez dans le prompt : « Êtes-vous sûr de vouloir supprimer “[Widget Title]” ? Cette action ne peut pas être annulée. »

Une fois supprimé :

Le widget est supprimé de NerdStorage et disparaît définitivement.
La carte du widget est immédiatement supprimée du dashboard.
Le titre est supprimé de la liste déroulante des Métriques de qualité.
Si le widget était sélectionné, il est automatiquement désélectionné.

Prudence

La suppression est définitive. Copiez votre requête NRQL avant de supprimer un widget si vous risquez d’en avoir besoin plus tard.

Limite de widgets

La limite souple de 50 widgets par compte est basée sur la capacité des documents NerdStorage. À 50 widgets, l'utilisation du stockage est d'environ 21 Ko — environ 33 % de la limite de 64 Ko par document, offrant une marge de sécurité.

Si vous atteignez la limite, la création de widgets est bloquée jusqu’à ce qu’un widget personnalisé existant soit supprimé. Les widgets existants continuent de fonctionner normalement.

Dépannage

Vous avez peut-être utilisé le mauvais type d'espace réservé. Vérifier :

Si votre requête n'a pas de clause WHERE, utilisez /* {whereClause} */.
Si votre requête possède déjà une clause WHERE, utilisez /* {andWhereClause} */.
Si l’espace réservé se trouve dans une fonction filter() qui a déjà son propre WHERE, utilisez /* {aggregatorWhereClause} */.
Le mauvais espace réservé produit un NRQL non valide à l'exécution, ce qui entraîne l'échec de la requête.

Cette traduction automatique est fournie pour votre commodité.

Créer des widgets personnalisés pour les dashboards de streaming

Important

Avant de commencer

Créer un widget personnalisé

Rédaction de requêtes

Exigences de la requête

Espaces réservés de filtrage

Conseil

Mots-clés et caractères bloqués

Exemples de requêtes

Prévisualiser un widget

Modifier un widget personnalisé

Supprimer un widget personnalisé

Prudence

Limite de widgets

Dépannage

Le widget ne se met pas à jour lorsque j’applique un filtre de dashboard

Les filtres s’appliquent mais la requête renvoie une erreur ou aucune donnée

Ma requête échoue à la validation ou ne s’enregistre pas

Je ne peux pas ajouter de nouveau widget — limite atteinte

Le widget s'enregistre mais disparaît après une actualisation de la page

Cette traduction automatique est fournie pour votre commodité.

Créer des widgets personnalisés pour les dashboards de streaming

Important

Avant de commencer .css-21sua1{background:none;border:none;width:0;padding:0;}

Créer un widget personnalisé

Rédaction de requêtes

Exigences de la requête

Espaces réservés de filtrage

Conseil

Mots-clés et caractères bloqués

Exemples de requêtes

Prévisualiser un widget

Modifier un widget personnalisé

Supprimer un widget personnalisé

Prudence

Limite de widgets

Dépannage

Les filtres s’appliquent mais la requête renvoie une erreur ou aucune donnée

Ma requête échoue à la validation ou ne s’enregistre pas

Je ne peux pas ajouter de nouveau widget — limite atteinte

Le widget s'enregistre mais disparaît après une actualisation de la page

Avant de commencer