list_notebook_executions

Retrieve execution history for a Microsoft Fabric notebook to view past job instances, states, and timing information for analysis and troubleshooting.

Instructions

List all Livy sessions (execution history) for a notebook.

Retrieves a list of all Livy sessions associated with a notebook, providing an execution history with job instance IDs, states, and timing information.

Use this tool when:

You want to see the execution history of a notebook
You need to find a job instance ID for a past execution
You want to analyze execution patterns over time

Parameters: workspace_name: The display name of the workspace containing the notebook. notebook_name: Name of the notebook. limit: Optional maximum number of sessions to return.

Returns: Dictionary with: - status: "success" or "error" - message: Description of the result - sessions: List of session summaries, each containing: - job_instance_id: Unique identifier for the job - livy_id: Livy session identifier - state: Execution state (Success, Failed, Cancelled, etc.) - operation_name: Type of operation (Notebook Scheduled Run, etc.) - spark_application_id: Spark application identifier - submitted_time_utc: When the job was submitted - start_time_utc: When execution started - end_time_utc: When execution ended - total_duration_seconds: Total execution time - total_count: Total number of sessions found

Example: ```python history = list_notebook_executions( workspace_name="Analytics", notebook_name="ETL_Pipeline", limit=10 )

if history["status"] == "success": print(f"Found {history['total_count']} executions") for session in history["sessions"]: print(f"{session['job_instance_id']}: {session['state']}") ```

Input Schema

TableJSON Schema

Name	Required	Description	Default
`workspace_name`	Yes
`notebook_name`	Yes
`limit`	No

ms-fabric-mcp-server