Skip to content

Commit 6e64dae

Browse files
Merge pull request #227301 from AaronMaxwell/aaronmax-add-dep-notice
continuous export deprecation notice
2 parents 2589678 + 8e4ba61 commit 6e64dae

File tree

1 file changed

+18
-13
lines changed

1 file changed

+18
-13
lines changed

articles/azure-monitor/app/convert-classic-resource.md

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,11 @@ Workspace-based resources:
2222
> - Are available in all commercial regions and [Azure US Government](../../azure-government/index.yml).
2323
> - Don't require changing instrumentation keys after migration from a classic resource.
2424
25+
> [!IMPORTANT]
26+
> * On February 29, 2024, continuous export will be deprecated as part of the classic Application Insights deprecation.
27+
> * When you [migrate to a workspace-based Application Insights resource](convert-classic-resource.md), you must use [diagnostic settings](export-telemetry.md#diagnostic-settings-based-export) for exporting telemetry. All [workspace-based Application Insights resources](./create-workspace-resource.md) must use [diagnostic settings](./create-workspace-resource.md#export-telemetry).
28+
> * Diagnostic settings export might increase costs. For more information, see [Diagnostic settings-based export](export-telemetry.md#diagnostic-settings-based-export).
29+
2530
## New capabilities
2631

2732
Workspace-based Application Insights resources allow you to take advantage of the latest capabilities of Azure Monitor and Log Analytics:
@@ -42,7 +47,7 @@ Workspace-based Application Insights resources allow you to take advantage of th
4247

4348
When you migrate to a workspace-based resource, no data is transferred from your classic resource's storage to the new workspace-based storage. Choosing to migrate changes the location where new data is written to a Log Analytics workspace while preserving access to your classic resource data.
4449

45-
Your classic resource data will persist and be subject to the retention settings on your classic Application Insights resource. All new data ingested post migration will be subject to the [retention settings](../logs/data-retention-archive.md) of the associated Log Analytics workspace, which also supports [different retention settings by data type](../logs/data-retention-archive.md#set-retention-and-archive-policy-by-table).
50+
Your classic resource data persists and is subject to the retention settings on your classic Application Insights resource. All new data ingested post migration is subject to the [retention settings](../logs/data-retention-archive.md) of the associated Log Analytics workspace, which also supports [different retention settings by data type](../logs/data-retention-archive.md#set-retention-and-archive-policy-by-table).
4651

4752
*The migration process is permanent and can't be reversed.* After you migrate a resource to workspace-based Application Insights, it will always be a workspace-based resource. After you migrate, you can change the target workspace as often as needed.
4853

@@ -55,7 +60,7 @@ If you don't need to migrate an existing resource, and instead want to create a
5560
- Workspace-based Application Insights resources aren't compatible with workspaces set to the dedicated **workspace-based permissions** setting. To learn more about Log Analytics workspace access control, see the [Access control mode guidance](../logs/manage-access.md#access-control-mode).
5661
- If you don't already have an existing Log Analytics workspace, see the [Log Analytics workspace creation documentation](../logs/quick-create-workspace.md).
5762

58-
- **Continuous export** isn't supported for workspace-based resources and must be disabled. After the migration is finished, you can use [diagnostic settings](../essentials/diagnostic-settings.md) to configure data archiving to a storage account or streaming to Azure Event Hubs.
63+
- **Continuous export** isn't compatible with workspace-based resources and must be disabled. After the migration is finished, you can use [diagnostic settings](../essentials/diagnostic-settings.md) to configure data archiving to a storage account or streaming to Azure Event Hubs.
5964

6065
> [!CAUTION]
6166
> * Diagnostic settings use a different export format/schema than continuous export. Migrating breaks any existing integrations with Azure Stream Analytics.
@@ -111,7 +116,7 @@ You might have multiple Application Insights resources that store telemetry in o
111116
- Go to your Application Insights resource and select the **Logs** tab. All queries from this tab automatically pull data from the selected Application Insights resource.
112117
- Go to the Log Analytics workspace that you configured as the destination for your Application Insights telemetry and select the **Logs** tab. To query data from a specific Application Insights resource, filter for the built-in `_ResourceId` property that's available in all application-specific tables.
113118

114-
If you query directly from the Log Analytics workspace, you'll only see data that's ingested post migration. To see both your classic Application Insights data and the new data ingested after migration in a unified query experience, use the **Logs** tab from within your migrated Application Insights resource.
119+
When you query directly from the Log Analytics workspace, you only see data that's ingested post migration. To see both your classic Application Insights data and the new data ingested after migration in a unified query experience, use the **Logs** tab from within your migrated Application Insights resource.
115120

116121
> [!NOTE]
117122
> If you rename your Application Insights resource after you migrate to the workspace-based model, the Application Insights **Logs** tab no longer shows the telemetry collected before renaming. You can see all old and new data on the **Logs** tab of the associated Log Analytics resource.
@@ -128,7 +133,7 @@ To access the preview Application Insights Azure CLI commands, you first need to
128133
az extension add -n application-insights
129134
```
130135

131-
If you don't run the `az extension add` command, you'll see an error message that states `az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.`
136+
If you don't run the `az extension add` command, you see an error message that states `az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.`
132137

133138
Now you can run the following code to create your Application Insights resource:
134139

@@ -248,7 +253,7 @@ This section provides answers to common questions.
248253
There's usually no difference, with a couple of exceptions:
249254

250255
- Migrated Application Insights resources can use [Log Analytics commitment tiers](../logs/cost-logs.md#commitment-tiers) to reduce cost if the data volumes in the workspace are high enough.
251-
- Grandfathered Application Insights resources will no longer get 1 GB per month free from the original Application Insights pricing model.
256+
- Grandfathered Application Insights resources no longer get 1 GB per month free from the original Application Insights pricing model.
252257

253258
### How will telemetry capping work?
254259

@@ -260,23 +265,23 @@ There's no strict billing capping available.
260265

261266
There are no changes to ingestion-based sampling.
262267

263-
### Will there be any gap in data collected during migration?
268+
### Are there gaps in data collected during migration?
264269

265270
No. We merge data during query time.
266271

267-
### Will my old log queries continue to work?
272+
### Do old log queries continue to work?
268273

269-
Yes, they'll continue to work.
274+
Yes, they continue to work.
270275

271276
### Will my dashboards that have pinned metric and log charts continue to work after migration?
272277

273-
Yes, they'll continue to work.
278+
Yes, they continue to work.
274279

275-
### Will migration affect AppInsights API accessing data?
280+
### Does migration affect AppInsights API accessing data?
276281

277-
No. Migration won't affect existing API access to data. After migration, you can access data directly from a workspace by using a [slightly different schema](#workspace-based-resource-changes).
282+
No. Migration doesn't affect existing API access to data. After migration, you can access data directly from a workspace by using a [slightly different schema](#workspace-based-resource-changes).
278283

279-
### Will there be any impact on Live Metrics or other monitoring experiences?
284+
### Is there be any impact on Live Metrics or other monitoring experiences?
280285

281286
No. There's no impact to [Live Metrics](live-stream.md#live-metrics-monitor-and-diagnose-with-1-second-latency) or other monitoring experiences.
282287

@@ -312,7 +317,7 @@ The legacy **Continuous export** functionality isn't supported for workspace-bas
312317

313318
![Screenshot that shows the Continuous export Disable button.](./media/convert-classic-resource/disable.png)
314319

315-
- After you select **Disable**, you can go back to the migration UI. If the **Edit continuous export** page prompts you that your settings won't be saved, select **OK**. This prompt doesn't pertain to disabling or enabling continuous export.
320+
- After you select **Disable**, you can go back to the migration UI. If the **Edit continuous export** page prompts you that your settings aren't saved, select **OK**. This prompt doesn't pertain to disabling or enabling continuous export.
316321

317322
- After you've successfully migrated your Application Insights resource to workspace based, you can use diagnostic settings to replace the functionality that continuous export used to provide. Select **Diagnostics settings** > **Add diagnostic setting** in your Application Insights resource. You can select all tables, or a subset of tables, to archive to a storage account or stream to Azure Event Hubs. For more information on diagnostic settings, see the [Azure Monitor diagnostic settings guidance](../essentials/diagnostic-settings.md).
318323

0 commit comments

Comments
 (0)