Metrics - Get Multiple
メトリック データを取得する
複数のメトリックのメトリック値を取得します
POST https://api.applicationinsights.io/v1/apps/{appId}/metrics
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
app
|
path | True |
string |
アプリケーションの ID。 これは、Azure portalの [API アクセス設定] ブレードの [アプリケーション ID] です。 |
要求本文
名前 | 型 | 説明 |
---|---|---|
body |
バッチ処理されたメトリック クエリ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
成功応答 |
|
Other Status Codes |
エラー応答オブジェクト。 |
セキュリティ
oauth2
Azure アプリケーション Insights API に接続する
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントの借用 |
例
postMetric
要求のサンプル
POST https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics
[
{
"id": "failed",
"parameters": {
"metricId": "requests/failed",
"timespan": "P2D",
"interval": "P1D"
}
},
{
"id": "count",
"parameters": {
"metricId": "requests/count",
"timespan": "P2D",
"interval": "P1D"
}
}
]
応答のサンプル
[
{
"id": "failed",
"status": 200,
"body": {
"value": {
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-24T19:59:12.488Z",
"interval": "P1D",
"segments": [
{
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-23T00:00:00.000Z",
"requests/failed": {
"sum": 277
}
},
{
"start": "2018-01-23T00:00:00.000Z",
"end": "2018-01-24T00:00:00.000Z",
"requests/failed": {
"sum": 1599
}
},
{
"start": "2018-01-24T00:00:00.000Z",
"end": "2018-01-24T19:59:12.488Z",
"requests/failed": {
"sum": 1392
}
}
]
}
}
},
{
"id": "count",
"status": 200,
"body": {
"value": {
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-24T19:59:12.488Z",
"interval": "P1D",
"segments": [
{
"start": "2018-01-22T19:59:12.488Z",
"end": "2018-01-23T00:00:00.000Z",
"requests/count": {
"sum": 1225
}
},
{
"start": "2018-01-23T00:00:00.000Z",
"end": "2018-01-24T00:00:00.000Z",
"requests/count": {
"sum": 7382
}
},
{
"start": "2018-01-24T00:00:00.000Z",
"end": "2018-01-24T19:59:12.488Z",
"requests/count": {
"sum": 6674
}
}
]
}
}
}
]
定義
名前 | 説明 |
---|---|
error |
エラーの詳細。 |
error |
エラーのコードとメッセージ。 |
error |
エラーの詳細。 |
Metric |
メトリックの ID。 これは、標準の AI メトリック、またはアプリケーション固有のカスタム メトリックです。 |
Metrics |
メトリック値を計算するときに使用する集計。 一度に複数の集計を取得するには、コンマで区切ります。 集計が指定されていない場合は、メトリックの既定の集計が使用されます。 |
metrics |
メトリック要求 |
metrics |
メトリックの結果。 |
metrics |
メトリックの結果データ。 |
metrics |
メトリックの結果のセット。 |
Metrics |
メトリック値をセグメント化するディメンションの名前。 このディメンションは、取得するメトリックに適用する必要があります。 一度に複数のディメンションでセグメント化するには、コンマ (,) で区切ります。 この場合、メトリック データは、ディメンションがパラメーターに一覧表示される順序でセグメント化されます。 |
metrics |
メトリック セグメント |
Parameters |
1 つのメトリック クエリのパラメーター |
errorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalProperties |
object |
|
code |
string |
エラーのコード。 |
message |
string |
人間が判読できるエラー メッセージ。 |
resources |
string[] |
エラーの原因となったリソースを示します。 |
target |
string |
要求のどのプロパティがエラーの原因であるかを示します。 |
value |
string |
"target" のどの値がエラーの原因であるかを示します。 |
errorInfo
エラーのコードとメッセージ。
名前 | 型 | 説明 |
---|---|---|
additionalProperties |
object |
|
code |
string |
コンピューターで読み取り可能なエラー コード。 |
details |
エラーの詳細。 |
|
innererror |
エラーのコードとメッセージ。 |
|
message |
string |
人間が判読できるエラー メッセージ。 |
errorResponse
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
error |
エラーのコードとメッセージ。 |
MetricId
メトリックの ID。 これは、標準の AI メトリック、またはアプリケーション固有のカスタム メトリックです。
名前 | 型 | 説明 |
---|---|---|
availabilityResults/availabilityPercentage |
string |
|
availabilityResults/duration |
string |
|
billing/telemetryCount |
string |
|
client/networkDuration |
string |
|
client/processingDuration |
string |
|
client/receiveDuration |
string |
|
client/sendDuration |
string |
|
client/totalDuration |
string |
|
customEvents/count |
string |
|
dependencies/count |
string |
|
dependencies/duration |
string |
|
dependencies/failed |
string |
|
exceptions/browser |
string |
|
exceptions/count |
string |
|
exceptions/server |
string |
|
pageViews/count |
string |
|
pageViews/duration |
string |
|
performanceCounters/exceptionsPerSecond |
string |
|
performanceCounters/memoryAvailableBytes |
string |
|
performanceCounters/processCpuPercentage |
string |
|
performanceCounters/processIOBytesPerSecond |
string |
|
performanceCounters/processPrivateBytes |
string |
|
performanceCounters/processorCpuPercentage |
string |
|
performanceCounters/requestExecutionTime |
string |
|
performanceCounters/requestsInQueue |
string |
|
performanceCounters/requestsPerSecond |
string |
|
requests/count |
string |
|
requests/duration |
string |
|
requests/failed |
string |
|
sessions/count |
string |
|
users/authenticated |
string |
|
users/count |
string |
MetricsAggregation
メトリック値を計算するときに使用する集計。 一度に複数の集計を取得するには、コンマで区切ります。 集計が指定されていない場合は、メトリックの既定の集計が使用されます。
名前 | 型 | 説明 |
---|---|---|
avg |
string |
|
count |
string |
|
max |
string |
|
min |
string |
|
sum |
string |
|
unique |
string |
metricsPostBodySchema
メトリック要求
名前 | 型 | 説明 |
---|---|---|
id |
string |
このクエリの識別子。 要求の投稿本文内で一意である必要があります。 この識別子は、このクエリを表す応答オブジェクトの 'id' プロパティになります。 |
parameters |
1 つのメトリック クエリのパラメーター |
metricsResult
メトリックの結果。
名前 | 型 | 説明 |
---|---|---|
value |
メトリックの結果データ。 |
metricsResultInfo
メトリックの結果データ。
名前 | 型 | 説明 |
---|---|---|
end |
string |
メトリックの開始時刻。 |
interval |
string |
メトリック データのセグメント化に使用される間隔。 |
segments |
セグメント化されたメトリック データ (セグメント化されている場合)。 |
|
start |
string |
メトリックの開始時刻。 |
metricsResults
メトリックの結果のセット。
名前 | 型 | 説明 |
---|---|---|
body |
このメトリック クエリの結果。 |
|
id |
string |
このメトリックに指定された ID。 |
status |
integer |
このメトリック クエリの HTTP 状態コード。 |
MetricsSegment
メトリック値をセグメント化するディメンションの名前。 このディメンションは、取得するメトリックに適用する必要があります。 一度に複数のディメンションでセグメント化するには、コンマ (,) で区切ります。 この場合、メトリック データは、ディメンションがパラメーターに一覧表示される順序でセグメント化されます。
名前 | 型 | 説明 |
---|---|---|
applicationBuild |
string |
|
applicationVersion |
string |
|
authenticatedOrAnonymousTraffic |
string |
|
browser |
string |
|
browserVersion |
string |
|
city |
string |
|
cloudRoleName |
string |
|
cloudServiceName |
string |
|
continent |
string |
|
countryOrRegion |
string |
|
deploymentId |
string |
|
deploymentUnit |
string |
|
deviceType |
string |
|
environment |
string |
|
hostingLocation |
string |
|
instanceName |
string |
metricsSegmentInfo
メトリック セグメント
名前 | 型 | 説明 |
---|---|---|
end |
string |
メトリック セグメントの開始時刻 (間隔が指定された場合のみ)。 |
segments |
セグメント化されたメトリック データ (さらにセグメント化されている場合)。 |
|
start |
string |
メトリック セグメントの開始時刻 (間隔が指定された場合のみ)。 |
Parameters
1 つのメトリック クエリのパラメーター
名前 | 型 | 説明 |
---|---|---|
aggregation |
メトリック値を計算するときに使用する集計。 一度に複数の集計を取得するには、コンマで区切ります。 集計が指定されていない場合は、メトリックの既定の集計が使用されます。 |
|
filter |
string |
結果をフィルター処理するために使用される式。 この値は、有効な OData フィルター式である必要があります。各句のキーは、取得するメトリックに適用可能なディメンションである必要があります。 |
interval |
string |
メトリック値を取得するときに使用する時間間隔。 これはISO8601期間です。 interval を省略すると、メトリック値は期間全体で集計されます。 interval が指定されている場合、サーバーは、クエリに使用される期間に基づいて、より適切なサイズに間隔を調整できます。 いずれの場合も、クエリに使用される実際の間隔が応答に含まれます。 |
metricId |
メトリックの ID。 これは、標準の AI メトリック、またはアプリケーション固有のカスタム メトリックです。 |
|
orderby |
string |
セグメントを並べ替える集計関数と方向。 この値は、セグメントが指定されている場合にのみ有効です。 |
segment |
メトリック値をセグメント化するディメンションの名前。 このディメンションは、取得するメトリックに適用する必要があります。 一度に複数のディメンションでセグメント化するには、コンマ (,) で区切ります。 この場合、メトリック データは、ディメンションがパラメーターに一覧表示される順序でセグメント化されます。 |
|
timespan |
string |
メトリック値を取得する期間。 これは、ISO8601期間の値です。 timespan を省略すると、既定の |
top |
integer |
返すセグメントの数。 この値は、セグメントが指定されている場合にのみ有効です。 |