Skip to content

Commit 3837a92

Browse files
authored
Merge pull request #198017 from guywi-ms/la-tables-ui
Add table configuration in portal
2 parents f2a10c4 + 89ecfdb commit 3837a92

File tree

6 files changed

+51
-11
lines changed

6 files changed

+51
-11
lines changed

articles/azure-monitor/logs/basic-logs-configure.md

Lines changed: 26 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,27 @@ You can currently configure the following tables for Basic Logs:
2727
2828

2929
## Set table configuration
30+
31+
# [Portal](#tab/portal-1)
32+
33+
To configure a table for Basic Logs or Analytics Logs in the Azure portal:
34+
35+
1. From the **Log Analytics workspaces** menu, select **Tables (preview)**.
36+
37+
The **Tables (preview)** screen lists all of the tables in the workspace.
38+
39+
1. Select the context menu for the table you want to configure and select **Manage table**.
40+
41+
:::image type="content" source="media/basic-logs-configure/log-analytics-table-configuration.png" lightbox="media/basic-logs-configure/log-analytics-table-configuration.png" alt-text="Screenshot showing the Manage table button for one of the tables in a workspace.":::
42+
43+
1. From the **Table plan** dropdown on the table configuration screen, select **Basic** or **Analytics**.
44+
45+
The **Table plan** dropdown is enabled only for [tables that support Basic Logs](#which-tables-support-basic-logs).
46+
47+
:::image type="content" source="media/basic-logs-configure/log-analytics-configure-table-plan.png" lightbox="media/basic-logs-configure/log-analytics-configure-table-plan.png" alt-text="Screenshot showing the Table plan dropdown on the table configuration screen.":::
48+
49+
1. Select **Save**.
50+
3051
# [API](#tab/api-1)
3152

3253
To configure a table for Basic Logs or Analytics Logs, call the **Tables - Update** API:
@@ -117,9 +138,11 @@ For example:
117138
---
118139
119140
## Check table configuration
120-
# [Portal](#tab/portal-1)
141+
# [Portal](#tab/portal-2)
142+
143+
To check table configuration in the Azure portal, you can open the table configuration screen, as described in [Set table configuration](#set-table-configuration).
121144
122-
To check the configuration of a table in the Azure portal:
145+
Alternatively:
123146
124147
1. From the **Azure Monitor** menu, select **Logs** and select your workspace for the [scope](scope.md). See [Log Analytics tutorial](log-analytics-tutorial.md#view-table-information) for a walkthrough.
125148
1. Open the **Tables** tab, which lists all tables in the workspace.
@@ -128,7 +151,7 @@ To check the configuration of a table in the Azure portal:
128151
129152
![Screenshot of the Basic Logs table icon in the table list.](./media/basic-logs-configure/table-icon.png#lightbox)
130153
131-
You can also hover over a table name for the table information view. This will specify that the table is configured as Basic Logs:
154+
You can also hover over a table name for the table information view, which indicates whether the table is configured as Basic Logs:
132155
133156
![Screenshot of the Basic Logs table indicator in the table details.](./media/basic-logs-configure/table-info.png#lightbox)
134157

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

Lines changed: 25 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ During the interactive retention period, data is available for monitoring, troub
2323
> The archive feature is currently in public preview and can only be set at the table level, not at the workspace level.
2424
2525
## Configure the default workspace retention policy
26-
You can set the workspace default retention policy in the Azure portal to 30, 31, 60, 90, 120, 180, 270, 365, 550, and 730 days. To set a different policy, use the Resource Manager configuration method described below. If you're on the *free* tier, you need to upgrade to the paid tier to change the data retention period.
26+
You can set the workspace default retention policy in the Azure portal to 30, 31, 60, 90, 120, 180, 270, 365, 550, and 730 days. You can set a different policy for specific tables by [configuring 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.
2727

2828
To set the default workspace retention policy:
2929

@@ -37,17 +37,25 @@ To set the default workspace retention policy:
3737

3838
## Set retention and archive policy by table
3939

40-
You can set retention policies for individual tables, except for workspaces in the legacy Free Trial pricing tier, using Azure Resource Manager APIs. You can’t currently configure data retention for individual tables in the Azure portal.
40+
By default, all tables in your workspace inherit the workspace's interactive retention setting and have no archive policy. You can modify the retention and archive policies of individual tables, except for workspaces in the legacy Free Trial pricing tier.
4141

4242
You can keep data in interactive retention between 4 and 730 days. You can set the archive period for a total retention time of up to 2,555 days (seven years).
4343

44-
Each table is a subresource of the workspace it's in. For example, you can address the `SecurityEvent` table in [Azure Resource Manager](../../azure-resource-manager/management/overview.md) as:
44+
# [Portal](#tab/portal-1)
4545

46-
```
47-
/subscriptions/00000000-0000-0000-0000-00000000000/resourceGroups/MyResourceGroupName/providers/Microsoft.OperationalInsights/workspaces/MyWorkspaceName/Tables/SecurityEvent
48-
```
46+
To set the retention and archive duration for a table in the Azure portal:
47+
48+
1. From the **Log Analytics workspaces** menu, select **Tables (preview)**.
49+
50+
The **Tables (preview)** screen lists all of the tables in the workspace.
51+
52+
1. Select the context menu for the table you want to configure and select **Manage table**.
53+
54+
:::image type="content" source="media/basic-logs-configure/log-analytics-table-configuration.png" lightbox="media/basic-logs-configure/log-analytics-table-configuration.png" alt-text="Screenshot showing the Manage table button for one of the tables in a workspace.":::
4955

50-
The table name is case-sensitive.
56+
1. Configure the retention and archive duration in **Data retention settings** section of the table configuration screen.
57+
58+
:::image type="content" source="media/data-retention-configure/log-analytics-configure-table-retention-archive.png" lightbox="media/data-retention-configure/log-analytics-configure-table-retention-archive.png" alt-text="Screenshot showing the data retention settings on the table configuration screen.":::
5159

5260
# [API](#tab/api-1)
5361

@@ -58,7 +66,7 @@ PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups
5866
```
5967

6068
> [!NOTE]
61-
> You don't explicitly specify the archive duration in the API call. Instead, you set the total retention, which specifies the retention plus the archive duration.
69+
> You don't explicitly specify the archive duration in the API call. Instead, you set the total retention, which is the sum of the interactive retention plus the archive duration.
6270
6371

6472
You can use either PUT or PATCH, with the following difference:
@@ -133,6 +141,15 @@ az monitor log-analytics workspace table update --subscription ContosoSID --reso
133141

134142
## Get retention and archive policy by table
135143

144+
# [Portal](#tab/portal-2)
145+
146+
To view the retention and archive duration for a table in the Azure portal, from the **Log Analytics workspaces** menu, select **Tables (preview)**.
147+
148+
The **Tables (preview)** screen shows the interactive retention and archive period for all of the tables in the workspace.
149+
150+
:::image type="content" source="media/data-retention-configure/log-analytics-view-table-retention-archive.png" lightbox="media/data-retention-configure/log-analytics-view-table-retention-archive.png" alt-text="Screenshot showing the Manage table button for one of the tables in a workspace.":::
151+
152+
136153
# [API](#tab/api-2)
137154

138155
To get the retention policy of a particular table (in this example, `SecurityEvent`), call the **Tables - Get** API:
136 KB
Loading
93.5 KB
Loading
145 KB
Loading
133 KB
Loading

0 commit comments

Comments
 (0)