サーバーのネットワークデータの取得 (API v2)

サーバーのネットワークインターフェースで受信され、送信されるデータは、New Relic Server の UI に表示されます。

  • Network I/O (Mb/s) チャート上のデータの上にカーソルを当てると、サーバーのOverview ダッシュボード上に表示されます。
  • Network ダッシュボードの特定のネットワークインターフェースの Bandwidth チャート上に表示されます。

ここでは、New Relic REST API (v2) を使って、受信、送信されるデータを取得する方法について説明します。${SERVER_ID} プレースホルダーをあなたのサーバーIDに置き換えてください。

注: データを取得した際に返される値は、指定した期間やデータの保存方法によって変わることがあります。詳しくは、メトリックデータの抽出をご覧ください。

目次

システムネットワークスピードの識別

指定した期間にサーバーによって転送されたデータ量を取得するには、以下のメトリック名を使用してください。

System/Network/${INTERFACE}/Transmitted/bytes/sec
System/Network/${INTERFACE}/Received/bytes/sec

サーバによって転送される <bパケット数を取得するには、以下のメトリック名を使用してください。

"System/Network/${INTERFACE}/Transmitted/packets/sec"
"System/Network/${INTERFACE}/Received/packets/sec"

${INTERFACE}には、以下の interface values のどちらかの値を利用してください。

  • All (Overview または集計チャート用)
  • 個々のネットワークインターフェースを識別するネットワークダッシュボード上の名前。例えば、eth0, eth2など。

per_secondは各コマンドにおいて必須のメトリック値です。

転送されたデータ平均の取得(全インターフェース)

指定した期間において、サーバー上のネットワークインターフェースが受信および送信したデータの平均を取得するには、次のようなコマンドを使用します。

curl -X GET "https://api.newrelic.com/v2/servers/${SERVER_ID}/metrics/data.xml" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=System/Network/All/Received/bytes/sec&names[]=System/Network/All/Transmitted/bytes/sec&values[]=per_second&from=2014-09-08T16:04:00+00:00&to=2014-09-08T16:34:00+00:00&summarize=true' 

ヒント:期間内の各時間における増分データを取得するには、summarize 値をtrueからfalseに変更します。もしくは、&summarize=trueを削除します。

転送されたデータ平均の取得(単一インターフェース)

指定した期間において、サーバー上の単一のネットワークインターフェースが受信および送信したデータの平均を取得するには、次のようなコマンドを使用します。${INTERFACE}を指定したインターフェース名に変更してください。例えば、eth0Allは使わないこと。

curl -X GET "https://api.newrelic.com/v2/servers/${SERVER_ID}/metrics/data.xml" \
     -H "X-Api-Key:${API_KEY}" -i \
     -d 'names[]=System/Network/${INTERFACE}/Received/bytes/sec&names[]=System/Network/${INTERFACE}/Transmitted/bytes/sec&values[]=per_second&from=2014-09-08T16:04:00+00:00&to=2014-09-08T16:34:00+00:00&summarize=true' 

バイト (API) からメガビット(ダッシュボード)への変換

APIによって保存され、返されるデータは バイト/秒です。しかしメガビット/秒 (Mb/s, 1キロバイト=1024バイト)として、サーバー Overview ダッシュボードに表示されます。ダッシュボードに表示される値とAPIコールから取得した値を一致させために、以下の計算を行います。

Megabits/sec = (<bytes/sec> * 8) / (1024)**2

転送パケットの平均の取得

指定した期間内にサーバー上の単一のネットワークインターフェースで送受信したたパケットの平均数を取得するには、以下のようなコマンドを使用します。

curl -X GET 'https://api.newrelic.com/v2/servers/${SERVER_ID}/metrics/data.xml' \
     -H 'X-Api-Key:${API_KEY}' -i \
     -d 'names[]=System/Network/${INTERFACE}/Received/packets/sec&names[]=System/Network/${INTERFACE}/Transmitted/packets/sec&values[]=per_second&from=2014-04-08T13:40:00+00:00&to=2014-04-08T13:45:00+00:00&summarize=true'

さらに詳しい情報

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

  • API Explorer の利用 (API Explorer の UI を使って、New Relic のデータの取得や入力を行う方法について)
  • API Explorer の部品 (API Explorer の各セクションの使い方についてのクイックリファレンス)