Azure Container Registry monitoring data reference

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.

• All columns might not be present in every table.
• Some columns might be beyond the viewing area of the page. Select Expand table to view all available columns.

Table headings

• Category - The metrics group or classification.
• Metric - The metric display name as it appears in the Azure portal.
• Name in REST API - The metric name as referred to in the REST API.
• Unit - Unit of measure.
• Aggregation - The default aggregation type. Valid values: Average (Avg), Minimum (Min), Maximum (Max), Total (Sum), 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 dimensions

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

This service has the following dimensions associated with its metrics.

Region values depend on the registry's home region and geo-replicas.

API name values

The Transactions metric supports the following ApiName values:

• HeadManifest: Checks whether a manifest exists and retrieves its response headers.
• GetManifest: Retrieves a manifest.
• GetManifestProperties: Retrieves properties for a specific manifest.
• GetListManifests: Lists the manifests in a repository.
• GetTag: Retrieves information about a tag.
• GetListTags: Lists the tags in a repository.
• HeadBlob: Checks whether a blob or layer exists and retrieves its response headers.
• GetBlobRedirection: Redirects a blob or layer download request to its content location.
• GetBlob: Retrieves blob or layer content.
• GetListRepositories: Lists repositories in the registry.
• GetListReferrers: Lists artifacts that refer to a specified manifest digest.
• GetRepositoryProperties: Retrieves repository properties.
• GetToken: Requests an ACR access token for the requested scope.
• PostToken: Exchanges an ACR refresh token for an ACR access token.
• PostExchange: Exchanges a Microsoft Entra access token for an ACR refresh token.

For the corresponding API definitions, see Registry data plane REST operation groups.

The DataTransfer metric supports the following ApiName values:

• GetBlob: Data transferred when a client downloads a blob or layer.
• GetManifest: Data transferred when a client retrieves a manifest.
• GeoReplication: Data transferred during service-initiated geo-replication, including initial synchronization and replication after a push.
• ImportSource: Data transferred when another Azure container registry uses this registry as the source of an import operation.

Response type values

The Transactions metric supports the following ResponseType values:

• Success: The operation succeeded with HTTP status code 200, 201, or 202.
• Redirect: The operation returned HTTP status code 307. For example, a blob download can redirect the client to the blob's content location.
• ClientErrorUnauthorized: Authentication or authorization failed with HTTP status code 401 or 403.
• ClientErrorNotFound: The requested resource wasn't found and returned HTTP status code 404.
• Throttled: The request was rate limited and returned HTTP status code 429.
• ClientErrorOther: The operation returned a 4xx client error that doesn't have a dedicated response type.
• ServerErrorOther: The operation returned a 5xx server error.

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

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 can be recorded in the activity log for this service. These operations are 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.

• Microsoft.ContainerRegistry resource provider operations

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

Related content

• See Monitor Azure Container Registry for a description of monitoring Container Registry.
• See Monitor Azure resources with Azure Monitor for details on monitoring Azure resources.