Skip to content

Commit 2e43029

Browse files
committed
Fix some grammar and tone suggestions
1 parent 6d0a7ae commit 2e43029

File tree

1 file changed

+8
-7
lines changed

1 file changed

+8
-7
lines changed

articles/application-insights/app-insights-snapshot-debugger.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -231,7 +231,7 @@ The Snapshot Collector is implemented as an [Application Insights Telemetry Proc
231231
Each time your application calls [TrackException](app-insights-asp-net-exceptions.md#exceptions), the Snapshot Collector computes a Problem ID from the type of exception being thrown and the throwing method.
232232
Each time your application calls TrackException, a counter is incremented for the appropriate Problem ID. When the counter reaches the `ThresholdForSnapshotting` value, the Problem ID is added to a Collection Plan.
233233

234-
The Snapshot Collector also monitors exceptions as they are thrown by subscribing to the [AppDomain.CurrentDomain.FirstChanceException](https://docs.microsoft.com/dotnet/api/system.appdomain.firstchanceexception) event. When that event fires, the Problem ID of the exception is computed and compared against the Problem IDs in the Collection Plan.
234+
The Snapshot Collector also monitors exceptions as they're thrown by subscribing to the [AppDomain.CurrentDomain.FirstChanceException](https://docs.microsoft.com/dotnet/api/system.appdomain.firstchanceexception) event. When that event fires, the Problem ID of the exception is computed and compared against the Problem IDs in the Collection Plan.
235235
If there's a match, then a snapshot of the running process is created. The snapshot is assigned a unique identifier and the exception is stamped with that identifier. After the FirstChanceException handler returns, the thrown exception is processed as normal. Eventually, the exception reaches the TrackException method again where it, along with the snapshot identifier, is reported to Application Insights.
236236

237237
The main process continues to run and serve traffic to users with little interruption. Meanwhile, the snapshot is handed off to the Snapshot Uploader process. The Snapshot Uploader creates a minidump and uploads it to Application Insights along with any relevant symbol (.pdb) files.
@@ -247,7 +247,8 @@ The main process continues to run and serve traffic to users with little interru
247247
## Current limitations
248248

249249
### Publish symbols
250-
The Snapshot Debugger requires symbol files on the production server to decode variables and to provide a debugging experience in Visual Studio. The 15.2 release of Visual Studio 2017 publishes symbols for release builds by default when it publishes to App Service. In prior versions, you need to add the following line to your publish profile `.pubxml` file so that symbols are published in release mode:
250+
The Snapshot Debugger requires symbol files on the production server to decode variables and to provide a debugging experience in Visual Studio.
251+
Version 15.2 (or above) of Visual Studio 2017 publishes symbols for release builds by default when it publishes to App Service. In prior versions, you need to add the following line to your publish profile `.pubxml` file so that symbols are published in release mode:
251252

252253
```xml
253254
<ExcludeGeneratedDebugSymbol>False</ExcludeGeneratedDebugSymbol>
@@ -401,15 +402,15 @@ Follow these steps to configure your Cloud Service role with a dedicated local r
401402
### Overriding the Shadow Copy folder
402403

403404
When the Snapshot Collector starts up, it tries to find a folder on disk that is suitable for running the Snapshot Uploader process.
404-
The Snapshot Collector checks a few well-known locations (e.g. environment variables LOCALAPPDATA, APPDATA and TEMP), making sure it has permissions to copy the Snapshot Uploader binaries. The chosen folder is known as the Shadow Copy folder.
405+
The Snapshot Collector checks a few well-known locations (environment variables LOCALAPPDATA, APPDATA, and TEMP, among others), making sure it has permissions to copy the Snapshot Uploader binaries. The chosen folder is known as the Shadow Copy folder.
405406

406-
If a suitable folder cannot be found, Snapshot Collector reports an error saying _"Could not find a suitable shadow copy folder."_
407+
If a suitable folder can't be found, Snapshot Collector reports an error saying _"Could not find a suitable shadow copy folder."_
407408

408409
If the copy fails, Snapshot Collector reports a `ShadowCopyFailed` error.
409410

410-
If the uploader cannot be launched, Snapshot Collector reports an `UploaderCannotStartFromShadowCopy` error, possibly with a `System.UnauthorizedAccessException` in the body of the message. This is usually because the application is running under an account with reduced permissions. The account has permission to write to the shadow copy folder, but it doesn't have permission to execute code.
411+
If the uploader can't be launched, Snapshot Collector reports an `UploaderCannotStartFromShadowCopy` error. The body of the message often contains `System.UnauthorizedAccessException`. This error usually occurs because the application is running under an account with reduced permissions. The account has permission to write to the shadow copy folder, but it doesn't have permission to execute code.
411412

412-
Since these errors usually happen during startup, they will usually be followed by an `ExceptionDuringConnect` error saying _"Uploader failed to start."_
413+
Since these errors usually happen during startup, they'll usually be followed by an `ExceptionDuringConnect` error saying _"Uploader failed to start."_
413414

414415
To work around these errors, you can specify the shadow copy folder manually via the `ShadowCopyFolder` configuration option. For example, using ApplicationInsights.config:
415416

@@ -423,7 +424,7 @@ To work around these errors, you can specify the shadow copy folder manually via
423424
</TelemetryProcessors>
424425
```
425426

426-
Or, if you are using appsettings.json with a .NET Core application:
427+
Or, if you're using appsettings.json with a .NET Core application:
427428

428429
```json
429430
{

0 commit comments

Comments
 (0)