Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Monitoring data reference for Azure Blob Storage description: This article contains important reference material you need when you monitor Azure Blob Storage. ms.date: 02/27/2025 ms.custom: horz-monitor ms.topic: reference author: normesta ms.author: normesta ms.service: azure-blob-storage # Customer intent: "As a cloud administrator, I want to understand the monitoring metrics and resource logs for Azure Blob Storage, so that I can effectively track performance and ensure data integrity in my storage environment." --- # Azure Blob Storage monitoring data reference [!INCLUDE [horz-monitor-ref-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-intro.md)] See [Monitor Azure Blob Storage](monitor-blob-storage.md) for details on the data you can collect for Azure Blob Storage and how to use it. <a name="metrics-dimensions"></a> [!INCLUDE [horz-monitor-ref-metrics-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-intro.md)] ### Supported metrics for Microsoft.Storage/storageAccounts The following table lists the metrics available for the Microsoft.Storage/storageAccounts resource type. [!INCLUDE [horz-monitor-ref-metrics-tableheader](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-tableheader.md)] [!INCLUDE [Microsoft.Storage/storageAccounts](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/metrics/microsoft-storage-storageaccounts-metrics-include.md)] ### Category: Object replication | **Metric** | **Name in REST API** | **Unit** | **Aggregation** | **Dimensions** | **Time Grains** | **DS Export** | |---|---|---|---|---|---|---| | **Pending Bytes for Replication (preview)**<br><br>The size in bytes of the blob object pending for replication. | PendingBytesForReplication | Bytes | Average<br>Minimum, Maximum | TimeBucket, AccountName, and PolicyId | PT2M | No | | **Pending Operations for Replication (preview)**<br><br>The count of pending operations for replication. | PendingOperationsForReplication | Count | Average<br>Minimum, Maximum | TimeBucket, AccountName, and PolicyId | PT2M | No | ### Supported metrics for Microsoft.Storage/storageAccounts/blobServices The following table lists the metrics available for the Microsoft.Storage/storageAccounts/blobServices resource type. [!INCLUDE [horz-monitor-ref-metrics-tableheader](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-tableheader.md)] [!INCLUDE [Microsoft.Storage/storageAccounts/blobServices](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/metrics/microsoft-storage-storageaccounts-blobservices-metrics-include.md)] > [!NOTE] > The Blob Capacity and Blob Count metric are emitted hourly. A background process computes these metrics and updates them multiple times a day. [!INCLUDE [horz-monitor-ref-metrics-dimensions-intro](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions-intro.md)] [!INCLUDE [horz-monitor-ref-metrics-dimensions](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-metrics-dimensions.md)] ### Dimensions available to all storage services [!INCLUDE [Metrics dimensions](../../../includes/azure-storage-account-metrics-dimensions.md)] ### Dimensions specific to Blob storage | Dimension Name | Description | | ------------------- | ----------------- | | **BlobType** | The type of blob for Blob metrics only. The supported values are **BlockBlob**, **PageBlob**, and **Azure Data Lake Storage**. Append blobs are included in **BlockBlob**. | | **Tier** | Azure storage offers different access tiers, which allow you to store blob object data in the most cost-effective manner. See more in [Azure Storage blob tier](../blobs/access-tiers-overview.md). The supported values include: <br><br>**Hot**: Hot tier<br>**Cool**: Cool tier<br>**Cold**: Cold tier<br>**Archive**: Archive tier<br>**Premium**: Premium tier for block blob<br>**P4/P6/P10/P15/P20/P30/P40/P50/P60**: Tier types for premium page blob<br>**Standard**: Tier type for standard page Blob<br>**Untiered**: Tier type for general purpose v1 storage account | For the metrics supporting dimensions, you need to specify the dimension value to see the corresponding metrics values. For example, if you look at **Transactions** value for successful responses, you need to filter the **ResponseType** dimension with **Success**. If you look at **BlobCount** value for Block Blob, you need to filter the **BlobType** dimension with **BlockBlob**. <a name="resource-logs-preview"></a> [!INCLUDE [horz-monitor-ref-resource-logs](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-resource-logs.md)] ### Supported resource logs for Microsoft.Storage/storageAccounts/blobServices [!INCLUDE [Microsoft.Storage/storageAccounts/blobServices](~/reusable-content/ce-skilling/azure/includes/azure-monitor/reference/logs/microsoft-storage-storageaccounts-blobservices-logs-include.md)] [!INCLUDE [horz-monitor-ref-logs-tables](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-logs-tables.md)] - [AzureActivity](/azure/azure-monitor/reference/tables/azureactivity) - [AzureMetrics](/azure/azure-monitor/reference/tables/azuremetrics) - [StorageBlobLogs](/azure/azure-monitor/reference/tables/storagebloblogs) The following sections describe the properties for Azure Storage resource logs when they're collected in Azure Monitor Logs or Azure Storage. The properties describe the operation, the service, and the type of authorization that was used to perform the operation. > [!NOTE] > The field names listed in each section below are valid when resource logs are sent to Azure storage or to an event hub. When the logs are sent to a Log Analytics workspace, the field names might be different. ### Fields that describe the operation ```json { "time": "2019-02-28T19:10:21.2123117Z", "resourceId": "/subscriptions/00001111-aaaa-2222-bbbb-3333cccc4444/resourceGroups/mytestrp/providers/Microsoft.Storage/storageAccounts/testaccount1/blobServices/default", "category": "StorageWrite", "operationName": "PutBlob", "operationVersion": "2017-04-17", "schemaVersion": "1.0", "statusCode": 201, "statusText": "Success", "durationMs": 5, "callerIpAddress": "192.168.0.1:11111", "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd", "location": "uswestcentral", "uri": "http://mystorageaccount.blob.core.windows.net/cont1/blobname?timeout=10" } ``` [!INCLUDE [Account level capacity metrics](../../../includes/azure-storage-logs-properties-operation.md)] ### Fields that describe how the operation was authenticated ```json { "identity": { "authorization": [ { "action": "Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read", "denyAssignmentId": "aaaa0000-bb11-2222-33cc-444444dddddd", "principals": [ { "id": "aaaaaaaa-bbbb-cccc-1111-222222222222", "type": "User" } ], "reason": "Policy", "result": "Granted", "roleAssignmentId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee", "roleDefinitionId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff", "type": "RBAC" } ], "properties": { "metricResponseType": "Success", "objectKey": "/samplestorageaccount/samplecontainer/sampleblob.png" }, "requester": { "appId": "00001111-aaaa-2222-bbbb-3333cccc4444", "audience": "https://storage.azure.com/", "objectId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb", "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "tokenIssuer": "https://sts.windows.net/2c2c2c2c-3333-dddd-4444-5e5e5e5e5e5e", "uniqueName": "someone@example.com" }, "delegatedResource": { "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "resourceId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1", "objectId": "a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1" }, "type": "OAuth" }, } ``` [!INCLUDE [Account level capacity metrics](../../../includes/azure-storage-logs-properties-authentication.md)] ### Fields that describe the service ```json { "properties": { "accountName": "contoso", "requestUrl": "https://contoso.blob.core.windows.net:443/upload?restype=container&comp=list&prefix=&delimiter=/&marker=&maxresults=30&include=metadata&_=1551405598426", "userAgentHeader": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.140 Safari/537.36 Edge/17.17134", "referrerHeader": "blob:https://portal.azure.com/00001111-aaaa-2222-bbbb-3333cccc4444", "clientRequestId": "", "etag": "", "serverLatencyMs": 63, "serviceType": "blob", "operationCount": 0, "requestHeaderSize": 2658, "requestBodySize": 0, "responseHeaderSize": 295, "responseBodySize": 2018, "contentLengthHeader": 0, "requestMd5": "", "serverMd5": "", "lastModifiedTime": "", "conditionsUsed": "", "smbTreeConnectID" : "0x3", "smbPersistentHandleID" : "0x6003f", "smbVolatileHandleID" : "0xFFFFFFFF00000065", "smbMessageID" : "0x3b165", "smbCreditsConsumed" : "0x3", "smbCommandDetail" : "0x2000 bytes at offset 0xf2000", "smbFileId" : " 0x9223442405598953", "smbSessionID" : "0x8530280128000049", "smbCommandMajor" : "0x6", "smbCommandMinor" : "DirectoryCloseAndDelete", "downloadRange" : "bytes=4-4194307", "accessTier": "None", "sourceAccessTier": "Hot", "rehydratePriority":"High" } } ``` [!INCLUDE [Account level capacity metrics](../../../includes/azure-storage-logs-properties-service.md)] [!INCLUDE [horz-monitor-ref-activity-log](~/reusable-content/ce-skilling/azure/includes/azure-monitor/horizontals/horz-monitor-ref-activity-log.md)] - [Microsoft.Storage resource provider operations](/azure/role-based-access-control/resource-provider-operations#microsoftstorage) ## Related content - See [Monitor Azure Blob Storage](monitor-blob-storage.md) for a description of monitoring Azure Blob Storage. - See [Monitor Azure resources with Azure Monitor](/azure/azure-monitor/essentials/monitor-azure-resource) for details on monitoring Azure resources. - See [Metrics and logs FAQ](storage-blob-faq.yml#metrics-and-logs) for frequently asked questions and answers.