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/profiler/profiler-bring-your-own-storage.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,13 +16,13 @@ ms.custom: devdivchpfy22
16
16
17
17
When you use Application Insights Profiler or Snapshot Debugger, artifacts generated by your application are uploaded into Azure storage accounts over the public Internet. For these artifacts and storage accounts, Microsoft controls and covers the cost for:
18
18
19
-
* Processing and analysis
20
-
* Encryption-at-rest and lifetime management policies
19
+
* Processing and analysis.
20
+
* Encryption-at-rest and lifetime management policies.
21
21
22
22
When you configure Bring Your Own Storage (BYOS), artifacts are uploaded into a storage account that you control. That means you control and are responsible for the cost of:
23
23
24
-
* The encryption-at-rest policy and the Lifetime management policy
25
-
* Network access
24
+
* The encryption-at-rest policy and the Lifetime management policy.
25
+
* Network access.
26
26
27
27
> [!NOTE]
28
28
> BYOS is required if you are enabling Private Link or Customer-Managed Keys.
@@ -79,19 +79,19 @@ Steps:
79
79
:::image type="content" source="media/profiler-bring-your-own-storage/add-role-assignment-page.png" alt-text="Screenshot showing how to add role assignment page in Azure portal.":::
80
80
*Figure 1.0*
81
81
82
-
After you added the role, it will appear under the "Role assignments" section, like the below Figure 1.1.
82
+
After you added the role, it will appear under the "**Role assignments**" section, like the below Figure 1.1.
83
83
:::image type="content" source="media/profiler-bring-your-own-storage/figure-11.png" alt-text="Screenshot showing the IAM screen after Role assignments.":::
84
84
*Figure 1.1*
85
85
86
-
If you're also using Private Link, it's required one additional configuration to allow connection to our Trusted Microsoft Service from your Virtual Network. Refer to the[Storage Network Security documentation](../../storage/common/storage-network-security.md#trusted-microsoft-services).
86
+
If you're also using Private Link, it's required one additional configuration to allow connection to our Trusted Microsoft Service from your Virtual Network. or more information, see[Storage Network Security documentation](../../storage/common/storage-network-security.md#trusted-microsoft-services).
87
87
88
88
### Link your Storage Account with your Application Insights resource
89
89
90
90
To configure BYOS for code-level diagnostics (Profiler/Debugger), there are three options:
91
91
92
-
* Using Azure PowerShell cmdlets
93
-
* Using the Azure CLI
94
-
* Using Azure Resource Manager templates
92
+
* Using Azure PowerShell cmdlets.
93
+
* Using the Azure CLI.
94
+
* Using Azure Resource Manager templates.
95
95
96
96
#### [PowerShell](#tab/azure-powershell)
97
97
@@ -111,7 +111,7 @@ To configure BYOS for code-level diagnostics (Profiler/Debugger), there are thre
Snapshot Debugger is pre-installed as part of the App Services runtime, but you need to turn it on to get snapshots for your App Service app. To enable Snapshot Debugger for an app, follow the instructions below.
23
+
Snapshot Debugger is pre-installed as part of the App Services runtime, but you need to turn it on to get snapshots for your App Service app. To enable Snapshot Debugger for an app, follow the instructions below:
24
24
25
25
> [!NOTE]
26
26
> If you're using a preview version of .NET Core, or your application references Application Insights SDK (directly or indirectly via a dependent assembly), follow the instructions for [Enable Snapshot Debugger for other environments](snapshot-debugger-vm.md) to include the [`Microsoft.ApplicationInsights.SnapshotCollector`](https://www.nuget.org/packages/Microsoft.ApplicationInsights.SnapshotCollector) NuGet package with the application.
@@ -29,9 +29,9 @@ Snapshot Debugger is pre-installed as part of the App Services runtime, but you
29
29
> Codeless installation of Application Insights Snapshot Debugger follows the .NET Core support policy.
30
30
> For more information about supported runtimes, see [.NET Core Support Policy](https://dotnet.microsoft.com/platform/support/policy/dotnet-core).
31
31
32
-
Once you've deployed your .NET app:
32
+
After you've deployed your .NET app:
33
33
34
-
1.Navigate to the Azure control panel for your App Service.
34
+
1.Go to to the Azure control panel for your App Service.
35
35
1. Go to the **Settings** > **Application Insights** page.
36
36
37
37
:::image type="content" source="./media/snapshot-debugger/application-insights-app-services.png" alt-text="Screenshot showing the Enable App Insights on App Services portal.":::
@@ -69,15 +69,15 @@ Application Insights Snapshot Debugger supports Azure AD authentication for snap
69
69
70
70
As of today, Snapshot Debugger only supports Azure AD authentication when you reference and configure Azure AD using the Application Insights SDK in your application.
71
71
72
-
To enable Azure AD for snapshot ingestion:
72
+
To turn-on Azure AD for snapshot ingestion:
73
73
74
74
1. Create and add the managed identity you want to use to authenticate against your Application Insights resource to your App Service.
75
75
76
-
1. For System-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-system-assigned-identity)
76
+
1. For System-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-system-assigned-identity).
77
77
78
-
1. For User-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-user-assigned-identity)
78
+
1. For User-Assigned Managed identity, see the following [documentation](../../app-service/overview-managed-identity.md?tabs=portal%2chttp#add-a-user-assigned-identity).
79
79
80
-
1. Configure and enable Azure AD in your Application Insights resource. For more information, see the following [documentation](../app/azure-ad-authentication.md?tabs=net#configuring-and-enabling-azure-ad-based-authentication)
80
+
1. Configure and turn on Azure AD in your Application Insights resource. For more information, see the following [documentation](../app/azure-ad-authentication.md?tabs=net#configuring-and-enabling-azure-ad-based-authentication)
81
81
1. Add the following application setting, used to let Snapshot Debugger agent know which managed identity to use:
82
82
83
83
For System-Assigned Identity:
@@ -94,7 +94,7 @@ For User-Assigned Identity:
94
94
95
95
## Disable Snapshot Debugger
96
96
97
-
To disable Snapshot Debugger, repeat the [steps for enabling](#installation), but switch the Snapshot Debugger toggles to **Off**.
97
+
To disable Snapshot Debugger, repeat the [steps for enabling](#installation). However, switch the Snapshot Debugger toggles to **Off**.
98
98
99
99
## Azure Resource Manager template
100
100
@@ -140,11 +140,11 @@ For an Azure App Service, you can set app settings within the Azure Resource Man
140
140
141
141
## Not Supported Scenarios
142
142
143
-
Below you can find scenarios where Snapshot Collector is not supported:
143
+
Below you can find scenarios where Snapshot Collector isn't supported:
144
144
145
145
|Scenario | Side Effects | Recommendation |
146
146
|------------|--------------|----------------|
147
-
|You're using the Snapshot Collector SDK in your application directly (.csproj) and have enabled the advanced option "Interop".| The local Application Insights SDK (including Snapshot Collector telemetry) will be lost and no Snapshots will be available. <br/> Your application could crash at startup with `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` <br/> [Learn more about the Application Insights feature "Interop".](../app/azure-web-apps-net-core.md#troubleshooting)| If you are using the advanced option "Interop", use the codeless Snapshot Collector injection (enabled through the Azure portal). |
147
+
|You're using the Snapshot Collector SDK in your application directly (*.csproj*) and have enabled the advanced option "Interop".| The local Application Insights SDK (including Snapshot Collector telemetry) will be lost and no Snapshots will be available. <br/> Your application could crash at startup with `System.ArgumentException: telemetryProcessorTypedoes not implement ITelemetryProcessor.` <br/> [Learn more about the Application Insights feature "Interop".](../app/azure-web-apps-net-core.md#troubleshooting)| If you're using the advanced option "Interop", use the codeless Snapshot Collector injection (enabled through the Azure portal). |
Copy file name to clipboardExpand all lines: articles/azure-monitor/snapshot-debugger/snapshot-debugger-function-app.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@ ms.custom: devdivchpfy22
14
14
15
15
Snapshot Debugger currently works for ASP.NET and ASP.NET Core apps that are running on Azure Functions on Windows Service Plans.
16
16
17
-
We recommend you run your application on the Basic service tier or higher when using Snapshot Debugger.
17
+
We recommend that you run your application on the Basic service tier or higher when using Snapshot Debugger.
18
18
19
19
For most applications, the Free and Shared service tiers don't have enough memory or disk space to save snapshots.
20
20
@@ -43,7 +43,7 @@ Snapshot Debugger is pre-installed as part of the Azure Functions runtime and is
43
43
44
44
In the simple .NET Core Function app example below, `.csproj`, `{Your}Function.cs`, and `host.json` has Snapshot Debugger enabled:
45
45
46
-
***Project.`csproj`***
46
+
***`Project.csproj`***
47
47
48
48
```xml
49
49
<ProjectSdk="Microsoft.NET.Sdk">
@@ -160,11 +160,11 @@ To disable Snapshot Debugger in your Function app, update your `host.json` file
160
160
}
161
161
```
162
162
163
-
We recommend you have Snapshot Debugger enabled on all your apps to ease diagnostics of application exceptions.
163
+
We recommend that you have Snapshot Debugger enabled on all your apps to ease diagnostics of application exceptions.
164
164
165
165
## Next steps
166
166
167
167
* Generate traffic to your application that can trigger an exception. Then, wait 10 to 15 minutes for snapshots to be sent to the Application Insights instance.
168
168
*[View snapshots](snapshot-debugger.md?toc=/azure/azure-monitor/toc.json#view-snapshots-in-the-portal) in the Azure portal.
169
-
* Customize Snapshot Debugger configuration based on your use-case on your Function app. For more info, see [snapshot configuration in host.json](../../azure-functions/functions-host-json.md#applicationinsightssnapshotconfiguration).
169
+
* Customize Snapshot Debugger configuration based on your use-case on your Function app. For more information, see [snapshot configuration in host.json](../../azure-functions/functions-host-json.md#applicationinsightssnapshotconfiguration).
170
170
* For help with troubleshooting Snapshot Debugger issues, see [Snapshot Debugger troubleshooting](snapshot-debugger-troubleshoot.md?toc=/azure/azure-monitor/toc.json).
0 commit comments