Azure Monitor helps you maximize the availability and performance of your apps. It delivers a comprehensive solution for collecting, analyzing, and acting on telemetry from your cloud and on-premises environments.

All data collected by Azure Monitor fits into one of two fundamental types:

• Metrics—Numerical values that describe some aspect of a system at a particular point in time. They’re lightweight and can support near real-time scenarios.
• Logs—Contain different kinds of data organized into records with different sets of properties for each type. In addition to performance data, telemetry such as events, exceptions, and traces are stored as Logs.

To better support analyzing these data sources, we’re pleased to announce the 1.0 Beta 1 release of the Azure Monitor Query client library. The library:

• Enables querying both Azure Monitor Logs and Azure Monitor Metrics data.
• Supports .NET, Java, JavaScript/TypeScript, and Python.
• Follows the new Azure SDK guidelines.

This blog post will highlight new features of the library.

Azure Monitor Query library highlights

The new packages offer the following benefits over their predecessors.

Unified client library

Before this release, the libraries used for querying Logs and Metrics data were maintained as separate packages. The two distinct querying libraries have been combined into a single package. The table below lists packages being replaced by these new packages.

New client library features

The new libraries were updated to include the following new features:

Batch API for Logs query

The new libraries support the execution of multiple Logs queries in a single request. Consider this C# example, which executes two Kusto queries:

// code omitted for brevity

var client = new LogsQueryClient(endpoint, new DefaultAzureCredential());

// Query TOP 10 resource groups by event count
// And total event count
var batch = new LogsBatchQuery();
string countQueryId = batch.AddQuery(
    workspace: workspaceId,
    query: "AzureActivity | count",
    timeRange: TimeSpan.FromDays(1));
string topQueryId = batch.AddQuery(
    workspace: workspaceId, 
    query: "AzureActivity | summarize Count = count() by ResourceGroup | top 10 by Count",
    timeRange: TimeSpan.FromDays(1));

Response<LogsBatchQueryResult> response = await client.QueryBatchAsync(batch);

Performance statistics

Logs query performance statistics, such as execution time and resource usage, can be included in the response by opting in. Consider the following C# example, which opts in via the LogsQueryOptions class’ IncludeStatistics property:

// code omitted for brevity

var client = new LogsQueryClient(endpoint, new DefaultAzureCredential());
Response<LogsQueryResult> response = await client.QueryAsync(
    workspaceId, "AzureActivity | top 10 by TimeGenerated", TimeSpan.FromDays(1),
    new LogsQueryOptions
    {
        IncludeStatistics = true
    });

Server timeout

Logs query execution times vary widely based on several factors. Examples of such factors include:

• The query’s complexity.
• The amount of data being analyzed.
• The system and workspace load at the time of the query.

Some Logs queries take longer than three minutes to execute. The default server timeout is three minutes. With the new libraries, you can increase the server timeout to a maximum of 10 minutes. Consider the following C# example, which sets the server timeout to five minutes:

// code omitted for brevity

var client = new LogsQueryClient(endpoint, new DefaultAzureCredential());
Response<LogsQueryResult> response = await client.QueryAsync(
    workspaceId, "AzureActivity | top 10 by TimeGenerated", TimeSpan.FromDays(1),
    new LogsQueryOptions
    {
        ServerTimeout = TimeSpan.FromMinutes(5)
    });

Handwritten client libraries

Except for the .NET library, code generation was used to produce the old libraries. The new libraries for Java, JavaScript/TypeScript, and Python are handwritten to achieve parity with .NET. Per the design principles for the new Azure SDK libraries, the libraries strive to be idiomatic. As a developer in the target language, interacting with the library should feel natural.

Azure Active Directory authentication

The new library includes Azure Active Directory authentication support for both Logs and Metrics queries. Azure Identity is used, which improves the local development experience in editors and IDEs. Some popular examples include IntelliJ, Visual Studio Code, and Visual Studio.

Conclusion

The Azure Monitor Query libraries have enhanced querying Logs and Metrics data sources. To get started with the library, see the language-specific instructions below.

• .NET
• Java
• JavaScript/TypeScript
• Python

For language-specific examples, see the following code samples:

• .NET

• Java

• JavaScript / TypeScript

• Python

You’re encouraged to provide feedback before the library reaches general availability. To report issues or send feedback to the Azure SDK engineering team, use the language-specific links below:

• .NET

• Java

• JavaScript

• Python

Azure SDK Blog Contributions

Thank you for reading this Azure SDK blog post! We hope that you learned something new and welcome you to share this post. We are open to Azure SDK blog contributions. Please contact us at azsdkblog@microsoft.com with your topic and we’ll get you set up as a guest blogger.

Azure SDK Links

• Azure SDK Website: aka.ms/azsdk
• Azure SDK Intro (3 minute video): aka.ms/azsdk/intro
• Azure SDK Intro Deck (PowerPoint deck): aka.ms/azsdk/intro/deck
• Azure SDK Releases: aka.ms/azsdk/releases
• Azure SDK Blog: aka.ms/azsdk/blog
• Azure SDK Twitter: twitter.com/AzureSDK
• Azure SDK Design Guidelines: aka.ms/azsdk/guide
• Azure SDKs & Tools: azure.microsoft.com/downloads
• Azure SDK Central Repository: github.com/azure/azure-sdk
• Azure SDK for .NET: github.com/azure/azure-sdk-for-net
• Azure SDK for Java: github.com/azure/azure-sdk-for-java
• Azure SDK for Python: github.com/azure/azure-sdk-for-python
• Azure SDK for JavaScript/TypeScript: github.com/azure/azure-sdk-for-js
• Azure SDK for Android: github.com/Azure/azure-sdk-for-android
• Azure SDK for iOS: github.com/Azure/azure-sdk-for-ios
• Azure SDK for Go: github.com/Azure/azure-sdk-for-go
• Azure SDK for C: github.com/Azure/azure-sdk-for-c
• Azure SDK for C++: github.com/Azure/azure-sdk-for-cpp