--- title: Docker container monitoring integration source: https://docs.newrelic.com/docs/infrastructure/host-integrations/host-integrations-list/docker-container-monitoring-integration --- The Docker Container [integration](https://docs.newrelic.com/docs/integrations/new-relic-integrations/getting-started/introduction-infrastructure-integrations) monitors and reports metrics from docker containers using [Docker API](https://docs.docker.com/reference/api/engine/version/v1.48/) to New Relic. > #### 💡 TIP > > This integration is released as [open source on Github](https://github.com/newrelic/nri-docker). A change log is also available there for the latest updates. > #### ⚠️ IMPORTANT > > - This integration does not support LCOW (Linux Containers on Windows). For more information, see the [Docker documentation](https://docs.docker.com/desktop/windows/wsl/). > - For Linux - this integration is bundled with the infrastructure agent, and would automatically become active, if docker containers are detected. > - For Windows - starting version 2.3.0 we are providing compatibility, but it requires a manual installation on top of the infrastructure agent. It will be bundled with the infrastructure agent in future releases. ### Container metrics [#container-metric] These attributes can be found by querying the `ContainerSample` event type. | Metric | Type | Description | | ----------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------- | | commandLine | ATTRIBUTE | The command line used to start the container. | | image | ATTRIBUTE | The image used to start the container. | | imageName | ATTRIBUTE | The name of the image used to start the container. | | name | ATTRIBUTE | The name of the container. | | state | ATTRIBUTE | The state of the container. | | status | ATTRIBUTE | The status of the container. | | restartCount | GAUGE | The number of times the container has been restarted. | | cpuUsedCores | GAUGE | The number of CPU cores used by the container. | | cpuUsedCoresPercent | GAUGE | The percentage of CPU cores used by the container. _Linux Only_ | | cpuLimitCores | GAUGE | The number of CPU cores available to the container. _Linux Only_ | | cpuPercent | GAUGE | The percentage of CPU used by the container. | | cpuKernelPercent | GAUGE | The percentage of CPU kernel used by the container. _Not available for Windows containers with Hyper-V isolation_ | | cpuUserPercent | GAUGE | The percentage of CPU user used by the container. _Not available for Windows containers with Hyper-V isolation_ | | cpuThrottleTimeMs | GAUGE | The time the container has been throttled. _Linux Only_ | | cpuThrottlePeriods | GAUGE | The number of times the container has been throttled. _Linux Only_ | | cpuShares | GAUGE | The number of CPU shares used by the container. _Linux Only_ | | cpuProcs | GAUGE | The number of CPU processes used by the container. _Windows Only_ | | memoryUsageBytes | GAUGE | The memory used by the container. _Linux Only_ | | memoryCacheBytes | GAUGE | The memory cache used by the container. _Linux Only_ | | memoryResidentSizeBytes | GAUGE | The memory resident size used by the container. _Linux Only_ | | memorySizeLimitBytes | GAUGE | The memory size limit used by the container. _Linux Only_ | | memoryUsageLimitPercent | GAUGE | The memory usage limit percent used by the container. | | memoryKernelUsageBytes | GAUGE | The memory kernel usage bytes used by the container. _Linux Only_ | | memorySwapUsageBytes | GAUGE | The memory swap usage bytes used by the container. _Linux Only_ | | memorySwapOnlyUsageBytes | GAUGE | The memory swap only usage bytes used by the container. _Linux Only_ | | memorySwapLimitBytes | GAUGE | The memory swap limit bytes used by the container. _Linux Only_ | | memorySwapLimitUsagePercent | GAUGE | The memory swap limit usage percent used by the container. _Linux Only_ | | memoryCommitBytes | GAUGE | The memory commit bytes used by the container. _Windows Only_ | | memoryCommitPeakBytes | GAUGE | The memory commit peak bytes used by the container. _Windows Only_ | | memoryPrivateWorkingSet | GAUGE | The memory private working set used by the container. _Windows Only_ | | memorySoftLimitBytes | GAUGE | The memory soft limit bytes used by the container. _Linux Only_ | | ioReadCountPerSecond | PRATE | The I/O read count per second used by the container. _Linux Only_ | | ioWriteCountPerSecond | PRATE | The I/O write count per second used by the container. _Linux Only_ | | ioReadBytesPerSecond | PRATE | The I/O read bytes per second used by the container. _Linux Only_ | | ioWriteBytesPerSecond | PRATE | The I/O write bytes per second used by the container. _Linux Only_ | | ioTotalReadCount | GAUGE | The total I/O read count used by the container. _Linux Only_ | | ioTotalWriteCount | GAUGE | The total I/O write count used by the container. _Linux Only_ | | ioTotalReadBytes | GAUGE | The total I/O read bytes used by the container. | | ioTotalWriteBytes | GAUGE | The total I/O write bytes used by the container. | | ioReadCountNormalized | GAUGE | The normalized I/O read count used by the container. _Windows Only_ | | ioWriteCountNormalized | GAUGE | The normalized I/O write count used by the container. _Windows Only_ | | ioTotalBytes | GAUGE | The total I/O bytes used by the container. | | threadCount | GAUGE | The number of threads used by the container. _Linux Only_ | | threadCountLimit | GAUGE | The number of threads limit used by the container. _Linux Only_ | | networkRxBytes | GAUGE | The network receive bytes used by the container. | | networkRxDropped | GAUGE | The network receive dropped used by the container. | | networkRxErrors | GAUGE | The network receive errors used by the container. | | networkRxPackets | GAUGE | The network receive packets used by the container. | | networkTxBytes | GAUGE | The network transmit bytes used by the container. | | networkTxDropped | GAUGE | The network transmit dropped used by the container. | | networkTxErrors | GAUGE | The network transmit errors used by the container. | | networkTxPackets | GAUGE | The network transmit packets used by the container. | | networkRxBytesPerSecond | PRATE | The network receive bytes per second used by the container. | | networkRxDroppedPerSecond | PRATE | The network receive dropped per second used by the container. | | networkRxErrorsPerSecond | PRATE | The network receive errors per second used by the container. | | networkRxPacketsPerSecond | PRATE | The network receive packets per second used by the container. | | networkTxBytesPerSecond | PRATE | The network transmit bytes per second used by the container. | | networkTxDroppedPerSecond | PRATE | The network transmit dropped per second used by the container. | | networkTxErrorsPerSecond | PRATE | The network transmit errors per second used by the container. | | networkTxPacketsPerSecond | PRATE | The network transmit packets per second used by the container. | | storageDataUsedBytes | GAUGE | The storage data used bytes used by the container. | | storageDataAvailableBytes | GAUGE | The storage data available bytes used by the container. | | storageDataTotalBytes | GAUGE | The storage data total bytes used by the container. | | storageDataUsagePercent | GAUGE | The storage data usage percent used by the container. | | storageMetadataUsedBytes | GAUGE | The storage metadata used bytes used by the container. | | storageMetadataAvailableBytes | GAUGE | The storage metadata available bytes used by the container. | | storageMetadataTotalBytes | GAUGE | The storage metadata total bytes used by the container. | | storageMetadataUsagePercent | GAUGE | The storage metadata usage percent used by the container. | ### > #### ⚠️ IMPORTANT > > - To monitor Docker using OpenTelemetry, see [Monitor Docker with OpenTelemetry](https://docs.newrelic.com/docs/opentelemetry/integrations/docker-monitoring/overview).