cancel
Showing results forย 
Search instead forย 
Did you mean:ย 
Data Engineering
Join discussions on data engineering best practices, architectures, and optimization strategies within the Databricks Community. Exchange insights and solutions with fellow data engineers.
cancel
Showing results forย 
Search instead forย 
Did you mean:ย 

Dashboard "Export as HTML" fails for job-associated notebook dashboards (UI only)

amrim
New Contributor III

Context:
A notebook is scheduled to run as a Databricks Job. The notebook has an associated dashboard. When viewing the dashboard from the job run, exporting via "Export as HTML" fails.

amrim_0-1782980409213.png

Error:
When clicking "Export as HTML," the download fails and the following error is displayed:

amrim_1-1782980423193.png
 
{"error_code":"INVALID_PARAMETER_VALUE","message":"Path (???) doesn't start with '/'"}

Environment:

  • Databricks Runtime: 16.4.27
  • Cluster: d3.2xlarge driver, d3.2xlarge workers, 1โ€“4 workers, On-demand and Spot (falls back to On-demand), autoscaling enabled

Reproduction / isolation:

Method Result
Export from dashboard in interactive modeโœ… Works
Export from job-run dashboard via UI ("Export as HTML")โŒ Fails (error above)
Export from job-run dashboard via API (api/2.2/jobs/runs/export)โœ… Works
1 REPLY 1

Louis_Frolio
Databricks Employee
Databricks Employee

Greetings @amrim , this is a well-scoped report, and your isolation table does most of the diagnostic work for us.

Thanks for laying it out that way.

The behavior you documented is consistent, and it points at the product, not your notebook or cluster. Same dashboard, three export paths, and only the job-run UI button fails while interactive export and the Jobs API export both work. That rules out the dashboard content, the runtime, and the cluster, so the DBR 16.4.27 and cluster details, while good to include, are almost certainly not the cause here.

The error you hit, {"error_code":"INVALID_PARAMETER_VALUE","message":"Path (???) doesn't start with '/'"}, is the path validator rejecting an invalid or empty value: it expected an absolute workspace path and got something that is not one. This matches a UI-side regression that has been reproduced internally, affecting notebook dashboards viewed from a job run. The Jobs API path avoids the problem because runs/export takes the run_id directly and never has to resolve a workspace path, which is why that route keeps working.

Two workarounds while the fix is pending:

  1. Export via the Jobs API instead of the job-run UI. This is the reliable route, and the one to use if you need this run's exact output:
    • Endpoint: POST /api/2.2/jobs/runs/export
    • Parameters: run_id for the run, and views_to_export=DASHBOARDS (use ALL if you also want the notebook code)
    • Response: one HTML string per dashboard in the views array
    • Caveat: this endpoint only exports notebook task runs, so it fits your case but will not cover non-notebook task types.
  2. Open the notebook and its dashboard in interactive mode and export from there, which you already confirmed works. One thing to keep in mind: interactive export re-renders with current data, so it will not reproduce the exact snapshot from that specific job run. Use this only when a fresh render is acceptable.

If you have not already, I'd file this with Databricks support and include your workspace, the run_id, and a rough timestamp so they can tie it to the request logs, then reference this thread. That gives whoever picks it up a clean starting point.

Until the fix ships, the API export is your dependable path, and it is the better option for anything you want to automate anyway.

Regards,
Louis