Docker Data Collected
New announcements from Dash: Incident Management, Continuous Profiler, and more! New announcements from Dash!

Docker Data Collected

Metrics

Metrics collected by the Agent when deployed in a Docker container:

docker.cpu.system
(gauge)
The percent of time the CPU is executing system calls on behalf of processes of this container, unnormalized
Shown as percent
docker.cpu.system.95percentile
(gauge)
95th percentile of docker.cpu.system
Shown as percent
docker.cpu.system.avg
(gauge)
Average value of docker.cpu.system
Shown as percent
docker.cpu.system.count
(rate)
The rate that the value of docker.cpu.system was sampled
Shown as sample
docker.cpu.system.max
(gauge)
Max value of docker.cpu.system
Shown as percent
docker.cpu.system.median
(gauge)
Median value of docker.cpu.system
Shown as percent
docker.cpu.user
(gauge)
The percent of time the CPU is under direct control of processes of this container, unnormalized
Shown as percent
docker.cpu.user.95percentile
(gauge)
95th percentile of docker.cpu.user
Shown as percent
docker.cpu.user.avg
(gauge)
Average value of docker.cpu.user
Shown as percent
docker.cpu.user.count
(rate)
The rate that the value of docker.cpu.user was sampled
Shown as sample
docker.cpu.user.max
(gauge)
Max value of docker.cpu.user
Shown as percent
docker.cpu.user.median
(gauge)
Median value of docker.cpu.user
Shown as percent
docker.cpu.usage
(gauge)
The percent of CPU time obtained by this container
Shown as percent
docker.cpu.throttled
(gauge)
Number of times the cgroup has been throttled
docker.cpu.shares
(gauge)
Shares of CPU usage allocated to the container
docker.kmem.usage
(gauge)
The amount of kernel memory that belongs to the container's processes.
Shown as byte
docker.mem.cache
(gauge)
The amount of memory that is being used to cache data from disk (e.g. memory contents that can be associated precisely with a block on a block device)
Shown as byte
docker.mem.cache.95percentile
(gauge)
95th percentile value of docker.mem.cache
Shown as byte
docker.mem.cache.avg
(gauge)
Average value of docker.mem.cache
Shown as byte
docker.mem.cache.count
(rate)
The rate that the value of docker.mem.cache was sampled
Shown as sample
docker.mem.cache.max
(gauge)
Max value of docker.mem.cache
Shown as byte
docker.mem.cache.median
(gauge)
Median value of docker.mem.cache
Shown as byte
docker.mem.rss
(gauge)
The amount of non-cache memory that belongs to the container's processes. Used for stacks, heaps, etc.
Shown as byte
docker.mem.rss.95percentile
(gauge)
95th percentile value of docker.mem.rss
Shown as byte
docker.mem.rss.avg
(gauge)
Average value of docker.mem.rss
Shown as byte
docker.mem.rss.count
(rate)
The rate that the value of docker.mem.rss was sampled
Shown as sample
docker.mem.rss.max
(gauge)
Max value of docker.mem.rss
Shown as byte
docker.mem.rss.median
(gauge)
Median value of docker.mem.rss
Shown as byte
docker.mem.swap
(gauge)
The amount of swap currently used by the container
Shown as byte
docker.mem.swap.95percentile
(gauge)
95th percentile value of docker.mem.swap
Shown as byte
docker.mem.swap.avg
(gauge)
Average value of docker.mem.swap
Shown as byte
docker.mem.swap.count
(rate)
The rate that the value of docker.mem.swap was sampled
Shown as sample
docker.mem.swap.max
(gauge)
Max value of docker.mem.swap
Shown as byte
docker.mem.swap.median
(gauge)
Median value of docker.mem.swap
Shown as byte
docker.container.open_fds
(gauge)
The number of open file descriptors
Shown as file
docker.container.size_rw
(gauge)
Total size of all the files in the container which have been created or changed by processes running in the container
Shown as byte
docker.container.size_rw.95percentile
(gauge)
95th percentile of docker.container.size_rw
Shown as byte
docker.container.size_rw.avg
(gauge)
Average value of docker.container.size_rw
Shown as byte
docker.container.size_rw.count
(rate)
The rate that the value of docker.container.size_rw was sampled
Shown as sample
docker.container.size_rw.max
(gauge)
Max value of docker.container.size_rw
Shown as byte
docker.container.size_rw.median
(gauge)
Median value of docker.container.size_rw
Shown as byte
docker.container.size_rootfs
(gauge)
Total size of all the files in the container
Shown as byte
docker.container.size_rootfs.95percentile
(gauge)
95th percentile of docker.container.size_rootfs
Shown as byte
docker.container.size_rootfs.avg
(gauge)
Average value of docker.container.size_rootfs
Shown as byte
docker.container.size_rootfs.count
(rate)
The rate that the value of docker.container.size_rw was sampled
Shown as sample
docker.container.size_rootfs.max
(gauge)
Max value of docker.container.size_rootfs
Shown as byte
docker.container.size_rootfs.median
(gauge)
Median value of docker.container.size_rootfs
Shown as byte
docker.containers.running
(gauge)
The number of containers running on this host tagged by image
docker.containers.stopped
(gauge)
The number of containers stopped on this host tagged by image
docker.containers.running.total
(gauge)
The total number of containers running on this host
docker.containers.stopped.total
(gauge)
The total number of containers stopped on this host
docker.images.available
(gauge)
The number of top-level images
docker.images.intermediate
(gauge)
The number of intermediate images, which are intermediate layers that make up other images
docker.mem.limit
(gauge)
The memory limit for the container, if set
Shown as byte
docker.mem.limit.95percentile
(gauge)
95th percentile of docker.mem.limit. Ordinarily this value will not change
Shown as byte
docker.mem.limit.avg
(gauge)
Average value of docker.mem.limit. Ordinarily this value will not change
Shown as byte
docker.mem.limit.count
(rate)
The rate that the value of docker.mem.limit was sampled
Shown as sample
docker.mem.limit.max
(gauge)
Max value of docker.mem.limit. Ordinarily this value will not change
Shown as byte
docker.mem.limit.median
(gauge)
Median value of docker.mem.limit. Ordinarily this value will not change
Shown as byte
docker.mem.sw_limit
(gauge)
The swap + memory limit for the container, if set
Shown as byte
docker.mem.sw_limit.95percentile
(gauge)
95th percentile of docker.mem.sw_limit. Ordinarily this value will not change
Shown as byte
docker.mem.sw_limit.avg
(gauge)
Average value of docker.mem.sw_limit. Ordinarily this value will not change
Shown as byte
docker.mem.sw_limit.count
(rate)
The rate that the value of docker.mem.sw_limit was sampled
Shown as sample
docker.mem.sw_limit.max
(gauge)
Max value of docker.mem.sw_limit. Ordinarily this value will not change
Shown as byte
docker.mem.sw_limit.median
(gauge)
Median value of docker.mem.sw_limit. Ordinarily this value will not change
Shown as byte
docker.mem.soft_limit
(gauge)
The memory reservation limit for the container, if set
Shown as byte
docker.mem.soft_limit.95percentile
(gauge)
95th percentile of docker.mem.soft_limit. Ordinarily this value will not change
Shown as byte
docker.mem.soft_limit.avg
(gauge)
Average value of docker.mem.soft_limit. Ordinarily this value will not change
Shown as byte
docker.mem.soft_limit.count
(rate)
The rate that the value of docker.mem.soft_limit was sampled
Shown as sample
docker.mem.soft_limit.max
(gauge)
Max value of docker.mem.soft_limit. Ordinarily this value will not change
Shown as byte
docker.mem.soft_limit.median
(gauge)
Median value of docker.mem.soft_limit. Ordinarily this value will not change
Shown as byte
docker.mem.in_use
(gauge)
The fraction of used memory to available memory, IF THE LIMIT IS SET
Shown as fraction
docker.mem.in_use.95percentile
(gauge)
95th percentile of docker.mem.in_use
Shown as fraction
docker.mem.in_use.avg
(gauge)
Average value of docker.mem.in_use
Shown as fraction
docker.mem.in_use.count
(rate)
The rate that the value of docker.mem.in_use was sampled
Shown as sample
docker.mem.in_use.max
(gauge)
Max value of docker.container.mem.in_use
Shown as fraction
docker.mem.in_use.median
(gauge)
Median value of docker.container.mem.in_use
Shown as fraction
docker.mem.sw_in_use
(gauge)
The fraction of used swap + memory to available swap + memory, if the limit is set
Shown as fraction
docker.mem.sw_in_use.95percentile
(gauge)
95th percentile of docker.mem.swinuse
Shown as fraction
docker.mem.sw_in_use.avg
(gauge)
Average value of docker.mem.swinuse
Shown as fraction
docker.mem.sw_in_use.count
(rate)
The rate that the value of docker.mem.swinuse was sampled
Shown as sample
docker.mem.sw_in_use.max
(gauge)
Max value of docker.container.mem.swinuse
Shown as fraction
docker.mem.sw_in_use.median
(gauge)
Median value of docker.container.mem.swinuse
Shown as fraction
docker.io.read_bytes
(gauge)
Bytes read per second from disk by the processes of the container
Shown as byte
docker.io.read_bytes.95percentile
(gauge)
95th percentile of docker.io.read_bytes
Shown as byte
docker.io.read_bytes.avg
(gauge)
Average value of docker.io.read_bytes
Shown as byte
docker.io.read_bytes.count
(rate)
The rate that the value of docker.io.read_bytes was sampled
Shown as sample
docker.io.read_bytes.max
(gauge)
Max value of docker.container.io.read_bytes
Shown as byte
docker.io.read_bytes.median
(gauge)
Median value of docker.container.io.read_bytes
Shown as byte
docker.io.write_bytes
(gauge)
Bytes written per second to disk by the processes of the container
Shown as byte
docker.io.write_bytes.95percentile
(gauge)
95th percentile of docker.io.write_bytes
Shown as byte
docker.io.write_bytes.avg
(gauge)
Average value of docker.io.write_bytes
Shown as byte
docker.io.write_bytes.count
(rate)
The rate that the value of docker.io.write_bytes was sampled
Shown as sample
docker.io.write_bytes.max
(gauge)
Max value of docker.container.io.write_bytes
Shown as byte
docker.io.write_bytes.median
(gauge)
Median value of docker.container.io.write_bytes
Shown as byte
docker.image.virtual_size
(gauge)
Size of all layers of the image on disk
Shown as byte
docker.image.size
(gauge)
Size of all layers of the image on disk
Shown as byte
docker.net.bytes_rcvd
(gauge)
Bytes received per second from the network
Shown as byte
docker.net.bytes_rcvd.95percentile
(gauge)
95th percentile of docker.net.bytes_rcvd
Shown as byte
docker.net.bytes_rcvd.avg
(gauge)
Average value of docker.net.bytes_rcvd
Shown as byte
docker.net.bytes_rcvd.count
(rate)
The rate that the value of docker.net.bytes_rcvd was sampled
Shown as sample
docker.net.bytes_rcvd.max
(gauge)
Max value of docker.container.net.bytes_rcvd
Shown as byte
docker.net.bytes_rcvd.median
(gauge)
Median value of docker.container.net.bytes_rcvd
Shown as byte
docker.net.bytes_sent
(gauge)
Bytes sent per second to the network
Shown as byte
docker.net.bytes_sent_bytes.95percentile
(gauge)
95th percentile of docker.net.bytessentbytes
Shown as byte
docker.net.bytes_sent_bytes.avg
(gauge)
Average value of docker.net.bytessentbytes
Shown as byte
docker.net.bytes_sent_bytes.count
(rate)
The rate that the value of docker.net.bytessentbytes was sampled
Shown as sample
docker.net.bytes_sent_bytes.max
(gauge)
Max value of docker.container.net.bytessentbytes
Shown as byte
docker.net.bytes_sent_bytes.median
(gauge)
Median value of docker.container.net.bytessentbytes
Shown as byte
docker.data.used
(gauge)
Storage pool disk space used
Shown as byte
docker.data.free
(gauge)
Storage pool disk space free
Shown as byte
docker.data.total
(gauge)
Storage pool disk space total
Shown as byte
docker.data.percent
(gauge)
The percent of storage pool used
Shown as percent
docker.metadata.used
(gauge)
Storage pool metadata space used
Shown as byte
docker.metadata.free
(gauge)
Storage pool metadata space free
Shown as byte
docker.metadata.total
(gauge)
Storage pool metadata space total
Shown as byte
docker.metadata.percent
(gauge)
The percent of storage pool metadata used
Shown as percent
docker.thread.count
(gauge)
Current thread count for the container
Shown as thread
docker.thread.limit
(gauge)
Thread count limit for the container, if set
Shown as thread

Events

The Docker Agent produces the following events:

  • Delete Image
  • Die
  • Error
  • Fail
  • Kill
  • Out of memory (oom)
  • Pause
  • Restart container
  • Restart Daemon
  • Update

Service Checks

  • docker.service_up: Returns CRITICAL if the Agent is unable to collect the list of containers from the Docker daemon, otherwise returns OK.

  • docker.container_health: This Service Check is only available for Agent v5. It returns CRITICAL if a container is unhealthy, UNKNOWN if the health is unknown, and OK otherwise.

  • docker.exit: Returns CRITICAL if a container exited with a non-zero exit code, otherwise returns OK.