Query - Get

Referência

Service:: Log Analytics

API Version:: 2022-10-27_Preview

Executar uma consulta do Analytics
Executa uma consulta do Analytics para dados

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}

With optional parameters:

GET https://api.loganalytics.io/v1/workspaces/{workspaceId}/query?query={query}&timespan={timespan}

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
workspaceId	path	True	string	ID da área de trabalho. Este é o ID da Área de Trabalho do painel Propriedades no portal do Azure.
query	query	True	string	A consulta Análise. Saiba mais sobre a sintaxe da consulta do Analytics
timespan	query		string duration	Opcional. O período de tempo sobre o qual consultar dados. Trata-se de um valor ISO8601 período de tempo. Este intervalo de tempo é aplicado para além de todos os especificados na expressão de consulta.

Respostas

Name	Tipo	Description
200 OK	queryResults	OK. A chamada à API foi efetuada com êxito e o resultado da consulta do Analytics está no payload de resposta
Other Status Codes	errorResponse	Um objeto de resposta de erro.

Segurança

oauth2

Fluxo OAuth2 do Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

cross-workspace

simple-query

cross-workspace

Sample Request

HTTP

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=union * | where TimeGenerated > ago(1h) | summarize count() by Type, TenantId

Sample Response

Status code:: 200

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "Type",
          "type": "string"
        },
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "count_",
          "type": "long"
        }
      ],
      "rows": [
        [
          "Usage",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "Usage",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "BillingFact",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "1"
        ],
        [
          "BillingFact",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "1"
        ],
        [
          "Operation",
          "63613592-b6f7-4c3d-a390-22ba13102111",
          "7"
        ],
        [
          "Operation",
          "d436f322-a9f4-4aad-9a7d-271fbf66001c",
          "5"
        ]
      ]
    }
  ]
}

simple-query

Sample Request

HTTP

GET https://api.loganalytics.io/v1/workspaces/63613592-b6f7-4c3d-a390-22ba13102111/query?query=Usage | take 10&timespan=PT12H

Sample Response

Status code:: 200

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5

Response Body

{
  "tables": [
    {
      "name": "PrimaryResult",
      "columns": [
        {
          "name": "TenantId",
          "type": "string"
        },
        {
          "name": "Computer",
          "type": "string"
        },
        {
          "name": "TimeGenerated",
          "type": "datetime"
        },
        {
          "name": "SourceSystem",
          "type": "string"
        },
        {
          "name": "StartTime",
          "type": "datetime"
        },
        {
          "name": "EndTime",
          "type": "datetime"
        },
        {
          "name": "ResourceUri",
          "type": "string"
        },
        {
          "name": "LinkedResourceUri",
          "type": "string"
        },
        {
          "name": "DataType",
          "type": "string"
        },
        {
          "name": "Solution",
          "type": "string"
        },
        {
          "name": "BatchesWithinSla",
          "type": "long"
        },
        {
          "name": "BatchesOutsideSla",
          "type": "long"
        },
        {
          "name": "BatchesCapped",
          "type": "long"
        },
        {
          "name": "TotalBatches",
          "type": "long"
        },
        {
          "name": "AvgLatencyInSeconds",
          "type": "real"
        },
        {
          "name": "Quantity",
          "type": "real"
        },
        {
          "name": "QuantityUnit",
          "type": "string"
        },
        {
          "name": "IsBillable",
          "type": "bool"
        },
        {
          "name": "MeterId",
          "type": "string"
        },
        {
          "name": "LinkedMeterId",
          "type": "string"
        },
        {
          "name": "Type",
          "type": "string"
        }
      ],
      "rows": [
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "ContosoSQLSrv1",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.286",
          "0.076408",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ],
        [
          "b438b4f6-912a-46d5-9cb1-b44069212abc",
          "Store010Web3",
          "2017-08-24T06:59:59Z",
          "OMS",
          "2017-08-24T06:00:00Z",
          "2017-08-24T06:59:59Z",
          "/subscriptions/e4272367-5645-4c4e-9c67-3b74b59a6982/resourcegroups/contosoazurehq/providers/microsoft.operationalinsights/workspaces/contosoretail-it",
          null,
          "Perf",
          "LogManagement",
          "1",
          "0",
          "0",
          "1",
          "1.7",
          "0.106767",
          "MBytes",
          "true",
          "a4e29a95-5b4c-408b-80e3-113f9410566e",
          "00000000-0000-0000-0000-000000000000",
          "Usage"
        ]
      ]
    }
  ]
}

Definições

Name	Description
column	Uma coluna de tabela.
errorDetail	Detalhes do erro.
errorInfo	O código e a mensagem de um erro.
errorResponse	Detalhes do erro.
logsColumnType	O tipo de dados desta coluna.
queryResults	Uma resposta de consulta.
Render	Dados de visualização no formato JSON.
Statistics	Estatísticas representadas no formato JSON.
table	Uma tabela de resposta de consulta.

column

Uma coluna de tabela.

Name	Tipo	Description
name	string	O nome desta coluna.
type	logsColumnType	O tipo de dados desta coluna.

errorDetail

Detalhes do erro.

Name	Tipo	Description
additionalProperties	object	Propriedades adicionais que podem ser fornecidas no objeto de detalhes do erro
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	Propriedades adicionais que podem ser fornecidas no objeto de informações de erro
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.

logsColumnType

O tipo de dados desta coluna.

Name	Tipo	Description
bool	string
datetime	string
decimal	string
dynamic	string
guid	string
int	string
long	string
real	string
string	string
timespan	string

queryResults

Uma resposta de consulta.

Name	Tipo	Description
error	errorInfo	O código e a mensagem de um erro.
render	Render	Dados de visualização no formato JSON.
statistics	Statistics	Estatísticas representadas no formato JSON.
tables	table[]	A lista de tabelas, colunas e linhas.

Render

Dados de visualização no formato JSON.

Statistics

Estatísticas representadas no formato JSON.

table

Uma tabela de resposta de consulta.

Name	Tipo	Description
columns	column[]	A lista de colunas nesta tabela.
name	string	O nome da tabela.
rows	object[]	As linhas resultantes desta consulta.

Query - Get

Parâmetros do URI

Respostas

Segurança

oauth2

Scopes

Exemplos

cross-workspace

Sample Request

Sample Response

simple-query

Sample Request

Sample Response

Definições

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table

Recursos adicionais