Metrics - Get Multiple

Referência

Serviço:: Application Insights

Versão da API:: v1

Obter dados de métricas
Obtém valores de métricas para várias métricas

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
appId	path	True	string	ID da aplicação. Este é o ID da Aplicação no painel definições de Acesso à API no portal do Azure.

Corpo do Pedido

Name	Tipo	Description
body	metricsPostBodySchema[]	A consulta de métricas em lote.

Respostas

Name	Tipo	Description
200 OK	metricsResults[]	Resposta bem-sucedida
Other Status Codes	errorResponse	Um objeto de resposta de erro.

Segurança

oauth2

Ligar à API do Aplicação Azure Insights

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize?resource=https%3A%2F%2Fapi.applicationinsights.io

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

postMetric

Pedido de amostra

HTTP

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"
    }
  }
]

Resposta da amostra

Código de estado:: 200

[
  {
    "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
            }
          }
        ]
      }
    }
  }
]

Definições

Name	Description
errorDetail	Detalhes do erro.
errorInfo	O código e a mensagem de um erro.
errorResponse	Detalhes do erro.
MetricId	ID da métrica. Trata-se de uma métrica de IA padrão ou de uma métrica personalizada específica da aplicação.
MetricsAggregation	A agregação a utilizar ao calcular os valores das métricas. Para obter mais do que uma agregação de cada vez, separe-as com uma vírgula. Se não for especificada nenhuma agregação, é utilizada a agregação predefinida para a métrica.
metricsPostBodySchema	Um pedido de métrica
metricsResult	Um resultado de métrica.
metricsResultInfo	Dados de resultados de métricas.
metricsResults	Um conjunto de resultados de métricas.
MetricsSegment	O nome da dimensão pela qual segmentar os valores das métricas. Esta dimensão tem de ser aplicável à métrica que está a obter. Para segmentar por mais do que uma dimensão de cada vez, separe-as com uma vírgula (,). Neste caso, os dados de métricas serão segmentados pela ordem em que as dimensões são listadas no parâmetro.
metricsSegmentInfo	Um segmento de métrica
Parameters	Os parâmetros de uma única consulta de métricas

errorDetail

Detalhes do erro.

Name	Tipo	Description
additionalProperties	object
code	string	O código do erro.
message	string	Uma mensagem de erro legível por humanos.
resources	string[]	Indica os recursos responsáveis pelo erro.
target	string	Indica que propriedade no pedido é responsável pelo erro.
value	string	Indica qual o valor em "destino" responsável pelo erro.

errorInfo

O código e a mensagem de um erro.

Name	Tipo	Description
additionalProperties	object
code	string	Um código de erro legível por computador.
details	errorDetail[]	detalhes do erro.
innererror	errorInfo	O código e a mensagem de um erro. Detalhes do erro interno se existirem.
message	string	Uma mensagem de erro legível por humanos.

errorResponse

Detalhes do erro.

Name	Tipo	Description
error	errorInfo	O código e a mensagem de um erro. Os detalhes do erro.

MetricId

ID da métrica. Trata-se de uma métrica de IA padrão ou de uma métrica personalizada específica da aplicação.

Name	Tipo	Description
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

A agregação a utilizar ao calcular os valores das métricas. Para obter mais do que uma agregação de cada vez, separe-as com uma vírgula. Se não for especificada nenhuma agregação, é utilizada a agregação predefinida para a métrica.

Name	Tipo	Description
avg	string
count	string
max	string
min	string
sum	string
unique	string

metricsPostBodySchema

Um pedido de métrica

Name	Tipo	Description
id	string	Um identificador para esta consulta. Tem de ser exclusivo no corpo da mensagem do pedido. Este identificador será a propriedade "id" do objeto de resposta que representa esta consulta.
parameters	Parameters	Os parâmetros de uma única consulta de métricas

metricsResult

Um resultado de métrica.

Name	Tipo	Description
value	metricsResultInfo	Dados de resultados de métricas.

metricsResultInfo

Dados de resultados de métricas.

Name	Tipo	Description
end	string	Hora de início da métrica.
interval	string	O intervalo utilizado para segmentar os dados de métricas.
segments	metricsSegmentInfo[]	Dados de métrica segmentados (se segmentados).
start	string	Hora de início da métrica.

metricsResults

Um conjunto de resultados de métricas.

Name	Tipo	Description
body	metricsResult	Os resultados desta consulta de métricas.
id	string	O ID especificado para esta métrica.
status	integer	O código de estado HTTP desta consulta de métrica.

MetricsSegment

O nome da dimensão pela qual segmentar os valores das métricas. Esta dimensão tem de ser aplicável à métrica que está a obter. Para segmentar por mais do que uma dimensão de cada vez, separe-as com uma vírgula (,). Neste caso, os dados de métricas serão segmentados pela ordem em que as dimensões são listadas no parâmetro.

Name	Tipo	Description
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

Um segmento de métrica

Name	Tipo	Description
end	string	Hora de início do segmento de métricas (apenas quando foi especificado um intervalo).
segments	metricsSegmentInfo[]	Dados de métricas segmentados (se forem segmentados).
start	string	Hora de início do segmento de métricas (apenas quando foi especificado um intervalo).

Parameters

Os parâmetros de uma única consulta de métricas

Name	Tipo	Description
aggregation	MetricsAggregation[]	A agregação a utilizar ao calcular os valores das métricas. Para obter mais do que uma agregação de cada vez, separe-as com uma vírgula. Se não for especificada nenhuma agregação, é utilizada a agregação predefinida para a métrica.
filter	string	Uma expressão utilizada para filtrar os resultados. Este valor deve ser uma expressão de filtro OData válida onde as chaves de cada cláusula devem ser dimensões aplicáveis para a métrica que está a obter.
interval	string	O intervalo de tempo a utilizar ao obter valores de métricas. Esta é uma duração ISO8601. Se o intervalo for omitido, o valor da métrica é agregado em todo o intervalo de tempo. Se o intervalo for fornecido, o servidor poderá ajustar o intervalo para um tamanho mais adequado com base no intervalo de tempo utilizado para a consulta. Em todos os casos, o intervalo real utilizado para a consulta está incluído na resposta.
metricId	MetricId	ID da métrica. Trata-se de uma métrica de IA padrão ou de uma métrica personalizada específica da aplicação.
orderby	string	A função de agregação e a direção para ordenar os segmentos por. Este valor só é válido quando o segmento é especificado.
segment	MetricsSegment[]	O nome da dimensão pela qual segmentar os valores das métricas. Esta dimensão tem de ser aplicável à métrica que está a obter. Para segmentar por mais do que uma dimensão de cada vez, separe-as com uma vírgula (,). Neste caso, os dados de métricas serão segmentados pela ordem em que as dimensões são listadas no parâmetro.
timespan	string	O intervalo de tempo sobre o qual obter valores de métricas. Trata-se de um valor ISO8601 período de tempo. Se o intervalo de tempo for omitido, é utilizado um intervalo de tempo predefinido de `PT12H` ("últimas 12 horas"). O período de tempo real que é consultado pode ser ajustado pelo servidor com base no servidor. Em todos os casos, o intervalo de tempo real utilizado para a consulta está incluído na resposta.
top	integer	O número de segmentos a devolver. Este valor só é válido quando o segmento é especificado.

Partilhar via