Поделиться через


Query - Get

Выполнение запроса аналитики
Выполняет запрос аналитики для данных

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

Параметры URI

Имя В Обязательно Тип Описание
workspaceId
path True

string

Идентификатор рабочей области. Это идентификатор рабочей области из колонки Свойства в портал Azure.

query
query True

string

Запрос Аналитики. Дополнительные сведения о синтаксисе запросов Аналитики

timespan
query

string

duration

Необязательный элемент. Интервал времени для запроса данных. Это ISO8601 значение периода времени. Этот интервал времени применяется в дополнение к любому, что указано в выражении запроса.

Ответы

Имя Тип Описание
200 OK

queryResults

Все в порядке. Вызов API выполнен успешно, и результат запроса Аналитики находится в полезных данных ответа

Other Status Codes

errorResponse

Объект ответа об ошибке.

Безопасность

oauth2

Поток OAuth2 в Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

cross-workspace
simple-query

cross-workspace

Образец запроса

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

Пример ответа

{
  "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

Образец запроса

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

Пример ответа

x-ms-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
x-ms-correlation-request-id: 58a37988-2c05-427a-891f-5e0e1266fcc5
{
  "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"
        ]
      ]
    }
  ]
}

Определения

Имя Описание
column

Столбец таблицы.

errorDetail

Сведения об ошибке.

errorInfo

Код и сообщение об ошибке.

errorResponse

Сведения об ошибке.

logsColumnType

Тип данных этого столбца.

queryResults

Ответ запроса.

Render

Данные визуализации в формате JSON.

Statistics

Статистика представлена в формате JSON.

table

Таблица ответов запроса.

column

Столбец таблицы.

Имя Тип Описание
name

string

Имя этого столбца.

type

logsColumnType

Тип данных этого столбца.

errorDetail

Сведения об ошибке.

Имя Тип Описание
additionalProperties

object

Дополнительные свойства, которые могут быть предоставлены в объекте сведений об ошибке

code

string

Код ошибки.

message

string

Удобочитаемое сообщение об ошибке.

resources

string[]

Указывает ресурсы, ответственные за ошибку.

target

string

Указывает, какое свойство в запросе отвечает за ошибку.

value

string

Указывает, какое значение в target отвечает за ошибку.

errorInfo

Код и сообщение об ошибке.

Имя Тип Описание
additionalProperties

object

Дополнительные свойства, которые могут быть предоставлены в объекте сведений об ошибке

code

string

Код ошибки, доступный для чтения на компьютере.

details

errorDetail[]

сведения об ошибке.

innererror

errorInfo

Код и сообщение об ошибке.
Сведения о внутренних ошибках, если они существуют.

message

string

Удобочитаемое сообщение об ошибке.

errorResponse

Сведения об ошибке.

Имя Тип Описание
error

errorInfo

Код и сообщение об ошибке.
Сведения об ошибке.

logsColumnType

Тип данных этого столбца.

Имя Тип Описание
bool

string

datetime

string

decimal

string

dynamic

string

guid

string

int

string

long

string

real

string

string

string

timespan

string

queryResults

Ответ запроса.

Имя Тип Описание
error

errorInfo

Код и сообщение об ошибке.

render

Render

Данные визуализации в формате JSON.

statistics

Statistics

Статистика представлена в формате JSON.

tables

table[]

Список таблиц, столбцов и строк.

Render

Данные визуализации в формате JSON.

Statistics

Статистика представлена в формате JSON.

table

Таблица ответов запроса.

Имя Тип Описание
columns

column[]

Список столбцов в этой таблице.

name

string

Имя таблицы.

rows

object[]

Результирующие строки из этого запроса.