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
+16-18Lines changed: 16 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,30 +1,29 @@
1
1
---
2
2
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.
4
4
ms.topic: conceptual
5
5
ms.custom: event-tier1-build-2022
6
6
ms.date: 10/01/2022
7
7
---
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
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
17
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:
20
19
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.
-[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.
-[ContainerAppConsoleLogs](/azure/azure-monitor/reference/tables/ContainerAppConsoleLogs): Logs generated by Azure Container Apps, within a Container Apps environment.
25
24
26
25
> [!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.
> 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).
61
60
62
61
**Request body**
63
62
64
63
|Name | Type | Description |
65
64
| --- | --- | --- |
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`.|
67
66
68
67
**Example**
69
68
70
69
This example configures the `ContainerLogV2` table for Basic Logs.
71
70
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.
73
72
74
73
**Sample request**
75
74
@@ -146,7 +145,7 @@ To check table configuration in the Azure portal, you can open the table configu
146
145
147
146
Alternatively:
148
147
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.
150
149
1. Open the **Tables** tab, which lists all tables in the workspace.
151
150
152
151
Basic Logs tables have a unique icon:
@@ -169,9 +168,9 @@ GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{
169
168
170
169
|Name | Type | Description |
171
170
| --- | --- | --- |
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.|
175
174
|properties.archiveRetentionInDays|integer|The table's archive period (read-only, calculated).|
176
175
|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).
177
176
@@ -181,7 +180,6 @@ GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{
181
180
GET https://management.azure.com/subscriptions/ContosoSID/resourcegroups/ContosoRG/providers/Microsoft.OperationalInsights/workspaces/ContosoWorkspace/tables/ContainerLogV2?api-version=2021-12-01-preview
182
181
```
183
182
184
-
185
183
**Sample response**
186
184
187
185
Status code: 200
@@ -213,7 +211,7 @@ az monitor log-analytics workspace table show --subscription ContosoSID --resour
213
211
214
212
---
215
213
216
-
## Retention and archiving of Basic Logs
214
+
## Retain and archive Basic Logs
217
215
218
216
Analytics tables retain data based on a [retention and archive policy](data-retention-archive.md) you set.
0 commit comments