Skip to content

Commit dce1c5a

Browse files
denreadenrea
authored
Merge pull request #301817 from pthippeswamy/release-storage-discovery-2025
Overview page with supporting materials for Storage Discovery.
2 parents 5be65b4 + 04fe72a commit dce1c5a

15 files changed

+402
-87
lines changed

‎articles/storage-discovery/TOC.yml

Lines changed: 12 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,26 @@
11
items:
2-
- name: Azure Storage Mover documentation
2+
- name: Azure Storage Discovery documentation
33
href: ./index.yml
44
- name: Overview
55
items:
66
- name: What is Azure Storage Discovery?
77
href: overview.md
88
expanded: true
99
- name: Concepts
10-
items:
11-
- name: placeholder
12-
href: overview.md
10+
items:
11+
- name: Discovery core concepts
12+
href: core-concepts.md
13+
- name: Planning for deployment
14+
href: deploy-planning.md
15+
- name: Understand Discovery Pricing
16+
href: pricing.md
1317
- name: How-To
1418
items:
1519
- name: Deploy
1620
items:
17-
- name: placeholder
18-
href: overview.md
19-
- name: Manage
20-
items:
21-
- name: placeholder
22-
href: overview.md
23-
- name: Decommission
24-
items:
25-
- name: placeholder
26-
href: overview.md
27-
- name: Troubleshoot
28-
items:
29-
- name: placeholder
30-
href: overview.md
21+
- name: Create Storage Discovery Workspace
22+
href: create-workspace.md
3123
- name: Resources
3224
items:
33-
- name: placeholder
34-
href: overview.md
25+
- name: Release notes
26+
href: release-notes.md

‎articles/storage-discovery/core-concepts.md

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Planning for Storage Discovery deployment | Microsoft Docs
3+
titleSuffix: Azure Storage Discovery
4+
description: Storage Discovery provides insights on storage capacity, transactions, and configurations - providing visibility into your storage estate at entire organization level and aiding business decisions.
5+
author: pthippeswamy
6+
ms.service: azure-storage-mover
7+
ms.topic: overview
8+
ms.date: 08/01/2025
9+
ms.author: shaas
10+
ms.custom: references_regions
11+
---
12+
13+
# Azure Storage Discovery concepts
14+
15+
The concepts and terminology used throughout this documentation are defined below.
16+
17+
## Key concepts
18+
19+
### Azure Storage Discovery workspace (ASDW)
20+
The Azure Storage Discovery workspace is the resource used to deploy and manage Storage Discovery in your subscription. It defines the scope of analysis - such as subscriptions or resource groups and once created, it enables visibility into capacity, transactions, and configuration trends across storage accounts within the selected "scope".
21+
22+
### Workspace Root
23+
Azure Resource Manager (ARM) resource identifiers that define the root-level boundaries of an Azure Storage Discovery Workspace (ASDW). These roots specify the top-level Azure resources - such as subscriptions and/or resource groups - over which the discovery workspace will operate.
24+
25+
Example:
26+
27+
```json
28+
"workspaceRoots": [
29+
"/subscriptions/abc123...",
30+
"/subscriptions/abc123/resourceGroups/rg1"
31+
]
32+
```
33+
34+
This configuration means the workspace will monitor storage accounts under the specified subscription and resource group.
35+
36+
> [!NOTE]
37+
> - Users need Reader access on subscriptions or resource groups to add them to workspace roots during Discovery workspace deployment.
38+
39+
40+
### Scope
41+
A Scope in Azure Storage Discovery represents a logical grouping of storage accounts based on user-defined criteria, such as resource tags. Scopes are configured within the boundaries of a workspace and serve as filters to organize and segment data for reporting and insights. By defining scopes, users can tailor their workspace to align with specific business units, workloads, or any segment of their Azure Storage environment they wish to monitor. This enables more targeted visibility and actionable insights across distinct areas of the storage estate. Users have flexibility to define:
42+
43+
- A scope without any ARM tags will include all storage accounts within the defined scope
44+
- A scope with tags enables users to selectively choose specific storage accounts based on Azure tags assigned to the storage accounts.
45+
46+
Deploying Azure Storage Discovery workspace in one of your Azure subscriptions is the first step in starting aggregation of storage account metrics.
47+
48+
## Select a subscription and region for Azure Storage Discovery workspace deployment
49+
50+
Azure Storage Discovery workspace can be deployed in a subscription of your choice and in one of the supported regions.
51+
[!INCLUDE [control-plane-regions](includes/control-plane-regions.md)]
52+
53+
Once a discovery workspace is created in a specific region, it can aggregate metrics from storage accounts located across a broader set of supported regions, irrespective of the region in which the discovery workspace itself resides.
54+
[!INCLUDE [data-plane-regions](includes/data-plane-regions.md)]
55+
56+
## Permissions
57+
58+
To deploy a Discovery Workspace, user must have following access:
59+
60+
| Scenario | Minimal RBAC role assignments needed |
61+
|---|---|
62+
| To deploy Discovery workspace | Contributor access on the subscription or the resource group|
63+
| To include the subscription or resource groups in a Discovery workspace as part of *workspaceRoots* | Microsoft.Storage/storageAccounts/read access on the subscription or resource group |
64+
| To view Discovery reports | Reader access on the Discovery workspace |
65+
66+
## Azure Storage Discovery pricing plans
67+
68+
Storage Discovery is available in two different SKUs or pricing plans.
69+
70+
[!INCLUDE [pricing-plan-differentiation](includes/pricing-plan-differentiation.md)]

‎articles/storage-discovery/create-workspace.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
---
2+
title: Create and manage a storage discovery workspace
3+
titleSuffix: Azure Storage Discovery
4+
description: Learn how to create a discovery workspace.
5+
author: pthippeswamy
6+
ms.service: azure-storage-mover
7+
ms.topic: how-to
8+
ms.author: shaas
9+
ms.date: 08/01/2025
10+
---
11+
12+
# Create and manage a storage discovery workspace
13+
14+
The Azure Storage Discovery Workspace (ASDW) is a central resource within the Azure Storage Discovery platform designed to help users manage and visualize storage data across various scopes—such as tenants, subscriptions, and resource groups.
15+
16+
This article helps you create an ASDW resource.
17+
18+
## Create an ASDW from Azure portal
19+
20+
Click on **Create**
21+
22+
> [!div class="mx-imgBorder"]
23+
> ![Screenshot of the create ASDW page.](./media/create-resource.png)
24+
25+
Choose a **Subscription** and **Resource group** to create the discovery workspace
26+
27+
The following table describes each element.
28+
29+
| Element | Description |
30+
|---|--|
31+
| `Name` | The name of the Discovery workspace resource. |
32+
| `Description` | Optional. Description of the Discovery workspace resource. |
33+
| `Region` | Azure region where the Discovery resource is created.<sup>1</sup>|
34+
| `Pricing plan` | Storage Discovery pricing plan.<sup>2</sup>|
35+
36+
<sup>1</sup> For information on regions covered, see [Storage Discovery workspace regions](deploy-planning.md).
37+
<sup>2</sup> For information on Storage Discovery pricing plan, see [Understand Storage Discovery Pricing](pricing.md).
38+
39+
### Define workspace root
40+
Workspace root specifies the top-level Azure resource identifiers - such as subscriptions or resource groups - where Storage Discovery initiates its scan for storage accounts. These identifiers serve as the root of the discovery process, defining the overall scope and boundaries of your Azure estate that is analyzed. Select the subscriptions and/or resource groups that need to be included in the workspace.
41+
42+
> [!NOTE]
43+
> - Ensure that the user or service principal deploying the workspace has at least **Reader** access to each specified resource.
44+
> - Up to 100 resources - subscriptions and/or resource groups can be included in one Discovery workspace.
45+
46+
> [!div class="mx-imgBorder"]
47+
> ![Screenshot of the workspace root.](./media/workspace-roots-checks.png)
48+
49+
Once the subscriptions, resource groups or tenant is added to the workspace, an access check is run to verify if the user has Microsoft.Storage/storageAccounts/read on the added resources. As the checks are running, status of the run is as shown:
50+
51+
If you do not have Microsoft.Storage/storageAccounts/read on any of the resources added, remove the resource from the workSpace root to proceed with the creation of workspace or resolve the access issue and try again.
52+
53+
### Create Scope
54+
Scopes are logical groupings of storage accounts within the defined workspace root. They allow you to filter and organize data using tags and resource types. Scope enables targeted insights - you can create scopes for different departments, environments, or compliance zones.
55+
56+
> [!div class="mx-imgBorder"]
57+
> ![Screenshot of scope](./media/scope.png)
58+
59+
> [!IMPORTANT]
60+
> **Default Scope** is added automatically, which would include all storage accounts within the subscriptions or resource groups added in the **workspace root**
61+
62+
Add tags, if needed on the ASDW resource and click on Review and Create.
63+
64+
If the access check for the workspace root resources hasn’t finished yet, the Review and Create tab shows a message saying the check is still in progress. You won’t be able to deploy the resource until the check is complete.
65+
66+
> [!NOTE]
67+
> Note that Discovery resource creation fails if the access checks on any added subscription or resource group or tenant is not successful.
68+
69+
When the access checks complete successfully, resource can be deployed.
70+
71+
> [!NOTE]
72+
> Note that it will take up to 24 hours for the metrics to start appearing in the Reports after the scope is created.

‎articles/storage-discovery/deploy-planning.md

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
title: Planning for an Azure Storage Discovery deployment
3+
titleSuffix: Azure Storage Discovery
4+
description: Considerations and best-practices while deploying Azure Storage Discovery service
5+
author: pthippeswamy
6+
ms.service: azure-storage-mover
7+
ms.topic: overview
8+
ms.date: 08/01/2025
9+
ms.author: shaas
10+
---
11+
12+
# Azure Storage Discovery: Regional availability and planning guide
13+
14+
Azure Storage Discovery empowers organizations to gain deep, actionable insights into their storage estate—across subscriptions, regions, and scopes. This article outlines the regional availability of Azure Storage Discovery, explains how to select regions for your workspace, and clarifies how regional aggregation of insights work.
15+
16+
## Workspace Region Availability
17+
18+
Azure Storage Discovery Workspaces (ASDW) are the foundational resource for configuring and visualizing your storage insights.
19+
[!INCLUDE [control-plane-regions](includes/control-plane-regions.md)]
20+
21+
### What This Means for You
22+
23+
The region where your discovery workspace is deployed determines where the control plane for your discovery experience resides. This includes:
24+
25+
- **Latency**: Choosing a region close to your operational base can improve dashboard responsiveness.
26+
- **Compliance**: Some organizations may have regulatory requirements that dictate where data must reside.
27+
28+
### Planning Guidance
29+
30+
When selecting a region for your workspace:
31+
32+
- **Proximity**: Choose a region geographically close to your primary operations or data sources.
33+
- **Compliance**: Ensure the region aligns with your data residency and compliance policies.
34+
- **Preview Availability**: Confirm that the region is supported in the current release phase (e.g., public preview).
35+
36+
## Regions for Storage Insights Aggregation
37+
38+
While the workspace defines where your the Discovery resource resides, the actual data being analyzed comes from storage accounts across multiple regions.
39+
[!INCLUDE [data-plane-regions](includes/data-plane-regions.md)]
40+
41+
### What This Means for You
42+
43+
This means that even if your workspace is deployed in a limited set of regions, you can still gain visibility into storage accounts located in a broader set of Azure regions. The service collects and aggregates metrics such as:
44+
45+
- **Capacity trends**
46+
- **Activity and transaction volumes**
47+
- **Configuration and security settings**
48+
- **Cost and consumption breakdowns**
49+
50+
These insights are then visualized in your Discovery reports, enabling centralized visualization of a globally distributed storage estate.
51+
52+
## Best Practices for Regional Planning
53+
54+
To maximize the value of Azure Storage Discovery:
55+
56+
1. **Deploy your workspace in a supported region**: Ensure your chosen region is enabled for workspace creation.
57+
2. **Define scopes strategically**: Use tenant, subscription, or resource group levels to group storage accounts logically.
58+
3. **Use tags for filtering**: Apply Azure tags to storage accounts to selectively include them in your discovery scope.
59+
4. **Verify access**: Ensure users have Reader access to the ASDW resource to view reports.
60+
5. **Allow time for data to populate**: Metrics typically begin appearing within 24 hours of scope configuration.
61+
62+
For questions or feedback, contact the team at [[email protected]](mailto:[email protected]).

‎articles/storage-discovery/includes/control-plane-regions.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
---
2+
author: pthippeswamy
3+
ms.author: pthippeswamy
4+
ms.topic: include
5+
ms.date: 08/01/2025
6+
ms.service: azure-storage-mover
7+
ms.custom: references_regions
8+
---
9+
10+
Below is the list of regions where storage discovery workspaces can be created:
11+
12+
- France Central
13+
- Canada Central
14+
- East US2
15+
- North Europe
16+
- West Europe

‎articles/storage-discovery/includes/data-plane-regions.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
author: pthippeswamy
3+
ms.author: pthippeswamy
4+
ms.topic: include
5+
ms.date: 08/01/2025
6+
ms.service: azure-storage-mover
7+
ms.custom: references_regions
8+
---
9+
10+
List of regions from which storage insights will be aggregated by Storage Discovery is as given below. This list is temporary and will change over time as Public Preview support continues to expand.
11+
12+
**Americas:**
13+
- Canada Central
14+
- Canada East
15+
- Mexico Central
16+
- US Central
17+
- US East
18+
- US East2
19+
- US North
20+
- US South
21+
- US South East
22+
- US West
23+
- US West2
24+
- US West3
25+
- US West Central
26+
27+
**Europe:**
28+
- Europe North
29+
- Europe West
30+
- France Central
31+
- France South
32+
- Germany North
33+
- Germany West Central
34+
- Italy North
35+
- Israel Central
36+
- Norway East
37+
- Norway West
38+
- Poland Central
39+
- Spain Central
40+
- Sweden Central
41+
- Sweden South
42+
- Switzerland North
43+
- Switzerland West
44+
- UK South
45+
- UK West
46+
47+
**Asia Pacific:**
48+
- Australia Central
49+
- Australia Central2
50+
- Australia East
51+
- Australia South East
52+
- New Zealand North

‎articles/storage-discovery/includes/pricing-plan-differentiation.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
author: pthippeswamy
3+
ms.author: pthippeswamy
4+
ms.topic: include
5+
ms.date: 08/01/2025
6+
ms.service: azure-storage-mover
7+
ms.custom: references_regions
8+
---
9+
10+
| Pricing Plan | Best for | Capacity | Transactions | Configuration | History |
11+
|---|---|---|---|---|---|
12+
| Free | Small-scale deployments and evaluation | • Trends<br>• Distributions<br>• Top storage accounts | Not available | • Resource configuration | • Backfill: 15 days<br>• Retention: 15 days |
13+
| Standard | Production deployments with comprehensive insights | • Trends<br>• Distributions<br>• Top storage accounts | • Trends<br>• Distributions<br>• Top storage accounts | • Resource configuration<br>• Security configuration | • Backfill: 30 days <br>• Retention: 18 months |

0 commit comments

Comments
 (0)