Skip to content

Commit 4f1debc

Browse files
committed
Moving App Insights FAQs
1 parent 6b9e32b commit 4f1debc

9 files changed

+149
-176
lines changed

articles/azure-monitor/app/api-custom-events-metrics.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1166,7 +1166,11 @@ Each item that's transmitted carries an `itemCount` property that shows how many
11661166
```
11671167
requests | summarize original_events = sum(itemCount), transmitted_events = count()
11681168
```
1169-
1169+
1170+
### How can I set an alert on an event?
1171+
1172+
Azure alerts are only on metrics. Create a custom metric that crosses a value threshold whenever your event occurs. Then set an alert on the metric. You get a notification whenever the metric crosses the threshold in either direction. You won't get a notification until the first crossing, no matter whether the initial value is high or low. There's always a latency of a few minutes.
1173+
11701174

11711175
## <a name="next"></a>Next steps
11721176

articles/azure-monitor/app/app-insights-overview.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -212,6 +212,30 @@ From other sources, if you configure them:
212212
* [Import to Log Analytics](../logs/data-collector-api.md)
213213
* [Log Analytics](../logs/data-collector-api.md)
214214
* [Logstash](../logs/data-collector-api.md)
215+
216+
### How can I manage Application Insights resources with PowerShell?
217+
218+
You can [write PowerShell scripts](./powershell.md) by using Azure Resource Monitor to:
219+
220+
* Create and update Application Insights resources.
221+
* Set the pricing plan.
222+
* Get the instrumentation key.
223+
* Add a metric alert.
224+
* Add an availability test.
225+
226+
You can't set up a metrics explorer report or set up continuous export.
227+
228+
### How can I query Application Insights telemetery?
229+
230+
Use the [REST API](/rest/api/application-insights/) to run [Log Analytics](./logs/log-query-overview.md) queries.
231+
232+
### Can I send telemetry to the Application Insights portal?
233+
234+
We recommend that you use our SDKs and use the [SDK API](app/api-custom-events-metrics.md). There are variants of the SDK for various [platforms](app/app-insights-overview.md#supported-languages). These SDKs handle processes like buffering, compression, throttling, and retries. However, the [ingestion schema](https://github.com/microsoft/ApplicationInsights-dotnet/tree/master/BASE/Schema/PublicSchema) and [endpoint protocol](https://github.com/MohanGsk/ApplicationInsights-Home/blob/master/EndpointSpecs/ENDPOINT-PROTOCOL.md) are public.
235+
236+
### How long does it take for telemetry to be collected?
237+
238+
Most Application Insights data has a latency of under 5 minutes. Some data can take longer, which is typical for larger log files. See the [Application Insights service-level agreement](https://azure.microsoft.com/support/legal/sla/application-insights/v1_2/).
215239

216240
## Troubleshooting
217241

articles/azure-monitor/app/application-insights-asp-net-agent.md

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -310,7 +310,7 @@ When you monitor a computer on your private intranet, you'll need to route HTTP
310310
The PowerShell commands to download and install Az.ApplicationMonitor from the PowerShell Gallery support a `-Proxy` parameter.
311311
Review the preceding instructions when you write your installation scripts.
312312
313-
The Application Insights SDK will need to send your app's telemetry to Microsoft. We recommend that you configure proxy settings for your app in your web.config file. For more information, see [Application Insights FAQ: Proxy passthrough](../faq.yml).
313+
The Application Insights SDK will need to send your app's telemetry to Microsoft. We recommend that you configure proxy settings for your app in your web.config file. For more information, see [How do I achieve proxy passthrough?](#how-do-i-achieve-proxy-passthrough).
314314
315315
316316
### Enable monitoring
@@ -1011,6 +1011,25 @@ See the dedicated [troubleshooting article](/troubleshoot/azure/azure-monitor/ap
10111011
10121012
[!INCLUDE [azure-monitor-app-insights-test-connectivity](../../../includes/azure-monitor-app-insights-test-connectivity.md)]
10131013
1014+
## Frequently asked questions
1015+
1016+
This section provides answers to common questions.
1017+
1018+
### How do I achieve proxy passthrough?
1019+
1020+
To achieve proxy passthrough, configure a machine-level proxy or an application-level proxy.
1021+
See [DefaultProxy](/dotnet/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings).
1022+
1023+
Example Web.config:
1024+
1025+
```xml
1026+
<system.net>
1027+
<defaultProxy>
1028+
<proxy proxyaddress="http://xx.xx.xx.xx:yyyy" bypassonlocal="true"/>
1029+
</defaultProxy>
1030+
</system.net>
1031+
```
1032+
10141033
## Next steps
10151034

10161035
View your telemetry:

articles/azure-monitor/app/availability-overview.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,17 @@ You can create up to 100 availability tests per Application Insights resource.
3434

3535
See the dedicated [troubleshooting article](/troubleshoot/azure/azure-monitor/app-insights/troubleshoot-availability).
3636

37+
## Frequently asked questions
38+
39+
This section provides answers to common questions.
40+
41+
### Can I run Availability web tests on an intranet server?
42+
43+
Our [web tests](/previous-versions/azure/azure-monitor/app/monitor-web-app-availability) run on points of presence that are distributed around the globe. There are two solutions:
44+
45+
* **Firewall door**: Allow requests to your server from [the long and changeable list of web test agents](./ip-addresses.md).
46+
* **Custom code**: Write your own code to send periodic requests to your server from inside your intranet. You could run Visual Studio web tests for this purpose. The tester could send the results to Application Insights by using the `TrackAvailability()` API.
47+
3748
## Next steps
3849

3950
* [Availability alerts](availability-alerts.md)

articles/azure-monitor/app/ip-addresses.md

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -249,3 +249,48 @@ Managing changes to source IP addresses can be time consuming. Using *service ta
249249
| Agent | agent.azureserviceprofiler.net<br/>*.agent.azureserviceprofiler.net | 20.190.60.38<br/>20.190.60.32<br/>52.173.196.230<br/>52.173.196.209<br/>23.102.44.211<br/>23.102.45.216<br/>13.69.51.218<br/>13.69.51.175<br/>138.91.32.98<br/>138.91.37.93<br/>40.121.61.208<br/>40.121.57.2<br/>51.140.60.235<br/>51.140.180.52<br/>52.138.31.112<br/>52.138.31.127<br/>104.211.90.234<br/>104.211.91.254<br/>13.70.124.27<br/>13.75.195.15<br/>52.185.132.101<br/>52.185.132.170<br/>20.188.36.28<br/>40.89.153.171<br/>52.141.22.239<br/>52.141.22.149<br/>102.133.162.233<br/>102.133.161.73<br/>191.232.214.6<br/>191.232.213.239 | 443
250250
| Portal | gateway.azureserviceprofiler.net | dynamic | 443
251251
| Storage | *.core.windows.net | dynamic | 443
252+
253+
## Frequently asked questions
254+
255+
This section provides answers to common questions.
256+
257+
### Can I monitor an intranet web server?
258+
259+
Yes, but you need to allow traffic to our services by either firewall exceptions or proxy redirects:
260+
261+
- QuickPulse `https://rt.services.visualstudio.com:443`
262+
- ApplicationIdProvider `https://dc.services.visualstudio.com:443`
263+
- TelemetryChannel `https://dc.services.visualstudio.com:443`
264+
265+
See [IP addresses used by Azure Monitor](app/ip-addresses.md) to review our full list of services and IP addresses.
266+
267+
### How do I reroute traffic from my server to a gateway on my intranet?
268+
269+
Route traffic from your server to a gateway on your intranet by overwriting endpoints in your configuration. If the `Endpoint` properties aren't present in your config, these classes use the default values shown in the following ApplicationInsights.config example.
270+
271+
Your gateway should route traffic to our endpoint's base address. In your configuration, replace the default values with `http://<your.gateway.address>/<relative path>`.
272+
273+
#### Example ApplicationInsights.config with default endpoints:
274+
275+
```xml
276+
<ApplicationInsights>
277+
...
278+
<TelemetryModules>
279+
<Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
280+
<QuickPulseServiceEndpoint>https://rt.services.visualstudio.com/QuickPulseService.svc</QuickPulseServiceEndpoint>
281+
</Add>
282+
</TelemetryModules>
283+
...
284+
<TelemetryChannel>
285+
<EndpointAddress>https://dc.services.visualstudio.com/v2/track</EndpointAddress>
286+
</TelemetryChannel>
287+
...
288+
<ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
289+
<ProfileQueryEndpoint>https://dc.services.visualstudio.com/api/profiles/{0}/appId</ProfileQueryEndpoint>
290+
</ApplicationIdProvider>
291+
...
292+
</ApplicationInsights>
293+
```
294+
295+
> [!NOTE]
296+
> `ApplicationIdProvider` is available starting in v2.6.0.

articles/azure-monitor/app/javascript-sdk-configuration.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -338,7 +338,16 @@ Access-Control-Allow-Headers: `Request-Id`, `traceparent`, `Request-Context`, `<
338338
### How can I disable distributed tracing for the JavaScript SDK?
339339

340340
Distributed tracing can be disabled in configuration.
341-
341+
342+
### Are the HTTP 502 and 503 responses always captured by Application Insights?
343+
344+
No. The "502 bad gateway" and "503 service unavailable" errors aren't always captured by Application Insights. If only client-side JavaScript is being used for monitoring, this behavior would be expected because the error response is returned prior to the page containing the HTML header with the monitoring JavaScript snippet being rendered.
345+
346+
If the 502 or 503 response was sent from a server with server-side monitoring enabled, the errors are collected by the Application Insights SDK.
347+
348+
Even when server-side monitoring is enabled on an application's web server, sometimes a 502 or 503 error isn't captured by Application Insights. Many modern web servers don't allow a client to communicate directly. Instead, they employ solutions like reverse proxies to pass information back and forth between the client and the front-end web servers.
349+
350+
In this scenario, a 502 or 503 response might be returned to a client because of an issue at the reverse proxy layer, so it isn't captured out-of-box by Application Insights. To help detect issues at this layer, you might need to forward logs from your reverse proxy to Log Analytics and create a custom rule to check for 502 or 503 responses. To learn more about common causes of 502 and 503 errors, see [Troubleshoot HTTP errors of "502 bad gateway" and "503 service unavailable" in Azure App Service](../../app-service/troubleshoot-http-502-http-503.md).
342351

343352
## Next steps
344353

articles/azure-monitor/app/resources-roles-access-control.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -62,8 +62,8 @@ Where applicable, the link connects to the associated official reference documen
6262
| Azure Service Deploy Release Management Contributor | Contributor role for services deploying through Azure Service Deploy. |
6363
| [Data Purger](../../role-based-access-control/built-in-roles.md#data-purger) | Special role for purging personal data. For more information, see [Manage personal data in Log Analytics and Application Insights](../logs/personal-data-mgmt.md). |
6464
| Azure ExpressRoute administrator | Can create, delete, and manage express routes.|
65-
| [Log Analytics Contributor](../../role-based-access-control/built-in-roles.md#log-analytics-contributor) | Log Analytics Contributor can read all monitoring data and edit monitoring settings. Editing monitoring settings includes adding the VM extension to VMs, reading storage account keys to be able to configure collection of logs from Azure Storage, creating and configuring Automation accounts, adding solutions, and configuring Azure diagnostics on all Azure resources. |
66-
| [Log Analytics Reader](../../role-based-access-control/built-in-roles.md#log-analytics-reader) | Log Analytics Reader can view and search all monitoring data and view monitoring settings, including viewing the configuration of Azure diagnostics on all Azure resources. |
65+
| [Log Analytics Contributor](../../role-based-access-control/built-in-roles.md#log-analytics-contributor) | Log Analytics Contributor can read all monitoring data and edit monitoring settings. Editing monitoring settings includes adding the VM extension to VMs, reading storage account keys to be able to configure collection of logs from Azure Storage, creating and configuring Automation accounts, adding solutions, and configuring Azure diagnostics on all Azure resources. If you're having trouble setting up your Azure diagnostics, see [Azure diagnostics](../agents/diagnostics-extension-to-application-insights.md). |
66+
| [Log Analytics Reader](../../role-based-access-control/built-in-roles.md#log-analytics-reader) | Log Analytics Reader can view and search all monitoring data and view monitoring settings, including viewing the configuration of Azure diagnostics on all Azure resources. If you're having trouble setting up your Azure diagnostics, see [Azure diagnostics](../agents/diagnostics-extension-to-application-insights.md). |
6767
| masterreader | Allows a user to view everything but not make changes. |
6868
| [Monitoring Contributor](../../role-based-access-control/built-in-roles.md#monitoring-contributor) | Can read all monitoring data and update monitoring settings.|
6969
| [Monitoring Metrics Publisher](../../role-based-access-control/built-in-roles.md#monitoring-metrics-publisher) | Enables publishing metrics against Azure resources. |

articles/azure-monitor/best-practices-cost.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,39 @@ This article describes [Cost optimization](/azure/architecture/framework/cost/)
9090
| Limit the use of custom metrics. | The Application Insights option to [Enable alerting on custom metric dimensions](app/pre-aggregated-metrics-log-metrics.md#custom-metrics-dimensions-and-pre-aggregation) can increase costs. Using this option can result in the creation of more pre-aggregation metrics. |
9191
| Ensure use of updated SDKs. | Earlier versions of the ASP.NET Core SDK and Worker Service SDK [collect many counters by default](app/eventcounters.md#default-counters-collected), which were collected as custom metrics. Use later versions to specify [only required counters](app/eventcounters.md#customizing-counters-to-be-collected). |
9292

93+
## Frequently asked questions
9394

95+
This section provides answers to common questions.
96+
97+
### Is Application Insights free?
98+
99+
Yes, for experimental use. In the basic pricing plan, your application can send a certain allowance of data each month free of charge. The free allowance is large enough to cover development and publishing an app for a few users. You can set a cap to prevent more than a specified amount of data from being processed.
100+
101+
Larger volumes of telemetry are charged by the gigabyte. We provide some tips on how to [limit your charges](#application-insights).
102+
103+
The Enterprise plan incurs a charge for each day that each web server node sends telemetry. It's suitable if you want to use Continuous Export on a large scale.
104+
105+
Read the [pricing plan](https://azure.microsoft.com/pricing/details/application-insights/).
106+
107+
### How much does Application Insights cost?
108+
109+
* Open the **Usage and estimated costs** page in an Application Insights resource. There's a chart of recent usage. You can set a data volume cap, if you want.
110+
* To see your bills across all resources:
111+
112+
1. Open the [Azure portal](https://portal.azure.com).
113+
1. Search for **Cost Management** and use the **Cost analysis** pane to see forecasted costs.
114+
1. Search for **Cost Management and Billing** and open the **Billing scopes** pane to see current charges across subscriptions.
115+
116+
### Are there data transfer charges between an Azure web app and Application Insights?
117+
118+
* If your Azure web app is hosted in a datacenter where there's an Application Insights collection endpoint, there's no charge.
119+
* If there's no collection endpoint in your host datacenter, your app's telemetry incurs [Azure outgoing charges](https://azure.microsoft.com/pricing/details/bandwidth/).
120+
121+
This answer depends on the distribution of our endpoints, *not* on where your Application Insights resource is hosted.
122+
123+
### Will I incur network costs if my Application Insights resource is monitoring an Azure resource (i.e., telemetry producer) in a different region?
124+
125+
Yes, you may incur additional network costs which will vary depending on the region the telemetry is coming from and where it is going. Refer to [Azure bandwidth pricing](https://azure.microsoft.com/pricing/details/bandwidth/) for details.
94126

95127
## Next step
96128

0 commit comments

Comments
 (0)