OpenTelemetry Demo 3.0

We are planning a blog post to share more details about this major release. Stay tuned on opentelemetry.io/blog.

💥 Breaking changes

Telemetry attribute renaming to the demo.* prefix. Custom demo attributes previously used the app.* prefix, which conflicts with client-side instrumentation conventions. All demo-specific attributes have been renamed to demo.* across every business domain. If you have dashboards, alerts, or queries referencing the old app.* attributes, they will need to be updated.

• Product: demo.product.id, demo.product.name, demo.product.quantity, demo.product.count, demo.product.recommended.count, demo.product.review.question (#3355, #3370, #3371, #3372, #3374, #3376, #3454)
• Ad: demo.ad.* (#3387)
• Order, Cart, Payment: demo.order.*, demo.cart.*, demo.payment* (#3389, #3390, #3484)
• Shipping: demo.shipping.* (#3391)
• Exchange, User Context, Recommendation, Notification, Other (#3393)
• Metrics: demo.ads.ad_requests, demo.cart.add_item.latency, demo.cart.get_cart.latency, demo.currency, demo.payment.transactions, plus remaining recommendation/review metrics (#3399, #3401)
• Duplicate frontend request metric removed (#3400)
• Dropped email-recipient attribute removed for privacy (#3397)
• Misc attribute domain dissolved into proper categories (#3482)
• Final cleanup of leftover naming (#3435)

All by @fbourgey.

Services removed:

• product-reviews service removed, including its frontend and load-generator references (#3567, #3568, #3587) by @julianocosta89
• LLM service removed (#3599) by @julianocosta89
• Tracetest removed (#3602) by @julianocosta89

🚀 Deployment modes

• Modular Docker Compose with layered -f files, so services can be composed selectively (#3229) by @puckpuck
• Podman support added alongside Docker (#3307) by @osullivandonal
• Opt-in read-only root filesystem for checkout, product-catalog, and shipping (#3658) by @bhuvan-somisetty
• Generated Kubernetes manifests removed from the repo (#3236) by @puckpuck

Agentic

New Agent, MCP, and Chatbot services added to the demo (#3455) by @fali007, plus follow-up hardening:

• Services moved to the OTLP HTTP exporter (#3745) by @julianocosta89
• Fixed VCR fuzzy match (#3749) by @fali007
• Fixed MCP/Agent pod dependency ordering (#3609) and documentation issues (#3588) by @fali007
• CHATBOT_HOST/CHATBOT_PORT wiring fixed in the frontend-proxy compose file (#3570) by @ps48

Profiling

• OTel Collector eBPF profiler support added via firepit (#3333) by @osullivandonal
• firepit bumped to its first tagged release, v0.1.0 (#3524) by @florianl
• Resource attributes added to profiles (#3659) by @julianocosta89

📊 Self-observability & OpAMP Server

• Self-observability dashboard added (#3621), extended to fraud-detection and the Kafka Java service (#3653) by @cijothomas
• OpAMP status reporting for the Collector (#3566) by @cijothomas
• Events by Name dashboard added (#3691) with filters (#3697) by @cijothomas
• Exemplar-to-logs navigation added in Grafana (#3617) by @cijothomas
• Host metadata resource attributes added via the resourcedetector processor (#3417) by @osullivandonal
• gen_ai_normalizer processor added for Traceloop telemetry (#3604) by @ps48
• Grafana bumped to 13.0.1 with a provisioned default-email receiver (#3288) by @tolzhabayev
• Cart exemplars dashboard fixed to use demo_cart metrics (#3436) by @fbourgey

🧪 Load generator overhaul

• Replaced Locust with k6 as the load-generation engine (#3564) by @mwimpelberg28

✨ Other notable changes

• Kafka metrics exporter added to the Collector (#3158) by @Red-GV, with KAFKA_ADDR (#3219) and KAFKA_TOPIC (#3665) environment variables added by @julianocosta89 and @ryanfaircloth
• New service.criticality demo attribute (#2950) by @bachgarash
• enduser.id propagated as a span attribute and W3C baggage across frontend, ad, and payment (#3366) by @dpacheconr
• More realistic PostgreSQL setup with dedicated users, database, and monitoring (#3153) by @cyrille-leclerc
• Weaver configuration added for all telemetry, with a generated mkdocs site (telemetry-docs) (#2794) by @martinjt
• DSN-derived attributes added to product-catalog DB telemetry (#3154) and otelsql SQLCommenter instrumentation added (#3577) by @abruneau
• Prometheus /metrics endpoint exposed on ad, scraped by the Collector (#3388) by @cyrille-leclerc
• OpenFeature flag generation support added for checkout and product-catalog (#3305) by @erka
• shippingSlowdown feature flag added to delay international shipments (#3354) by @tlee768
• cartFailure made a configurable rate instead of a fixe...

Highlight

Product Review service was added to the demo, bringing GenAI-powered summaries.
The summaries can be locally simulated (useful to test spans with GenAI semantic conventions), but it can also be used with OpenAI.

Check out the documentation to learn how to configure it: https://opentelemetry.io/docs/demo/services/product-reviews/

What's Changed

• chore: use pre-built nginx otel image by @erka in #2614
• Update grafana to 12.2.0 by @itsgareth in #2615
• [chore] Generate K8s manifests by @julianocosta89 in #2607
• ad service: update README.md to refer to needed JDK (21) by @ebarped in #2636
• feat: add ipv6 support by @gnmeyer in #2594
• Adding OpenObserve to README.md by @chaitanya-sistla in #2638
• [chore] Bump C++ OTel version and simplify build by @julianocosta89 in #2642
• Upgrade OpenFeature and add fix deprecation warnings for dependency injection by @askpt in #2664
• [frontend] Fix navigation and cart math by @julianocosta89 in #2660
• Add Oodle in supported vendors by @mgaurav in #2711
• Add a Product Review service with GenAI-powered summaries by @dmitchsplunk in #2663
• [chore] Bump dependent images by @julianocosta89 in #2717
• [collector] Remove batch processor by @julianocosta89 in #2734
• [email] Add OTLP metrics and logs by @julianocosta89 in #2737
• [chore] Bump cart to .NET10 by @Kielek in #2745
• [flagd-ui] add back legacy REST APIs to empower programmatic usage by @dottorblaster in #2720
• [chore] Bump accounting to .NET10 by @Kielek in #2763
• Enable .NET analyzers and resolve warnings by @martincostello in #2757
• chore: Add badges to readme by @thompson-tomo in #2782
• [chore] update memory limits by @puckpuck in #2822
• [chore] Bump dependent images by @julianocosta89 in #2823
• [product-catalog] use database for products by @puckpuck in #2859
• [chore/jaeger] - fix small issues with Jaeger config by @puckpuck in #2861
• Improve the OpenTelemetry Collector dashboard by @cyrille-leclerc in #2855
• [cart] Add Grpc Readiness probe. Failure can be enabled through feature flag to simulate pod not ready situation by @manojsardana in #2830
• [chore] align settings with K8s/Helm by @puckpuck in #2865
• [chore] rename postgres to postgresql by @puckpuck in #2867
• [chore] add jaeger and postgresql to helm-update-required label by @puckpuck in #2868
• [chore] release pre-work by @julianocosta89 in #2872

New Contributors

• @itsgareth made their first contribution in #2615
• @ebarped made their first contribution in #2636
• @gnmeyer made their first contribution in #2594
• @chaitanya-sistla made their first contribution in #2638
• @mgaurav made their first contribution in #2711
• @dmitchsplunk made their first contribution in #2663
• @martincostello made their first contribution in #2757
• @thompson-tomo made their first contribution in #2782
• @manojsardana made their first contribution in #2830

Full Changelog: 2.1.3...2.2.0

What's Changed

• [Fix] Postgresql container by @julianocosta89 in #2597

Full Changelog: 2.1.2...2.1.3

What's Changed

This release adds postgresql and opensearch images to the demo container registry by @julianocosta89 in #2595

Full Changelog: 2.1.1...2.1.2

What's Changed

• [flagd-ui] fix application start order for mix release by @dottorblaster in #2577
• [chore] Align env vars by @julianocosta89 in #2582
• Reduce OpenSearch container memory footprint by @ps48 in #2587

Full Changelog: 2.1.0...2.1.1

What's Changed

chore

• Post-release housekeeping. #2125 by @julianocosta89
• Add GOMEMLIMIT for Go services. #2148 by @puckpuck
• Add Docker, Cargo, Bundler, .NET to Dependabot actions. #2153 by @Red-GV
• Update maintainers and approvers. #2287 by @julianocosta89
• Bump dependant images.
  • #2318 by @julianocosta89
  • #2477 by @ps48
• Add Shenoy to Demo Approvers. #2366 by @julianocosta89

Security & CI

• Add OSSF Scorecard scanning workflow. #2138 by @opentelemetrybot
• Harden GitHub Actions (StepSecurity). #2273 by @step-security-bot
• Minimum token permissions across workflows. #2322 by @opentelemetrybot
• Fix token permission blocks. #2403 by @trask

Docs & Community

• Add the following demos featuring the Astronomy Shop to README:
  • Add SigNoz. #2136 by @Elizabeth-Mathew1
  • Add Last9. #2146 by @sahilk
  • Update AppDynamics link. #2192 by @saurabhdes
  • Add Parseable. #2404 by @Debanitrkl
  • Add ClickStack. #2429 by @gingerwizard
  • Add VictoriaMetrics. #2499 by @Amper
  • Add Tinybird. #2545 by @alrocar
  • Add Apache Doris. #2458 by @xiaokang
  • Add Causely. #2381 by @svrnm
• Update community member listings. #2296 by @opentelemetrybot, #2303 by @opentelemetrybot
• Standardize contributing section. #2313 by @trask
• Fix outdated community membership link. #2308 by @opentelemetrybot
• Fix non-descriptive CONTRIBUTING.md. #2323 by @rogercoll
• Fix non-descriptive link in test/README.md. #2325 by @rogercoll
• Add subscript to issue templates. #2418 by @opentelemetrybot

Build / Images & Base OS

• Replace Alpine base image with distroless (checkout/product-catalog). #2161 by @Red-GV
• Replace Debian with Alpine (recommendation). #2164 by @Red-GV
• Update distroless image (fraud-detection). #2170 by @Red-GV
• Image-provider: move to nonroot Alpine; later update nginx & Alpine. #2193 by @Red-GV, #2369 by @Red-GV
• Replace Debian with Alpine (quote). #2216 by @Red-GV
• Replace Debian with distroless (shipping). #2294 by @Red-GV
• Update Alpine images to 3.22. #2292 by @Red-GV
• [currency] bump Alpine images to 3.21. #2291 by @Red-GV
• Replace Alpine with distroless (payment/frontend/flagd-ui). #2224 by @Red-GV

OpenFeature / Feature Flags

• Refactor OpenFeature integration + add dependency injection. #2160 by @askpt
• Upgrade OpenFeature + change Hooks integration. #2199 by @askpt
• Upgrade OpenFeature and add new telemetry Hooks. #2332 by @askpt
• Bump Flagd; adopt semconv-compliant OTel metrics. #2392 by @cyrille-leclerc

Collector / Telemetry Pipeline

• Collector pushes via OTLP/HTTP. #2187 by @ps48
• Add OpenSearch dynamic index support. #2363 by @ps48
• Meta-monitoring exports to HTTP port. #2502 by @cyrille-leclerc

Dashboards & Observability UX

• Grafana: enable traceToLogs. #2162 by @aabmass
• Update exemplars dashboard. #2188 by @julianocosta89
• Enhanced Prometheus integration & APM dashboard. #2340 by @cyrille-leclerc
• Add PostgreSQL dashboard. #2372 by @cyrille-leclerc
• Update APM dashboards for OpenSearch logs index. #2419 by @ps48
• Add Linux dashboard. #2395 by @cyrille-leclerc
• Add host metrics per service instance (Grafana/APM). #2507 by @cyrille-leclerc
• Demo alert: CartAddItemHighLatency on p95 duration. #2401 by @cyrille-leclerc

Frontend & UI

• Update genproto image to Node 22. #2282 by @Red-GV
• React Native example: update how resource attributes are captured. #2331 by @jpmunz
• Make frontend-proxy URL configurable in React Native app. #2531 by @jpmunz
• Flagd UI Elixir rewrite. #2427 by @dottorblaster

Data / Storage

• Persist orders to PostgreSQL from accounting service. #2175 by @cuichenli

Logging

• Use pino-otlp-transport to send logs to the collector. #2352 by @cuichenli
• Frontend-proxy: add redirects for web UI paths for proper asset loading. #2476 by @ps48

Kafka

• Fix Kafka listener. #2229 by @julianocosta89

Misc Build & Tooling

• make target respects $(DOCKER_COMPOSE_ENV). #2133 by @keyoke
• Fix spelling in Dependabot config. #2165 by @Red-GV
• Remove dotnet_sdk ecosystem from Dependabot. #2217 by @Red-GV
• Add .gitignore for generated protobufs (frontend). #2373 by @jburns24
• Playwright: replace nonexistent wait_until param. #2374 by @brylee10

Services

Cart

• Record seconds (not ticks) for custom metrics. #2135 by @matt-hensley
• Generate service.instance.id by default. #2402 by @matt-hensley
• Fix IDs in cart logging. #2413 by @shantanualsi

Checkout

• Add OTel gRPC logger. #2336 by @kerneljack
• Graceful shutdown for gRPC server. #2491 by @kartikgola

Product Catalog

• Simplify span event name. #2150 by @puckpuck
• Add OTel gRPC logger. #2285 by @kerneljack

Payment

• Handle “no active span” scenario safely. #2129 by @keyoke

Shipping

• Update grpc-health-probe. #2157 by @Red-GV
• Actix Web refactor. [#2214](https://github.com/open-telemetry/opentelemetry-de...

What's Changed

• [chore] post release 2.0.1 by @puckpuck in #2096
• [chore] update release process by @puckpuck in #2097
• [load-generator] optimize build by @puckpuck in #2098
• Bump OTel .NET dependencies by @Kielek in #2106
• [quote] Updated open-telemetry/exporter-otlp to 1.2.1 which includes the fix for IS_REMOTE flag feature by @SergeyKleyman in #2112
• feat(load-generator): Adapt OpenFeature OFREP instead of IN_PROCESS by @aepfli in #2114
• [flagd-ui] increase memory to 100M by @puckpuck in #2120

New Contributors

• @SergeyKleyman made their first contribution in #2112
• @aepfli made their first contribution in #2114

Full Changelog: 2.0.1...2.0.2

What's Changed

• Add FOSSA scanning workflow by @opentelemetrybot in #2048
• [chore] bump dependent images by @julianocosta89 in #2061
• [chore] adds a clean-images Makefile target by @puckpuck in #2067
• [frontend] Cypress Tests: update cypress/included to 14.0.3 by @puckpuck in #2072
• [chore] Use linkspector to check links by @puckpuck in #2070
• [grafana] cleanup dashboards by @puckpuck in #2085
• [frontend] update browser tracer provider config by @puckpuck in #2092
• [chore] release 2.0.1 prep by @puckpuck in #2091

Full Changelog: 2.0.0...2.0.1

🚀 BIG RELEASE FOR VERSION 2.0.0 🚀

• A new react-native mobile app with iOS and Android support (still beta)
• Simplified naming of all services
• Multi-platform build support
• Full dependabot support, keeping all code dependencies up to date
• And much more...

What's Changed

• [release] 1.12.0 by @julianocosta89 in #1763
• Bump Grafana version by @jcreixell in #1764
• [chore] - update k8s manifests for 1.12.0 release by @puckpuck in #1766
• [chore] Move build args to .env file by @julianocosta89 in #1767
• [Fix] flagd ui name by @julianocosta89 in #1773
• [chore] Bump components versions by @julianocosta89 in #1770
• Fix frontend-proxy crashing when using start-minimal by @jpmunz in #1774
• build(deps): bump gradle/actions from 4.1.0 to 4.2.0 by @dependabot in #1776
• Remove Helios from demo list by @julianocosta89 in #1777
• [accountingservice] Bump OTel .NET Auto to 1.9.0 by @lachmatt in #1780
• [grafana] Fix dashboards by @julianocosta89 in #1779
• build(deps): bump gradle/actions from 4.2.0 to 4.2.1 by @dependabot in #1782
• [fix] update k8s manifest to chart 0.33.1 - fixes grafana-test pod by @puckpuck in #1783
• [frontendproxy] - add envoy access logs by @puckpuck in #1768
• [chore] update memory limits by @puckpuck in #1786
• Update k8s manifest by @julianocosta89 in #1790
• [chore] add multi platform build support by @puckpuck in #1785
• [accountingservice] fix-instrumentation by @julianocosta89 in #1791
• build(deps): bump docker/build-push-action from 6.9.0 to 6.10.0 by @dependabot in #1796
• Generate protobuf code for Go and Python services by @CharlieTLe in #1794
• Setup dependabot for go dependencies by @CharlieTLe in #1754
• build(deps): bump the go-production-dependencies group across 2 directories with 16 updates by @dependabot in #1802
• [chore] Update k8s manifest by @julianocosta89 in #1804
• [accountingservice] fix-build-targetarch by @julianocosta89 in #1805
• build(deps): bump the go-production-dependencies group across 2 directories with 6 updates by @dependabot in #1807
• Revert "[accountingservice] fix-build-targetarch" by @julianocosta89 in #1811
• Add nodejs auto-instrumentation for runtime metrics in paymentservice by @liyanwei93 in #1797
• Fix RUNTIME_IDENTIFIER for accountingservice by @pjanotti in #1812
• build(deps): bump the go-production-dependencies group across 2 directories with 1 update by @dependabot in #1813
• [chore] Update k8s manifests by @julianocosta89 in #1822
• build(deps): bump the go-production-dependencies group across 2 directories with 1 update by @dependabot in #1826
• [accounting]: rename accountingservice to accounting by @puckpuck in #1827
• Variable paymentservice error rate and introduce loyalty level attributes by @rcastley in #1815
• [chore] Add Dependabot auto-update-workflow by @julianocosta89 in #1828
• build(deps): bump the go-production-dependencies group across 2 directories with 10 updates by @dependabot in #1837
• [cartservice] - Add Exemplars to Cart Service by @julianocosta89 in #1830
• [otel-collector] - rename otelcol to otel-collector by @puckpuck in #1841
• [grafana] Add Exemplars Dashboard by @julianocosta89 in #1836
• build(deps): bump the go-production-dependencies group across 2 directories with 1 update by @dependabot in #1847
• build(deps): bump gradle/actions from 4.2.1 to 4.2.2 by @dependabot in #1849
• [quote] rename quoteservice to quote by @puckpuck in #1838
• [ad] rename adService to ad by @Sozhan308 in #1832
• [flagd-ui]: rename flagdui to flagd-ui by @puckpuck in #1840
• [cart]: rename cartservice to cart by @puckpuck in #1839
• build(deps): bump the go-production-dependencies group across 2 directories with 1 update by @dependabot in #1852
• [paymentservice] Bump dependencies by @julianocosta89 in #1854
• [shipping] rename shippingservice to shipping by @Sozhan308 in #1842
• Add a React Native example app to the demo by @jpmunz in #1781
• [chore] - update demo dependencies by @puckpuck in #1855
• [load-generator] rename loadgenerator to load-generator by @puckpuck in #1856
• [image-provider] rename imageprovider to image-provider by @puckpuck in #1857
• [currency] Rename currencyservice to currency by @puckpuck in #1858
• [email] rename emailservice to email by @puckpuck in #1861
• [fraud-detection] rename frauddetectionservice to fraud-detection by @puckpuck in #1862
• [payment] rename paymentservice to payment by @puckpuck in #1863
• [recommendation] rename recommendationservice to recommendation by @puckpuck in #1865
• [react-native-app] cleanup build instructions by @puckpuck in #1860
• build(deps): bump the go-production-dependencies group across 2 directories with 1 update by @dependabot in #1869
• build(deps): bump the go-production-dependencies group across 1 directory with 2 updates by @dependabot in #1877
• Update dependabot.yml by @CharlieTLe in #1870
• build(deps): bump docker/build-push-action from 6.10.0 to 6.11.0 by @dependabot in #1878
• build(deps): bump the go-production-dependencies group across 2 directories with 2 updates by @dependabot in #1879
• Generate proto for C++ by @CharlieTLe in #1871
• [product-catalog] rename productcatalogservice to product-catalog by @puckpuck in #1864
• [checkout] rename checkoutservice to checkout by @puckpuck in #1867
• build(deps): bump the nuget-production-dependencies group across 4 directories with 7 updates by @dependabot in #1884
• build(deps): bump the actions-production-dependencies group across 1 directory with 3 updates by @dependabot in #1885
• build(deps): bump the npm-development-dependencies group across 4 directories with 18 updates by @dependabot in #1888
• build(deps): bump the composer-production-dependencies group across 1 directory with 11 updates by @dependabot in #1890
• Revert "build(deps): bump the composer-production-dependencies group across 1 directory with 11 updates" by @julianocosta89 in #1898
• fix(docker): add workaround for JDK-8345296 o...

🚀 A new Feature Flag UI was introduced 🚀

With release 1.12.0 you can now access http://localhost:8080/feature to enable/disable available feature flags.
The flagd-ui is a Next.js service.

What's Changed

• [checkout] update to NewClient call by @puckpuck in #1688
• [shippingservice] set rpc.method and rpc.service by @mottibec in #1690
• [accountingservice] allow running the container with non root user by @iblancasa in #1692
• [loadgenerator] bump otel sdk version to match the one used by recommendationservice by @xrmx in #1705
• [chore] Add yamllint to make all by @CodePrometheus in #1707
• [chore] Fix gen-proto for accountingservice by @CodePrometheus in #1709
• [chore] Upgrade flagd to v0.11.2 by @Starefossen in #1711
• [chore] Add depends on to otelcol to wait on healthy opensearch by @julianocosta89 in #1724
• [flagd-ui] Add UI for managing Flagd feature flags by @maindotmarcell in #1725
• [accountingservice] Bump OTel .NET Auto Instrumentation to 1.8.0 together with other dependencies by @Kielek in
  #1727
• [frontend] fix imageSlowLoad headers not applied to 1.8.0 together with other dependencies by @klucsik in #1733
• [productcatalogservice] Fix: only register otel during initialization by @beeme1mr in #1736
• [cartservice] Propagate cartservice exceptions by @rogercoll in #1744
• [cartservice] Update cart service to fail when cartServiceFailure is enabled by @julianocosta89 in #1748
• [chore] Update Makefile to always use DOCKER_COMPOSE_ENV var by @dadoonet in #1759

New Contributors

• @iblancasa made their first contribution in #1692
• @mottibec made their first contribution in #1690
• @xrmx made their first contribution in #1705
• @CodePrometheus made their first contribution in #1707
• @Starefossen made their first contribution in #1711
• @maindotmarcell made their first contribution in #1725
• @dadoonet made their first contribution in #1759

Full Changelog: 1.11.1...1.12.0