You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/azure-monitor/agents/azure-monitor-agent-migration.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -114,6 +114,8 @@ When you migrate the following services, which currently use Log Analytics agent
114
114
| :--- | :--- | :--- | :--- |
115
115
| [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) |
116
116
| [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) |
Copy file name to clipboardExpand all lines: articles/azure-monitor/logs/data-retention-archive.md
+17-18Lines changed: 17 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,15 +9,16 @@ ms.date: 6/28/2023
9
9
10
10
# Data retention and archive in Azure Monitor Logs
11
11
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.
15
16
16
17
This article describes how to configure data retention and archiving.
17
18
18
19
## How retention and archiving work
19
20
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.
21
22
22
23
:::image type="content" source="media/data-retention-configure/retention-archive.png" alt-text="Diagram that shows an overview of data retention and archive periods.":::
23
24
@@ -29,22 +30,21 @@ You can access archived data by [running a search job](search-jobs.md) or [resto
29
30
30
31
> [!NOTE]
31
32
> 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
-
37
33
### Adjustments to retention and archive settings
38
34
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.
40
36
41
37
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.
42
38
43
39
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.
44
40
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
+
45
45
## Configure the default workspace retention
46
46
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.
48
48
49
49
To set the default workspace retention:
50
50
@@ -56,11 +56,14 @@ To set the default workspace retention:
56
56
57
57
1. Move the slider to increase or decrease the number of days, and then select **OK**.
58
58
59
-
## Set retention and archive by table
59
+
## Configure retention and archive at the table level
60
60
61
61
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.
62
62
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.
64
67
65
68
# [Portal](#tab/portal-1)
66
69
@@ -100,13 +103,9 @@ The request body includes the values in the following table.
100
103
101
104
|Name | Type | Description |
102
105
| --- | --- | --- |
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. |
104
107
|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. |
105
108
106
-
> [!NOTE]
107
-
> In the coming months, additional settings will be available to allow retention of up to 12 years.
108
-
109
-
110
109
**Example**
111
110
112
111
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