Skip to content

Commit 0783dfe

Browse files
committed
acrolinx
1 parent 18af49c commit 0783dfe

File tree

1 file changed

+5
-5
lines changed

1 file changed

+5
-5
lines changed

articles/azure-monitor/logs/custom-logs-migrate.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,34 +7,34 @@ ms.date: 01/06/2022
77
---
88

99
# 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).
1111

1212
> [!IMPORTANT]
1313
> 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.
1414
1515
## Background
1616
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:
1717

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.
1919
- Any previously defined custom fields will stop populating.
2020
- 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.
2121
- The schema and historic data is preserved and can be accessed the same way it was previously.
2222

2323
## Applicable scenarios
2424
This article is only applicable if all of the following criteria apply:
2525

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.
2727
- The table in question was either created using the Data Collector API, or has custom fields defined in it
2828
- You want to migrate using the custom logs API instead of the Azure portal.
2929

3030
If all of these conditions are not true, then you can use DCR-based custom logs without following the procedure described here.
3131

3232
## 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:
3434

3535
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).
3636

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

3939
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.
4040

0 commit comments

Comments
 (0)