Skip to content

Commit 3614d63

Browse files
committed
edit pass: log-articles-batch-2
1 parent c56ae06 commit 3614d63

File tree

3 files changed

+149
-124
lines changed

3 files changed

+149
-124
lines changed

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

Lines changed: 28 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -8,13 +8,14 @@ ms.date: 10/01/2022
88

99
# Configure Basic Logs in Azure Monitor
1010

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.
1212

1313
> [!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).
1515
1616
## 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.
1819
You can currently configure the following tables for Basic Logs:
1920

2021
- 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:
3334

3435
1. From the **Log Analytics workspaces** menu, select **Tables**.
3536

36-
The **Tables** screen lists all of the tables in the workspace.
37+
The **Tables** screen lists all the tables in the workspace.
3738

3839
1. Select the context menu for the table you want to configure and select **Manage table**.
3940

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.":::
4142

4243
1. From the **Table plan** dropdown on the table configuration screen, select **Basic** or **Analytics**.
4344

4445
The **Table plan** dropdown is enabled only for [tables that support Basic Logs](#which-tables-support-basic-logs).
4546

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.":::
4748

4849
1. Select **Save**.
4950

@@ -54,6 +55,7 @@ To configure a table for Basic Logs or Analytics Logs, call the **Tables - Updat
5455
```http
5556
PATCH https://management.azure.com/subscriptions/<subscriptionId>/resourcegroups/<resourceGroupName>/providers/Microsoft.OperationalInsights/workspaces/<workspaceName>/tables/<tableName>?api-version=2021-12-01-preview
5657
```
58+
5759
> [!IMPORTANT]
5860
> 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).
5961
@@ -67,7 +69,7 @@ PATCH https://management.azure.com/subscriptions/<subscriptionId>/resourcegroups
6769

6870
This example configures the `ContainerLogV2` table for Basic Logs.
6971

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.
7173

7274
**Sample request**
7375

@@ -97,7 +99,7 @@ Use this request body to change to Analytics Logs:
9799

98100
**Sample response**
99101

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:
101103

102104
Status code: 200
103105

@@ -133,27 +135,28 @@ For example:
133135
```azurecli
134136
az monitor log-analytics workspace table update --subscription ContosoSID --resource-group ContosoRG --workspace-name ContosoWorkspace --name ContainerLogV2 --plan Analytics
135137
```
136-
138+
137139
---
138140
139141
## Check table configuration
142+
140143
# [Portal](#tab/portal-2)
141144
142-
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).
143146
144-
Alternatively:
147+
Alternatively:
145148
146149
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.
148151
149-
Basic Logs tables have a unique icon:
152+
Basic Logs tables have a unique icon:
150153
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":::
152155
153156
You can also hover over a table name for the table information view, which indicates whether the table is configured as Basic Logs:
154157
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+
157160
# [API](#tab/api-2)
158161
159162
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:
162165
GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}?api-version=2021-12-01-preview
163166
```
164167

165-
**Response Body**
168+
**Response body**
166169

167170
|Name | Type | Description |
168171
| --- | --- | --- |
169172
|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.|
172175
|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).
174177

175-
**Sample Request**
178+
**Sample request**
176179

177180
```http
178181
GET https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview
179182
```
180183

181184

182-
**Sample Response**
185+
**Sample response**
183186

184187
Status code: 200
185188
```http
@@ -214,9 +217,9 @@ az monitor log-analytics workspace table show --subscription ContosoSID --resour
214217

215218
Analytics tables retain data based on a [retention and archive policy](data-retention-archive.md) you set.
216219

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.
218221

219222
## Next steps
220223

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)
225+
- [Query data in Basic Logs](basic-logs-query.md)

0 commit comments

Comments
 (0)