ラベルのリスト (API v2)

アカウントに紐づく利用可能なラベルのリストを取得するには、以下のサンプルを実行してください。その際に、サンプルにある${API_KEY}をあなたのアカウントのAPIキーに置き換えてください。

ヒント: New Relic REST API Explorer (v2)を使って、ラベルのリストを取得することもできます。

目次

既存のラベル一覧の取得

アカウントの存在しているラベルのリストを取得するには以下のコマンドを使用してください。

    curl 'https://api.newrelic.com/v2/labels.xml' \
     -H "X-Api-Key:${API_KEY}" -i 

出力内容の表示

ラベルの出力内容には、以下が含まれます。

  • ラベルの完全なキー名 (例:Staging:Test1)とキーのコンポーネントと名前
  • サーバーやアプリケーションのhealth_status (赤、黄色、緑、灰色)と各カテゴリにあるラベル用のサーバーやアプリケーションのID。例えば、サーバーID 3801143とID 5879721の健康状態は両方とも赤です。アプリは良好です。
  • このラベルに紐付いたアプリやサーバー。例えば、Staging:Test1 ラベルは、1つのアプリケーション(4937390)と2つのサーバー (3801143 and 5879721)に適用されています。

ラベル一覧を取得すると以下のサンプルのような出力内容となります。

{ "labels": [ { "key": "Production:Main", "category": "Production", "name": "Main", "application_health_status": { "green": [], "orange": [], "red": [], "gray": [] }, "server_health_status": { "green": [], "orange": [ 5879558 ], "red": [], "gray": [] }, "links": { "applications": [], "servers": [ 5879558 ] } }, &##123; "key": "Staging:Test1", "category": "Staging", "name": "Test1", "application_health_status": { "green": [], "orange": [], "red": [ 4937390 ], "gray": [] }, "server_health_status": { "green": [], "orange": [], "red": [ 3801143, 5879721 ], "gray": [] }, "links": { "applications": [ 4937390 ], "servers": [ 3801143, 5879721 ] } }, ... }

さらに詳しい情報

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

  • ラベルとカテゴリー (アプリやサーバーにラベル付を行うと、アプリやサーバーを意味のあるカテゴリにまとめることができます。それにより、その単位で表示や比較を行うことができます。)
  • API Explorer の利用 (API Explorer の UI を使って、New Relic のデータの取得や入力を行う方法について)
  • API Explorer の部品 (API Explorer の各セクションの使い方についてのクイックリファレンス)