Deploy Azure Monitor Application Insights Agent for on-premises servers

Important

This guidance is recommended for On-Premises and non-Azure cloud deployments of Application Insights Agent. Here's the recommended approach for Azure virtual machine and virtual machine scale set deployments.

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.

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 here: https://www.powershellgallery.com/packages/Az.ApplicationMonitor.

Instructions

• See the getting started instructions to get a start with concise code samples.
• See the detailed instructions for a deep dive on how to get started.

PowerShell API reference

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

Troubleshooting

• Troubleshooting
• Known issues

FAQ

• 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 Status Monitor v2 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?

  • The Get-ApplicationInsightsMonitoringStatus cmdlet can be used to verify that enablement succeeded.

  • We recommend you 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
    

Release notes

2.0.0-beta3

• Update ApplicationInsights .NET/.NET Core SDK to 2.20.1-redfield.
• Enable SQL query collection.

2.0.0-beta2

• Updated ApplicationInsights .NET/.NET Core SDK to 2.18.1-redfield.

2.0.0-beta1

• Added 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 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 web page code and to enable trace calls.
• Add the Application Insights SDK to your code so you can insert trace and log calls.