Metrics - Get

Riferimento

Servizio:: Application Insights

Versione API:: v1

Recuperare i dati delle metriche
Ottiene i valori delle metriche per una singola metrica

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}

Con parametri facoltativi:

GET https://api.applicationinsights.io/v1/apps/{appId}/metrics/{metricId}?timespan={timespan}&interval={interval}&aggregation={aggregation}&segment={segment}&top={top}&orderby={orderby}&filter={filter}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
appId	path	True	string	ID dell'applicazione. Si tratta dell'ID applicazione del pannello Impostazioni accesso API nel portale di Azure.
metricId	path	True	MetricId	ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione.
aggregation	query		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.
filter	query		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	query		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 alla dimensione più appropriata in base all'intervallo di tempo usato per la query. In tutti i casi, l'intervallo effettivo usato per la query viene incluso nella risposta.
orderby	query		string	Funzione di aggregazione e direzione per ordinare i segmenti. Questo valore è valido solo quando viene specificato il segmento.
segment	query		MetricsSegment[]	Nome della dimensione per cui segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica recuperata. Per segmentare più dimensioni 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	query		string	Intervallo di tempo in 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 `PT12H` ("ultime 12 ore"). L'intervallo di tempo effettivo su cui viene eseguita una query può essere modificato dal server basato sul server. In tutti i casi, l'intervallo di tempo effettivo usato per la query viene incluso nella risposta.
top	query		integer int32	Numero di segmenti da restituire. Questo valore è valido solo quando viene specificato il segmento.

Risposte

Nome	Tipo	Descrizione
200 OK	metricsResult	Risposta di esito positivo
Other Status Codes	errorResponse	Oggetto risposta di errore.

Sicurezza

oauth2

Connettersi all'API di applicazione Azure 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

intervaledMetric

segmentedIntervaledMetric

simpleMetric

intervaledMetric

Esempio di richiesta

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D

Risposta di esempio

Codice di stato:: 200

{
  "value": {
    "start": "2018-02-04T10:01:35.086Z",
    "end": "2018-02-06T10:01:35.086Z",
    "interval": "P1D",
    "segments": [
      {
        "start": "2018-02-04T10:01:35.086Z",
        "end": "2018-02-05T00:00:00.000Z",
        "requests/count": {
          "sum": 4927
        }
      },
      {
        "start": "2018-02-05T00:00:00.000Z",
        "end": "2018-02-06T00:00:00.000Z",
        "requests/count": {
          "sum": 8460
        }
      },
      {
        "start": "2018-02-06T00:00:00.000Z",
        "end": "2018-02-06T10:01:35.086Z",
        "requests/count": {
          "sum": 3743
        }
      }
    ]
  }
}

segmentedIntervaledMetric

Esempio di richiesta

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount?timespan=P2D&interval=P1D&segment=operation/name,request/success

Risposta di esempio

Codice di stato:: 200

{
  "value": {
    "start": "2018-10-22T10:40:09.065Z",
    "end": "2018-10-22T22:40:09.065Z",
    "segments": [
      {
        "operation/name": "GET Home/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 156483,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 3795,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /",
        "segments": [
          {
            "requests/count": null,
            "sum": 34168,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 12,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-light-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9378,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET /FabrikamProd/Content/fonts/segoewp-webfont.eot",
        "segments": [
          {
            "requests/count": null,
            "sum": 9370,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 1989,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 14,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1991,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1990,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET ServiceTickets/GetLogEntries",
        "segments": [
          {
            "requests/count": null,
            "sum": 1985,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Employees/Details",
        "segments": [
          {
            "requests/count": null,
            "sum": 663,
            "request/success": false
          },
          {
            "requests/count": null,
            "sum": 663,
            "request/success": true
          }
        ]
      },
      {
        "operation/name": "GET Reports/Index",
        "segments": [
          {
            "requests/count": null,
            "sum": 1086,
            "request/success": true
          }
        ]
      }
    ]
  }
}

simpleMetric

Esempio di richiesta

HTTP

GET https://api.applicationinsights.io/v1/apps/DEMO_APP/metrics/requests%2Fcount

Risposta di esempio

Codice di stato:: 200

{
  "value": {
    "start": "2016-01-01T02:00:00.000Z",
    "end": "2016-01-03T02:00:00.000Z",
    "requests/count": {
      "sum": 23
    }
  }
}

Definizioni

Nome	Descrizione
errorDetail	Dettagli errore.
errorInfo	Codice e messaggio per un errore.
errorResponse	Dettagli errore.
MetricId	ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione.
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.
metricsResult	Risultato della metrica.
metricsResultInfo	Dati dei risultati della metrica.
MetricsSegment	Nome della dimensione per cui segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica recuperata. Per segmentare più dimensioni 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 .
metricsSegmentInfo	Un segmento di metrica

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 dal computer.
details	errorDetail[]	dettagli dell'errore.
innererror	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore interno, se esistenti.
message	string	Messaggio di errore leggibile.

errorResponse

Dettagli errore.

Nome	Tipo	Descrizione
error	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore.

MetricId

ID della metrica. Si tratta di una metrica di intelligenza artificiale standard o di una metrica personalizzata specifica dell'applicazione.

Nome	Tipo	Descrizione
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

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.

Nome	Tipo	Descrizione
avg	string
count	string
max	string
min	string
sum	string
unique	string

metricsResult

Risultato della metrica.

Nome	Tipo	Descrizione
value	metricsResultInfo	Dati dei risultati della metrica.

metricsResultInfo

Dati dei risultati della metrica.

Nome	Tipo	Descrizione
end	string	Ora di inizio della metrica.
interval	string	Intervallo utilizzato per segmentare i dati delle metriche.
segments	metricsSegmentInfo[]	Dati delle metriche segmentati (se segmentati).
start	string	Ora di inizio della metrica.

MetricsSegment

Nome della dimensione per cui segmentare i valori delle metriche. Questa dimensione deve essere applicabile alla metrica recuperata. Per segmentare più dimensioni 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 .

Nome	Tipo	Descrizione
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

Un segmento di metrica

Nome	Tipo	Descrizione
end	string	Ora di inizio del segmento di metrica (solo quando è stato specificato un intervallo).
segments	metricsSegmentInfo[]	Dati delle metriche segmentati (se ulteriormente segmentati).
start	string	Ora di inizio del segmento di metrica (solo quando è stato specificato un intervallo).

Condividi tramite

Metrics - Get

Parametri dell'URI

Risposte

Sicurezza

oauth2

Ambiti

Esempio

intervaledMetric

Esempio di richiesta

Risposta di esempio

segmentedIntervaledMetric

Esempio di richiesta

Risposta di esempio

simpleMetric

Esempio di richiesta

Risposta di esempio

Definizioni

errorDetail

errorInfo

errorResponse

MetricId

MetricsAggregation

metricsResult

metricsResultInfo

MetricsSegment

metricsSegmentInfo

Risorse aggiuntive