Metrics - Get Multiple
Recuperare i dati delle metriche
Ottiene i valori delle metriche per più metriche
POST https://api.applicationinsights.io/v1/apps/{appId}/metrics
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
app
|
path | True |
string |
ID dell'applicazione. Si tratta dell'ID applicazione nel pannello Impostazioni di accesso API nel portale di Azure. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
body |
Query sulle metriche in batch. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Risposta riuscita |
|
Other Status Codes |
Oggetto risposta di errore. |
Sicurezza
oauth2
Connettersi all'API di Azure Application Insights
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
postMetric
Esempio di richiesta
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"
}
}
]
Risposta di esempio
[
{
"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
}
}
]
}
}
}
]
Definizioni
Nome | Descrizione |
---|---|
error |
Dettagli errore. |
error |
Codice e messaggio per un errore. |
error |
Dettagli errore. |
Metric |
ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione. |
Metrics |
Aggregazione da usare per calcolare i valori delle metriche. Per recuperare più aggregazioni alla volta, separarle con una virgola. Se non viene specificata alcuna aggregazione, viene usata l'aggregazione predefinita per la metrica. |
metrics |
Una richiesta di metrica |
metrics |
Risultato della metrica. |
metrics |
Dati dei risultati delle metriche. |
metrics |
Set di risultati delle metriche. |
Metrics |
Nome della dimensione per segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica che si sta recuperando. Per segmentare più di una dimensione alla volta, separarle con una virgola (,). In questo caso, i dati delle metriche verranno segmentati nell'ordine in cui le dimensioni sono elencate nel parametro . |
metrics |
Segmento di metrica |
Parameters |
Parametri per una singola query sulle metriche |
errorDetail
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalProperties |
object |
|
code |
string |
Codice dell'errore. |
message |
string |
Messaggio di errore leggibile. |
resources |
string[] |
Indica le risorse responsabili dell'errore. |
target |
string |
Indica quale proprietà nella richiesta è responsabile dell'errore. |
value |
string |
Indica il valore in 'target' responsabile dell'errore. |
errorInfo
Codice e messaggio per un errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalProperties |
object |
|
code |
string |
Codice di errore leggibile del computer. |
details |
dettagli dell'errore. |
|
innererror |
Codice e messaggio per un errore. |
|
message |
string |
Messaggio di errore leggibile. |
errorResponse
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
error |
Codice e messaggio per un errore. |
MetricId
ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione.
Valore | Descrizione |
---|---|
availabilityResults/availabilityPercentage | |
availabilityResults/duration | |
billing/telemetryCount | |
client/networkDuration | |
client/processingDuration | |
client/receiveDuration | |
client/sendDuration | |
client/totalDuration | |
customEvents/count | |
dependencies/count | |
dependencies/duration | |
dependencies/failed | |
exceptions/browser | |
exceptions/count | |
exceptions/server | |
pageViews/count | |
pageViews/duration | |
performanceCounters/exceptionsPerSecond | |
performanceCounters/memoryAvailableBytes | |
performanceCounters/processCpuPercentage | |
performanceCounters/processIOBytesPerSecond | |
performanceCounters/processPrivateBytes | |
performanceCounters/processorCpuPercentage | |
performanceCounters/requestExecutionTime | |
performanceCounters/requestsInQueue | |
performanceCounters/requestsPerSecond | |
requests/count | |
requests/duration | |
requests/failed | |
sessions/count | |
users/authenticated | |
users/count |
MetricsAggregation
Aggregazione da usare per calcolare i valori delle metriche. Per recuperare più aggregazioni alla volta, separarle con una virgola. Se non viene specificata alcuna aggregazione, viene usata l'aggregazione predefinita per la metrica.
Valore | Descrizione |
---|---|
avg | |
count | |
max | |
min | |
sum | |
unique |
metricsPostBodySchema
Una richiesta di metrica
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Identificatore per la query. Deve essere univoco all'interno del corpo del post della richiesta. Questo identificatore sarà la proprietà 'id' dell'oggetto risposta che rappresenta questa query. |
parameters |
Parametri per una singola query sulle metriche |
metricsResult
Risultato della metrica.
Nome | Tipo | Descrizione |
---|---|---|
value |
Dati dei risultati delle metriche. |
metricsResultInfo
Dati dei risultati delle metriche.
Nome | Tipo | Descrizione |
---|---|---|
end |
string (date_time) |
Ora di inizio della metrica. |
interval |
string (duration) |
Intervallo usato per segmentare i dati delle metriche. |
segments |
Dati delle metriche segmentati (se segmentati). |
|
start |
string (date_time) |
Ora di inizio della metrica. |
metricsResults
Set di risultati delle metriche.
Nome | Tipo | Descrizione |
---|---|---|
body |
Risultati di questa query metrica. |
|
id |
string |
ID specificato per questa metrica. |
status |
integer (int32) |
Codice di stato HTTP di questa query di metrica. |
MetricsSegment
Nome della dimensione per segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica che si sta recuperando. Per segmentare più di una dimensione alla volta, separarle con una virgola (,). In questo caso, i dati delle metriche verranno segmentati nell'ordine in cui le dimensioni sono elencate nel parametro .
Valore | Descrizione |
---|---|
applicationBuild | |
applicationVersion | |
authenticatedOrAnonymousTraffic | |
browser | |
browserVersion | |
city | |
cloudRoleName | |
cloudServiceName | |
continent | |
countryOrRegion | |
deploymentId | |
deploymentUnit | |
deviceType | |
environment | |
hostingLocation | |
instanceName |
metricsSegmentInfo
Segmento di metrica
Nome | Tipo | Descrizione |
---|---|---|
end |
string (date_time) |
Ora di inizio del segmento di metrica (solo quando è stato specificato un intervallo). |
segments |
Dati delle metriche segmentati (se ulteriormente segmentati). |
|
start |
string (date_time) |
Ora di inizio del segmento di metrica (solo quando è stato specificato un intervallo). |
Parameters
Parametri per una singola query sulle metriche
Nome | Tipo | Descrizione |
---|---|---|
aggregation |
Aggregazione da usare per calcolare i valori delle metriche. Per recuperare più aggregazioni alla volta, separarle con una virgola. Se non viene specificata alcuna aggregazione, viene usata l'aggregazione predefinita per la metrica. |
|
filter |
string |
Espressione utilizzata per filtrare i risultati. Questo valore deve essere un'espressione di filtro OData valida in cui le chiavi di ogni clausola devono essere dimensioni applicabili per la metrica che si sta recuperando. |
interval |
string (duration) |
Intervallo di tempo da usare per il recupero dei valori delle metriche. Questa è una durata ISO8601. Se l'intervallo viene omesso, il valore della metrica viene aggregato nell'intero intervallo di tempo. Se viene specificato l'intervallo, il server può modificare l'intervallo in base alle dimensioni più appropriate in base all'intervallo di tempo utilizzato per la query. In tutti i casi, l'intervallo effettivo usato per la query viene incluso nella risposta. |
metricId |
ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione. |
|
orderby |
string |
Funzione di aggregazione e direzione per ordinare i segmenti. Questo valore è valido solo quando viene specificato il segmento. |
segment |
Nome della dimensione per segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica che si sta recuperando. Per segmentare più di una dimensione alla volta, separarle con una virgola (,). In questo caso, i dati delle metriche verranno segmentati nell'ordine in cui le dimensioni sono elencate nel parametro . |
|
timespan |
string |
Intervallo di tempo su cui recuperare i valori delle metriche. Si tratta di un valore ISO8601 periodo di tempo. Se timepan viene omesso, viene usato un intervallo di tempo predefinito di |
top |
integer (int32) |
Numero di segmenti da restituire. Questo valore è valido solo quando viene specificato il segmento. |