• English日本語한국어
  • Log inStart now

Container instrumentation for infrastructure monitoring

Our infrastructure agent automatically monitors your containers. With container monitoring you can:


Requirement details for automatic container monitoring for New Relic's infrastructure agent:


Support for Operating systems using Control Group v2 is included from infrastructure agent v.1.26.0 and nri-docker v1.7.0.

Enable container monitoring

If you meet the requirements and have installed the correct infrastructure monitoring agent, there are no additional steps to enable container monitoring. If a container runtime is running, data will automatically be reported.

You can also use a container image containing the infrastructure monitoring agent. For more information, see Container for infrastructure monitoring.

Did this doc help with your installation?

View your container data

To view your container data in the New Relic UI, use either of these options:

For more information, see Query your data.

container attributes

Container attributes (metrics and metadata) are attached to the ContainerSample event. Here's an example of a query to find out how many containers are associated with each container image:

SELECT uniqueCount(containerId) FROM ContainerSample FACET imageName SINCE 1 HOUR AGO TIMESERIES

To see all ContainerSample attributes, use our data dictionary. Attributes include:

  • General metadata (like containerId, name, and image)
  • CPU metrics (like cpuUsedCores, cpuPercent, and cpuThrottleTimeMs)
  • Memory metrics (like memoryUsageBytes, memoryCacheBytes, and memoryResidentSizeBytes)
  • Network metrics (like networkRxBytes, networkRxDropped, and networkTxBytes)

Container metrics are also attached to the ProcessSample event.

The reported data does not include information related to the container orchestrator (for example, ECS or Kubernetes). To monitor those, you can add the orchestrator's cluster and task names as labels.

Set alert conditions

To create container-related alert conditions, use either of these options:

  1. Go to one.newrelic.com > All capabilities > Alerts & AI.


    Go to one.newrelic.com > All capabilities > Infrastructure > Settings > Alerts.

  2. Create a new alert condition.

  3. For the condition type, select Container metrics.

Disabling container monitoring

To disable this capability simply delete the docker-config.yml configuration file from the integrations.d folder.

Copyright © 2023 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.