Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

Unit of measure is missing for metrics endpoints

Abierto
#19,642 1 comentario 0 reacciones 1 asignado Ver en GitHub

Los mantenedores suelen responder en 1 día

@dvdksn ya está trabajando en esto.

Desde el 16/3/2024.

Evaluación

Este issue todavía no se ha evaluado.

Descripción

area/api area/engine lifecycle/frozen status/triage
Is this a docs issue?
  • My issue is about the documentation content or website
Type of issue

I can't find what I'm looking for

Description

I'm looking for the unit of measure used by many metrics endpoints exposed by the docker engine and used my metric streaming components like telegraf.

In telegraf's own documentation, here you can see an example

docker_container_cpu

tags:
engine_host
server_version
container_image
container_name
container_status
container_version
cpu
fields:
throttling_periods
throttling_throttled_periods
throttling_throttled_time
usage_in_kernelmode
usage_in_usermode
usage_system
usage_total
usage_percent
container_id

these usages are all missing their unit of measure, and when I query the DB I get numbers I can't make sense of.
I then looked into the docker engine api and I am more confused: the latest mention of the usage_in_usermode endpoint is in v1.24, I couldn't find any mention in any more recent version.

And even in 1.24 docs, there is no mention of the unit of measure.

Maybe I anm missing something obvious here?

Location

https://docs.docker.com/engine/api/v1.24/

Suggestion

Create a specific page for metrics with all endpoints and their unit of measure

Lenguaje dominante
Markdown
Estrellas
4.7k
Forks
8.5k
Merge medio
1 d 21 h
PR fusionados (30 d)
127

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de docker/docs

Todos los issues de docker/docs

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.