正確なメトリック名を探す

New Relic を使っていると、正確なメトリック名が要求される場面があります。例えば、特定のメトリックに対してアラートを行う際に、正確なメトリック名が必要です。Insights のメトリックエクスプローラーREST API エクスプローラーを使って、メトリック名を取得できます。

New Relic の REST API エクスプローラーを使っていると、意味のないデータを含むメトリクスを見つけることがあります。望んだ結果を得るには、API エクスプローラーを使う前に、メトリックに望むデータが関連しているか検証するために、Insights のメトリックエクスプローラーを使ってください。

Insights のメトリックエクスプローラーを使う (推奨)

<

p class=”margin-bottom-05rem>以下のことをしたい場合、Insights のメトリックエクスプローラーを使うことを推奨しています。

  • カスタムメトリックを含む全メトリックデータを検索したい。
  • メトリックチャートを好きに作りたい
  • メトリックチャートを Insights のダッシュボードに追加したい

カスタムダッシュボードエディタを使う (レガシー)

カスタムダッシュボードは、レガシーの機能です。New Relic では、代わりに Insights のメトリックエクスプローラーを使うことを推奨しています。

カスタムダッシュボードエディタを使用して、アプリ、サーバー、プラグインのメトリックを探すことができます。

既存のダッシュボードを使用することができますが、新規にダッシュボードを作成すると、メトリック名を探している間に既存のものを変えないで済みます。
  1. New Relic のメニューバーから、Tools > Create custom dashboard を選択します。
  2. タイトルを入力 (Metric name explorer [メトリック名エクスプローラー]のような) し、レイアウトを選択し、Create [作成]を押します。
  3. Add chart or table [チャートまたは表を追加]を押します。
  4. 適切な Agent type を選び、対象のアプリ、サーバー、プラグインを決めます。そして、Visualizer を選択します。
  5. エージェントにレポートするメトリック名のセグメントのリストを配置する Metric(s) フィールドを選択します。
  6. 子の名前のセグメント付きのリストを再配置するために、関連する親の名前のセグメント(例、ApdexWebTransaction)を選択します。
  7. メトリック対象として、正確なメトリック名を選択します。
  8. 有効で完全なメトリック値を使っていることをチェックするために、正確なメトリック名をコピーして、宛先へ貼り付けます。
crop-exact-metric-match.png
Tools > Create custom dashboard > (特定のメタデータ) > Add chart or table > (特定のソース) > Metric(s): 正確なメトリック名が見つかると、ドロップダウンのメッセージは、Exact metric matchに変わります。

API エクスプローラーを使う (上級者向け)

REST API エクスプローラーを使うと、アプリ、サーバー、プラグインの全メトリックのリストを取得できます。すべてのメトリックを調べることができます。よって、他の場所で使うかもしれない対象も見つけられます。

API エクスプローラーを使うには、REST API キーまたは管理者ユーザーの API キー [英語] が必要です。New Relic の API エクスポートに自動で API キーが設定されない場合は、Select an account ドロップダウンからあなたのアカウントを選択し、確かめてください。

もしくは

API キーの手動取得 [英語]を行ってください。

  1. New Relic のメニューバーから、APM > Applications > (選択したアプリ)Servers > Servers > (選択したサーバー)Plugins > (選択したプラグイン) のいづれかにアクセスします。
  2. rpm.newrelic.com/api/explore にある API エクスプローラーにアクセスします。
  3. API エクスプローラーの Select an account ドロップダウンから、アカウント名を選択します。

    crop-select-account-api-explorer.png

  4. Select (製品カテゴリー) > GET Metric Names を選択し、application_id (または component_id, server_id 等) フィールドにある product ID を指定します。そして、Send Request [リクエスト送信]を押します。
  5. API エクスプローラーが受け取った JSON レスポンスから、"name": キーに関連付いたメトリック名を探して、対象のメトリックを見つけます。
API エクスプローラーが生成する cURL コマンドをターミナルウィンドウにコピペすれば、ローカルで実行可能です。