Abrufen von Spark Livy-Protokollen mithilfe von Spark-Überwachungs-APIs

Rufen Sie Spark Livy-Protokolle ab.

Erlaubnisse

Die aufrufende Person muss über die Berechtigung „Lesen“ für das Element verfügen.

Erforderliche delegierte Bereiche

Item.Read.All oder Item.ReadWrite.All oder eine der folgenden drei Gruppen (entsprechend dem Element, das die Spark-Anwendung ausgelöst hat).

• Notebook.Read.All oder Notebook.ReadWrite.All
• SparkJobDefinition.Read.All oder SparkJobDefinition.ReadWrite.All
• Lakehouse.Read.All oder Lakehouse.ReadWrite.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität	Unterstützung
Benutzer	Ja
Dienstprinzipal und verwaltete Identitäten	Ja

Abrufen von Livy-Protokollmetadaten

Hier rufen Sie die Metadaten des Livy-Protokolls ab.

Schnittstelle

Ohne attemptId

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

URI-Parameter

Nichts

Antworten

Name	Typ	BESCHREIBUNG
200 OK	FileMeta	Anforderung erfolgreich abgeschlossen

Beispiele

Musteranforderung

GET https://api.fabric.microsoft.com/v1/workspaces/6e335e92-a2a2-4b5a-970a-bd6a89fbb765/notebooks/cfafbeb1-8037-4d0c-896e-a46fb27ff229/livySessions/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/application/none/logs?type=livy&meta=true

Statuscode: 200

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

Abrufen von Livy-Protokollinhalten

Dateiinhalte des Livy-Protokolls abrufen.

Schnittstelle

Ohne attemptId

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

Mit optionalen Parametern:

Ohne attemptId

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-Parameter

Name	Geben Sie in	Erforderlich	Typ	BESCHREIBUNG
Arbeitsbereichs-ID	Pfad	Richtig	string uuid	Die Arbeitsbereichs-ID.
itemId	Pfad	Richtig	string uuid	Dies ist die Element-ID des Notebooks oder der Spark-Auftragsdefinition oder des Lakehouse.
livyId	Pfad	Richtig	string uuid	Die Livy-Sitzungs-ID.
Anwendungs-ID	Pfad	Richtig	Schnur	Die Spark-Anwendungs-ID, z. B. application_1704417105000_0001.
isDownload	Abfrage	Falsch	Boolesch	Aktivieren Sie "True", um die Protokolldatei als Stream herunterzuladen. Der Standardwert lautet „false“.
isPartial	Abfrage	Falsch	Boolesch	Wird nur wirksam, wenn isDownload „true“ ist. „True“, um einen Teil des Dateiinhalts entsprechend dem angegebenen Offset und der Größe herunterzuladen. Der Standardwert zum Herunterladen der gesamten Datei lautet „false.“
offset, size	Abfrage	Falsch	Long	Der Anfangsoffset (in Byte) und die Größe (in Byte), um den Dateiinhalt zu lesen. Nur wirksam, wenn isDownload und isPartial jeweils „true“ sind. – Bei Offset ist der Standardwert 0, d  h. es wird vom Anfang der Datei gelesen. – Für die Größe ist der Standardwert 1M Bytes (1024*1024).

Antworten

Name	Typ	BESCHREIBUNG
200 OK	FileMeta	Anforderung erfolgreich abgeschlossen

Beispiele

Musteranforderung

GET https://api.fabric.microsoft.com/v1/workspaces/6e335e92-a2a2-4b5a-970a-bd6a89fbb765/notebooks/cfafbeb1-8037-4d0c-896e-a46fb27ff229/livySessions/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7/application/none/logs?type=livy

Definitionen

FileMeta

Objekt

Metadaten einer Protokolldatei

Name	Typ	BESCHREIBUNG
fileName	Schnur	Dateiname
length	long	Die Größe der Datei in Byte
lastModified	Schnur	Zeitpunkt der letzten Änderung der Datei
Erstellungszeit	Schnur	Der Zeitpunkt, zu dem die Datei erstellt wurde
Metadaten	Zuordnen einer Zeichenfolge zu einer Zeichenfolge:	Hilfsdaten, falls vorhanden