What's new in Azure Monitor documentation
This article lists significant changes to Azure Monitor documentation.
December 2022
| Subservice | Article | Description |
|---|---|---|
| General | Azure Monitor for existing Operations Manager customers | Updated for AMA and SCOM managed instance. |
| Application-Insights | Create an Application Insights resource | Classic Application Insights resources are deprecated and support will end on February 29th, 2024. Migrate to workspace-based resources to take advantage of new capabilities. |
| Application-Insights | Enable Azure Monitor OpenTelemetry for .NET, Node.js, and Python applications (preview) | Updated Node.js sample code for JavaScript and TypeScript. |
| Application-Insights | System performance counters in Application Insights | Updated code samples for .NET 6/7. |
| Application-Insights | Sampling in Application Insights | Updated code samples for .NET 6/7. |
| Application-Insights | Availability alerts | This article has been rewritten with new guidance and screenshots. |
| Change-Analysis | Tutorial: Track a web app outage using Change Analysis | Change tutorial content to reflect changes to repo; remove and replace a few sections. |
| Containers | Configure Azure CNI networking in Azure Kubernetes Service (AKS) | Added steps to enable IP subnet usage |
| Containers | Reports in Container insights | Updated the documents to reflect the steps to enable IP subnet Usage |
| Essentials | Best practices for data collection rule creation and management in Azure Monitor | New article |
| Essentials | Configure self-managed Grafana to use Azure Monitor managed service for Prometheus (preview) with Azure Active Directory. | New Article: Configure self-managed Grafana to use Azure Monitor managed service for Prometheus (preview) with Azure Active Directory. |
| Logs | Azure Monitor SCOM Managed Instance (preview) | New article |
| Logs | Set a table's log data plan to Basic or Analytics | Updated the list of tables that support Basic logs. |
| Virtual-Machines | Tutorial: Create availability alert rule for Azure virtual machine (preview) | New article |
| Virtual-Machines | Tutorial: Enable recommended alert rules for Azure virtual machine | New article |
| Virtual-Machines | Tutorial: Enable monitoring with VM insights for Azure virtual machine | New article |
| Virtual-Machines | Monitor Azure virtual machines | Updated for AMA and availability metric. |
| Virtual-Machines | Enable VM insights by using Azure Policy | Updated flow for enabling VM insights with Azure Monitor Agent by using Azure Policy. |
| Visualizations | Creating an Azure Workbook | added Tutorial - resource centric logs queries in workbooks |
November 2022
| Subservice | Article | Description |
|---|---|---|
| General | Cost optimization and Azure Monitor | Complete rewrite to align with Well Architected Framework. Detailed content moved to other articles and linked from here. |
| Agents | Collect SNMP trap data with Azure Monitor Agent | New tutorial that explains how to collect Simple Network Management Protocol (SNMP) traps using Azure Monitor Agent. |
| Alerts | Create a new alert rule | Resource Health alerts and Service Health alerts are created using the same simplified workflow as all other alert types. |
| Alerts | Manage your alert rules | Recommended alert rules are enabled for AKS and Log Analytics workspace resources in addition to VMs. |
| Application-insights | Sampling in Application Insights | ASP.NET Core applications may be configured in code or through the appsettings.json file. Conflicting information was removed. |
| Application-insights | How many Application Insights resources should I deploy? | Clarification has been added on setting iKey dynamically in code. |
| Application-insights | Application Map: Triage distributed applications | App Map Filters, an exciting new feature, has been documented. |
| Application-insights | Enable Application Insights for ASP.NET Core applications | The Azure Café sample app is now hosted and linked on Git. |
| Application-insights | What is auto-instrumentation for Azure Monitor Application Insights? | Our auto-instrumentation supported languages chart has been updated. |
| Application-insights | Application Monitoring for Azure App Service and ASP.NET | Links to check versions have been corrected. |
| Application-insights | Sampling overrides (preview) - Azure Monitor Application Insights for Java | Updated OpenTelemetry Span information for Java. |
| Autoscale | Understand autoscale settings | Refresh and update |
| Autoscale | Overview of common autoscale patterns | Refreshed and updated. |
| Essentials | Azure Monitor managed service for Prometheus (preview) | General restructure of Prometheus content. |
| Essentials | Configure remote write for Azure Monitor managed service for Prometheus using Azure Active Directory authentication (preview) | New article |
| Essentials | Azure Monitor workspace (preview) | Added Bicep example. |
| Essentials | Migrate from diagnostic settings storage retention to Azure Storage lifecycle management | Deprecation note added |
| Essentials | Diagnostic settings in Azure Monitor | All destination endpoints support TLS 1.2. |
| Logs | Cost optimization and Azure Monitor | Added cost information and removed preview label. |
| Logs | Diagnostic settings in Azure Monitor | Added section on controlling costs with transformations. |
| Logs | Analyze usage in a Log Analytics workspace | Added KQL query that retrieves data volumes for charged data types. |
| Logs | Access the Azure Monitor Log Analytics API | Refresh and update |
| Logs | Collect text logs with the Log Analytics agent in Azure Monitor | New table management section with new articles on table configuration options, schema management, and custom table creation. |
| Logs | Azure Monitor Metrics overview | Added a new Azure SDK client library for Go. |
| Logs | Azure Monitor Log Analytics API Overview | Added a new Azure SDK client library for Go. |
| Logs | Azure Monitor Logs overview | Added a new Azure SDK client library for Go. |
| Logs | Log queries in Azure Monitor | Added a new Azure SDK client library for Go. |
| Logs | Set a table's log data plan to Basic or Analytics | Added new tables to the list of tables that support the Basic log data plan. |
| Visualizations | Monitor your Azure services in Grafana | The Grafana integration is GA, and is no longer in preview. |
| Visualizations | Get started with Azure Workbooks | Added instructions for how to share Workbooks. |
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
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 |
Feedback
Submit and view feedback for