Skip to content

Commit 0273bf1

Browse files
committed
updates from Meir
1 parent 582d802 commit 0273bf1

File tree

2 files changed

+19
-18
lines changed

2 files changed

+19
-18
lines changed

articles/azure-monitor/agents/azure-monitor-agent-migration.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,6 +114,8 @@ When you migrate the following services, which currently use Log Analytics agent
114114
| :--- | :--- | :--- | :--- |
115115
| [Update Management](../../automation/update-management/overview.md) | Update Management Center - Public preview (no dependency on Log Analytics agents or Azure Monitor Agent) | None | [Update management center (Public preview with Azure Monitor Agent) documentation](../../update-center/index.yml) |
116116
| [Automation Hybrid Runbook Worker overview](../../automation/automation-hybrid-runbook-worker.md) | Automation Hybrid Worker Extension - Generally available (no dependency on Log Analytics agents or Azure Monitor Agent) | None | [Migrate an existing Agent based to Extension based Hybrid Workers](../../automation/extension-based-hybrid-runbook-worker-install.md#migrate-an-existing-agent-based-to-extension-based-hybrid-workers) |
117+
| [Defender for Servers] | | |
118+
117119
118120
## Next steps
119121

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

Lines changed: 17 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,15 +9,16 @@ ms.date: 6/28/2023
99

1010
# Data retention and archive in Azure Monitor Logs
1111

12-
Data is retained in Azure Monitor Logs in two modes:
13-
* **Interactive Retention**: Allow you to retain Analytics logs for [interactive queries](../logs/get-started-queries.md) of up to 2 years.
14-
* **Archive**: Let you keep older, less used data in your workspace at a reduced cost. Data in archive can be accessed by [Search Jobs](../logs/search-jobs.md) and [Restore](../logs/restore.md). You can keep in Archive logs up to 7 years. In the coming months, it would be possible to extend archive to 12 years.
12+
Azure Monitor Logs retains data in two states:
13+
14+
* **Interactive retention**: Lets you retain Analytics logs for [interactive queries](../logs/get-started-queries.md) of up to 2 years.
15+
* **Archive**: Lets you keep older, less used data in your workspace at a reduced cost. You can access data in the archived state by using [search jobs](../logs/search-jobs.md) and [restore](../logs/restore.md). You can currently keep data in archived state for up to 7 years. In the coming months, it will be possible to extend archive to 12 years.
1516

1617
This article describes how to configure data retention and archiving.
1718

1819
## How retention and archiving work
1920

20-
Each workspace has a default retention that's applied to all tables. You can set a different retention setting on individual tables.
21+
Each workspace has a default retention setting that's applied to all tables. You can configure a different retention setting on individual tables.
2122

2223
:::image type="content" source="media/data-retention-configure/retention-archive.png" alt-text="Diagram that shows an overview of data retention and archive periods.":::
2324

@@ -29,22 +30,21 @@ You can access archived data by [running a search job](search-jobs.md) or [resto
2930

3031
> [!NOTE]
3132
> The archive period can only be set at the table level, not at the workspace level.
32-
33-
## Permissions
34-
35-
To configure set data retention and archiving, you must have at least [contributor rights](../logs/manage-access.md#azure-rbac).
36-
3733
### Adjustments to retention and archive settings
3834

39-
When you shorten an existing retention setting, Azure Monitor waits 30 days before removing the data, so you can revert the change and prevent data loss in the event of an error in configuration. You can [purge data](#purge-retained-data) immediately when required.
35+
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.
4036

4137
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.
4238

4339
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.
4440

41+
## Permissions
42+
43+
To configure set data retention and archiving, you must have at least [contributor rights](../logs/manage-access.md#azure-rbac).
44+
4545
## Configure the default workspace retention
4646

47-
You can set the workspace default retention in the Azure portal to 30, 31, 60, 90, 120, 180, 270, 365, 550, and 730 days. You can set a different for specific tables by [configuring the retention and archive policy at the table level](#set-retention-and-archive-policy-by-table). If you're on the *free* tier, you'll need to upgrade to the paid tier to change the data retention period.
47+
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.
4848

4949
To set the default workspace retention:
5050

@@ -56,11 +56,14 @@ To set the default workspace retention:
5656

5757
1. Move the slider to increase or decrease the number of days, and then select **OK**.
5858

59-
## Set retention and archive by table
59+
## Configure retention and archive at the table level
6060

6161
By default, all tables in your workspace inherit the workspace's interactive retention setting and have no archive. You can modify the retention and archive settings of individual tables, except for workspaces in the legacy Free Trial pricing tier.
6262

63-
The Analytics log data plan includes 30 days of interactive retention. You can increase the interactive retention period to up to 730 days at an [additional cost](https://azure.microsoft.com/pricing/details/monitor/). If needed, you can reduce the interactive retention period to as low as four days using the API or CLI, however, since 30 days are included in the ingestion price, lowering the retention period below 30 days does not reduce costs. You can set the archive period to a total retention time of up to 2,556 days (seven years).
63+
The Analytics log data plan includes 30 days of interactive retention. You can increase the interactive retention period to up to 730 days at an [additional cost](https://azure.microsoft.com/pricing/details/monitor/). If needed, you can reduce the interactive retention period to as little as four days using the API or CLI. However, since 30 days are included in the ingestion price, lowering the retention period below 30 days doesn't reduce costs. You can set the archive period to a total retention time of up to 2,556 days (seven years).
64+
65+
> [!NOTE]
66+
> In the coming months, new settings will enable retaining data for up to 12 years.
6467
6568
# [Portal](#tab/portal-1)
6669

@@ -100,13 +103,9 @@ The request body includes the values in the following table.
100103

101104
|Name | Type | Description |
102105
| --- | --- | --- |
103-
|properties.retentionInDays | integer | The table's data retention in days. This value can be between 4 and 730. <br/>Setting this property to null will default to the workspace retention. For a Basic Logs table, the value is always 8. |
106+
|properties.retentionInDays | integer | The table's data retention in days. This value can be between 4 and 730. <br/>Setting this property to null applies the workspace retention period. For a Basic Logs table, the value is always 8. |
104107
|properties.totalRetentionInDays | integer | The table's total data retention including archive period. This value can be between 4 and 730; or 1095, 1460, 1826, 2191, or 2556. Set this property to null if you don't want to archive data. |
105108

106-
> [!NOTE]
107-
> In the coming months, additional settings will be available to allow retention of up to 12 years.
108-
109-
110109
**Example**
111110

112111
This example sets the table's interactive retention to the workspace default of 30 days, and the total retention to two years, which means that the archive duration is 23 months.

0 commit comments

Comments
 (0)