Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Unit of measure is missing for metrics endpoints

Aperta
#19,642 1 commento 0 reazioni 1 assegnatario Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

@dvdksn ci sta già lavorando.

Dal 16/3/2024.

Valutazione

Questa issue non è ancora stata valutata.

Descrizione

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

Lingua principale
Markdown
Stelle
4.7k
Fork
8.5k
Merge medio
1g 21h
PR unite (30g)
127

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di docker/docs

Tutte le issue di docker/docs

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.