Need to make Docker API Version default to 1.44+

[reimarstier]

Component(s)

receiver/dockerstatsreceiver

What happened?

Description

Currently, the Docker client API version is set to 1.25 as default. But due to this changelog, we need to make the Client API version default to 1.44+.

The daemon now requires API version v1.44 or later (Docker v25.0+).

This has happened before here

Steps to Reproduce

• Install recent docker-ce version 29 on Ubuntu: For me this was the following package 5:29.0.0-1~ubuntu.22.04~jammy
• Configure OTel Collector observe docker stats, otel-collector.yml:

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
        auth:
          authenticator: oidc
  docker_stats:
    endpoint: unix:///var/run/docker.sock
    collection_interval: 15s
    metrics:

Expected Result

Docker metrics are consumed from docker daemon.

Actual Result

OTel collector running in docker reports the following error when fetching docker stats:

2025/11/14 12:27:06 collector server run finished with error: cannot start pipelines: failed to start "docker_stats" receiver:
 Error response from daemon: client version 1.25 is too old. Minimum supported API version is 1.44, please upgrade your client
 to a newer version                                                                                                           

Collector version

v0.139.0

Environment information

Environment

OS: (e.g., "Ubuntu 20.04")
Compiler(if manually compiled): (e.g., "go 14.2")

OpenTelemetry Collector configuration

receivers:
  otlp:
    protocols:
      grpc:
        endpoint: 0.0.0.0:4317
        auth:
          authenticator: oidc
  docker_stats:
    endpoint: unix:///var/run/docker.sock
    collection_interval: 15s
    metrics:

service:
  extensions: [ pprof, zpages, health_check, oidc ]
  pipelines:
    metrics:
      receivers: [ otlp, docker_stats ]
      processors: [ batch ]
      exporters: [ debug, prometheus ]

Log output

2025/11/14 12:27:06 collector server run finished with error: cannot start pipelines: failed to start "docker_stats" receiver:
 Error response from daemon: client version 1.25 is too old. Minimum supported API version is 1.44, please upgrade your client
 to a newer version                                                                                                           

Additional context

No response

Tip

_{React with 👍 to help prioritize this issue. Please use comments to provide useful context, avoiding +1 or me too, to help us triage it. Learn more here.}

[paulojmdias]

/label receiver/dockerstats

[github-actions]

Pinging code owners for receiver/dockerstats: @jamesmoessis. See Adding Labels via Comments if you do not have permissions to add labels yourself. For example, comment '/label priority:p2 -needs-triage' to set the priority and remove the needs-triage label.

[jamesmoessis]

Thanks for raising the issue. I agree we need to do this with some priority.

I will take a look in the next couple of days. Also open to any contributions for this.

[github-actions]

Pinging code owners for extension/observer/dockerobserver: @MovieStoreGuy. See Adding Labels via Comments if you do not have permissions to add labels yourself. For example, comment '/label priority:p2 -needs-triage' to set the priority and remove the needs-triage label.