Grafana プラグインを使用して RUM データを視覚化する

1. プラグインの最新バージョンは以下からダウンロードしてください。 https://github.com/ns1/grafana-pulsar-datasource-v2.
2. ファイルを解凍し、解凍したディレクトリを Grafana 設定ファイルで指定されたプラグインディレクトリに移動します。
3. ローカルの grafana.ini ファイルを編集し、以下の変更を加えてください

   [plugins]
   allow_loading_unsigned_plugins = ns1labs-pulsarmetrics-datasource
   [plugin.ns1labs-pulsarmetrics-datasource]
   allow_local_mode = true

4. Grafana インスタンスを再起動します。

1. Grafana ポータルで、サイドバーメニューから Configuration ページに移動し、 Plugins を選択して利用可能なプラグインのリストを表示します。
   
   
2. NS1 Pulsar Metricsがインストールされているプラグインのリストに含まれていることを確認してください。 表示されない場合は、 Grafana のログを参照し、関連するエラーメッセージを検索してください。
   注意： プラグインが Grafana Labs のレビューキューにある間、一時的に未署名の警告が表示されることがあります。
3. データソース] タブ （[設定] > [データソース] ）に移動し、 [データソースの追加] をクリックします。
4. NS1 Pulsar Metrics データソースを検索し、選択する（「 その他 」にリストされている）。
   
   

   確認メッセージが表示され、データソースが正常に追加されたことが示されます。その後、プラグイン設定ページにリダイレクトされます。

   
   
   
5. API Keyの隣に、先ほど作成した NS1 Connect APIキーを入力する。 APIキーは Grafana データベースに安全に保存されます。 完了したら 、「保存してテスト」 をクリックします。 Grafana は、API キーが からデータを引き出すために使用できることを検証します。 NS1 Connect 成功すると、確認メッセージが表示されます。
   注： Grafana がエラー・メッセージを返した場合は、 NS1 Connect API キーのシークレットを確認するか、API キーのパーミッションが正しいことを確認してください。
   
   
   

   戻るをクリックして、設定済みのデータソースに戻ります。 NS1 Connect Pulsar データソースがリストに表示される。

   
   
   

   このデータ・ソースしかインストールされていない場合は、 デフォルトと表示されます。 追加のプラグインを設定する際には、デフォルトとして指定するプラグインを1つ選択できます。

次に、 Pulsar のデータを照会するために、 Grafana に新しいパネルを作成する。

1. 新しい Grafana ダッシュボードを作成するか、既存のダッシュボードに移動します。
2. 右上にあるパネルアイコンの追加をクリックします。
   
   

   新しいオプションがダッシュボードの上部に表示されます。

   
   
   
3. 新しいパネルを追加するをクリックします。
   
   

   上のスクリーンショットは、 Grafana のデフォルト・データ・ソースからのデータを使ったサンプル・クエリです。 設定によって表示が異なる場合があります。

   データソースドロップダウンメニュー （左下、 クエリタブの下）をクリックし、 NS1 Pulsar Metricsを選択する。 現在、利用可能なすべての Pulsar アプリケーションとジョブが選択可能です。 データソースを構成する際に入力した NS1 Connect API キーにアクセス可能なアプリケーションとジョブのみを表示できることに注意してください。

   注： Pulsar アプリケーションとジョブの詳細については、 Pulsar RUMアプリケーションとジョブの作成をご参照ください。
4. Appで、 Pulsar アプリケーションを選択します。 Pulsar アプリケーションは、 Pulsar リソースの集まりである。
5. Jobで、 Pulsar ジョブを選択します。 ジョブは、測定される単一の Pulsar リソース（CDN、データセンター、クラウドなど）に対応する。 このリソースは、ページの読み込み時に JavaScript タグが実行された際に、可用性とレイテンシを測定するためのアセット（1ピクセル画像など）をホストします。
6. Metric（メトリック） の下で、リストからメトリックの種類 （パフォーマンスまたは可用性）を選択します。
7. 集計の下で、事前計算された集計（最小値 、最大値 、平均値、 p50、 p75, p90, p95, p99 ）を選択します。
8. オプションとして、データをフィルタリングするためにGeoおよび/またはASNを選択することができますが、特定の状況下でのみ意味を持つCDNのグローバルな動作を示すチャートを避けるために、少なくともGeoを指定することをお勧めします。
9. 右側のサイドバーで、新しいパネルのタイトルを入力し、パネルの設定と環境設定を必要に応じて調整します。 Y軸の単位をミリ秒に設定したいと思うでしょう。
10. オプションで、追加のクエリを指定して、複数の Pulsar アプリケーションとジョブのパフォーマンスまたは可用性データを比較できます。 詳細は下記をご覧ください。
11. 準備ができたら 、「適用」 をクリックして変更を保存します。 作業が完了したら、右上の 「保存」 をクリックします。 編集モードを終了します。
12. ダッシュボードの名前を入力し（例： NS1 Pulsar）、[保存] をクリックします。

先ほど作成したパネルとともに、新しいダッシュボードが表示されます。 ダッシュボードは必要に応じて変更でき、パネルを追加することもできます。