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/logs/basic-logs-configure.md
+28-25Lines changed: 28 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,13 +8,14 @@ ms.date: 10/01/2022
8
8
9
9
# Configure Basic Logs in Azure Monitor
10
10
11
-
Setting a table's [log data plan](log-analytics-workspace-overview.md#log-data-plans) to *Basic Logs* lets you save on the cost of storing high-volume verbose logs you use for debugging, troubleshooting and auditing, but not for analytics and alerts. This article describes how to configure Basic Logs for a particular table in your Log Analytics workspace.
11
+
Setting a table's [log data plan](log-analytics-workspace-overview.md#log-data-plans) to *Basic Logs* lets you save on the cost of storing high-volume verbose logs you use for debugging, troubleshooting, and auditing, but not for analytics and alerts. This article describes how to configure Basic Logs for a particular table in your Log Analytics workspace.
12
12
13
13
> [!IMPORTANT]
14
-
> You can switch a table's plan once a week. The Basic Logs feature is not available for workspaces in [legacy pricing tiers](cost-logs.md#legacy-pricing-tiers).
14
+
> You can switch a table's plan once a week. The Basic Logs feature isn't available for workspaces in [legacy pricing tiers](cost-logs.md#legacy-pricing-tiers).
15
15
16
16
## Which tables support Basic Logs?
17
-
By default, all tables in your Log Analytics are Analytics tables, and available for query and alerts.
17
+
18
+
By default, all tables in your Log Analytics are Analytics tables, and available for query and alerts.
18
19
You can currently configure the following tables for Basic Logs:
19
20
20
21
- All custom tables created with or migrated to the [Data Collection Rule (DCR)-based logs ingestion API.](logs-ingestion-api-overview.md)
@@ -33,17 +34,17 @@ To configure a table for Basic Logs or Analytics Logs in the Azure portal:
33
34
34
35
1. From the **Log Analytics workspaces** menu, select **Tables**.
35
36
36
-
The **Tables** screen lists all of the tables in the workspace.
37
+
The **Tables** screen lists all the tables in the workspace.
37
38
38
39
1. Select the context menu for the table you want to configure and select **Manage table**.
39
40
40
-
:::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.":::
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 that shows the Manage table button for one of the tables in a workspace.":::
41
42
42
43
1. From the **Table plan** dropdown on the table configuration screen, select **Basic** or **Analytics**.
43
44
44
45
The **Table plan** dropdown is enabled only for [tables that support Basic Logs](#which-tables-support-basic-logs).
45
46
46
-
:::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.":::
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 that shows the Table plan dropdown on the table configuration screen.":::
47
48
48
49
1. Select **Save**.
49
50
@@ -54,6 +55,7 @@ To configure a table for Basic Logs or Analytics Logs, call the **Tables - Updat
> Use the Bearer token for authentication. Read more about [using Bearer tokens](https://social.technet.microsoft.com/wiki/contents/articles/51140.azure-rest-management-api-the-quickest-way-to-get-your-bearer-token.aspx).
This example configures the `ContainerLogV2` table for Basic Logs.
69
71
70
-
Container Insights uses ContainerLog by default. To switch to using ContainerLogV2 for Container Insights, [enable the ContainerLogV2 schema](../containers/container-insights-logging-v2.md) before you convert the table to Basic Logs.
72
+
Container Insights uses `ContainerLog` by default. To switch to using `ContainerLogV2` for Container Insights, [enable the ContainerLogV2 schema](../containers/container-insights-logging-v2.md) before you convert the table to Basic Logs.
71
73
72
74
**Sample request**
73
75
@@ -97,7 +99,7 @@ Use this request body to change to Analytics Logs:
97
99
98
100
**Sample response**
99
101
100
-
This is the response for a table changed to Basic Logs.
102
+
This sample is the response for a table changed to Basic Logs:
To check table configuration in the Azure portal, you can open the table configuration screen, as described in [Set table configuration](#set-table-configuration).
145
+
To check table configuration in the Azure portal, you can open the table configuration screen, as described in [Set table configuration](#set-table-configuration).
143
146
144
-
Alternatively:
147
+
Alternatively:
145
148
146
149
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.
147
-
1. Open the **Tables** tab, which lists all tables in the workspace.
150
+
1. Open the **Tables** tab, which lists all tables in the workspace.
148
151
149
-
Basic Logs tables have a unique icon:
152
+
Basic Logs tables have a unique icon:
150
153
151
-
:::image type="content" source="media/basic-logs-configure/table-icon.png" alt-text="Screenshot of the Basic Logs table icon in the table list." lightbox="media/basic-logs-configure/table-icon.png":::
154
+
:::image type="content" source="media/basic-logs-configure/table-icon.png" alt-text="Screenshot that shows the Basic Logs table icon in the table list." lightbox="media/basic-logs-configure/table-icon.png":::
152
155
153
156
You can also hover over a table name for the table information view, which indicates whether the table is configured as Basic Logs:
154
157
155
-
:::image type="content" source="media/basic-logs-configure/table-info.png" alt-text="Screenshot of the Basic Logs table indicator in the table details." lightbox="media/basic-logs-configure/table-info.png":::
156
-
158
+
:::image type="content" source="media/basic-logs-configure/table-info.png" alt-text="Screenshot that shows the Basic Logs table indicator in the table details." lightbox="media/basic-logs-configure/table-info.png":::
159
+
157
160
# [API](#tab/api-2)
158
161
159
162
To check the configuration of a table, call the **Tables - Get** API:
@@ -162,24 +165,24 @@ To check the configuration of a table, call the **Tables - Get** API:
162
165
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2021-12-01-preview
163
166
```
164
167
165
-
**Response Body**
168
+
**Response body**
166
169
167
170
|Name | Type | Description |
168
171
| --- | --- | --- |
169
172
|properties.plan | string | The table plan. Either "Analytics" or "Basic". |
170
-
|properties.retentionInDays | integer | The table's data retention in days. In _Basic Logs_, the value is 8 days, fixed. In _Analytics Logs_, the value is between 7 and 730.|
171
-
|properties.totalRetentionInDays | integer | The table's data retention including Archive period|
173
+
|properties.retentionInDays | integer | The table's data retention in days. In _Basic Logs_, the value is 8 days, fixed. In _Analytics Logs_, the value is between 7 and 730.|
174
+
|properties.totalRetentionInDays | integer | The table's data retention including Archive period.|
172
175
|properties.archiveRetentionInDays|integer|The table's archive period (read-only, calculated).|
173
-
|properties.lastPlanModifiedDate|String|Last time when plan was set for this table. Null if no change was ever done from the default settings (read-only)
176
+
|properties.lastPlanModifiedDate|String|Last time when the plan was set for this table. Null if no change was ever done from the default settings (read-only).
174
177
175
-
**Sample Request**
178
+
**Sample request**
176
179
177
180
```http
178
181
GET https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview
179
182
```
180
183
181
184
182
-
**Sample Response**
185
+
**Sample response**
183
186
184
187
Status code: 200
185
188
```http
@@ -214,9 +217,9 @@ az monitor log-analytics workspace table show --subscription ContosoSID --resour
214
217
215
218
Analytics tables retain data based on a [retention and archive policy](data-retention-archive.md) you set.
216
219
217
-
Basic Logs tables retain data for eight days. When you change an existing table's plan to Basic Logs, Azure archives data that is more than eight days old but still within the table's original retention period.
220
+
Basic Logs tables retain data for eight days. When you change an existing table's plan to Basic Logs, Azure archives data that's more than eight days old but still within the table's original retention period.
218
221
219
222
## Next steps
220
223
221
-
-[Learn more about the different log plans.](log-analytics-workspace-overview.md#log-data-plans)
222
-
-[Query data in Basic Logs.](basic-logs-query.md)
224
+
-[Learn more about the different log plans](log-analytics-workspace-overview.md#log-data-plans)
0 commit comments