Skip to content

Commit 8373e40

Browse files
authored
Merge pull request #50601 from v-thpra/azure-triage-fix-1055038
Technical Review 1055038: Monitor, diagnose, and troubleshoot your Azure Storage
2 parents 3d2cbe3 + 423255c commit 8373e40

15 files changed

+233
-234
lines changed
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.1-introduction
3-
metadata:
4-
title: Introduction
5-
description: Introduction
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Introduction
11-
durationInMinutes: 2
12-
content: |
13-
[!include[](includes/1-introduction.md)]
14-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.1-introduction
3+
metadata:
4+
title: Introduction
5+
description: Introduction
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Introduction
11+
durationInMinutes: 2
12+
content: |
13+
[!include[](includes/1-introduction.md)]
14+
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.2-storage-troubleshooting-tools
3-
metadata:
4-
title: Identify the troubleshooting tools available in Azure
5-
description: In this unit, we'll discuss how to identify the troubleshooting tools available in Azure.
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Identify the troubleshooting tools available in Azure
11-
durationInMinutes: 3
12-
content: |
13-
[!include[](includes/2-storage-troubleshooting-tools.md)]
14-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.2-storage-troubleshooting-tools
3+
metadata:
4+
title: Identify the troubleshooting tools available in Azure
5+
description: In this unit, we discuss how to identify the troubleshooting tools available in Azure.
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Identify the troubleshooting tools available in Azure
11+
durationInMinutes: 3
12+
content: |
13+
[!include[](includes/2-storage-troubleshooting-tools.md)]
14+
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.3-storage-metrics
3-
metadata:
4-
title: Troubleshoot with storage metrics
5-
description: In this unit, we'll discuss how you can troubleshoot issues in a storage account by using storage metrics.
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Troubleshoot with storage metrics
11-
durationInMinutes: 9
12-
content: |
13-
[!include[](includes/3-storage-metrics.md)]
14-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.3-storage-metrics
3+
metadata:
4+
title: Troubleshoot with storage metrics
5+
description: In this unit, we discuss how you can troubleshoot issues in a storage account by using storage metrics.
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Troubleshoot with storage metrics
11+
durationInMinutes: 9
12+
content: |
13+
[!include[](includes/3-storage-metrics.md)]
14+
Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.4-exercise-storage-metrics
3-
metadata:
4-
title: Exercise - Enable storage metrics and view metric data
5-
description: In this exercise, we'll explore how to enable storage metrics and view metric data.
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Exercise - Enabling storage metrics and view metric data
11-
durationInMinutes: 10
12-
azureSandbox: true
13-
content: |
14-
[!include[](includes/4-exercise-storage-metrics.md)]
15-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.4-exercise-storage-metrics
3+
metadata:
4+
title: Exercise - Enable storage metrics and view metric data
5+
description: In this exercise, we explore how to enable storage metrics and view metric data.
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Exercise - Enabling storage metrics and view metric data
11+
durationInMinutes: 10
12+
azureSandbox: true
13+
content: |
14+
[!include[](includes/4-exercise-storage-metrics.md)]
15+
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.5-storage-logging
3-
metadata:
4-
title: Troubleshoot with storage resource logs
5-
description: In this unit, we'll learn about resource logs and how to route them to various destinations for analysis.
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Troubleshoot with storage resource logs
11-
durationInMinutes: 4
12-
content: |
13-
[!include[](includes/5-storage-logging.md)]
14-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.5-storage-logging
3+
metadata:
4+
title: Troubleshoot with storage resource logs
5+
description: In this unit, we learn about resource logs and how to route them to various destinations for analysis.
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Troubleshoot with storage resource logs
11+
durationInMinutes: 4
12+
content: |
13+
[!include[](includes/5-storage-logging.md)]
14+
Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.6-exercise-storage-logging
3-
metadata:
4-
title: Exercise - Route resource logs to Log Analytics and then view log data
5-
description: In this exercise, we'll explore how to route storage resource logs, and then view log data.
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Exercise - Route resource logs to Log Analytics and then view log data
11-
durationInMinutes: 8
12-
azureSandbox: true
13-
content: |
14-
[!include[](includes/6-exercise-storage-logging.md)]
15-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.6-exercise-storage-logging
3+
metadata:
4+
title: Exercise - Route resource logs to Log Analytics and then view log data
5+
description: In this exercise, we explore how to route storage resource logs, and then view log data.
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Exercise - Route resource logs to Log Analytics and then view log data
11+
durationInMinutes: 8
12+
azureSandbox: true
13+
content: |
14+
[!include[](includes/6-exercise-storage-logging.md)]
15+
Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
### YamlMime:ModuleUnit
2-
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.7-summary
3-
metadata:
4-
title: Summary
5-
description: Summary
6-
ms.date: 12/21/2023
7-
author: normesta
8-
ms.author: normesta
9-
ms.topic: unit
10-
title: Summary
11-
durationInMinutes: 5
12-
content: |
13-
[!include[](includes/7-summary.md)]
14-
1+
### YamlMime:ModuleUnit
2+
uid: learn.monitor-diagnose-and-troubleshoot-azure-storage.7-summary
3+
metadata:
4+
title: Summary
5+
description: Summary
6+
ms.date: 05/22/2025
7+
author: normesta
8+
ms.author: normesta
9+
ms.topic: unit
10+
title: Summary
11+
durationInMinutes: 5
12+
content: |
13+
[!include[](includes/7-summary.md)]
14+

learn-pr/azure/monitor-diagnose-and-troubleshoot-azure-storage/includes/1-introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
Azure Storage is a fundamental part of many Azure applications. You can use it to store the critical data your applications require. It's vital to ensure any problems or performance issues with your storage accounts are identified and fixed quickly.
22

3-
Consider an automobile parts distributor who has released the latest updates of their customer portal. The distributor recently received error reports from users when viewing the files they've uploaded. You know the data was moved recently to Azure Storage. As part of the team working on the release, you're unsure of the cause of these issues. You'll troubleshoot and correct the problem to restore functionality for your customers.
3+
Consider an automobile parts distributor who released the latest updates of their customer portal. The distributor recently received error reports from users when they're viewing the files they uploaded. You know that this data was recently moved to Azure Storage. As part of the team working on the release, you're unsure of the cause of these issues. You want to troubleshoot and correct the problem to restore functionality for your customers.
44

5-
In this module, you'll learn about monitoring, troubleshooting, and diagnosing problems with your Azure Storage. You'll also learn about some of the tools that are available and how to use them.
5+
In this module, you learn about monitoring, troubleshooting, and diagnosing problems with your Azure Storage. You also learn about some of the tools that are available for troubleshooting Azure Storage issues and how to use them.
66

77
## Learning objectives
88

learn-pr/azure/monitor-diagnose-and-troubleshoot-azure-storage/includes/2-storage-troubleshooting-tools.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
Diagnosing and troubleshooting issues for an application hosted in a cloud environment can be more complicated than in traditional environments. To support these types of applications successfully, you should monitor them and understand how to diagnose and troubleshoot any aspects of those applications and their dependent technologies. You can use a combination of tools and logging to identify issues.
22

3-
In this unit, you'll learn about some of the different tools you can use to analyze issues with Azure Storage.
3+
In this unit, you learn about some of the different tools you can use to analyze issues with Azure Storage.
44

55
## Tools available for monitoring metrics
66

7-
Azure Monitor collects numeric data (*metrics*) from your storage account and makes that data available in a time-series database. Metrics are numerical values that describe some aspect of a storage account at a particular time. The Azure portal gives you a graphical way to view these metrics in near real time. There can be a delay of a few minutes between the time a metric is recorded to the time that they appear on the Azure portal. In the Azure portal, you can:
7+
Azure Monitor collects numeric data (*metrics*) from your storage account and makes that data available in a time-series database. Metrics are numerical values that describe some aspect of a storage account at a particular time. The Azure portal gives you a graphical way to view these metrics in near real time. There can be a delay of a few minutes between the time a metric is recorded and the time that it appears on the Azure portal. In the Azure portal, you can:
88

9-
- Configure metrics (*and logging*)
9+
- Configure metrics (*and logging*).
1010

11-
- View graphs and charts and select which metrics to visualize
11+
- View graphs and charts and select which metrics to visualize.
1212

13-
- Assess how your applications are doing over some time
13+
- Assess how your applications are doing over a specified time.
1414

15-
- Configure alerts to notify you of any behavior that is out of the ordinary
15+
- Configure alerts to notify you of any behavior that is out of the ordinary.
1616

1717
### Overview page Monitoring tab
1818

19-
You can obtain snapshot view of common metrics by opening the **Monitoring** tab on the storage account's **Overview** page. The following image shows an example that includes the ingress and egress for a storage account:
19+
You can obtain a snapshot view of common metrics by opening the **Monitoring** tab on the storage account's **Overview** page. The following image shows an example that includes the ingress and egress for a storage account:
2020

2121
> [!div class="mx-imgBorder"]
2222
> ![Screenshot of the Monitoring tab on the Overview page for a storage account in the Azure portal.](../media/2-block-blob-metrics.png)
@@ -39,13 +39,13 @@ Storage insights provide a unified view of your Azure Storage services performan
3939

4040
You can process metric values by creating batch jobs in Azure CLI, PowerShell scripts, or by writing code that uses a storage client library. You can also archive transaction metrics to a storage account, and then view or process them by using these same tools.
4141

42-
If you choose to archive transaction metrics to a storage account, metric data will be collected and stored inside a single blob as a line-delimited JSON payload. You can view those blobs by opening the relevant log container in the Azure portal or by using [Storage Explorer](https://azure.microsoft.com/features/storage-explorer/). You can also download those blobs your local computer and process them by using tools and SDKs.
42+
If you choose to archive transaction metrics to a storage account, metric data is collected and stored inside a single blob as a line-delimited JSON payload. You can view those blobs by opening the relevant log container in the Azure portal or by using [Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/). You can also download those blobs to your local computer and process them by using tools and Software Development Kits (SDKs).
4343

4444
## Tools available for reviewing log data
4545

4646
There are two types of logs in Azure Monitor: activity logs and resource logs.
4747

48-
Activity logs provide insight into the operations on each Azure resource in the subscription from the outside (*the management plane*) in addition to updates on Service Health events. This module doesn't explore activity logs.
48+
Activity logs provide insight into the operations on each Azure resource in the subscription from the outside (*the management plane*). They also provide updates on Service Health events. This module doesn't explore activity logs.
4949

5050
Resource logs (commonly referred to as *diagnostic logs*) capture detailed information about operations on storage account resources such as blobs or files. To view these logs, you need to route them to a location in Azure. Then, you can use tools to view and analyze them.
5151

@@ -58,6 +58,6 @@ If you route logs to Log Analytics, then you can review log data by running quer
5858
5959
### Tools that process archived logs
6060

61-
If you choose to archive your logs to a storage account, you can view those logs by opening the relevant log container in the Azure portal or by using [Storage Explorer](https://azure.microsoft.com/products/storage/storage-explorer/). To download logs to your local computer, you can use either of those tools as well as the [AzCopy](/azure/storage/common/storage-use-azcopy-v10) utility.
61+
If you choose to archive your logs to a storage account, you can view those logs by opening the relevant log container in the Azure portal or by using [Azure Storage Explorer](https://azure.microsoft.com/products/storage/storage-explorer/). To download logs to your local computer, you can use either of those tools and the [AzCopy](/azure/storage/common/storage-use-azcopy-v10) utility.
6262

6363
Viewing individual logs can be time consuming so might consider processing logs by using some sort of automation. You can process logs by creating batch jobs in Azure CLI, PowerShell scripts, or by writing code that uses a storage client library.

0 commit comments

Comments
 (0)