TL;DR
- New Relic InsightでダッシュボードをREST APIから使うには、Admin user API Keyが必要
-
New Relic REST API Explorerに使いたいAPIと必要なパラメーターを入力すると、
curl
コマンドを作成してくれるので利用するとよい
やりたいこと
New Relic Insightsのダッシュボードの定義を取得したり、定義からダッシュボードを作成するのにコードなどで表現できるといいなぁと思いまして。
Insights Dashboard APIを使うと良いようです。
で、ドキュメントから利用までの流れを掴むのにややてこずったのでメモとして書いておきます。
New Relic Admin API Keyの入手
Insights Dashboard APIを使用するには、Admin API Keyが必要です。REST API Keyではありません。
New RelicのWeb UIのヘッダーから自分のアイコンをクリックして、Account settings
→ Integrations
→ API Key
を選択します。
以下のような画面が表示されます。
下の表になっているところに、Admin's API Keyが表示されるのですが、最初はなにもないので、矢印のアイコンをクリックして作成します(赤で囲っている部分です)
作成済みであれば、Show key
をクリックして表示させて、Admin API Keyをコピーするなりします。
Insights Dashboard APIにアクセスする
続いて、New Relic REST API Explorerにアクセスして、APIの定義や呼び出し方を確認します。
左上部に、現在ログインしているアカウントのキーを選ぶようにすれば、Admin API Key(REST API Keyも選べます)が補完されるので便利です。
次に、左のメニューから利用したいAPIを選びます。今回はDashboards
を。
APIごとに必要なパラメーターを入力すると、curl
コマンドを作成してくれます。
あとは、このコマンドを使ってREST APIを使いましょう。