個々のプラグインのコンポーネントリスト (API v2)

New Relic の REST API とAPI キーを使って、プラグイン用の単一のコンポーネントに関する情報を取得できます。以下の情報を含んでいます。

  • プラグインのCOMPONENT_IDCOMPONENT_NAME
  • SUMMARY_METRIC_IDSUMMARY_METRIC_NAME を含む要約情報
  • METRIC_NAME and METRIC_VALUE を含む関連する要約メトリックの情報
  • Caution と Critical アラートを発行する基準となる閾値
  • プラグイン発行者によってセットされた生の要約メトリックとフォーマットされた要約メトリック

注: 以下のサンプルを利用する際は、各プレースホルダー(例えば、${PLUGIN_ID})を 特定のIDに置き換えてください。

目次

プラグインIDによるリスト

プラグインIDから該当するコンポーネントの情報を取得する方法は以下のとおりです。

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

コンポーネント名によるリスト

コンポーネント名から該当するコンポーネントの要約データのリストを取得する方法は以下のとおりです。

curl -X GET 'https://api.newrelic.com/v2/components.json' \
     -H "X-Api-Key:${APIKEY}" -i \
     -d "filter[name]=${COMPONENT_NAME}" 

もしくは、以下でも可能です。

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

コンポーネントの出力の表示

両方のAPIコールとも同じ出力内容となります。

{
  "components": [
    {
      "id": 3947935,    <---<<<  COMPONENT_ID
      "name": "F5-01-prod",    <---<<<  COMPONENT_NAME
      "summary_metrics": [
        {
          "id": 116635,     <---<<< SUMMARY_METRIC_ID
          "name": "CPU",     <---<<< SUMMARY_METRIC_NAME
          "metric": "Component/CPU/Total/Global[%]",     <---<<< METRIC_NAME
          "value_function": "average_value",     <---<<< METRIC_VALUE
          "thresholds": {
            "caution": 75,     <---<<< SUMMARY_METRIC_CAUTION_THRESHOLD
            "critical": 85     <---<<< SUMMARY_METRIC_CRITICAL_THRESHOLD
        },
    },
}

さらに詳しい情報

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