ストリーミングダッシュボードのカスタムウィジェットの作成

カスタムウィジェットを使用すると、独自のNRQLクエリから構築された専用のチャート視覚化でMedia Streamingダッシュボードを拡張できます。カスタムウィジェットは、事前定義されたメトリクスとともに、Quality Metricsドロップダウンの別のCustom Metricsカテゴリに表示されます。これらはセッションをまたいで保持され、既存のダッシュボード内でスケーリングされます。

あなたが始める前に

カスタムウィジェットは、Media Streaming nerdpack内から作成されます。Streaming Video & AdsエージェントがインストールされたNew Relicアカウントへのアクセスが必要です。まだセットアップしていない場合は、Streaming Video & Adsエージェントのインストールを参照してください。

カスタムウィジェットを作成する

1. Media Streamingダッシュボードを開き、Quality Metricsセクションに移動します。
2. + Add Custom Widgetをクリックします。
3. ウィジェットのタイトルを入力してください。
4. NRQLエディタでNRQLクエリを記述します。構文、フィルターのプレースホルダー、および例のガイダンスについては、クエリの記述を参照してください。
5. 保存する前に結果をプレビューするには、Run Queryをクリックします。
6. Saveをクリックします。ウィジェットはQuality MetricsドロップダウンのCustom Metricsセクションに追加され、ダッシュボードにレンダリングされます。

クエリの記述

NRQLエディタは、任意の有効なNRQLSELECTまたはFROMクエリを受け入れます。完全なクエリをエディタに直接記述してください — 構文のハイライト、オートコンプリート、リアルタイムの検証はエディタによって提供されます。

クエリの要件

• クエリはSELECTまたはFROMで始まり、両方の句を含める必要があります。
• ハードコードされたSINCE句またはUNTIL句を含めないでください。ダッシュボードのタイムピッカーは、実行時に時間範囲を自動的に挿入します。
• ダッシュボードレベルのフィルターバーの選択に応答するには、クエリにフィルタープレースホルダーを含めます。

フィルタープレースホルダー

フィルターのプレースホルダーは、ダッシュボードのフィルターバーで適用されたフィルター条件に実行時に置き換えられるNRQLコメントトークンです。手動でクエリに追加してください。

例 — 既存のWHERE句がない場合：

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

asn = '14618'のフィルターがアクティブな場合：

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

例 — 既存のWHERE句：

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

例 — 集計関数内のフィルター：

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

ブロックされたキーワードと文字

偶発的または悪意のあるデータ変更を防ぐため、NRQLエディターでは以下がブロックされます：

ブロックされたキーワード：

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

ブロックされる文字：

• セミコロン（;） — クエリのチェーンやインジェクション攻撃を防ぐためにブロックされます。

これらのいずれかを含むクエリは検証に失敗し、保存やプレビューを行うことはできません。

クエリの例

基本的な時系列 — ビデオの合計開始数：

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

フィルターインテグレーションを使用したユニーク視聴者数：

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

イベントタイプ全体のエラー率：

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

接続に起因するリバッファリング率（詳細）：

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

より多くのクエリのヒントについては、ビットレートメトリクスデータディクショナリで、VideoActionとVideoErrorActionを使用した事前構築済みのNRQLの例を参照してください。

ウィジェットをプレビューする

保存する前にRun Queryをクリックして、ライブデータに対してクエリを実行し、レンダリングされたチャートを確認します。これによりウィジェットが保存されることはありません。

プレビューを使用して以下を行います：

• チャートに期待するデータがレンダリングされることを確認します。
• フィルターバーでフィルターがアクティブなときに、フィルタープレースホルダーが正しく解決されることを確認します。
• ウィジェットがダッシュボードにコミットされる前に、構文エラーや論理エラーを検出します。

カスタムウィジェットを編集する

1. Quality Metricsセクションで、変更するカスタムウィジェットを見つけます。
2. ウィジェットカードの鉛筆アイコンをクリックします。
3. エディターは編集モードで開き、すべてのフィールドが事前に入力されています — タイトルと既存のNRQLクエリ。
4. 変更を行い、Run Queryをクリックして確認し、Saveをクリックします。

保存時：

• updatedAtタイムスタンプが更新されます；元のcreatedAtとウィジェットidは保持されます。
• ウィジェットは更新されたクエリで直ちに再レンダリングされます。
• タイトルを変更した場合は、Quality メトリクスのドロップダウンで更新されます。

カスタムウィジェットを削除する

1. Quality Metricsセクションで、ウィジェットカードのアイコンをクリックします。
2. Deleteを選択します。
3. プロンプトで確認します：「『[Widget Title]』を削除してもよろしいですか？この操作は元に戻せません。」

削除された場合：

• ウィジェットはNerdStorageから削除され、完全に消去されます。
• ウィジェットカードは直ちにダッシュボードから削除されます。
• Quality メトリクスのドロップダウンからタイトルが削除されます。
• ウィジェットが選択されていた場合、自動的に選択が解除されます。

ウィジェットの制限

アカウントあたり50ウィジェットというソフトリミットは、NerdStorageのドキュメント容量に基づいています。50ウィジェットでのストレージ使用量は約21 KBです — ドキュメントあたりの制限である64 KBの約33％であり、安全なマージンを確保しています。

制限に達した場合、既存のカスタムウィジェットが削除されるまで、ウィジェットの作成はブロックされます。既存のウィジェットは引き続き正常に機能します。

トラブルシューティング