Skip to content

Commit 9ebf640

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into wi229472-permission-management
2 parents cb1255f + 6dfd032 commit 9ebf640

File tree

8 files changed

+55
-71
lines changed

8 files changed

+55
-71
lines changed

articles/azure-monitor/cost-estimate.md

Lines changed: 0 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -41,17 +41,6 @@ This section includes charges for the ingestion and query of Prometheus metrics
4141
| Metric Sample Ingestion | Number and frequency of the Prometheus metrics collected by your AKS nodes. See [Default Prometheus metrics configuration in Azure Monitor](containers/prometheus-metrics-scrape-default.md). |
4242
| Query Samples Processed | Number of query samples can be estimated from the dashboards and alerting rules that use them. |
4343

44-
45-
## Application Insights
46-
This section includes charges from [classic Application Insights resources](app/convert-classic-resource.md). Workspace-based Application Insights resources are included in the Log Data Ingestion category.
47-
48-
| Category | Description |
49-
|:---|:---|
50-
| Data ingestion | Volume of data that you expect from your classic Application Insights resources. This can be difficult to estimate so you should enable monitoring for a small group of resources and use the observed data volumes to extrapolate for a full environment. |
51-
| Data Retention | [Data retention setting](logs/data-retention-archive.md#set-data-retention-for-classic-application-insights-resources) for your classic Application Insights resources. |
52-
| Multi-step Web Test | Number of legacy [multi-step web tests](/previous-versions/azure/azure-monitor/app/availability-multistep) that you expect to run. |
53-
54-
5544
## Alert rules
5645
This section includes charges for alert rules.
5746

articles/azure-monitor/logs/create-custom-table.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -151,11 +151,10 @@ Use the [Tables - Update PATCH API](/rest/api/loganalytics/tables/update) to cre
151151

152152
## Delete a table
153153

154-
There are several types of tables in Log Analytics and the delete experience is different for each:
155-
- [Azure table](../logs/manage-logs-tables.md#table-type-and-schema) -- Can't be deleted. Tables that are part of a solution are removed from workspace when [deleting the solution](/cli/azure/monitor/log-analytics/solution#az-monitor-log-analytics-solution-delete), but data remains in workspace for the duration of the retention policy defined for the tables, or if not exist, for the duration of the retention policy defined in workspace. If the [solution is re-created](/cli/azure/monitor/log-analytics/solution#az-monitor-log-analytics-solution-create) in the workspace, these tables and previously ingested data become visible again. To avoid charges, define [retention policy for tables in solutions](/rest/api/loganalytics/tables/update) to minimum (4-days) before deleting the solution.
156-
- [Restored table](./restore.md) (table_RST) -- Deletes the hot cache provisioned for the restore, but source table data isn't deleted.
157-
- [Search results table](./search-jobs.md) (table_SRCH) -- Deletes the table and data immediately and permanently.
158-
- [Custom log table](./create-custom-table.md#create-a-custom-table) (table_CL) -- Deletes the table definition immediately, but data remains in workspace for the duration of the retention policy defined for the table, or workspace. The retention policy for table is removed in 14-days and workspace retention governs. If custom log table is created with the same name and schema, the table and previously ingested data become visible again. To avoid charges and remove data from table, define [retention policy for table](/rest/api/loganalytics/tables/update) to minimum (4-days) before deleting the table.
154+
There are several types of tables in Azure Monitor Logs. You can delete any table that's not an Azure table, but what happens to the data when you delete the table is different for each type of table.
155+
156+
For more information, see [What happens to data when you delete a table in a Log Analytics workspace](../logs/data-retention-archive.md#what-happens-to-data-when-you-delete-a-table-in-a-log-analytics-workspace).
157+
159158

160159
# [Portal](#tab/azure-portal-2)
161160

articles/azure-monitor/logs/data-retention-archive.md

Lines changed: 38 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -33,26 +33,37 @@ You can access archived data by [running a search job](search-jobs.md) or [resto
3333
3434
### Adjustments to retention and archive settings
3535

36-
When you shorten an existing retention setting, Azure Monitor waits 30 days before removing the data, so you can revert the change and avoid data loss in the event of an error in configuration. You can [purge data](#purge-retained-data) immediately when required.
36+
When you shorten an existing retention setting, Azure Monitor waits 30 days before removing the data, so you can revert the change and avoid data loss in the event of an error in configuration. You can [purge data](../logs/personal-data-mgmt.md#delete) immediately when required.
3737

3838
When you increase the retention setting, the new retention period applies to all data that's already been ingested into the table and hasn't yet been purged or removed.
3939

4040
If you change the archive settings on a table with existing data, the relevant data in the table is also affected immediately. For example, you might have an existing table with 180 days of interactive retention and no archive period. You decide to change the retention setting to 90 days of interactive retention without changing the total retention period of 180 days. Log Analytics immediately archives any data that's older than 90 days and none of the data is deleted.
4141

42+
### What happens to data when you delete a table in a Log Analytics workspace
43+
44+
A Log Analytics workspace can contain several [types of tables](../logs/manage-logs-tables.md#table-type-and-schema). What happens when you delete the table is different for each:
45+
46+
|Table type|Data retention|Recommendations|
47+
|-|-|-|
48+
|Azure table |An Azure table holds logs from an Azure resource or data required by an Azure service or solution and cannot be deleted. When you stop streaming data from the resource, service, or solution, data remains in the workspace until the end of the retention period defined for the table or for the default workspace retention, if you do not define table-level retention. |To minimize charges, set [table-level retention](#configure-retention-and-archive-at-the-table-level) to four days before you stop streaming logs to the table.|
49+
|[Restored table](./restore.md) `(table_RST`)| Deletes the hot cache provisioned for the restore, but source table data isn't deleted.||
50+
|[Search results table](./search-jobs.md) (`table_SRCH`)| Deletes the table and data immediately and permanently.||
51+
|[Custom log table](./create-custom-table.md#create-a-custom-table) (`table_CL`)| Soft deletes the table until the end of the table-level retention or default workspace retention period. During the soft delete period, you continue to pay for data retention and can recreate the table and access the data by setting up a table with the same name and schema. Fourteen days after you delete a custom table, Azure Monitor removes the table-level retention configuration and applies the default workspace retention.|To minimize charges, set [table-level retention](#configure-retention-and-archive-at-the-table-level) to four days before you delete the table.|
52+
4253
## Permissions required
4354

4455
| Action | Permissions required |
4556
|:-------|:---------------------|
4657
| Configure data retention and archive policies for a Log Analytics workspace | `Microsoft.OperationalInsights/workspaces/write` and `microsoft.operationalinsights/workspaces/tables/write` permissions to the Log Analytics workspace, as provided by the [Log Analytics Contributor built-in role](./manage-access.md#log-analytics-contributor), for example |
4758
| Get the retention and archive policy by table for a Log Analytics workspace | `Microsoft.OperationalInsights/workspaces/tables/read` permissions to the Log Analytics workspace, as provided by the [Log Analytics Reader built-in role](./manage-access.md#log-analytics-reader), for example |
4859
| Purge data from a Log Analytics workspace | `Microsoft.OperationalInsights/workspaces/purge/action` permissions to the Log Analytics workspace, as provided by the [Log Analytics Contributor built-in role](./manage-access.md#log-analytics-contributor), for example |
49-
| Set data retention for a classic Application Insights resource | `microsoft.insights/components/write` permissions to the classic Application Insights resource, as provided by the [Application Insights Component Contributor built-in role](../../role-based-access-control/built-in-roles.md#application-insights-component-contributor), for example |
50-
| Purge data from a classic Application Insights resource | `Microsoft.Insights/components/purge/action` permissions to the classic Application Insights resource, as provided by the [Application Insights Component Contributor built-in role](../../role-based-access-control/built-in-roles.md#application-insights-component-contributor), for example |
51-
5260
## Configure the default workspace retention
5361

5462
You can set a Log Analytics workspace's default retention in the Azure portal to 30, 31, 60, 90, 120, 180, 270, 365, 550, and 730 days. You can apply a different setting to specific tables by [configuring retention and archive at the table level](#configure-retention-and-archive-at-the-table-level). If you're on the *free* tier, you need to upgrade to the paid tier to change the data retention period.
5563

64+
> [!IMPORTANT]
65+
> Workspaces with a 30-day retention might keep data for 31 days. If you need to retain data for 30 days only to comply with a privacy policy, configure the default workspace retention to 30 days using the API and update the `immediatePurgeDataOn30Days` workspace property to `true`. This operation is currently only supported using the [Workspaces - Update API](/rest/api/loganalytics/workspaces/update).
66+
5667
# [Portal](#tab/portal-3)
5768

5869
To set the default workspace retention:
@@ -67,7 +78,7 @@ To set the default workspace retention:
6778

6879
# [API](#tab/api-3)
6980

70-
To set the retention and archive duration for a table, call the [Workspaces - Update API](/rest/api/azureml/workspaces/update):
81+
To set the retention and archive duration for a table, call the [Workspaces - Create Or Update API](/rest/api/loganalytics/workspaces/create-or-update):
7182

7283
```http
7384
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01
@@ -79,23 +90,27 @@ The request body includes the values in the following table.
7990

8091
|Name | Type | Description |
8192
| --- | --- | --- |
82-
|properties.retentionInDays | integer | The workspace data retention in days. Allowed values are per pricing plan. See pricing tiers documentation for details. |
93+
|`properties.retentionInDays` | integer | The workspace data retention in days. Allowed values are per pricing plan. See pricing tiers documentation for details. |
94+
|`location`|string| The geo-location of the resource.|
95+
|`immediatePurgeDataOn30Days`|boolean|Flag that indicates whether data is immediately removed after 30 days and is non-recoverable. Applicable only when workspace retention is set to 30 days.|
96+
8397

8498
**Example**
8599

86-
This example sets the workspace's retention to the workspace default of 30 days.
100+
This example sets the workspace's retention to the workspace default of 30 days and ensures that data is immediately removed after 30 days and is non-recoverable.
87101

88102
**Request**
89103

90104
```http
91-
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-00000000000/resourcegroups/oiautorest6685/providers/Microsoft.OperationalInsights/workspaces/oiautorest6685?api-version=2023-09-01
105+
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}?api-version=2023-09-01
92106
93107
{
94108
"properties": {
95109
"retentionInDays": 30,
96-
}
110+
"features": {"immediatePurgeDataOn30Days": true}
111+
},
112+
"location": "australiasoutheast"
97113
}
98-
```
99114
100115
**Response**
101116
@@ -104,15 +119,18 @@ Status code: 200
104119
```http
105120
{
106121
"properties": {
122+
...
107123
"retentionInDays": 30,
108-
},
109-
"location": "australiasoutheast",
110-
"tags": {
111-
"tag1": "val1"
112-
}
113-
}
124+
"features": {
125+
"legacy": 0,
126+
"searchVersion": 1,
127+
"immediatePurgeDataOn30Days": true,
128+
...
129+
},
130+
...
114131
```
115132

133+
116134
# [CLI](#tab/cli-3)
117135

118136
To set the retention and archive duration for a table, run the [az monitor log-analytics workspace update](/cli/azure/monitor/log-analytics/workspace/#az-monitor-log-analytics-workspace-update) command and pass the `--retention-time` parameter.
@@ -307,16 +325,6 @@ Get-AzOperationalInsightsTable -ResourceGroupName ContosoRG -WorkspaceName Conto
307325

308326
---
309327

310-
## Purge retained data
311-
312-
If you set the data retention to 30 days, you can purge older data immediately by using the `immediatePurgeDataOn30Days` parameter in Azure Resource Manager. The purge functionality is useful when you need to remove personal data immediately. The immediate purge functionality isn't available through the Azure portal.
313-
314-
Workspaces with a 30-day retention might keep data for 31 days if you don't set the `immediatePurgeDataOn30Days` parameter.
315-
316-
You can also purge data from a workspace by using the [purge feature](personal-data-mgmt.md#exporting-and-deleting-personal-data), which removes personal data. You can't purge data from archived logs.
317-
318-
> [!IMPORTANT]
319-
> The Log Analytics [Purge feature](/rest/api/loganalytics/workspacepurge/purge) doesn't affect your retention costs. To lower retention costs, decrease the retention period for the workspace or for specific tables.
320328

321329
## Tables with unique retention periods
322330

@@ -342,22 +350,10 @@ The charge for maintaining archived logs is calculated based on the volume of da
342350

343351
For more information, see [Azure Monitor pricing](https://azure.microsoft.com/pricing/details/monitor/).
344352

345-
## Set data retention for classic Application Insights resources
346-
347-
Workspace-based Application Insights resources store data in a Log Analytics workspace, so it's included in the data retention and archive settings for the workspace. Classic Application Insights resources have separate retention settings.
348-
349-
The default retention for Application Insights resources is 90 days. You can select different retention periods for each Application Insights resource. The full set of available retention periods is 30, 60, 90, 120, 180, 270, 365, 550, or 730 days.
350-
351-
To change the retention, from your Application Insights resource, go to the **Usage and estimated costs** page and select the **Data retention** option.
352-
353-
:::image type="content" source="../app/media/pricing/pricing-005.png" lightbox="../app/media/pricing/pricing-005.png" alt-text="Screenshot that shows where to change the data retention period.":::
354-
355-
A several-day grace period begins when the retention is lowered before the oldest data is removed.
356-
357-
The retention can also be [set programmatically with PowerShell](../app/powershell.md#set-the-data-retention) by using the `retentionInDays` parameter. If you set the data retention to 30 days, you can trigger an immediate purge of older data by using the `immediatePurgeDataOn30Days` parameter. This approach might be useful for compliance-related scenarios. This purge functionality is only exposed via Azure Resource Manager and should be used with extreme care. The daily reset time for the data volume cap can be configured by using Azure Resource Manager to set the `dailyQuotaResetTime` parameter.
358-
359353
## Next steps
360354

361-
- [Learn more about Log Analytics workspaces and data retention and archive](log-analytics-workspace-overview.md)
362-
- [Create a search job to retrieve archive data matching particular criteria](search-jobs.md)
355+
Learn more about:
356+
357+
- [Managing personal data in Azure Monitor Logs](../logs/personal-data-mgmt.md)
358+
- [Creating a search job to retrieve archive data matching particular criteria](search-jobs.md)
363359
- [Restore archive data within a particular time range](restore.md)

articles/azure-monitor/logs/personal-data-mgmt.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Managing personal data in Azure Monitor Log Analytics and Application Insights
2+
title: Managing personal data in Azure Monitor Logs and Application Insights
33
description: This article describes how to manage personal data stored in Azure Monitor Log Analytics and the methods to identify and remove it.
44
ms.topic: conceptual
55
author: guywild
@@ -10,7 +10,7 @@ ms.date: 06/28/2022
1010

1111
---
1212

13-
# Managing personal data in Log Analytics and Application Insights
13+
# Managing personal data in Azure Monitor Logs and Application Insights
1414

1515
Log Analytics is a data store where personal data is likely to be found. Application Insights stores its data in a Log Analytics partition. This article explains where Log Analytics and Application Insights store personal data and how to manage this data.
1616

@@ -92,7 +92,7 @@ You need to implement the logic for converting the data to an appropriate format
9292
> [!WARNING]
9393
> Deletes in Log Analytics are destructive and non-reversible! Please use extreme caution in their execution.
9494
95-
Azure Monitor's Purge API lets you delete personal data. Use the purge operation sparingly to avoid potential risks, performance impact, and the potential to skew all-up aggregations, measurements, and other aspects of your Log Analytics data. See the [Strategy for personal data handling](#strategy-for-personal-data-handling) section for alternative approaches to handling personal data.
95+
Azure Monitor's [Purge API](/rest/api/loganalytics/workspacepurge/purge) lets you delete personal data. Use the purge operation sparingly to avoid potential risks, performance impact, and the potential to skew all-up aggregations, measurements, and other aspects of your Log Analytics data. See the [Strategy for personal data handling](#strategy-for-personal-data-handling) section for alternative approaches to handling personal data.
9696
9797
Purge is a highly privileged operation. Grant the _Data Purger_ role in Azure Resource Manager cautiously due to the potential for data loss.
9898

articles/defender-for-iot/organizations/how-to-manage-individual-sensors.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -244,7 +244,7 @@ This procedure describes how to turn off learning mode manually if you feel that
244244

245245
## Update a sensor's monitoring interfaces (configure ERSPAN)
246246

247-
You may want to change the interfaces used by your sensor to monitor traffic. You'd originally configured these details as part of your [initial sensor setup](ot-deploy/activate-deploy-sensor.md#define-the-interfaces-you-want-to-monitor), but may need to modify the settings as part of system maintenance, such as configuring ERSPAN monitoring.
247+
You may want to change the interfaces used by your sensor to monitor traffic. You originally configured these details as part of your [initial sensor setup](ot-deploy/activate-deploy-sensor.md#define-the-interfaces-you-want-to-monitor), but may need to modify the settings as part of system maintenance, such as configuring ERSPAN monitoring.
248248

249249
For more information, see [ERSPAN ports](best-practices/traffic-mirroring-methods.md#erspan-ports).
250250

articles/private-5g-core/azure-stack-edge-virtual-machine-sizing.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ The following table lists the maximum supported limits for a range of parameters
2121
| PDU sessions | Enterprise radios typically support up to 1000 simultaneous PDU sessions per radio |
2222
| Bandwidth | Over 25 Gbps per ASE |
2323
| RAN nodes (eNB/gNB) | 200 per packet core |
24-
| UEs | 10,000 per deployment (all sites) |
25-
| SIMs | 1000 per ASE |
26-
| SIM provisioning | 1000 per API call |
24+
| Active UEs | 10,000 per deployment (all sites) |
25+
| SIMs | 20,000 per ASE |
26+
| SIM provisioning | 10,000 per JSON file via Azure portal, 4MB per REST API call |
2727

2828
Your chosen service package may define lower limits, with overage charges for exceeding them - see [Azure Private 5G Core pricing](https://azure.microsoft.com/pricing/details/private-5g-core/) for details. If you require higher throughput for your use case, please contact us to discuss your needs.
2929

0 commit comments

Comments
 (0)