ここでは、New Relic REST API (v2) を使って、特定の アプリケーション ID と API キー を対象に、アプリケーションとブラウザの Apdex データを取得する例を紹介します。デフォルトでは、 過去30分 の値のリストを1分ごとにJSON形式で提供します。
データを取得する際、指定した期間やデータの保存方法によって、返される値が異なる場合があります。詳しくは、 メトリックデータの抽出 をご覧ください。
Apdexのメトリック名と値
REST APIコールでApdexメトリック名と値を指定するには、必要に応じてこれらのコードを使用します。
メトリクス名 | メトリック値 |
|---|---|
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
|
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 概要 ページ で示されているのと同じ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'ヒント:平均ではなく一連の 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時間として返されます。