Skip to content

feat: Ballista Text User Interface#1436

Merged
milenkovicm merged 112 commits intoapache:mainfrom
martin-g:ballusta-tui-in-cli-2
Apr 8, 2026
Merged

feat: Ballista Text User Interface#1436
milenkovicm merged 112 commits intoapache:mainfrom
martin-g:ballusta-tui-in-cli-2

Conversation

@martin-g
Copy link
Copy Markdown
Member

@martin-g martin-g commented Feb 1, 2026

Which issue does this PR close?

Closes #1396

Rationale for this change

See #1396

What changes are included in this PR?

Initial version of the TUI app that includes:

  • new Cargo feature tui to include it as part of the CLI app
  • New CLI option --tui to start the TUI app
  • Header navigation (Dashboard, Jobs, Metrics)
  • Help popup (activate with ? or h)
  • Dashboard view (scheduler state and executors info)
  • Placeholder for the Jobs and Metrics views
  • Yaml configuration
    • hardcoded defaults
    • OS specific config (e.g. ~/.config/ballista/config.yaml)
    • env variables, e.g. BALLISTA_HTTP_TIMEOUT=3000

Are there any user-facing changes?

New option for the CLI application, --tui that starts the TUI application

@martin-g
Ballista Text User Interface app
820a10a 
Initial version of the TUI app that includes:
* new Cargo feature `tui` to include it as part of the CLI app
* New CLI option `--tui` to start the TUI app
* Header navigation (Dashboard, Jobs, Metrics)
* Help popup (activate with `?` or `h`)
* Dashboard view (scheduler state and executors info)
* Placeholder for the Jobs and Metrics views
* Yaml configuration
  * hardcoded defaults
  * OS specific config (e.g. ~/.config/ballista/config.yaml)
  * env variables, e.g. `BALLISTA_HTTP_TIMEOUT=3000`

Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g martin-g mentioned this pull request Feb 1, 2026
Closed
martin-g added 10 commits February 1, 2026 23:43
@martin-g
Merge branch 'main' into ballusta-tui-in-cli-2
b85e915
@martin-g
Align the contents of the Jobs & Metrics panes to the center
ef525b9 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Implement Debug for Views enum
09c1580 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Implement std Error & Display for TuiError
883db23 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Improve the error handling in http_client
d205a5a 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Tidy up the imports of the sub-modules
cfb841e 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Do not center the banner text
7ead2f5 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Simplify the layout for the content panel
8af4683 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Log a warning if the event bus is not available
6bbb0a1 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Merge branch 'main' into ballusta-tui-in-cli-2
97ea334 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Feb 21, 2026

@martin-g i hope you're not waiting for my review :)

@martin-g
Copy link
Copy Markdown
Member Author

martin-g commented Feb 23, 2026

@milenkovicm I'll continue working on it this week!
Should I implement all functionalities from #1396 before merging it or should we split it in smaller tasks ?

@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Feb 24, 2026

sorry @martin-g your question fall off my radar. IMHO it would be great to get some kind of MVP in the PR if possible, but it's up to you

@martin-g
Copy link
Copy Markdown
Member Author

martin-g commented Feb 24, 2026

I'll continue adding functionalities for the other views too (jobs & metrics)!

@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Feb 24, 2026

I'll try to get logical and physical plan as part of api this week

@martin-g
Do not wrap the plans in the popup
f7871a2 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Copy link
Copy Markdown
Member Author

martin-g commented Apr 4, 2026

an we make lines not to wrap, it would improve readability

removed the wrapping

martin-g added 12 commits April 4, 2026 08:40
@martin-g
Optimize imports
94a8ccd 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Use saturating_add() when incrementing job_dot_scroll
c870503 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
url encode the job id when constructing the REST request url
122f049 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Fix the scrollbar state in the jobs/metrics tables
623f1f8 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Use a special newtype struct for parsing the /api/metrics response
ae2ce67 
The MetricsData struct has some state fields which otherwise need to be
ignored

Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Use .clone() instead of .to_string()
2bd3815 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Implement source() for TuiError
ddb847f 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Simplify the logic for collecting the dis/enabled cargo features
acda8ca 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Parallelize the HTTP requests in Dashboard
a46e92c 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Log a debug when an unexpected/unsupported type of event comes
61b0220 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Cleanup
d29a578 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Simplify to avoid .clone()
445bdbe 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Apr 4, 2026

I would suggest to have jobs view as default

In that case maybe we should rename "Dashboard" to "Executors" ? "Dashboard" is usually the landing page in such kind of monitoring apps.

spark starts from jobs

image

in most cases users use ui to check job status,

@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Apr 4, 2026

#1543 has added more task related information. This kind of information gives users ability to diagnose skewed partitions.

@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Apr 5, 2026

I guess we could do stage related changes as a follow up, wdyt?

@martin-g
Add unit tests for the non-Ratatui functionality
4da4d42 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Copy link
Copy Markdown
Member Author

martin-g commented Apr 5, 2026

I guess we could do stage related changes as a follow up, wdyt?

It is up to you how much code you want to review at once :-)

martin-g added 3 commits April 6, 2026 00:45
@martin-g
Add some more tests
ef66564 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
fmt
4acb8fd 
Signed-off-by: Martin Tzvetanov Grigorov <mgrigorov@apache.org>
@martin-g
Merge branch 'main' into ballusta-tui-in-cli-2
fa39e35
milenkovicm
milenkovicm approved these changes Apr 8, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@milenkovicm milenkovicm left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @martin-g heroic effort, I like it a lot. We can add improvements later

@milenkovicm
Copy link
Copy Markdown
Contributor

milenkovicm commented Apr 8, 2026

image

@milenkovicm milenkovicm changed the title Ballista Text User Interface app feat: Ballista Text User Interface Apr 8, 2026
@milenkovicm milenkovicm merged commit 20cf268 into apache:main Apr 8, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@milenkovicm milenkovicm milenkovicm approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Add interactive TUI (Text User Interface) for cluster monitoring

3 participants

@martin-g @milenkovicm @kevinjqliu