Получение журналов Spark Livy с помощью API мониторинга Spark

Извлечь журналы Spark Livy.

Разрешения

The caller must have "read" permission on the item.

Обязательные делегированные области применения

Item.Read.All или Item.ReadWrite.All или одна из следующих трех групп (в соответствии с элементом, который активировал приложение Spark).

• Notebook.Read.All или Notebook.ReadWrite.All
• SparkJobDefinition.Read.All или SparkJobDefinition.ReadWrite.All
• Lakehouse.Read.All или Lakehouse.ReadWrite.All

Идентификаторы, поддерживаемые Microsoft Entra

Этот API поддерживает удостоверения Microsoft, перечисленные в этом разделе.

Идентичность	Поддержка
Пользователь	Да
Service principal and Managed identities	Да

Получить метаданные журнала Livy

Get metadata of Livy log.

Интерфейс

Без идентификатора попытки

https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy&meta=true

Параметры URI

Отсутствует

Ответы

Имя	Тип	Описание
200 OK	FileMeta	Запрос успешно завершен

Примеры

Пример запроса

GET https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/notebooks/bbbbcccc-1111-dddd-2222-eeee3333ffff/livySessions/ccccdddd-2222-eeee-3333-ffff4444aaaa/application/none/logs?type=livy&meta=true

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

{ 
   "fileName": "livy.log",
   "length": 34723, 
   "lastModified": "2025-03-05T12:11:17.000GMT", 
   "creationTime": "2025-03-05T12:10:42.000GMT", 
   "metaData": {} 
} 

Get Livy log content

Get file content of Livy log.

Интерфейс

Без идентификатора попытки

https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy

С использованием необязательных параметров:

Без идентификатора попытки

https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/notebooks|sparkJobDefinitions|lakehouses/{itemId}/livySessions/{livyId}/applications/none/logs?type=livy&isDownload={isDownload}&isPartial={isPartial}&offset={offset}&size={size}

Параметры URI

Имя	In	Обязательно	Тип	Описание
Идентификатор рабочего пространства	путь	Верно	строка UUID	Идентификатор рабочей области.
itemId	путь	Верно	строка UUID	The item ID of the notebook or Spark job definition or Lakehouse.
livyId	путь	Верно	строка UUID	Идентификатор сеанса Livy.
идентификатор приложения	путь	Верно	струна	Идентификатор приложения Spark, например application_1704417105000_0001.
isDownload	запрос	Неправда	bool	True to download the log file as a stream. По умолчанию: false.
isPartial	запрос	Неправда	bool	Вступают в силу только в том случае, если значение isDownload имеет значение true. True to download a part of file content according to the given offset and size. По умолчанию установите значение false, чтобы скачать весь файл.
смещение, размер	запрос	Неправда	Long	Начальное смещение (в байтах) и размер (в байтах) для чтения содержимого файла. Вступают в силу только в том случае, если isDownload = true и isPartial = true. - For offset, the default value is 0, meaning reading from the beginning of the file — Для размера значение по умолчанию — 1M (1024*1024) байт

Ответы

Имя	Тип	Описание
200 OK	FileMeta	Запрос успешно завершен

Примеры

Пример запроса

GET https://api.fabric.microsoft.com/v1/workspaces/aaaabbbb-0000-cccc-1111-dddd2222eeee/notebooks/bbbbcccc-1111-dddd-2222-eeee3333ffff/livySessions/ccccdddd-2222-eeee-3333-ffff4444aaaa/application/none/logs?type=livy

Определения

FileMeta

Объект

Метаданные файла журнала

Имя	Тип	Описание
имя файла	струна	Имя файла
длина	длинный	Размер файла в байтах
последнееИзменение	струна	Время последнего изменения файла
время создания	струна	Время создания файла
metaData	сопоставление строк с строкой	Вспомогательные данные, если есть какие-либо