Skip to content

Commit 04b00a7

Browse files
authored
Merge pull request #190552 from AaronMaxwell/aaronmax-cont-export-update
[AppInsights][AaronMax] updating continuous export
2 parents 4a84e18 + f4e1149 commit 04b00a7

File tree

1 file changed

+24
-24
lines changed

1 file changed

+24
-24
lines changed

articles/azure-monitor/app/export-telemetry.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -7,10 +7,10 @@ ms.custom: references_regions
77
---
88

99
# Export telemetry from Application Insights
10-
Want to keep your telemetry for longer than the standard retention period? Or process it in some specialized way? Continuous Export is ideal for this. The events you see in the Application Insights portal can be exported to storage in Microsoft Azure in JSON format. From there, you can download your data and write whatever code you need to process it.
10+
Want to keep your telemetry for longer than the standard retention period? Or process it in some specialized way? Continuous Export is ideal for this purpose. The events you see in the Application Insights portal can be exported to storage in Microsoft Azure in JSON format. From there, you can download your data and write whatever code you need to process it.
1111

1212
> [!IMPORTANT]
13-
> Continuous export has been deprecated. [Migrate to a workspace-based Application Insights resource](convert-classic-resource.md) to use [diagnostic settings](#diagnostic-settings-based-export) for exporting telemetry.
13+
> Continuous export has been deprecated. When [migrating to a workspace-based Application Insights resource](convert-classic-resource.md), you must use [diagnostic settings](#diagnostic-settings-based-export) for exporting telemetry.
1414
1515
> [!NOTE]
1616
> Continuous export is only supported for classic Application Insights resources. [Workspace-based Application Insights resources](./create-workspace-resource.md) must use [diagnostic settings](./create-workspace-resource.md#export-telemetry).
@@ -25,7 +25,7 @@ Before you set up continuous export, there are some alternatives you might want
2525
* The [Data access REST API](https://dev.applicationinsights.io/) lets you access your telemetry programmatically.
2626
* You can also access setup [continuous export via PowerShell](/powershell/module/az.applicationinsights/new-azapplicationinsightscontinuousexport).
2727

28-
After Continuous Export copies your data to storage (where it can stay for as long as you like), it's still available in Application Insights for the usual [retention period](./data-retention-privacy.md).
28+
After continuous export copies your data to storage, where it may stay as long as you like, it's still available in Application Insights for the usual [retention period](./data-retention-privacy.md).
2929

3030
## Supported Regions
3131

@@ -84,7 +84,7 @@ Continuous Export **does not support** the following Azure storage features/conf
8484

8585
3. Create or select an [Azure storage account](../../storage/common/storage-introduction.md) where you want to store the data. For more information on storage pricing options, visit the [official pricing page](https://azure.microsoft.com/pricing/details/storage/).
8686

87-
Click Add, Export Destination, Storage account, and then either create a new store or choose an existing store.
87+
Select Add, Export Destination, Storage account, and then either create a new store or choose an existing store.
8888

8989
> [!Warning]
9090
> By default, the storage location will be set to the same geographical region as your Application Insights resource. If you store in a different region, you may incur transfer charges.
@@ -96,7 +96,7 @@ Continuous Export **does not support** the following Azure storage features/conf
9696
9797
There can be a delay of about an hour before data appears in the storage.
9898

99-
Once the first export is complete you will find a structure similar to the following in your Azure Blob storage container: (This will vary depending on the data you are collecting.)
99+
Once the first export is complete, you'll find the following structure in your Azure Blob storage container: (This structure will vary depending on the data you're collecting.)
100100

101101
|Name | Description |
102102
|:----|:------|
@@ -106,27 +106,27 @@ Once the first export is complete you will find a structure similar to the follo
106106
| [Messages](export-data-model.md#trace-messages) | Sent by [TrackTrace](./api-custom-events-metrics.md#tracktrace), and by the [logging adapters](./asp-net-trace-logs.md).
107107
| [Metrics](export-data-model.md#metrics) | Generated by metric API calls.
108108
| [PerformanceCounters](export-data-model.md) | Performance Counters collected by Application Insights.
109-
| [Requests](export-data-model.md#requests)| Sent by [TrackRequest](./api-custom-events-metrics.md#trackrequest). The standard modules use this to reports server response time, measured at the server.|
109+
| [Requests](export-data-model.md#requests)| Sent by [TrackRequest](./api-custom-events-metrics.md#trackrequest). The standard modules use requests to report server response time, measured at the server.|
110110

111111
### To edit continuous export
112112

113-
Click on continuous export and select the storage account to edit.
113+
Select continuous export and select the storage account to edit.
114114

115115
### To stop continuous export
116116

117-
To stop the export, click Disable. When you click Enable again, the export will restart with new data. You won't get the data that arrived in the portal while export was disabled.
117+
To stop the export, select Disable. When you select Enable again, the export will restart with new data. You won't get the data that arrived in the portal while export was disabled.
118118

119119
To stop the export permanently, delete it. Doing so doesn't delete your data from storage.
120120

121121
### Can't add or change an export?
122122
* To add or change exports, you need Owner, Contributor, or Application Insights Contributor access rights. [Learn about roles][roles].
123123

124124
## <a name="analyze"></a> What events do you get?
125-
The exported data is the raw telemetry we receive from your application, except that we add location data, which we calculate from the client IP address.
125+
The exported data is the raw telemetry we receive from your application with added location data from the client IP address.
126126

127-
Data that has been discarded by [sampling](./sampling.md) is not included in the exported data.
127+
Data that has been discarded by [sampling](./sampling.md) isn't included in the exported data.
128128

129-
Other calculated metrics are not included. For example, we don't export average CPU utilization, but we do export the raw telemetry from which the average is computed.
129+
Other calculated metrics aren't included. For example, we don't export average CPU utilization, but we do export the raw telemetry from which the average is computed.
130130

131131
The data also includes the results of any [availability web tests](./monitor-web-app-availability.md) that you have set up.
132132

@@ -136,7 +136,7 @@ The data also includes the results of any [availability web tests](./monitor-web
136136
>
137137
138138
## <a name="get"></a> Inspect the data
139-
You can inspect the storage directly in the portal. Click home in the leftmost menu, at the top where it says "Azure services" select **Storage accounts**, select the storage account name, on the overview page select **Blobs** under services, and finally select the container name.
139+
You can inspect the storage directly in the portal. Select home in the leftmost menu, at the top where it says "Azure services" select **Storage accounts**, select the storage account name, on the overview page select **Blobs** under services, and finally select the container name.
140140

141141
To inspect Azure storage in Visual Studio, open **View**, **Cloud Explorer**. (If you don't have that menu command, you need to install the Azure SDK: Open the **New Project** dialog, expand Visual C#/Cloud and choose **Get Microsoft Azure SDK for .NET**.)
142142

@@ -199,12 +199,12 @@ private IEnumerable<T> DeserializeMany<T>(string folderName)
199199
For a larger code sample, see [using a worker role][exportasa].
200200

201201
## <a name="delete"></a>Delete your old data
202-
You are responsible for managing your storage capacity and deleting the old data if necessary.
202+
You're responsible for managing your storage capacity and deleting the old data if necessary.
203203

204204
## If you regenerate your storage key...
205205
If you change the key to your storage, continuous export will stop working. You'll see a notification in your Azure account.
206206

207-
Open the Continuous Export tab and edit your export. Edit the Export Destination, but just leave the same storage selected. Click OK to confirm.
207+
Open the Continuous Export tab and edit your export. Edit the Export Destination, but just leave the same storage selected. Select OK to confirm.
208208

209209
The continuous export will restart.
210210

@@ -213,12 +213,12 @@ The continuous export will restart.
213213
* [Export to SQL using Stream Analytics][exportasa]
214214
* [Stream Analytics sample 2](../../stream-analytics/app-insights-export-stream-analytics.md)
215215

216-
On larger scales, consider [HDInsight](https://azure.microsoft.com/services/hdinsight/) - Hadoop clusters in the cloud. HDInsight provides a variety of technologies for managing and analyzing big data, and you could use it to process data that has been exported from Application Insights.
216+
On larger scales, consider [HDInsight](https://azure.microsoft.com/services/hdinsight/) - Hadoop clusters in the cloud. HDInsight provides various technologies for managing and analyzing big data. You can use it to process data that has been exported from Application Insights.
217217

218218
## Q & A
219219
* *But all I want is a one-time download of a chart.*
220220

221-
Yes, you can do that. At the top of the tab, click **Export Data**.
221+
Yes, you can do that. At the top of the tab, select **Export Data**.
222222
* *I set up an export, but there's no data in my store.*
223223

224224
Did Application Insights receive any telemetry from your app since you set up the export? You'll only receive new data.
@@ -230,17 +230,17 @@ On larger scales, consider [HDInsight](https://azure.microsoft.com/services/hdin
230230
No, sorry. Our export engine currently only works with Azure storage at this time.
231231
* *Is there any limit to the amount of data you put in my store?*
232232

233-
No. We'll keep pushing data in until you delete the export. We'll stop if we hit the outer limits for blob storage, but that's pretty huge. It's up to you to control how much storage you use.
233+
No. We'll keep pushing data in until you delete the export. We'll stop if we hit the outer limits for blob storage, but that's huge. It's up to you to control how much storage you use.
234234
* *How many blobs should I see in the storage?*
235235

236236
* For every data type you selected to export, a new blob is created every minute (if data is available).
237-
* In addition, for applications with high traffic, additional partition units are allocated. In this case, each unit creates a blob every minute.
237+
* In addition, for applications with high traffic, extra partition units are allocated. In this case, each unit creates a blob every minute.
238238
* *I regenerated the key to my storage or changed the name of the container, and now the export doesn't work.*
239239

240-
Edit the export and open the export destination tab. Leave the same storage selected as before, and click OK to confirm. Export will restart. If the change was within the past few days, you won't lose data.
240+
Edit the export and open the export destination tab. Leave the same storage selected as before, and select OK to confirm. Export will restart. If the change was within the past few days, you won't lose data.
241241
* *Can I pause the export?*
242242

243-
Yes. Click Disable.
243+
Yes. Select Disable.
244244

245245
## Code samples
246246

@@ -250,12 +250,12 @@ On larger scales, consider [HDInsight](https://azure.microsoft.com/services/hdin
250250

251251
## Diagnostic settings based export
252252

253-
Diagnostic settings based export uses a different schema than continuous export. It also supports features that continuous export does not like:
253+
Diagnostic settings based export uses a different schema than continuous export. It also supports features that continuous export doesn't like:
254254

255-
* Azure storage accounts with vnet, firewalls, and private links.
256-
* Export to event hub.
255+
* Azure storage accounts with virtual networks, firewalls, and private links.
256+
* Export to Event Hubs.
257257

258-
To migrate to diagnostic settings based export:
258+
To migrate to diagnostic settings-based export:
259259

260260
1. Disable current continuous export.
261261
2. [Migrate application to workspace-based](convert-classic-resource.md).

0 commit comments

Comments
 (0)