Deploy Azure Monitor Application Insights Agent for on-premises servers

Application Insights Agent (formerly named Status Monitor V2) is a PowerShell module published to the PowerShell Gallery. It replaces Status Monitor. Telemetry is sent to the Azure portal, where you can monitor your app.

For a complete list of supported auto-instrumentation scenarios, see Supported environments, languages, and resource providers.

Note

The module currently supports codeless instrumentation of ASP.NET and ASP.NET Core web apps hosted with IIS. Use an SDK to instrument Java and Node.js applications.

PowerShell Gallery

Application Insights Agent is located in the PowerShell Gallery.

Instructions

• To get started with concise code samples, see Get started.
• For a deep dive on how to get started, see the detailed instructions.

PowerShell API reference

• Disable-ApplicationInsightsMonitoring
• Disable-InstrumentationEngine
• Enable-ApplicationInsightsMonitoring
• Enable-InstrumentationEngine
• Get-ApplicationInsightsMonitoringConfig
• Get-ApplicationInsightsMonitoringStatus
• Set-ApplicationInsightsMonitoringConfig
• Start-ApplicationInsightsMonitoringTrace

Frequently asked questions

This section provides answers to common questions.

Does Application Insights Agent support proxy installations?

Yes. There are multiple ways to download Application Insights Agent:

• If your computer has internet access, you can onboard to the PowerShell Gallery by using -Proxy parameters.
• You can also manually download the module and either install it on your computer or use it directly.

Each of these options is described in the detailed instructions.

Does Application Insights Agent support ASP.NET Core applications?

Yes. Starting from Application Insights Agent 2.0.0-beta1, ASP.NET Core applications hosted in IIS are supported.

How do I verify that the enablement succeeded?

• You can use the Get-ApplicationInsightsMonitoringStatus cmdlet to verify that enablement succeeded.

• Use Live Metrics to quickly determine if your app is sending telemetry.

• You can also use Log Analytics to list all the cloud roles currently sending telemetry:

  union * | summarize count() by cloud_RoleName, cloud_RoleInstance
  

Troubleshooting

See the dedicated troubleshooting article.

Test connectivity between your application host and the ingestion service

Application Insights SDKs and agents send telemetry to get ingested as REST calls to our ingestion endpoints. You can test connectivity from your web server or application host machine to the ingestion service endpoints by using raw REST clients from PowerShell or curl commands. See Troubleshoot missing application telemetry in Azure Monitor Application Insights.

Release notes

The release note updates are listed here.

2.0.0-beta3

• Updated the Application Insights .NET/.NET Core SDK to 2.20.1-redfield
• Enabled SQL query collection

2.0.0-beta2

Updated the Application Insights .NET/.NET Core SDK to 2.18.1-redfield

2.0.0-beta1

Added the ASP.NET Core auto-instrumentation feature

Next steps

View your telemetry:

• Explore metrics to monitor performance and usage.
• Search events and logs to diagnose problems.
• Use Log Analytics for more advanced queries.
• Create dashboards.

Add more telemetry:

• Create web tests to make sure your site stays live.
• Add web client telemetry to see exceptions from webpage code and to enable trace calls.
• Add the Application Insights SDK to your code so that you can insert trace and log calls.