What's new in Azure Monitor documentation

This article lists significant changes to Azure Monitor documentation.

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 EventHub 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