What's new in Azure Monitor documentation

This article lists significant changes to Azure Monitor documentation.

October 2022

Sub-service Article Description
General Table of contents We have updated the Azure Monitor Table of Contents. The new TOC structure better reflects the customer experience and makes it easier for users to navigate and discover our content.
Alerts Connect Azure to ITSM tools by using IT Service Management Deprecating support for sending ITSM actions and events to ServiceNow. Instead, use ITSM actions in action groups based on Azure alerts to create work items in your ITSM tool.
Alerts Create a new alert rule New PowerShell commands to create and manage log alerts.
Alerts Types of Azure Monitor alerts Updated to include Prometheus alerts.
Alerts Customize alert notifications using Logic Apps New: How to use alerts to send emails or Teams posts using logic apps
Application-insights Sampling in Application Insights The "When to use sampling" and "How sampling works" sections have been prioritized as prerequisite information for the rest of the article.
Application-insights What is auto-instrumentation for Azure Monitor Application Insights? The auto-instrumentation overview has been visually overhauled with links and footnotes.
Application-insights Enable Azure Monitor OpenTelemetry for .NET, Node.js, and Python applications (preview) Open Telemetry Metrics are now available for .NET, Node.js and Python applications.
Application-insights Find and diagnose performance issues with Application Insights The URL Ping (Classic) Test has been replaced with the Standard Test step-by-step instructions.
Application-insights Application Insights API for custom events and metrics Flushing information was added to the FAQ.
Application-insights Azure AD authentication for Application Insights We updated the TelemetryConfiguration code sample using .NET.
Application-insights Using Azure Monitor Application Insights with Spring Boot Spring Boot information was updated to 3.4.2.
Application-insights Configuration options: Azure Monitor Application Insights for Java New features include Capture Log4j Markers and Logback Markers as custom properties on the corresponding trace (log message) telemetry.
Application-insights Create custom KPI dashboards using Application Insights This article has been refreshed with new screenshots and instructions.
Application-insights Share Azure dashboards by using Azure role-based access control This article has been refreshed with new screenshots and instructions.
Application-insights Application Monitoring for Azure App Service and ASP.NET Important notes added regarding System.IO.FileNotFoundException after 2.8.44 auto-instrumentation upgrade.
Application-insights Geolocation and IP address handling Geolocation lookup information has been updated.
Containers Metric alert rules in Container insights (preview) Container insights metric Alerts
Containers Custom metrics collected by Container insights New article.
Containers Overview of Container insights in Azure Monitor Rewritten to simplify onboarding options.
Containers Enable Container insights for Azure Kubernetes Service (AKS) cluster Updated to combine new and existing clusters.
Containers Prometheus Query logs from Container insights Now includes log queries for Prometheus data.
Containers Prometheus Collect Prometheus metrics with Container insights Updated to include Azure Monitor managed service for Prometheus.
Essentials Prometheus Metrics in Azure Monitor Updated to include Azure Monitor managed service for Prometheus
Essentials Prometheus New articles. Public preview of Azure Monitor managed service for Prometheus
Essentials Prometheus Azure Monitor managed service for Prometheus remote write - managed identity (preview) Addition: Verify Prometheus remote write is working correctly
Essentials Azure resource logs Clarification: Which blobs logs are written to, and when
Essentials Resource Manager template samples for Azure Monitor Added template deployment methods.
Essentials Azure Monitor service limits Added Azure Monitor managed service for Prometheus
Logs Manage access to Log Analytics workspaces Table-level role-based access control (RBAC) lets you give specific users or groups read access to particular tables.
Logs Configure Basic Logs in Azure Monitor General availability of the Basic Logs data plan, retention and archiving, search job, and the table management user experience in the Azure portal.
Logs Guided project - Analyze logs in Azure Monitor with KQL - Training New Learn module. Learn to write KQL queries to retrieve and transform log data to answer common business and operational questions.
Logs Detect and analyze anomalies with KQL in Azure Monitor New tutorial. Walkthrough of how to use KQL for time series analysis and anomaly detection in Azure Monitor Log Analytics.
Virtual-machines Enable VM insights for a hybrid virtual machine Updated versions of standalone installers.
Visualizations Retrieve legacy Application Insights workbooks New article about how to access legacy workbooks in the Azure portal.
Visualizations Azure Workbooks New video to see how you can use Azure Workbooks to get insights and visualize your data.

September 2022

Agents

Article Description
Azure Monitor Agent overview Added Azure Monitor Agent support for ARM64-based virtual machines for a number of distributions.

Azure Monitor Agent and legacy agents don't support machines and appliances that run heavily customized or stripped-down versions of operating system distributions.

Azure Monitor Agent versions 1.15.2 and higher now support syslog RFC formats, including Cisco Meraki, Cisco ASA, Cisco FTD, Sophos XG, Juniper Networks, Corelight Zeek, CipherTrust, NXLog, McAfee, and Common Event Format (CEF).

Alerts

Article Description
Convert ITSM actions that send events to ServiceNow to secure webhook actions As of September 2022, we're starting the 3-year process of deprecating support of using ITSM actions to send events to ServiceNow. Learn how to convert ITSM actions that send events to ServiceNow to secure webhook actions
Create a new alert rule Added description of all available monitoring services to create a new alert rule and alert processing rules pages.

Added support for regional processing for metric alert rules that monitor a custom metric with the scope defined as one of the supported regions.

Clarified that selecting the Automatically resolve alerts setting makes log alerts stateful.<
Types of Azure Monitor alerts Azure Database for PostgreSQL - Flexible Servers is supported for monitoring multiple resources.
Upgrade legacy rules management to the current Log Alerts API from legacy Log Analytics Alert API The process of moving legacy log alert rules management from the legacy API to the current API is now supported by the government cloud.

Application insights

Article Description
Azure Monitor OpenTelemetry-based auto-instrumentation for Java applications New OpenTelemetry @WithSpan annotation guidance.
Capture Application Insights custom metrics with .NET and .NET Core Tutorial steps and images have been updated.
Configuration options - Azure Monitor Application Insights for Java Connection string guidance updated.
Enable Application Insights for ASP.NET Core applications Tutorial steps and images have been updated.
Enable Azure Monitor OpenTelemetry Exporter for .NET, Node.js, and Python applications (preview) Our product feedback link at the bottom of each document has been fixed.
Filter and preprocess telemetry in the Application Insights SDK Added sample initializer to control which client IP gets used as part of geo-location mapping.
Java Profiler for Azure Monitor Application Insights Our new Java Profiler was announced at Ignite. Read all about it!
Release notes for Azure Web App extension for Application Insights Added release notes for 2.8.44 and 2.8.43.
Resource Manager template samples for creating Application Insights resources Fixed inaccurate tagging of workspace-based resources as still in Preview.
Unified cross-component transaction diagnostics A complete FAQ section is added to help troubleshoot Azure portal errors, such as "error retrieving data".
Upgrading from Application Insights Java 2.x SDK Additional upgrade guidance added. Java 2.x has been deprecated.
Using Azure Monitor Application Insights with Spring Boot Configuration options have been updated.

Autoscale

Article Description
Autoscale with multiple profiles New article: Using multiple profiles in autoscale with CLI PowerShell and templates.
Flapping in Autoscale New Article: Flapping in autoscale.
Understand Autoscale settings Clarified how often autoscale runs.

Change analysis

Article Description
Troubleshoot Azure Monitor's Change Analysis Added section about partial data and how to mitigate to the troubleshooting guide.

Essentials

Article Description
Structure of transformation in Azure Monitor (preview) New KQL functions supported.

Virtual Machines

Article Description
Migrate from Service Map to Azure Monitor VM insights Added a new article with guidance for migrating from the Service Map solution to Azure Monitor VM insights.

Network Insights

Article Description
Network Insights Onboarded the new topology experience to Network Insights in Azure Monitor.

Visualizations

Article Description
Access deprecated Troubleshooting guides in Azure Workbooks New article: Access deprecated Troubleshooting guides in Azure Workbooks.

August 2022

Agents

Article Description
Log Analytics agent overview Restructured the Agents section and rewrote the Agents Overview article to reflect that Azure Monitor Agent is the primary agent for collecting monitoring data.
Dependency analysis in Azure Migrate Discovery and assessment - Azure Migrate Revamped the guidance for migrating from Log Analytics Agent to Azure Monitor Agent.

Alerts

Article Description
Create Azure Monitor alert rules Added support for data processing in a specified region, for action groups and for metric alert rules that monitor a custom metric.

Application insights

Article Description
Azure Application Insights Overview Dashboard Important information has been added clarifying that moving or renaming resources will break dashboards, with additional instructions on how to resolve this scenario.
Azure Application Insights override default SDK endpoints We've clarified that endpoint modification isn't recommended and to use connection strings instead.
Continuous export of telemetry from Application Insights Important information has been added about avoiding duplicates when saving diagnostic logs in a Log Analytics workspace.
Dependency Tracking in Azure Application Insights with OpenCensus Python Updated Django sample application and documentation in the Azure Monitor OpenCensus Python samples repository.
Incoming Request Tracking in Azure Application Insights with OpenCensus Python Updated Django sample application and documentation in the Azure Monitor OpenCensus Python samples repository.
Monitor Python applications with Azure Monitor Updated Django sample application and documentation in the Azure Monitor OpenCensus Python samples repository.
Configuration options - Azure Monitor Application Insights for Java Updated connection string overrides example.
Application Insights SDK for ASP.NET Core applications A new tutorial with step-by-step instructions to use the Application Insights SDK with .NET Core applications.
Application Insights SDK support guidance Our SDK support guidance has been updated and clarified.
Azure Application Insights - Dependency Auto-Collection The latest currently supported node.js modules have been updated.
Application Insights custom metrics with .NET and .NET Core A new tutorial with step-by-step instructions on how to enable custom metrics with .NET applications.
Migrate an Application Insights classic resource to a workspace-based resource A comprehensive FAQ section has been added to assist with migration to workspace-based resources.
Configuration options - Azure Monitor Application Insights for Java This article has been fully updated for 3.4.0-BETA.

Autoscale

Article Description
Autoscale in Microsoft Azure Updated conceptual diagrams
Use predictive autoscale to scale out before load demands in Virtual Machine Scale Sets (preview) Predictive autoscale (preview) is now available in all regions

Change analysis

Article Description
Enable Change Analysis Added note for slot-level enablement
Tutorial - Track a web app outage using Change Analysis Added set up steps to tutorial
Use Change Analysis in Azure Monitor to find web-app issues Updated limitations
Observability data in Azure Monitor Added "Changes" section

Containers

Article Description
Monitor an Azure Kubernetes Service (AKS) cluster deployed Added section on using private link with Container insights.

Essentials

Article Description
Azure activity log Added instructions for how to stop collecting activity logs using the legacy collection method.
Azure activity log insights Created a separate Activity Log Insights article in the Insights section.

Logs

Article Description
Configure data retention and archive in Azure Monitor Logs (Preview) Clarified how data retention and archiving work in Azure Monitor Logs to address repeated customer inquiries.

July 2022

General

Article Description
Sources of data in Azure Monitor Updated with Azure Monitor agent and Logs ingestion API.

Agents

Article Description
Azure Monitor Agent overview Restructure of the Agents section. A single Azure Monitor Agent is replacing all of Azure Monitor's legacy monitoring agents.
Enable network isolation for the Azure Monitor agent Rewritten to better describe configuration of network isolation.

Alerts

Article Description
Azure Monitor Alerts Overview Updated the logic for the time to resolve behavior in stateful log alerts.

Application Insights

Article Description
Azure Monitor Application Insights Java OpenTelemetry-based auto-instrumentation for Java applications has an updated Supported Custom Telemetry table.
Application Insights API for custom events and metrics Clarification has been added that valueCount and itemCount have a minimum value of 1.
Telemetry sampling in Azure Application Insights Sampling documentation has been updated to warn of the potential impact on alerting accuracy.
Azure Monitor Application Insights Java (redirect to OpenTelemetry) Java Auto-Instrumentation now redirects to OpenTelemetry documentation.
Azure Application Insights for ASP.NET Core applications Updated .NET Core FAQ
Create a new Azure Monitor Application Insights workspace-based resource We've linked out to Microsoft Insights components for more information on Properties.
Application Insights SDK support guidance SDK support guidance has been updated and clarified.
Azure Monitor Application Insights Java Example code has been updated.
IP addresses used by Azure Monitor The IP/FQDN table has been updated.
Continuous export of telemetry from Application Insights The continuous export notice has been updated and clarified.
Set up availability alerts with Application Insights Custom Alert Rule and Alert Frequency sections have been added.

Autoscale

Article Description
How-to guide for setting up autoscale for a web app with a custom metric General rewrite to improve clarity.
Overview of autoscale in Microsoft Azure General rewrite to improve clarity.

Containers

Article Description
Overview of Container insights Added information about deprecation of Docker support.
Enable Container insights All Container insights content updated for new support of managed identity authentication using Azure Monitor agent.

Essentials

Article Description
Tutorial - Editing Data Collection Rules New article.
Data Collection Rules in Azure Monitor General rewrite to improve clarity.
Data collection transformations General rewrite to improve clarity.
Data collection in Azure Monitor New article.
How to Migrate from Diagnostic Settings Storage Retention to Azure Storage Lifecycle Policy New article.

Logs

Article Description
Logs ingestion API in Azure Monitor (Preview) Custom logs API renamed to Logs ingestion API.
Tutorial - Send data to Azure Monitor Logs using REST API (Resource Manager templates) Custom logs API renamed to Logs ingestion API.
Tutorial - Send data to Azure Monitor Logs using REST API (Azure portal) Custom logs API renamed to Logs ingestion API.

Virtual Machines

Article Description
What is VM insights? All VM insights content updated for new support of Azure Monitor agent.

June 2022

General

Article Description
Tutorial - Editing Data Collection Rules New article

Application Insights

Article Description
Application Insights logging with .NET Connection string sample code has been added.
Application Insights SDK support guidance Updated SDK supportability guidance.
Azure AD authentication for Application Insights Azure AD authenticated telemetry ingestion has been reached general availability.
Azure Application Insights for JavaScript web apps Our Java on-premises page has been retired and redirected to Azure Monitor OpenTelemetry-based auto-instrumentation for Java applications.
Azure Application Insights Telemetry Data Model - Telemetry Context Clarified that Anonymous User ID is simply User.Id for easy selection in Intellisense.
Continuous export of telemetry from Application Insights On February 29, 2024, continuous export will be deprecated as part of the classic Application Insights deprecation.
Dependency Tracking in Azure Application Insights The Event Hubs Client SDK and ServiceBus Client SDK information has been updated.
Monitor Azure app services performance .NET Core Updated Linux troubleshooting guidance.
Performance counters in Application Insights A prerequisite section has been added to ensure performance counter data is accessible.

Agents

Article Description
Collect text and IIS logs with Azure Monitor agent (preview) Added troubleshooting section.
Tools for migrating to Azure Monitor Agent from legacy agents New article that explains how to install and use tools for migrating from legacy agents to the new Azure Monitor agent (AMA).

Visualizations

Azure Monitor Workbooks documentation previously resided on an external GitHub repository. We've migrated all Azure Workbooks content to the same repo as all other Azure Monitor content.

May 2022

General

Article Description
Azure Monitor cost and usage Added standard web tests to table
Added explanation of billable GB calculation
Azure Monitor overview Updated overview diagram

Agents

Article Description
Azure Monitor agent extension versions Update to latest extension version
Azure Monitor agent overview Added supported resource types
Collect text and IIS logs with Azure Monitor agent (preview) Corrected error in data collection rule
Overview of the Azure monitoring agents Added new OS supported for agent
Resource Manager template samples for agents Added Bicep examples
Resource Manager template samples for data collection rules Fixed bug in sample parameter file
Rsyslog data not uploaded due to Full Disk space issue on AMA Linux Agent New article
Troubleshoot the Azure Monitor agent on Linux virtual machines and scale sets New article
Troubleshoot the Azure Monitor agent on Windows Arc-enabled server New article
Troubleshoot the Azure Monitor agent on Windows virtual machines and scale sets New article

Alerts

Article Description
IT Service Management Connector | Secure Webhook in Azure Monitor | Azure Configurations Added the workflow for ITSM management and removed all references to SCSM.
Overview of Azure Monitor Alerts Complete rewrite
Resource Manager template samples for log query alerts Bicep samples for alerting have been added to the Resource Manager template samples articles.
Supported resources for metric alerts in Azure Monitor Added a newly supported resource type.

Application Insights

Article Description
Application Map in Azure Application Insights Application Maps Intelligent View feature
Azure Application Insights for ASP.NET Core applications telemetry.Flush() guidance is now available.
Diagnose with Live Metrics Stream Updated information on using unsecure control channel.
Migrate an Azure Monitor Application Insights classic resource to a workspace-based resource Schema change documentation is now available here.
Profile production apps in Azure with Application Insights Profiler Profiler documentation now has a new home in the table of contents.

All references to unsupported versions of .NET and .NET CORE have been scrubbed from Application Insights product documentation. See .NET and >NET Core Support Policy

Change Analysis

Article Description
Navigate to a change using custom filters in Change Analysis New article
Pin and share a Change Analysis query to the Azure dashboard New article
Use Change Analysis in Azure Monitor to find web-app issues Added details enabling for web app in-guest changes

Containers

Article Description
Configure ContainerLogv2 schema (preview) for Container Insights New article describing new schema for container logs
Enable Container insights General rewrite to improve clarity
Resource Manager template samples for Container insights Added Bicep examples

Insights

Article Description
Troubleshoot SQL Insights (preview) Added known issue for OS computer name.

Logs

Article Description
Azure Monitor customer-managed key Update limitations and constraint.
Design a Log Analytics workspace architecture Complete rewrite to better describe decision criteria and include Sentinel considerations
Manage access to Log Analytics workspaces Consolidated and rewrote all content on configuring workspace access
Restore logs in Azure Monitor (Preview) Documented new Log Analytics table management configuration UI, which lets you configure a table's log plan and archive and retention policies.

Virtual Machines

Article Description
Migrate from VM insights guest health (preview) to Azure Monitor log alerts New article describing process to replace VM guest health with alert rules
VM insights guest health (preview) Added deprecation statement