プラグインのリストを取得 (API v2)

ここでは、New Relic REST API (v2)を使って、APIキーに関連するアカウントの全プラグインのリストを取得する方法について説明します。リストには以下の情報が含まれます。

目次

全プラグインのリスト

プラグインのリストを取得する方法は以下のとおりです。

curl -X GET "https://api.newrelic.com/v2/plugins.json" \
     -H "X-Api-Key:${APIKEY}" -i 

プラグインリストの出力

出力はJSON形式です。ただし、plugins.jsonの代わりにplugins.xml指定することで、変更ができます。以下の出力はJSON形式で表示されます。

注: APIクエリを使うと、大量のデータを取得することがあります。出力フォーマットや複数のページを表示する方法については、API出力のページ送りをご覧ください。

{
  "plugins": [
    {
      "id": 9568,    <---<<<  PLUGIN_ID
      "name": "F5 LTM",     <---<<<  PLUGIN_NAME
      "guid": "com.newrelic.f5",     <---<<<  GUID
      "publisher": "New Relic Inc.",
      "summary_metrics": [
        {
          "id": 116635,>    <---<<<  COMPONENT_ID
          "name": "CPU",>    <---<<<  COMPONENT_NAME
          "metric": "Component/CPU/Total/Global[%]",
          "value_function": "average_value",
          "thresholds": {
            "caution": 75,
            "critical": 85
          }
        },
        {
          "id": 116636,
          "name": "Throughput",
          "metric": "Component/Throughput/Total[bits/sec]",
          "value_function": "average_value",
          "thresholds": {
            "caution": null,
            "critical": null
          }
        },
        .....
      }
    }
  ]
  ...

プラグイン ID や GUID による絞り込み

GUID やプラグイン ID を指定してプラグインのリストを絞り込むには、[guid]ids を適切な値に置き換えてください。

curl -X GET 'https://api.newrelic.com/v2/plugins.json' \
    -H 'X-Api-Key:' -i \
    -d 'filter[guid]=mysql&filter[ids]=123,234'

さらに詳しい情報

追加のドキュメントリソースは次のとおりです。

  • API Explorer の利用 (API Explorer の UI を使って、New Relic のデータの取得や入力を行う方法について)
  • API Explorer の部品 (API Explorer の各セクションの使い方についてのクイックリファレンス)
  • New Relicのブログ記事 (New Relic の REST API を使ってプラグインデータを取得するため方法の追加情報とサンプルについて)