--- title: Azure Diagnostic Extension description: Track key Azure Diagnostic Extension metrics. breadcrumbs: Docs > Integrations > Azure Diagnostic Extension --- # Azure Diagnostic Extension {% alert level="warning" %} This integration is deprecated, and Azure plans to deprecate the Diagnostic Extension on March 31, 2026. Install the Datadog Agent for similar guest-level and process-level insights into your Azure VMs, with better granularity and latency. See Azure's Migration Guidance for additional migration options. The metrics listed on this page are no longer populated for newly created Datadog organizations. For existing users, these metrics were disabled on June 1, 2023. For any questions, contact Datadog Support. {% /alert %} ## Overview{% #overview %} The Azure Diagnostic Extension helps a user monitor the health of a VM running on Microsoft Azure. The Datadog Azure integration can collect metrics from the Azure Diagnostic Extension, but it is [recommended](https://www.datadoghq.com/blog/dont-fear-the-agent/) that you install the Datadog Agent on your VMs: - If your organization is on Datadog's US3 site and you've configured the Datadog resource in Azure, use the instructions on the [Azure Native Integration Manual Setup Guide](https://docs.datadoghq.com/integrations/guide/azure-native-manual-setup/#deploy-the-datadog-agent). - **All sites** can use the instructions on the [Azure Integration Manual Setup Guide](https://docs.datadoghq.com/integrations/guide/azure-manual-setup/#agent-installation) or [Azure Programmatic Management Guide](https://docs.datadoghq.com/integrations/guide/azure-programmatic-management/#datadog-azure-vm-extension). ## Setup{% #setup %} ### Installation{% #installation %} If you haven't already, set up the [Microsoft Azure integration](https://docs.datadoghq.com/integrations/azure/) first. There are no other installation steps. ## Data Collected{% #data-collected %} ### Metrics{% #metrics %} | | | | | **azure.vm.builtin\_disk\_averagediskqueuelength**(gauge) | Average number of queued disk operations (Deprecated)*Shown as operation* | | **azure.vm.builtin\_disk\_averagereadtime**(gauge) | Average seconds per read operation (Deprecated)*Shown as second* | | **azure.vm.builtin\_disk\_averagetransfertime**(gauge) | Average seconds per operation (Deprecated)*Shown as second* | | **azure.vm.builtin\_disk\_averagewritetime**(gauge) | Average seconds per write operation (Deprecated)*Shown as second* | | **azure.vm.builtin\_disk\_bytespersecond**(rate) | Number of bytes read or written per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_disk\_readbytespersecond**(rate) | Number of bytes read per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_disk\_readspersecond**(rate) | Read operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_disk\_transferspersecond**(rate) | Total operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_disk\_writebytespersecond**(rate) | Number of bytes written per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_disk\_writespersecond**(rate) | Write operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_filesystem\_bytespersecond**(rate) | Bytes read or written per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_filesystem\_bytesreadpersecond**(rate) | Bytes read per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_filesystem\_byteswrittenpersecond**(rate) | Bytes written per second (Deprecated)*Shown as byte* | | **azure.vm.builtin\_filesystem\_freespace**(gauge) | Available disk space in bytes (Deprecated)*Shown as byte* | | **azure.vm.builtin\_filesystem\_percentfreeinodes**(gauge) | Percentage of unused inodes (Deprecated)*Shown as percent* | | **azure.vm.builtin\_filesystem\_percentfreespace**(gauge) | Percentage free space (Deprecated)*Shown as percent* | | **azure.vm.builtin\_filesystem\_percentusedinodes**(gauge) | Percentage of allocated (in use) inodes summed across all filesystems (Deprecated)*Shown as percent* | | **azure.vm.builtin\_filesystem\_percentusedspace**(gauge) | Percentage used space (Deprecated)*Shown as percent* | | **azure.vm.builtin\_filesystem\_readspersecond**(rate) | Read operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_filesystem\_transferspersecond**(rate) | Read or write operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_filesystem\_usedspace**(gauge) | Used disk space in bytes (Deprecated)*Shown as byte* | | **azure.vm.builtin\_filesystem\_writespersecond**(rate) | Write operations per second (Deprecated)*Shown as operation* | | **azure.vm.builtin\_memory\_availablememory**(gauge) | Available physical memory in MiB (Deprecated)*Shown as mebibyte* | | **azure.vm.builtin\_memory\_availableswap**(gauge) | Unused swap space (MiB) (Deprecated)*Shown as mebibyte* | | **azure.vm.builtin\_memory\_pagespersec**(rate) | Total paging (read/write) (Deprecated)*Shown as page* | | **azure.vm.builtin\_memory\_pagesreadpersec**(rate) | Pages read from backing store (swap file, program file, mapped file, etc.) (Deprecated)*Shown as page* | | **azure.vm.builtin\_memory\_pageswrittenpersec**(rate) | Pages written to backing store (swap file, mapped file, etc.) (Deprecated)*Shown as page* | | **azure.vm.builtin\_memory\_percentavailablememory**(gauge) | Available physical memory as a percent of total memory (Deprecated)*Shown as percent* | | **azure.vm.builtin\_memory\_percentavailableswap**(gauge) | Unused swap space as a percentage of total swap (Deprecated)*Shown as percent* | | **azure.vm.builtin\_memory\_percentusedmemory**(gauge) | In-use physical memory as a percent of total memory (Deprecated)*Shown as percent* | | **azure.vm.builtin\_memory\_percentusedswap**(gauge) | In-use swap space as a percentage of total swap (Deprecated)*Shown as percent* | | **azure.vm.builtin\_memory\_usedmemory**(gauge) | In-use physical memory (MiB) (Deprecated)*Shown as mebibyte* | | **azure.vm.builtin\_memory\_usedswap**(gauge) | In-use swap space (MiB) (Deprecated)*Shown as mebibyte* | | **azure.vm.builtin\_network\_bytesreceived**(gauge) | Total bytes received since boot (Deprecated)*Shown as byte* | | **azure.vm.builtin\_network\_bytestotal**(gauge) | Total bytes sent or received since boot (Deprecated)*Shown as byte* | | **azure.vm.builtin\_network\_bytestransmitted**(gauge) | Total bytes sent since boot (Deprecated)*Shown as byte* | | **azure.vm.builtin\_network\_packetsreceived**(gauge) | Total packets received since boot (Deprecated)*Shown as packet* | | **azure.vm.builtin\_network\_packetstransmitted**(gauge) | Total packets sent since boot (Deprecated)*Shown as packet* | | **azure.vm.builtin\_network\_totalcollisions**(gauge) | Number of collisions reported by the network ports since boot (Deprecated) | | **azure.vm.builtin\_network\_totalrxerrors**(gauge) | Number of receive errors since boot (Deprecated)*Shown as error* | | **azure.vm.builtin\_network\_totaltxerrors**(gauge) | Number of transmit errors since boot (Deprecated)*Shown as error* | | **azure.vm.builtin\_processor\_percentidletime**(gauge) | Percentage of time during the aggregation window that processors were executing the kernel idle loop (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentinterrupttime**(gauge) | Percentage of time executing hardware/software interrupts and DPCs (deferred procedure calls) (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentiowaittime**(gauge) | Percentage of time waiting for IO operations to complete (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentnicetime**(gauge) | Of non-idle time, the percentage spent at lowered (nice) priority (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentprivilegedtime**(gauge) | Of non-idle time, the percentage spent in privileged (kernel) mode (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentprocessortime**(gauge) | Percentage of time executing a non-idle thread (Deprecated)*Shown as percent* | | **azure.vm.builtin\_processor\_percentusertime**(gauge) | Of non-idle time during the aggregation window, the percentage of time spent in user more at normal priority (Deprecated)*Shown as percent* | | **azure.vm.logical\_disk\_total\_avg.disk\_queue\_length**(gauge) | Average number of queued disk operations*Shown as operation* | | **azure.vm.logical\_disk\_total\_avg.disk\_read\_queue\_length**(gauge) | Average number of queued disk operations waiting to be read*Shown as operation* | | **azure.vm.logical\_disk\_total\_avg.disk\_sec\_read**(gauge) | Average seconds per read operation*Shown as second* | | **azure.vm.logical\_disk\_total\_avg.disk\_sec\_transfer**(gauge) | Average seconds per operation*Shown as second* | | **azure.vm.logical\_disk\_total\_avg.disk\_sec\_write**(gauge) | Average seconds per write operation*Shown as second* | | **azure.vm.logical\_disk\_total\_avg.disk\_write\_queue\_length**(gauge) | Average number of queued disk operations waiting to be written*Shown as operation* | | **azure.vm.logical\_disk\_total\_disk\_bytes\_per\_sec**(rate) | Number of bytes read or written per second*Shown as byte* | | **azure.vm.logical\_disk\_total\_disk\_read\_bytes\_per\_sec**(rate) | Number of bytes read per second*Shown as byte* | | **azure.vm.logical\_disk\_total\_disk\_reads\_per\_sec**(rate) | Read operations per second*Shown as operation* | | **azure.vm.logical\_disk\_total\_disk\_transfers\_per\_sec**(rate) | Total operations per second*Shown as operation* | | **azure.vm.logical\_disk\_total\_disk\_write\_bytes\_per\_sec**(rate) | Number of bytes written per second*Shown as byte* | | **azure.vm.logical\_disk\_total\_disk\_writes\_per\_sec**(rate) | Write operations per second*Shown as operation* | | **azure.vm.logical\_disk\_total\_free\_megabytes**(gauge) | The unallocated space, in megabytes, on the disk | | **azure.vm.logical\_disk\_total\_pct\_disk\_read\_time**(gauge) | Percentage of queued disk operations waiting to be read*Shown as percent* | | **azure.vm.logical\_disk\_total\_pct\_disk\_time**(gauge) | Percentage of queued disk operations*Shown as percent* | | **azure.vm.logical\_disk\_total\_pct\_disk\_write\_time**(gauge) | Percentage of queued disk operations waiting to be written*Shown as percent* | | **azure.vm.logical\_disk\_total\_pct\_free\_space**(gauge) | Percentage of unallocated space on the disk*Shown as percent* | | **azure.vm.logical\_disk\_total\_pct\_idle\_time**(gauge) | Percentage of time the disk remained idle*Shown as percent* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_bytes\_received\_per\_sec**(rate) | Bytes received per second*Shown as byte* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_bytes\_sent\_per\_sec**(rate) | Bytes sent per second*Shown as byte* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_bytes\_total\_per\_sec**(rate) | Total bytes per second*Shown as byte* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_packets\_outbound\_errors**(gauge) | Number of packet outbound errors*Shown as packet* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_packets\_per\_sec**(rate) | Total number of packets per second*Shown as packet* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_packets\_received\_errors**(gauge) | Number of packet received errors*Shown as error* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_packets\_received\_per\_sec**(rate) | Number of packets received per second*Shown as packet* | | **azure.vm.network\_interface\_microsoft\_hyper\_v\_network\_adapter\_2\_packets\_sent\_per\_sec**(rate) | Number of packets sent per second*Shown as packet* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_bytes\_received\_per\_sec**(rate) | Bytes received per second*Shown as byte* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_bytes\_sent\_per\_sec**(rate) | Bytes sent per second*Shown as byte* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_bytes\_total\_per\_sec**(rate) | Total bytes per second*Shown as byte* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_packets\_outbound\_errors**(gauge) | Number of packet outbound errors*Shown as error* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_packets\_per\_sec**(rate) | Total number of packets per second*Shown as packet* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_packets\_received\_errors**(gauge) | Number of packet received errors*Shown as error* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_packets\_received\_per\_sec**(rate) | Number of packets received per second*Shown as packet* | | **azure.vm.network\_interface\_teredo\_tunneling\_pseudo\_interface\_packets\_sent\_per\_sec**(rate) | Number of packets sent per second*Shown as packet* | | **azure.vm.processor\_information\_total\_pct\_privileged\_time**(gauge) | Of non-idle time, the percentage spent in privileged (kernel) mode*Shown as percent* | | **azure.vm.processor\_information\_total\_pct\_processor\_performance**(gauge) | Percentage processor performance*Shown as percent* | | **azure.vm.processor\_information\_total\_pct\_processor\_time**(gauge) | Percentage of time executing a non-idle thread*Shown as percent* | | **azure.vm.processor\_information\_total\_pct\_user\_time**(gauge) | Of non-idle time during the aggregation window, the percentage of time spent in user more at normal priority*Shown as percent* | | **azure.vm.processor\_percent\_idle\_time**(gauge) | Percentage of time during the aggregation window that processors were executing the kernel idle loop*Shown as percent* | | **azure.vm.system\_context\_switches\_per\_sec**(rate) | Number of system context switches per second*Shown as operation* | | **azure.vm.system\_processor\_queue\_length**(gauge) | Number of threads waiting for processor time*Shown as thread* | | **azure.vm.system\_system\_up\_time**(gauge) | System uptime | ### Events{% #events %} The Azure Diagnostic Extension integration does not include any events. ### Service Checks{% #service-checks %} The Azure Diagnostic Extension integration does not include any service checks. ## Troubleshooting{% #troubleshooting %} Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).