ここでは、New Relic REST API (v2) を使って、特定の アプリケーション ID と API キー を対象に、アプリケーションとブラウザの Apdex データを取得する例を紹介します。デフォルトでは、 過去30分 の値のリストを1分ごとにJSON形式で提供します。
データを取得する際、指定した期間やデータの保存方法によって、返される値が異なる場合があります。詳しくは、 メトリックデータの抽出 をご覧ください。
Apdexのメトリック名と値
REST APIコールでApdexメトリック名と値を指定するには、必要に応じてこれらのコードを使用します。
Metric name | Metric value |
---|---|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
|
score
を決定するために使用される計算については、 Apdex: ユーザー満足度の測定で説明されています。次のセクションでは、 score
を取得する方法と、それに到達するために使用されるs、t、および f の値について説明します。
Apdexの平均スコア
特定の期間の平均Apdex score
(アプリとブラウザーの両方) を取得するには、このコマンドを使用します。この例は、アプリケーション IDとそれに対応するAPI キーの 24 時間を XML 形式で示しています。
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.xml" \> -H "X-Api-Key:${API_KEY}" -i \> -d 'names[]=Apdex&names[]=EndUser/Apdex&values[]=score&from=2014-01-01T00:00:00+00:00&to=2014-01-02T00:00:00+00:00&summarize=true'
これにより、 APM Overviewページに表示されるものと同じ Apdex スコアが返されます。
Apdexメトリックの平均値
平均 Apdex メトリック値 特定の時間範囲 を取得するには、このコマンドを使用します。この例では、 アプリケーションID と、それに対応する APIキー の12時間をXML形式で表示しています。
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.xml" \> -H "X-Api-Key:${API_KEY}" -i \> -d 'names[]=Apdex&names[]=EndUser/Apdex&values[]=score&from=2014-06-09T00:00:00+00:00&to=2014-06-09T12:00:00+00:00&summarize=true'
Tip: 平均ではなく一連の Apdex スコアを返すには、 &summarize=true
を省略します。
全ての平均Apdex値
特定の時間範囲の平均スコアs
、 t
、 f
、 count
、およびしきい値の完全なセットを取得するには、このコマンドを使用します。この例では、アプリケーション IDと対応するAPI キーの 24 時間 ( %2B06:00
を使用して UTC の 6 時間西のタイムゾーンに調整) を XML 形式で示しています。
$curl -X GET "https://api.newrelic.com/v2/applications/${APP_ID}/metrics/data.xml" \> -H "X-Api-Key:${API_KEY}" -i \> -d 'names[]=Apdex&names[]=EndUser/Apdex&from=2014-06-09T00:00:00%2B06:00&to=2014-06-10T00:00:00%2B06:00&summarize=true'
ヒント
この例では、タイムゾーンを調整しても、出力はUTC時間として返されます。