What is Azure Diagnostics extension

The Azure Diagnostics extension is an agent within Azure that enables the collection of diagnostic data on a deployed application. You can use the diagnostics extension from a number of different sources. Currently supported are Azure Cloud Service (classic) Web and Worker Roles, Virtual Machines, Virtual Machine Scale sets, and Service Fabric. Other Azure services have different diagnostics methods. See Overview of monitoring in Azure.

Linux Agent

A Linux version of the extension is available for Virtual Machines running Linux. The statistics collected and behavior vary from the Windows version.

Data you can collect

The Azure Diagnostics extension can collect the following types of data:

Data Source Description
Performance counters Operating System and custom performance counters
Application Logs Trace messages written by your application
Windows Event logs Information sent to the Windows event logging system
.NET Event Source Code writing events using the .NET EventSource class
IIS Logs Information about IIS web sites
Manifest based ETW Event Tracing for Windows events generated by any process.(1)
Crash dumps Information about the state of the process in the event of an application crash
Custom error logs Logs created by your application or service
Azure Diagnostic infrastructure logs Information about Diagnostics itself

(1) To get a list of ETW providers, run c:\Windows\System32\logman.exe query providers in a console window on the machine you'd like to gather information from.

Data storage

The extension stores its data in an Azure Storage account that you specify.

You can also send it to Application Insights. Another option is to stream it to Event Hub, which then allows you to send it to non-Azure montoring services.

Versioning and configuration schema

See Azure Diagnostics Version History and Schema.

Next steps

Choose which service you are trying to collect diagnostics on and use the following articles to get started. Use the general Azure diagnostics links for reference for specific tasks.

Cloud Services using Azure Diagnostics

For more advanced topics, see

Virtual Machines

For more advanced topics, see

Service Fabric

Get started at Monitor a Service Fabric application. Many other Service Fabric diagnostics articles are available in the navigation tree on the left once you get to this article.

General articles