Skip to content

Blog: GenAI observability two-part series (JBang + Spring Boot) - #1734

Merged
davsclaus merged 6 commits into
apache:mainfrom
atiaomar1978-hub:genai-observability-blog-posts
Aug 31, 2026
Merged

Blog: GenAI observability two-part series (JBang + Spring Boot)#1734
davsclaus merged 6 commits into
apache:mainfrom
atiaomar1978-hub:genai-observability-blog-posts

Conversation

@atiaomar1978-hub

@atiaomar1978-hub atiaomar1978-hub commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds Blog 1: Observe Your Camel AI Routes with GenAI OpenTelemetry — Camel CLI, Ollama, --observe, TUI Spans screenshot, and gen_ai.* metrics
  • Adds Blog 2: GenAI Observability with Spring Boot and the Camel Observability Stack — Actuator/Prometheus, VictoriaTraces OTLP, Perses, production checklist

Both posts are published (draft: false, date 2026-09-01).

Same format and attribution as #1728 (ClickHouse analytics blog).

Companion examples

Review feedback addressed (latest push 168521a)

  • Camel CLI terminology throughout (not JBang in prose)
  • Examples point to camel-jbang-examples and camel-spring-boot-examples
  • Fixed broken Observability Services link (/components/next/others/...)
  • Correct property: camel.aiObservability.enabled
  • Spring Boot route shown in Java; YAML variant optional in example repo
  • camel export hint and camel infra run observability documented
  • TUI Spans screenshot added to Part 1
  • Publication date 2026-09-01; draft: false
  • JIRA for CLI dependency auto-discovery: draft prepared (pending ASF filing)

Test plan

  • TUI Spans screenshot captured and embedded
  • Publication date and draft status set
  • Posts moved to content/blog/2026/09/ with updated cross-links

AI-generated on behalf of atiaomar1978-hub

Comment thread content/blog/2026/08/camel-genai-observability-jbang/index.md Outdated
Comment thread content/blog/2026/08/camel-genai-observability-jbang/index.md Outdated
Comment thread content/blog/2026/08/camel-genai-observability-jbang/index.md Outdated
Comment thread content/blog/2026/08/camel-genai-observability-jbang/index.md Outdated
Comment thread content/blog/2026/09/camel-genai-observability-jbang/index.md
Comment thread content/blog/2026/08/camel-genai-observability-spring-boot/index.md Outdated
Comment thread content/blog/2026/09/camel-genai-observability-spring-boot/index.md Outdated
Comment thread content/blog/2026/09/camel-genai-observability-spring-boot/index.md
Comment thread content/blog/2026/08/camel-genai-observability-spring-boot/index.md Outdated
Comment thread content/blog/2026/08/camel-genai-observability-spring-boot/index.md Outdated
@davsclaus

Copy link
Copy Markdown
Contributor

Loved that the blog also details how to do queries in prometheus. You may want to capture a few screenshots from TUI / Victoriatrace etc that helps readers that dont have time to try hands-on but want to see what it would look like "for real".

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

Thanks @davsclaus — latest push e9051a9 addresses the review items:

  • Part 1: TUI Spans screenshot added, publication date 2026-08-30, draft: false, Camel CLI terminology, example links to camel-jbang-examples PR #73, camel export hint, camel infra run observability alternative, property placeholder fix in the Java route
  • Part 2: example links to camel-spring-boot-examples PR #191, Java route in the blog (YAML optional in repo), camel infra run observability as Option A, camel.aiObservability.enabled corrected, comparison table uses CLI/TUI
  • JIRA for CLI dependency auto-discovery: draft ready — will file and link once created

Replied inline on each review thread. Happy to add VictoriaTraces/Perses screenshots in a follow-up if useful.

AI-generated on behalf of atiaomar1978-hub (Cursor Cloud Agent)

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

Re @davsclaus screenshot suggestion: Part 1 now includes a TUI Spans screenshot (e9051a9). VictoriaTraces/Perses screenshots could be a nice follow-up for Part 2 — happy to add if useful.

AI-generated on behalf of atiaomar1978-hub (Cursor Cloud Agent)

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

@davsclaus Please check this ticket for Auto-discovery
https://issues.apache.org/jira/browse/CAMEL-24566

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

Updated the publication date to 1 September 2026 (commit 168521a).

Changes:

  • Both posts now use date: 2026-09-01
  • Moved from content/blog/2026/08/ to content/blog/2026/09/
  • Updated Part 1 ↔ Part 2 cross-links to the new URLs:
    • /blog/2026/09/camel-genai-observability-jbang/
    • /blog/2026/09/camel-genai-observability-spring-boot/

AI-generated on behalf of atiaomar1978-hub

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

Fixed the TUI spans screenshot location and verified blog links (commit f146c2d).

Image fix

  • Moved camel-genai-observability-spans.png from content/blog/2026/08/camel-genai-observability-jbang/ to content/blog/2026/09/camel-genai-observability-jbang/ alongside the post
  • Hugo build confirms the image renders at ./camel-genai-observability-spans.png in the generated Part 1 page

Link verification

  • Part 1 ↔ Part 2 cross-links (/blog/2026/09/...) resolve correctly in Hugo build output
  • #observability-stack anchor exists in the Camel 4.22 what's new post
  • Live site checks (200): TUI manual, OpenTelemetry spans anchor, AI components, Observability Services, LangChain4j Spring Boot integration, camel422-whatsnew anchor
  • Fixed broken link: /manual/camel-jbang-jdk-installation.html (404) → /manual/camel-jbang.html (200)

Note: Example repo tree links (camel-jbang-examples/.../ai/genai-observability and camel-spring-boot-examples/.../genai-observability) return 404 until the companion PRs are merged; the PR links (#73, #191) resolve correctly.

AI-generated on behalf of atiaomar1978-hub

Omar Atie and others added 5 commits August 31, 2026 17:26
Publish camel.apache.org blog posts for Camel 4.23 GenAI observability:
JBang/TUI quick start and Spring Boot with Prometheus/VictoriaTraces.

Co-authored-by: Cursor <cursoragent@cursor.com>
- Use Camel CLI terminology instead of JBang in prose
- Point examples to camel-jbang-examples and camel-spring-boot-examples PRs
- Fix Observability Services link (/components/next/others/...)
- Use camel.aiObservability.enabled (correct property name)
- Mark posts as draft until publication date is set
- Remove inline Claus thanks; add camel infra, export, and Java route content
- Document CLI dependency auto-discovery as future improvement

Co-authored-by: Cursor Agent <noreply@cursor.com>
- Set draft: false and publication date 2026-08-30
- Add TUI Spans screenshot showing gen_ai OpenTelemetry attributes
- Fix route example to resolve property placeholders in Java builder
- Note pending JIRA for CLI dependency auto-discovery

Co-authored-by: Cursor Agent <noreply@cursor.com>
Move both posts from 2026/08/ to 2026/09/ and update cross-links.

Co-authored-by: Cursor <cursoragent@cursor.com>
- Move camel-genai-observability-spans.png alongside the September blog post
- Fix broken /manual/camel-jbang-jdk-installation.html link (404) to /manual/camel-jbang.html

Co-authored-by: Cursor <cursoragent@cursor.com>
@atiaomar1978-hub
atiaomar1978-hub force-pushed the genai-observability-blog-posts branch from b8d477c to 45e2ed7 Compare August 31, 2026 17:27
@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

AI-generated comment on behalf of Omar Atie

Rebased genai-observability-blog-posts onto latest main (includes upstream commit 249e2256fcsimple is removed).

Root cause: The fork branch was stale and still linked to /components/next/languages/csimple-language.html in content/blog/2020/12/Camel37-Whatsnew/index.md. That page was removed when csimple was deprecated; upstream main already dropped those links.

Fix: Force-pushed rebased branch (45e2ed781). No csimple-language links remain in the tree.

CI may show action_required until a maintainer approves workflow execution for this fork PR — after approval, check:links should pass.

@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

@davsclaus could u trigger CI build when u have a moment ?

Align Part 2 with camel-spring-boot-examples#192: camel infra run
observability, management port 9876, Micrometer Tracing OTLP export,
two-model YAML routes, Perses GenAI dashboard screenshots, and
camel.aiobservability.enabled property name.

Co-authored-by: Cursor <cursoragent@cursor.com>
@atiaomar1978-hub

Copy link
Copy Markdown
Contributor Author

AI-generated comment on behalf of Omar Atie

Pushed blog updates (fd4836df9) addressing @davsclaus's feedback on apache/camel-spring-boot-examples#192:

Part 2 (Spring Boot) — aligned with the reworked genai-observability example:

  • camel infra run observability (removed docker-compose path)
  • Metrics on /observe/metrics port 9876, VictoriaTraces on 10428, Perses on 3000
  • Two-model YAML routes, Micrometer Tracing + OTel bridge for working trace export
  • Perses GenAI dashboard section with screenshots from the example
  • camel.aiobservability.enabled property name

Part 1 (JBang) — minor cross-link and property name fixes.

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview is available at https://pr-1734--camel.netlify.app

1 similar comment
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Preview is available at https://pr-1734--camel.netlify.app

@davsclaus
davsclaus merged commit 35688fd into apache:main Aug 31, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants