Skip to content

Commit ddc28f1

Browse files
committed
edit pass: log-articles-batch-2
1 parent 1770630 commit ddc28f1

File tree

1 file changed

+16
-18
lines changed

1 file changed

+16
-18
lines changed

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

Lines changed: 16 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,29 @@
11
---
22
title: Configure Basic Logs in Azure Monitor
3-
description: Configure a table for Basic Logs in Azure Monitor.
3+
description: Learn how to configure a table for Basic Logs in Azure Monitor.
44
ms.topic: conceptual
55
ms.custom: event-tier1-build-2022
66
ms.date: 10/01/2022
77
---
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]
1414
> 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?
1717

18-
By default, all tables in your Log Analytics are Analytics tables, and available for query and alerts.
19-
You can currently configure the following tables for Basic Logs:
18+
By default, all tables in your Log Analytics workspace are Analytics tables, and they're available for query and alerts. You can currently configure the following tables for Basic Logs:
2019

21-
- All custom tables created with or migrated to the [Data Collection Rule (DCR)-based logs ingestion API.](logs-ingestion-api-overview.md)
22-
- [ContainerLogV2](/azure/azure-monitor/reference/tables/containerlogv2) - Used in [Container Insights](../containers/container-insights-overview.md) and includes verbose text-based log records.
23-
- [AppTraces](/azure/azure-monitor/reference/tables/apptraces) - Freeform Application Insights traces.
24-
- [ContainerAppConsoleLogs](/azure/azure-monitor/reference/tables/ContainerAppConsoleLogs) - Logs generated by Container Apps, within a Container App environment.
20+
- Custom tables: All custom tables created with or migrated to the [data collection rule (DCR)-based logs ingestion API.](logs-ingestion-api-overview.md)
21+
- [ContainerLogV2](/azure/azure-monitor/reference/tables/containerlogv2): Used in [Container insights](../containers/container-insights-overview.md) and includes verbose text-based log records.
22+
- [AppTraces](/azure/azure-monitor/reference/tables/apptraces): Freeform Application Insights traces.
23+
- [ContainerAppConsoleLogs](/azure/azure-monitor/reference/tables/ContainerAppConsoleLogs): Logs generated by Azure Container Apps, within a Container Apps environment.
2524

2625
> [!NOTE]
27-
> Tables created with the [Data Collector API](data-collector-api.md) do not support Basic Logs.
26+
> Tables created with the [Data Collector API](data-collector-api.md) don't support Basic Logs.
2827
2928
## Set table configuration
3029

@@ -57,19 +56,19 @@ PATCH https://management.azure.com/subscriptions/<subscriptionId>/resourcegroups
5756
```
5857

5958
> [!IMPORTANT]
60-
> 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).
59+
> Use the bearer token for authentication. Learn 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).
6160
6261
**Request body**
6362

6463
|Name | Type | Description |
6564
| --- | --- | --- |
66-
|properties.plan | string | The table plan. Possible values are *Analytics* and *Basic*.|
65+
|properties.plan | string | The table plan. Possible values are `Analytics` and `Basic`.|
6766

6867
**Example**
6968

7069
This example configures the `ContainerLogV2` table for Basic Logs.
7170

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+
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.
7372

7473
**Sample request**
7574

@@ -146,7 +145,7 @@ To check table configuration in the Azure portal, you can open the table configu
146145
147146
Alternatively:
148147
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.
148+
1. From the **Azure Monitor** menu, select **Logs** and select your workspace for the [scope](scope.md). See the [Log Analytics tutorial](log-analytics-tutorial.md#view-table-information) for a walkthrough.
150149
1. Open the **Tables** tab, which lists all tables in the workspace.
151150
152151
Basic Logs tables have a unique icon:
@@ -169,9 +168,9 @@ GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{
169168

170169
|Name | Type | Description |
171170
| --- | --- | --- |
172-
|properties.plan | string | The table plan. Either "Analytics" or "Basic". |
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.|
171+
|properties.plan | string | The table plan. Either `Analytics` or `Basic`. |
172+
|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 days.|
173+
|properties.totalRetentionInDays | integer | The table's data retention that also includes the archive period.|
175174
|properties.archiveRetentionInDays|integer|The table's archive period (read-only, calculated).|
176175
|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).
177176

@@ -181,7 +180,6 @@ GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{
181180
GET https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview
182181
```
183182

184-
185183
**Sample response**
186184

187185
Status code: 200
@@ -213,7 +211,7 @@ az monitor log-analytics workspace table show --subscription ContosoSID --resour
213211

214212
---
215213

216-
## Retention and archiving of Basic Logs
214+
## Retain and archive Basic Logs
217215

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

0 commit comments

Comments
 (0)