Skip to content

docs: OpenTelemetry middleware moved to labstack/echo-otel - #453

Merged
vishr merged 1 commit into
masterfrom
docs/echo-otel
Sep 28, 2026
Merged

vishr merged 1 commit into
masterfrom
docs/echo-otel

Conversation

@vishr

@vishr vishr commented Sep 28, 2026

Copy link
Copy Markdown
Member

labstack/echo-opentelemetry has been renamed to labstack/echo-otel, and the module paths now carry the Echo major version:

Echo Module Release
v5 github.com/labstack/echo-otel/v5 v5.0.0
v4 github.com/labstack/echo-otel/v4 v4.0.0

github.com/labstack/echo-opentelemetry is deprecated (v0.0.4 marks it in go.mod) and gets no further changes. This PR points the docs at the new module.

Changes

  • site/external-sources.json: the OpenTelemetry API reference is now extracted from github.com/labstack/echo-otel/v5 v5.0.0.
  • site/external-baseline.json: regenerated with npm run source:prepare and npm run source:accept. Apart from the module and version, the only difference is the new ErrorType function. The Config fields are unchanged.
  • OpenTelemetry middleware page (English, es, ja, pt-br, zh-cn):
    • go get and the import path use github.com/labstack/echo-otel/v5
    • the repository, Config (otel.go#L31) and example links point to labstack/echo-otel
    • a short note says that Echo v4 applications use github.com/labstack/echo-otel/v4, that github.com/labstack/echo-opentelemetry is the deprecated previous name, and links to the migration notes
    • the Example section now says the example exports spans. It never exported metrics.

Checks

  • go test ./... and make test pass.
  • cd site && npm ci --ignore-scripts && npm run build passes. That covers the source check for stable and next, translation and security translation status, both Astro builds, site:check and performance:check.
  • npm run site:check passes: 687 routes and 61606 internal links/assets resolve.
  • npm run translations:status reports 0 sections to review. The OpenTelemetry page is not tracked there, so there was nothing to accept.

labstack/echo-opentelemetry was renamed to labstack/echo-otel. The Echo v5
module is now github.com/labstack/echo-otel/v5 (v5.0.0) and the Echo v4
module is github.com/labstack/echo-otel/v4 (v4.0.0). The old module path
is deprecated.

- Pin the OpenTelemetry API reference to github.com/labstack/echo-otel/v5
  v5.0.0 and regenerate the external baseline (adds ErrorType).
- Update the go get line, import path, and repository, Config, and
  example links on the OpenTelemetry page in every locale.
- Add a note that Echo v4 applications use github.com/labstack/echo-otel/v4
  and that github.com/labstack/echo-opentelemetry is the deprecated
  previous name, with a link to the migration notes.
- The example exports spans only; drop the mention of metrics.
@vishr
vishr merged commit f0b06e6 into master Sep 28, 2026
3 checks passed
@vishr
vishr deleted the docs/echo-otel branch September 28, 2026 19:25
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.

1 participant