golang echo otel middleware
- Repo stars 0
- Author repo skills-registry
- Domain
- Writing
- Author-declared agents
- No explicit declaration found; this is not inferred or tested compatibility
- Static check
- 88 / 100 · heuristic scan, not runtime safety proof
- Runtime evidence
- Not run; no isolated runtime test evidence is currently recorded
- Author / version / license
- @tomevault-io · no license declared
- Token usage
- Lean
- Setup complexity
- Plug-and-play
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No explicit requirements detected
- Detected file/system behavior
-
- Read-only
- Network behavior
- Local-only
- Install commands
- None (reference only)
Heads up: Tool permissions are not declared; actual access depends on the runtime.
# Skill: golang-echo-otel-middleware
Use this skill when adding or configuring `github.com/adlandh/echo-otel-middleware/v2` in a Go Echo application, or when writing examples for this middleware.
## Essentials
- Import path must include `/v2`: `github.com/adlandh/echo-otel-middleware/v2`.
- Alias examples as `echootelmiddleware` to match the package name and README.
- This middleware targets Echo v5: use `github.com/labstack/echo/v5` and handler signatures with `*echo.Context`.
- `Middleware()` uses global OpenTelemetry tracer provider and propagator; use `MiddlewareWithConfig` when the app owns explicit OTel setup.
## Basic Usage
```go
app := echo.New()
app.Use(echootelmiddleware.Middleware())
```
Use explicit config when a tracer provider or propagator is constructed by the application:
```go
app.Use(echootelmiddleware.MiddlewareWithConfig(echootelmiddleware.OtelConfig{
TracerProvider: tp,
Propagator: otel.GetTextMapPropagator(),
}))
```
## Config Defaults
- `TracerProvider`: `otel.GetTracerProvider()`.
- `Propagator`: `otel.GetTextMapPropagator()`.
- `Skipper`: Echo `middleware.DefaultSkipper`.
- `BodySkipper`: no-op, returns `false, false`.
- `AreHeadersDump`: `true`.
- `IsBodyDump`: `false`.
- `RemoveNewLines`: `false`.
- `LimitNameSize` and `LimitValueSize`: `0`, meaning unlimited.
## Safe Body Dumping
- Body dumping is opt-in with `IsBodyDump: true` because it can capture PII, tokens, and secrets.
- Prefer `BodySkipper` to exclude sensitive endpoints, compressed bodies, uploads, auth payloads, or large responses.
- `BodySkipper` only runs when `IsBodyDump` is true and returns `(skipReqBody, skipRespBody)`.
```go
BodySkipper: func(c *echo.Context) (bool, bool) {
if c.Request().Header.Get("Content-Encoding") == "gzip" {
return true, true
}
return false, false
},
```
## Attribute Limits
- `LimitNameSize` and `LimitValueSize` are byte-based, not rune-based.
- Truncation preserves valid UTF-8; values over a limit greater than 10 get a trailing `...`.
- `RemoveNewLines` replaces `\n` with spaces in string attributes, useful for backends such as Sentry.
## Do Not Assume
- Metrics are not implemented in this middleware; do not add or document metrics unless explicitly requested.
- Echo v4 examples are wrong for this package because context types and imports differ.
---
> Source: [adlandh/echo-otel-middleware](https://github.com/adlandh/echo-otel-middleware) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-23 -->
Sections and files
Listed in source order.
sections -> Essentials → Basic Usage → Config Defaults → Safe Body Dumping → Attribute Limits → Do Not Assume
terms -> - Import path must include /v2: github.com/adlandh/echo-otel-middleware/v2. · - TracerProvider: otel.GetTracerProvider(). · - Body dumping is opt-in with IsBodyDump: true because it can capture PII, tokens, and secrets. · - LimitNameSize and LimitValueSize are byte-based, not rune-based. · - Metrics are not implemented in this middleware; do not add or document metrics unless explicitly requested.
files/cmd -> github.com/adlandh/echo-otel-middleware/v2 · /v2 · echootelmiddleware · github.com/labstack/echo/v5 · *echo.Context · Middleware() · MiddlewareWithConfig · TracerProvider
body sha256 -> ebb54b593f29
Essentials
Import path must include
/v2:github.com/adlandh/echo-otel-middleware/v2. Alias examples asechootelmiddlewareto match the package name and README. This middleware targets Echo v5: usegithub.com/labstack/echo/v5and handler signatures with*echo.Context.Middleware()uses global OpenTelemetry tracer provider and propagator; useMiddlewareWithConfigwhen the app owns explicit OTel setup.Basic Usage
Use explicit config when a tracer provider or propagator is constructed by the application:
Config Defaults
TracerProvider:otel.GetTracerProvider().Propagator:otel.GetTextMapPropagator().Skipper: Echomiddleware.DefaultSkipper.BodySkipper: no-op, returnsfalse, false.AreHeadersDump:true.Safe Body Dumping
Body dumping is opt-in with
IsBodyDump: truebecause it can capture PII, tokens, and secrets. PreferBodySkipperto exclude sensitive endpoints, compressed bodies, uploads, auth payloads, or large responses.BodySkipperonly runs whenIsBodyDumpis true and returns(skipReqBody, skipRespBody).Attribute Limits
LimitNameSizeandLimitValueSizeare byte-based, not rune-based. Truncation preserves valid UTF-8; values over a limit greater than 10 get a trailing....RemoveNewLinesreplaces\nwith spaces in string attributes, useful for backends such as Sentry.