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 nel pannello Impostazioni di 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 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.
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 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	query		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 `PT12H` ("ultime 12 ore"). L'intervallo di tempo effettivo su cui viene eseguita una query può essere regolato dal server basato su . 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 riuscita
Other Status Codes	errorResponse	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

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 delle metriche.
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 .
metricsSegmentInfo	Segmento di metrica

errorDetail

Object

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

Object

Codice e messaggio per un errore.

Nome	Tipo	Descrizione
additionalProperties	object
code	string	Codice di errore leggibile del computer.
details	errorDetail[]	dettagli dell'errore.
innererror	errorInfo	Codice e messaggio per un errore. Dettagli dell'errore interno, se presenti.
message	string	Messaggio di errore leggibile.

errorResponse

Object

Dettagli errore.

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

MetricId

Enumerazione

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

Enumerazione

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

metricsResult

Object

Risultato della metrica.

Nome	Tipo	Descrizione
value	metricsResultInfo	Dati dei risultati delle metriche.

metricsResultInfo

Object

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	metricsSegmentInfo[]	Dati delle metriche segmentati (se segmentati).
start	string (date_time)	Ora di inizio della metrica.

MetricsSegment

Enumerazione

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

Object

Segmento di metrica

Nome	Tipo	Descrizione
end	string (date_time)	Ora di inizio del segmento di metrica (solo quando è stato specificato un intervallo).
segments	metricsSegmentInfo[]	Dati delle metriche segmentati (se ulteriormente segmentati).
start	string (date_time)	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