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/custom-logs-migrate.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,34 +7,34 @@ ms.date: 01/06/2022
7
7
---
8
8
9
9
# Migrate from Data Collector API and custom fields-enabled tables to DCR-based custom logs
10
-
This article will describe how to configure tables in a Log Analytics workspace in Azure Monitor that were populated with the [Data Collector API](data-collector-api.md) or the [custom fields](custom-fields.md)features for use with DCR-based custom logs. This includes both [direct ingestion](custom-logs-overview.md), and [ingestion-time transformations](ingestion-time-transformations.md).
10
+
This article describes how to migrate from [Data Collector API](data-collector-api.md) or [custom fields](custom-fields.md)in Azure Monitor to [DCR-based custom logs](custom-logs-overview.md). It includes configuration required for tables in your Log Analytics workspace and applies to both [direct ingestion](custom-logs-overview.md) and [ingestion-time transformations](ingestion-time-transformations.md).
11
11
12
12
> [!IMPORTANT]
13
13
> You do not need to follow this article if you are defining your DCR-based custom logs using the Azure Portal. This article only applies if you are using resource manager templates and the custom logs API.
14
14
15
15
## Background
16
16
To use a table with the [direct ingestion](custom-logs-overview.md), and [ingestion-time transformations](ingestion-time-transformations.md), it must be configured to support these new features. When you complete the process described in this article, the following actions are taken:
17
17
18
-
- The table will be reconfigured to enable all DCR-based custom logs features, including DCR and DCE support and management with the new Tables control plane.
18
+
- The table will be reconfigured to enable all DCR-based custom logs features. This includes DCR and DCE support and management with the new Tables control plane.
19
19
- Any previously defined custom fields will stop populating.
20
20
- The Data Collector API will continue to work but will not create any new columns. Data will only populate into any columns that was created prior to migration.
21
21
- The schema and historic data is preserved and can be accessed the same way it was previously.
22
22
23
23
## Applicable scenarios
24
24
This article is only applicable if all of the following criteria apply:
25
25
26
-
- You would like to use the DCR-based custom logs functionality to send data to an existing table, preserving both schema and historical data in that table.
26
+
- You need to use the DCR-based custom logs functionality to send data to an existing table, preserving both schema and historical data in that table.
27
27
- The table in question was either created using the Data Collector API, or has custom fields defined in it
28
28
- You want to migrate using the custom logs API instead of the Azure portal.
29
29
30
30
If all of these conditions are not true, then you can use DCR-based custom logs without following the procedure described here.
31
31
32
32
## Migration procedure
33
-
If the table that you would like to target with DCR-based custom logs does indeed falls under the criteria described above, the following strategy is required for a graceful migration:
33
+
If the table that you're targeting with DCR-based custom logs does indeed falls under the criteria described above, the following strategy is required for a graceful migration:
34
34
35
35
1. Configure your data collection rule (DCR) following procedures at [Send custom logs to Azure Monitor Logs using resource manager templates (preview)](tutorial-custom-logs-api.md) or [Add ingestion-time transformation to Azure Monitor Logs using resource manager templates (preview)](tutorial-ingestion-time-transformations-api.md).
36
36
37
-
1. If using the DCR-based API, also [configure the data collection endpoint (DCE)](tutorial-custom-logs-api.md#create-data-collection-endpoint)ands the agent or component that will be sending data to the API.
37
+
1. If using the DCR-based API, also [configure the data collection endpoint (DCE)](tutorial-custom-logs-api.md#create-data-collection-endpoint)and the agent or component that will be sending data to the API.
38
38
39
39
1. Issue the following API call against your table. This call is idempotent, so there will be no effect if the table has already been migrated.
0 commit comments