Skip to content

Commit 19c139e

Browse files
committed
Reorganize Storage Discovery documentation structure and update content
1 parent fa72f96 commit 19c139e

13 files changed

+251
-133
lines changed

articles/storage-discovery/TOC.yml

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,18 +7,20 @@ items:
77
href: overview.md
88
expanded: true
99
- name: Concepts
10-
items:
10+
items:
11+
- name: Discovery core concepts
12+
href: core-concepts.md
1113
- name: Planning for deployment
12-
href: discovery-deploy-planning.md
14+
href: deploy-planning.md
1315
- name: Understand Discovery Pricing
14-
href: discovery-pricing.md
16+
href: pricing.md
1517
- name: How-To
1618
items:
1719
- name: Deploy
1820
items:
1921
- name: Create Storage Discovery Workspace
20-
href: discovery-create.md
22+
href: create-workspace.md
2123
- name: Resources
2224
items:
2325
- name: Release notes
24-
href: discovery-release-notes.md
26+
href: release-notes.md

articles/storage-discovery/discovery-core-concepts.md renamed to articles/storage-discovery/core-concepts.md

Lines changed: 4 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -4,32 +4,19 @@ description: Storage Discovery provides insights on storage capacity, transactio
44
author: pthippeswamy
55
ms.service: azure-storage-mover
66
ms.topic: overview
7-
ms.date: 06/27/2025
7+
ms.date: 08/01/2025
88
ms.author: pthippeswamy
99
---
1010

11-
<!--
12-
!########################################################
13-
STATUS: DRAFT
14-
15-
CONTENT: NOT STARTED
16-
17-
REVIEW Stephen/Fabian: NOT STARTED
18-
EDIT PASS: NOT STARTED
19-
20-
Document score: not run
21-
22-
!########################################################
23-
-->
2411
# Azure Storage Discovery concepts
2512

2613
Deploying Azure Storage Discovery workspace in one of your Azure subscriptions is the first step in starting aggregation of storage account metrics. This article discusses the important decisions and best practices for a Storage Discovery deployment.
2714

2815
## Select a subscription and region for Azure Storage Discovery workspace deployment
2916

30-
Azure Storage Discovery workspace can be deployed in a subscription of your choice and in one of the supported regions as listed in [Regional coverage of Azure Storage Discovery](discovery-regionalCoverage.md).
17+
Azure Storage Discovery workspace can be deployed in a subscription of your choice and in one of the supported regions as listed in [Regional coverage of Azure Storage Discovery](regionalCoverage.md).
3118

32-
Once created, a Discovery workspace can aggregate metrics from storage accounts within its "Scope", regardless of whether those accounts reside in different regions. The list of regions from which metrics are aggregated is also provided in the [Regional coverage of Azure Storage Discovery](discovery-regionalCoverage.md).
19+
Once created, a Discovery workspace can aggregate metrics from storage accounts within its "Scope", regardless of whether those accounts reside in different regions. The list of regions from which metrics are aggregated is also provided in the [Regional coverage of Azure Storage Discovery](regionalCoverage.md).
3320

3421
## Permissions
3522

@@ -50,4 +37,4 @@ Storage Discovery is available in two different SKUs or pricing plans.
5037
| Free | Small-scale deployments and evaluation | • Trends<br>• Distributions<br>• Top storage accounts | Not available | • Resource configuration | • Backfill: 15 days<br>• Retention: 15 days |
5138
| 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: 15 days<br>• Retention: 18 months |
5239

53-
Refer [Storage Discovery Pricing page](discovery-pricing.md) for more details.
40+
Refer [Storage Discovery Pricing page](pricing.md) for more details.

articles/storage-discovery/discovery-create.md renamed to articles/storage-discovery/create-workspace.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: pthippeswamy
66
ms.service: azure-storage-mover
77
ms.topic: how-to
88
ms.author: pthippeswamy
9-
ms.date: 06/10/2025
9+
ms.date: 08/01/2025
1010
---
1111

1212
# Create and manage a storage discovery workspace
@@ -35,8 +35,8 @@ The following table describes each element.
3535
| `Region` | Azure region where the Discovery resource will be created.<sup>1</sup>|
3636
| `Pricing plan` | Storage Discovery pricing plan.<sup>2</sup>|
3737

38-
<sup>1</sup> For information on regions covered, see [Storage Discovery Regions](discovery-regionalCoverage.md).
39-
<sup>2</sup> For information on Storage Discovery pricing plan, see [Understand Storage Discovery Pricing](discovery-pricing.md).
38+
<sup>1</sup> For information on regions covered, see [Storage Discovery Regions](regionalCoverage.md).
39+
<sup>2</sup> For information on Storage Discovery pricing plan, see [Understand Storage Discovery Pricing](pricing.md).
4040

4141
### Define WorkspaceRoots
4242
WorkspaceRoots 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 will be analyzed. Select the subscriptions and/or resource groups that need to be included in the workspace.
@@ -80,8 +80,4 @@ When the access checks completes successfully, resource can be deployed.
8080
> ![Screenshot of deployment complete.](media/create/deploy.png)
8181
8282
> [!NOTE]
83-
> Please note that it will take upto 24 hours for the metrics to start appearing in the Reports after the scope has been created.
84-
85-
## Next steps
86-
87-
- [View insights on Storage Discovery Reports](discovery-reports.md)
83+
> Please note that it will take upto 24 hours for the metrics to start appearing in the Reports after the scope has been created.
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
title: Planning for an Azure Storage Discovery deployment
3+
description: Considerations and best-practices while deploying Azure Storage Discovery service
4+
author: pthippeswamy
5+
ms.service: azure-storage-mover
6+
ms.topic: overview
7+
ms.date: 08/01/2025
8+
ms.author: pthippeswamy
9+
---
10+
11+
# Azure Storage Discovery: Regional Availability and Planning Guide
12+
13+
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 works.
14+
15+
## Workspace Region Availability
16+
17+
Azure Storage Discovery Workspaces (ASDW) are the foundational resource for configuring and visualizing your storage insights. During the preview phase, workspaces can be created in the following Azure regions:
18+
19+
[!INCLUDE [control-plane-regions](includes/control-plane-regions.md)]
20+
21+
### What This Means for You
22+
23+
The region where your ASDW is deployed determines where the control plane for your discovery experience resides. This includes:
24+
25+
- **Data residency**: Metadata and insights are stored in the region where the workspace is created.
26+
- **Latency**: Choosing a region close to your operational base can improve dashboard responsiveness.
27+
- **Compliance**: Some organizations may have regulatory requirements that dictate where data must reside.
28+
29+
### Planning Guidance
30+
31+
When selecting a region for your workspace:
32+
33+
- **Proximity**: Choose a region geographically close to your primary operations or data sources.
34+
- **Compliance**: Ensure the region aligns with your data residency and compliance policies.
35+
- **Preview Availability**: Confirm that the region is supported in the current release phase (e.g., private preview).
36+
37+
## Regions for Storage Insights Aggregation
38+
39+
While the workspace defines where your insights are processed and stored, the actual data being analyzed comes from storage accounts across multiple regions.
40+
41+
[!INCLUDE [data-plane-regions](includes/data-plane-regions.md)]
42+
43+
### What This Means for You
44+
45+
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:
46+
47+
- **Capacity trends**
48+
- **Activity and transaction volumes**
49+
- **Configuration and security settings**
50+
- **Cost and consumption breakdowns**
51+
52+
These insights are then visualized in your ASDW reports, enabling centralized monitoring of a globally distributed storage estate.
53+
54+
## Best Practices for Regional Planning
55+
56+
To maximize the value of Azure Storage Discovery:
57+
58+
1. **Deploy your workspace in a supported region**: Ensure your chosen region is enabled for workspace creation.
59+
2. **Define scopes strategically**: Use tenant, subscription, or resource group levels to group storage accounts logically.
60+
3. **Use tags for filtering**: Apply Azure tags to storage accounts to selectively include them in your discovery scope.
61+
4. **Verify access**: Ensure users have Contributor access to the ASDW resource to view reports.
62+
5. **Allow time for data to populate**: Metrics typically begin appearing within 24 hours of scope configuration.
63+
64+
## Learn More
65+
66+
- [Azure Resource Tagging](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/tag-resources)
67+
68+
For questions or feedback, contact the team at [[email protected]](mailto:[email protected]).

articles/storage-discovery/discovery-regionalCoverage.md

Lines changed: 0 additions & 58 deletions
This file was deleted.

articles/storage-discovery/discovery-release-notes.md

Whitespace-only changes.
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
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+
---
8+
9+
# Azure Storage Discovery regions
10+
11+
Azure Storage Discovery is currently in PREVIEW and is available in the select regions. Below is the list of regions where storage discovery workspaces can be created:
12+
13+
- France Central
14+
- Canada Central
15+
- East US2
16+
- North Europe
17+
- West Europe
Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
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+
---
8+
9+
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.
10+
- East US2
11+
- West Europe
12+
- North Europe
13+
- Switzerland West
14+
- Switzerland North
15+
- Sweden South
16+
- Spain Central
17+
- Poland Central
18+
- Norway West
19+
- Sweden Central
20+
- Norway East
21+
- Canada Central
22+
- Canada East
23+
- Germany North
24+
- Italy North
25+
- Israel Central
26+
- France South
27+
- France Central
28+
- Germany West Central

articles/storage-discovery/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ metadata:
1212
ms.topic: hub-page
1313
author: pthippeswamy
1414
ms.author: pthippeswamy
15-
ms.date: 06/24/2025
15+
ms.date: 08/01/2025
1616

1717

1818
highlightedContent:
@@ -33,12 +33,12 @@ additionalContent:
3333
# Card
3434
- title: Overview
3535
links:
36-
- url: discovery-deploy-planning.md
36+
- url: deploy-planning.md
3737
text: Planning for a Storage Discovery deployment
38-
- url: discovery-create.md
38+
- url: create-workspace.md
3939
text: Deploying a Storage Discovery resource
4040
# Card
4141
- title: Understand Storage Discovery Pricing
4242
links:
43-
- url: discovery-pricing.md
43+
- url: pricing.md
4444
text: Discovery Pricing

articles/storage-discovery/overview.md

Lines changed: 34 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -4,37 +4,46 @@ description: Storage Discovery provides insights on storage capacity, transactio
44
author: pthippeswamy
55
ms.service: azure-storage-mover
66
ms.topic: overview
7-
ms.date: 06/15/2025
7+
ms.date: 08/01/2025
88
ms.author: pthippeswamy
99
---
1010

11-
<!--
12-
!########################################################
13-
STATUS: DRAFT
11+
## What is Azure Storage Discovery?
1412

15-
CONTENT: NOT STARTED
13+
**Azure Storage Discovery** is a fully managed Azure service that provides deep, actionable insights into your object storage estate across subscriptions, regions, and resource groups. It is designed to simplify data management at scale by offering a unified, no-code experience for analyzing storage usage, activity, configuration, and security posture—all from a single pane of glass in the Azure portal.
1614

17-
REVIEW Stephen/Fabian: NOT STARTED
18-
EDIT PASS: NOT STARTED
15+
With just a few clicks, users can answer critical questions such as:
16+
- How much data do I have across all my storage accounts?
17+
- Which regions or workloads are growing fastest?
18+
- Where can I reduce costs by adjusting access tiers or deleting stale data?
19+
- Are my storage configurations aligned with security and compliance best practices?
1920

20-
Document score: not run
21+
## Azure Storage Discovery delivers value across multiple dimensions:
2122

22-
!########################################################
23-
-->
23+
### Unified Visibility Across the Storage Estate
24+
Gain organization-wide visibility into up to 1 million storage accounts. Discovery aggregates insights across subscriptions, resource groups, and regions, enabling users to monitor their entire storage footprint in one place.
2425

25-
# What is Azure Storage Discovery?
26+
### Actionable Insights Without Engineering Overhead
27+
Out-of-the-box dashboards surface trends in capacity, transactions, errors, and configuration changes. Users can drill down into specific accounts or filter by tags, regions, or redundancy settings - without writing a single line of code or deploying infrastructure.
2628

27-
Azure Storage Discovery provides a centralized view of storage across subscriptions and regions, aggregating metrics on capacity, activity, and configuration. Discovery Workspaces can be customized to track the storage growth and align with business needs, enabling users to drill into specific areas of storage and understand the changes effectively.
29+
### AI-Powered Exploration with Copilot
30+
Integrated with Azure Copilot, Discovery allows users to ask natural language questions like “Which storage accounts have the highest egress this month?” and receive visual, contextual answers powered by KQL behind the scenes.
2831

29-
Multiple scopes can be created within each Discovery Workspace. Each scope can align with the business needs and can be defined per business unit or team to track the growth of storage estate overtime so that long term decisions can be taken
32+
### Security and Compliance Monitoring
33+
Visualize and audit storage configurations to ensure alignment with best practices. Identify accounts with settings that do not align with your business needs and take corrective action.
3034

31-
## Capabilities of Discovery:
32-
### Visibility into the storage estate
33-
Users can understand their entire data estate, including capacity, transactions, compliance, and security. You can drill down into different parts of the data estate, derive insights.
34-
### Data Security and Compliance
35-
Monitoring the implementation of security and compliance modifications across various subscriptions and regions can be complex. Discovery dashboards help visualize storage configuration effortlessly.
36-
### Storage Cost Prediction and Optimization
37-
Discovery advances user’s understanding of storage costs by offering a detailed breakdown of expenses related to storage and transactions, categorized by each operation type at the individual storage account level.
35+
### Long-Term Trend Analysis
36+
With up to 18 months of historical data and automatic backfill of the previous month, Discovery supports long-term planning and workload optimization.
37+
38+
### Seamless Integration and Scalability
39+
Discovery integrates with Azure Storage Center and other data management tools, offering a scalable solution that grows with your data estate.
40+
41+
## Why It Matters
42+
43+
As organizations scale their digital footprint, managing storage across thousands of accounts becomes increasingly complex. Azure Storage Discovery eliminates the need for custom scripts, fragmented dashboards, or manual audits. It empowers storage admins, architects, and governance leads to:
44+
- Make faster, data-driven decisions
45+
- Improve operational efficiency
46+
- Strengthen security posture
3847

3948
## Key concepts
4049

@@ -60,7 +69,7 @@ This configuration means the workspace will monitor storage accounts under the s
6069
6170

6271
### Scope
63-
A Scope in Azure Storage Discovery defines a logical grouping of storage accounts based on user-defined criteria such as resource tags. Scopes are nested within the boundaries defined by workspaceRoots and are used to filter and organize data for reporting and insights. Users have flexibility to define:
72+
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:
6473

6574
- Scope without any ARM tags will include all storage accounts within the defined scope
6675
- Scope with tags enables users to selectively choose specific storage accounts based on Azure tags assigned to the storage accounts.
@@ -69,7 +78,7 @@ A Scope in Azure Storage Discovery defines a logical grouping of storage account
6978

7079
The following articles can help you become familiar with the Storage Discovery service.
7180

72-
- [Planning for an Azure Storage Discovery deployment](discovery-deployment-planning.md)
73-
- [Create Storage Discovery Workspace by using the Azure portal](discovery-create.md)
74-
- [Pricing and billing](discovery-pricing-billing.md)
75-
- [Storage Discovery regional coverage](discovery-regionalCoverage.md)
81+
- [Planning for an Azure Storage Discovery deployment](deployment-planning.md)
82+
- [Create Storage Discovery Workspace by using the Azure portal](create-workspace.md)
83+
- [Pricing and billing](pricing.md)
84+
- [Storage Discovery regional coverage](regionalCoverage.md)

0 commit comments

Comments
 (0)