This is an automated email from the ASF dual-hosted git repository.
davsclaus pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push:
new 6f72af6c65ee CAMEL-24003: Fix activityEnabled gating, update TUI docs
and help text
6f72af6c65ee is described below
commit 6f72af6c65ee961e64575046ced100f5944f1f9e
Author: Claus Ibsen <[email protected]>
AuthorDate: Mon Jul 13 15:51:15 2026 +0200
CAMEL-24003: Fix activityEnabled gating, update TUI docs and help text
- ActivityEventNotifier.isDisabled() now checks activityEnabled flag
- Update TUI doc page with correct tab numbers and Activity tab section
- Fix Activity help text to show p50/p95/Max (not Avg/Max)
- Add Select Tab setting to docs, remove stale Health badge reference
- Move Health to More submenu in tab table
Co-Authored-By: Claude Opus 4.6 <[email protected]>
Signed-off-by: Claus Ibsen <[email protected]>
---
.../apache/camel/impl/debugger/BacklogTracer.java | 2 +-
.../modules/ROOT/pages/camel-jbang-tui.adoc | 49 +++++++++++++++-------
.../dsl/jbang/core/commands/tui/ActivityTab.java | 2 +-
3 files changed, 37 insertions(+), 16 deletions(-)
diff --git
a/core/camel-base-engine/src/main/java/org/apache/camel/impl/debugger/BacklogTracer.java
b/core/camel-base-engine/src/main/java/org/apache/camel/impl/debugger/BacklogTracer.java
index 1e5d07c7d77f..059388f860d5 100644
---
a/core/camel-base-engine/src/main/java/org/apache/camel/impl/debugger/BacklogTracer.java
+++
b/core/camel-base-engine/src/main/java/org/apache/camel/impl/debugger/BacklogTracer.java
@@ -817,7 +817,7 @@ public class BacklogTracer extends ServiceSupport
implements org.apache.camel.sp
@Override
public boolean isDisabled() {
- return !enabled && !standby;
+ return !activityEnabled || (!enabled && !standby);
}
@Override
diff --git a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui.adoc
b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui.adoc
index c5d3691dd548..d43a69d2e4d9 100644
--- a/docs/user-manual/modules/ROOT/pages/camel-jbang-tui.adoc
+++ b/docs/user-manual/modules/ROOT/pages/camel-jbang-tui.adoc
@@ -72,22 +72,41 @@ to any tab, or use *Tab* / *Shift+Tab* to cycle.
| 1 | Overview | All running integrations and infrastructure services. Start
here.
| 2 | Log | Real-time application logs with search and filtering.
-| 3 | Diagram | Visual route topology with drill-down into individual routes.
-| 4 | Routes | Route list with message counts, throughput, and processing
times.
-| 5 | Endpoints | All registered endpoints with usage statistics.
-| 6 | HTTP | HTTP endpoints with details.
-| 7 | Health | Health check status.
+| 3 | Activity | Live exchange activity with elapsed times, endpoint sends,
and failure tracking.
+| 4 | Diagram | Visual route topology with drill-down into individual routes.
+| 5 | Routes | Route list with message counts, throughput, and processing
times.
+| 6 | Endpoints | All registered endpoints with usage statistics.
+| 7 | HTTP | HTTP endpoints with details.
| 8 | Inspect | Message history and tracing -- step through exchanges
processor by processor.
| 9 | Errors | Failures with stack traces and exchange context.
-| 0 | More | Additional tabs: Beans, Browse, Circuit Breaker, Classpath,
Configuration, Consumers, Inflight, Memory, Metrics, Process, Spans, Startup,
Threads.
+| 0 | More | Additional tabs: Beans, Browse, Circuit Breaker, Classpath,
Configuration, Consumers, CVE Audit, Health, Inflight, Memory, Metrics, Spans,
Process, Startup, and more.
|===
-Tab badges show live counts -- the Errors tab shows a red badge when errors
exist,
-Health shows a badge when checks are DOWN, and Routes shows the route count.
+Tab badges show live counts -- the Errors tab shows a red badge when errors
exist
+and Routes shows the route count.
+
+== Activity
+
+The Activity tab (Tab 3) shows a live feed of exchange activity -- every
exchange that flows through
+the system is captured with its route, status (OK or Failed), elapsed time,
endpoint sends, and
+how long ago it completed.
+
+Activity data is captured when the integration runs in development mode (the
`dev` profile), which is
+the default when running with `camel run`. Activity tracking can also be
explicitly enabled via
+`camel.trace.activityEnabled=true` in `application.properties`. On a
production profile without
+dev mode or explicit enablement, the tab is empty.
+
+The top panel shows aggregated statistics: total / OK / failed exchange
counts, total sends,
+p50 / p95 / max elapsed times, and the time window of the visible entries.
+
+Select an exchange to see its details below: exchange ID, route, elapsed time,
the remote endpoints
+called during the exchange with individual timings, and exception details if
the exchange failed.
+
+Use *s* to cycle sort order, *S* to reverse, and *F5* to clear the activity
list.
== Route Topology Diagram
-The Diagram tab (Tab 3) renders the route topology as interactive ASCII art.
It shows how routes
+The Diagram tab (Tab 4) renders the route topology as interactive ASCII art.
It shows how routes
connect to each other through shared endpoints (direct, seda, kafka, etc.).
image::jbang/camel-tui-topology-diagram.svg[Diagram topology view]
@@ -134,7 +153,7 @@
image::jbang/camel-tui-topology-diagram-external.svg[Diagram with external endpo
== Message Insight
-The Inspect tab (Tab 8) lets you step through an exchange processor by
processor -- like
+The Inspect tab lets you step through an exchange processor by processor --
like
scrubbing through a video timeline of your message's journey. This is the key
to understanding
what Camel does with your data at every step.
@@ -207,12 +226,12 @@ Press *F5* to clear captured traces.
== Troubleshooting Errors
-The Errors tab (Tab 9) collects failures with full stack traces and exchange
context.
+The Errors tab collects failures with full stack traces and exchange context.
When errors occur, a red badge appears on the tab.
image::jbang/camel-tui-topology-errors.svg[Errors tab with failure details]
-For deeper troubleshooting, switch to the Inspect tab (Tab 8) and use the
diagram replay
+For deeper troubleshooting, switch to the Inspect tab and use the diagram
replay
(press *d*) to visualize exactly where the failure occurred:
* Failed steps are highlighted in red on the diagram
@@ -328,14 +347,16 @@ Open the *F2* actions menu and choose *Settings...* to
change TUI preferences in
* *Theme* -- cycle between *dark* and *light* (applied immediately on save).
* *Starting Tab* -- the tab shown when the TUI launches; any tab (primary or
under *More*) can be
chosen. Defaults to *Overview*.
+* *Select Tab* -- the tab to switch to when selecting an integration from the
Overview tab.
+ Defaults to *Log*.
* *Default Folder* -- the folder pre-filled in *Run from Folder*. The most
recently used folder
still takes precedence; this default is used only when there is no
remembered folder.
-Use *↑*/*↓* to move between rows, *Space* (or *←*/*→*) to cycle the theme and
starting tab, type to
+Use *↑*/*↓* to move between rows, *Space* (or *←*/*→*) to cycle the theme and
tab settings, type to
edit the default folder, *Enter* to save, and *Esc* to cancel.
Settings are stored under `camel.tui.*` keys (`camel.tui.theme`,
`camel.tui.startTab`,
-`camel.tui.defaultFolder`) in the Camel CLI configuration file. Each key is
read from and
+`camel.tui.selectTab`, `camel.tui.defaultFolder`) in the Camel CLI
configuration file. Each key is read from and
written back to the file where it currently lives: a key present in the local
`./camel-cli.properties` is treated as a project-level override and stays
local, while every
other key defaults to the global `~/.camel-cli.properties`. This means a
project can
diff --git
a/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/ActivityTab.java
b/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/ActivityTab.java
index 8dae1ef1df82..52bc50b324c8 100644
---
a/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/ActivityTab.java
+++
b/dsl/camel-jbang/camel-jbang-plugin-tui/src/main/java/org/apache/camel/dsl/jbang/core/commands/tui/ActivityTab.java
@@ -430,7 +430,7 @@ class ActivityTab extends AbstractTableTab {
- **Total** / **OK** / **Failed** — exchange counts
- **Sends** — total remote endpoint calls across all exchanges
- - **Avg** / **Max** — elapsed time statistics
+ - **p50** / **p95** / **Max** — elapsed time statistics
- **Window** — how far back the oldest and newest entries are
## Activity List
