Отправка данных журнала в Log Analytics с помощью API сборщика данных HTTP

API сборщика данных HTTP Azure Log Analytics позволяет отправлять данные JSON в рабочую область Log Analytics с любого клиента, который может вызывать REST API. С помощью этого метода можно отправлять данные из сторонних приложений или из скриптов, например из модуля Runbook в службе автоматизации Azure

Запрос URI

Чтобы указать рабочую область Log Analytics, замените {CustomerID} на идентификатор рабочей области.

Метод	Запрос URI
Пост	https://{Идентификатор клиента}.ods.opinsights.azure.com/< Ресурс>?api-version=2016-04-01

Просьба	Параметры URI
Параметр	Описание
Идентификатор клиента	Уникальный идентификатор рабочей области Log Analytics
Ресурс	Имя ресурса API. /api/журналы
Версия API	Версия API, которая будет использоваться с этим запросом. Текущий момент 2016-04-01

Заголовки запросов

Заголовки запросов в следующей таблице являются обязательными.

Заголовок	Описание
Авторизация	Дополнительную информацию о создании заголовка HMAC-SHA256 смотрите ниже
Тип контента	Обязательное. Установите для этого значение application/json
Тип журнала	Позволяет указать имя отправляемого сообщения. В настоящее время тип Log поддерживает только буквенные символы. Он не поддерживает цифры или специальные символы
x-мс-дата	Дата обработки запроса в формате RFC 1123
поле времени генерации	Позволяет указать поле метки времени сообщения, которое будет использоваться в качестве поля TimeGenerated. Это позволяет настроить TimeGenerated так, чтобы он отражал фактическую метку времени из данных сообщения. Если это поле не указано, значение по умолчанию для TimeGenerated при приеме сообщения. Указанное поле сообщения должно соответствовать стандарту ISO 8601 стандарта YYYY-MM-DDThh:mm:ssZ

Заголовок авторизации

Любой запрос к API сборщика данных HTTP Log analytics должен содержать заголовок Authorization. Чтобы проверить подлинность запроса, необходимо подписать его первичным или вторичным ключом для рабочей области, в которой выполняется запрос, и передать эту подпись как часть запроса.

Формат заголовка Authorization следующий:

Authorization: SharedKey <WorkspaceID>:<Signature>

WorkspaceID — это уникальный идентификатор для рабочей области Log Analytics, а подпись — это код проверки подлинности сообщения на основе хэша (HMAC), созданный на основе запроса и вычисленный с помощью алгоритма SHA256, а затем закодированный с помощью кодировки Base64.

Создание строки сигнатуры

Чтобы закодировать строку подписи общего ключа, используйте следующий формат:

	StringToSign = VERB + "\n" +
	Content-Length + "\n" +
	Content-Type + "\n" +
	x-ms-date + "\n" +
	"/api/logs";

В следующем примере показана строка сигнатуры:

POST \n1024\napplication/json\nx-ms-date:Mon, 04 Apr 2016 08:00:00 GMT\n/api/logs

Затем закодируйте эту строку с помощью алгоритма HMAC-SHA256 над строкой подписи в кодировке UTF-8, создайте заголовок Authorization и добавьте заголовок в запрос.

Кодирование подписи

Чтобы закодировать подпись, вызовите алгоритм HMAC-SHA256 для строки подписи в кодировке UTF-8 и закодируйте результат как Base64. Используйте следующий формат (отображается в виде псевдокода):

Signature=Base64(HMAC-SHA256(UTF8(StringToSign)))

Основное содержание запроса

Текст сообщения, отправленного в конечную точку.

	{
	  "key1": "value1",
	  "key2": "value2",
	  "key3": "value3",
	  "key4": "value4"
	}

Вы можете объединить несколько сообщений одного типа в один текст запроса.

	[
	  {
	    "key1": "value1",
	    "key2": "value2",
	    "key3": "value3",
	    "key4": "value4"
	  },
	  {
	    "key1": "value5",
	    "key2": "value6",
	    "key3": "value7",
	    "key4": "value8"
	  }
	]

Ограничения данных

Существуют некоторые ограничения, связанные с данными, публикуемыми в API сбора данных Log Analytics.

• Не более 30 МБ на одну запись в API сборщика данных Log Analytics. Это ограничение размера для одной публикации. Если размер данных из одного поста превышает 30 МБ, следует разделить данные на более мелкие фрагменты и отправлять их одновременно.
• Не более 32 КБ для значений полей. Если значение поля превышает 32 КБ, данные будут усечены.
• Рекомендуемое максимальное количество полей для данного типа — 50. Это ограничение введено для удобства поиска и использования.

См. также

• API сборщика данных HTTP в Log Analytics