Query - Get

Ссылка

Служба:: Log Analytics

Версия API:: 2022-10-27_Preview

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

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	Запрос аналитики. Дополнительные сведения о синтаксисе запросов Analytics
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

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

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

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

Код состояния:: 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

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

HTTP

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

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

Код состояния:: 200

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

Object

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

Имя	Тип	Описание
name	string	Имя этого столбца.
type	logsColumnType	Тип данных этого столбца.

errorDetail

Object

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

Имя	Тип	Описание
additionalProperties	object	Дополнительные свойства, которые можно предоставить в объекте сведений об ошибке
code	string	Код ошибки.
message	string	Сообщение об ошибке, доступное для чтения.
resources	string[]	Указывает ресурсы, ответственные за ошибку.
target	string	Указывает, какое свойство в запросе отвечает за ошибку.
value	string	Указывает, какое значение в target отвечает за ошибку.

errorInfo

Object

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

Имя	Тип	Описание
additionalProperties	object	Дополнительные свойства, которые можно предоставить в объекте сведений об ошибке
code	string	Код ошибки, доступный для чтения компьютером.
details	errorDetail[]	сведения об ошибке.
innererror	errorInfo	Код и сообщение об ошибке. Сведения о внутренней ошибке, если они существуют.
message	string	Сообщение об ошибке, доступное для чтения.

errorResponse

Object

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

Имя	Тип	Описание
error	errorInfo	Код и сообщение об ошибке. Сведения об ошибке.

logsColumnType

Перечисление

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

Значение	Описание
bool
datetime
decimal
dynamic
guid
int
long
real
string
timespan

queryResults

Object

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

Имя	Тип	Описание
error	errorInfo	Код и сообщение об ошибке.
render	Render	Данные визуализации в формате JSON.
statistics	Statistics	Статистика представлена в формате JSON.
tables	table[]	Список таблиц, столбцов и строк.

Render

Object

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

Statistics

Object

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

table

Object

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

Имя	Тип	Описание
columns	column[]	Список столбцов в этой таблице.
name	string	Название таблицы.
rows	object[]	Полученные строки из этого запроса.

Подключайтесь, создавайте код и развивайтесь

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

Параметры URI

Ответы

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

oauth2

Области

Примеры

cross-workspace

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

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

simple-query

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

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

Определения

column

errorDetail

errorInfo

errorResponse

logsColumnType

queryResults

Render

Statistics

table