Azure Container Registry monitoring data reference

  • Article

This article contains all the monitoring reference information for this service.

See Monitor Azure Container Registry for details on the data you can collect for Azure Container Registry and how to use it.

Metrics

This section lists all the automatically collected platform metrics for this service. These metrics are also part of the global list of all platform metrics supported in Azure Monitor.

For information on metric retention, see Azure Monitor Metrics overview.

Supported metrics for Microsoft.ContainerRegistry/registries

The following table lists the metrics available for the Microsoft.ContainerRegistry/registries resource type.

Table headings

  • Metric - The metric display name as it appears in the Azure portal.
  • Name in Rest API - Metric name as referred to in the REST API.
  • Unit - Unit of measure.
  • Aggregation - The default aggregation type. Valid values: Average, Minimum, Maximum, Total, Count.
  • Dimensions - Dimensions available for the metric.
  • Time Grains - Intervals at which the metric is sampled. For example, PT1M indicates that the metric is sampled every minute, PT30M every 30 minutes, PT1H every hour, and so on.
  • DS Export- Whether the metric is exportable to Azure Monitor Logs via Diagnostic Settings. For information on exporting metrics, see Create diagnostic settings in Azure Monitor.
Metric Name in REST API Unit Aggregation Dimensions Time Grains DS Export
AgentPool CPU Time

AgentPool CPU Time in seconds		 AgentPoolCPUTime Seconds Total (Sum) <none> PT1M Yes
Run Duration

Run Duration in milliseconds		 RunDuration MilliSeconds Total (Sum) <none> PT1M Yes
Storage used

The amount of storage used by the container registry. For a registry account, it's the sum of capacity used by all the repositories within a registry. It's sum of capacity used by shared layers, manifest files, and replica copies in each of its repositories.		 StorageUsed Bytes Average Geolocation PT1H Yes
Successful Pull Count

Number of successful image pulls		 SuccessfulPullCount Count Total (Sum) <none> PT1M Yes
Successful Push Count

Number of successful image pushes		 SuccessfulPushCount Count Total (Sum) <none> PT1M Yes
Total Pull Count

Number of image pulls in total		 TotalPullCount Count Total (Sum) <none> PT1M Yes
Total Push Count

Number of image pushes in total		 TotalPushCount Count Total (Sum) <none> PT1M Yes

Note

Because of layer sharing, registry Storage used might be less than the sum of storage for individual repositories. When you delete a repository or tag, you recover only the storage used by manifest files and the unique layers referenced.

Metric dimensions

For information about what metric dimensions are, see Multi-dimensional metrics.

This service has the following dimensions associated with its metrics.

  • Geolocation. The Azure region for a registry or geo-replica.

Resource logs

This section lists the types of resource logs you can collect for this service. The section pulls from the list of all resource logs category types supported in Azure Monitor.

Supported resource logs for Microsoft.ContainerRegistry/registries

Category Category display name Log table Supports basic log plan Supports ingestion-time transformation Example queries Costs to export
ContainerRegistryLoginEvents Login Events ContainerRegistryLoginEvents

Azure Container Registry Login Auditing Logs

 No Yes Queries No
ContainerRegistryRepositoryEvents RepositoryEvent logs ContainerRegistryRepositoryEvents

Azure Container Registry Repository Auditing Logs

 No Yes Queries No

Azure Monitor Logs tables

This section lists the Azure Monitor Logs tables relevant to this service, which are available for query by Log Analytics using Kusto queries. The tables contain resource log data and possibly more depending on what is collected and routed to them.

For a reference of all Azure Monitor Logs and Log Analytics tables, see the Azure Monitor Log Table Reference.

Container Registry Microsoft.ContainerRegistry/registries

  • AzureActivity. Entries from the Azure Activity log that provide insight into any subscription-level or management group level events that occurred in Azure.

  • AzureMetrics. Metric data emitted by Azure services that measure their health and performance.

  • ContainerRegistryLoginEvents. Registry authentication events and status, including the incoming identity and IP address.

  • ContainerRegistryRepositoryEvents. Operations on images and other artifacts in registry repositories. The following operations are logged: push, pull, untag, delete (including repository delete), purge tag, and purge manifest.

    Purge events are logged only if a registry retention policy is configured.

Activity log

The linked table lists the operations that may be recorded in the activity log for this service. This is a subset of all the possible resource provider operations in the activity log.

For more information on the schema of activity log entries, see Activity Log schema.

The following table lists operations related to Azure Container Registry that can be created in the Activity log. This list isn't exhaustive.

Operation Description
Create or Update Container Registry Create a container registry or update a registry property
Delete Container Registry Delete a container registry
List Container Registry Login Credentials Show credentials for registry's admin account
Import Image Import an image or other artifact to a registry
Create Role Assignment Assign an identity a Role-based access control (RBAC) role to access a resource

Related content