Azure Monitor Query SDK for Java Acceptance Criteria

SDK: com.azure:azure-monitor-queryRepository: https://github.com/Azure/azure-sdk-for-java/tree/main/sdk/monitor/azure-monitor-queryPurpose: Skill testing acceptance criteria for validating generated code correctness

---

⚠️ DEPRECATION NOTICE

This package is deprecated in favor of:

• azure-monitor-query-logs for Log Analytics queries
• azure-monitor-query-metrics for metrics queries

---

1. Correct Import Patterns

1.1 Client Imports

✅ CORRECT: Query Clients

import com.azure.monitor.query.LogsQueryClient;
import com.azure.monitor.query.LogsQueryClientBuilder;
import com.azure.monitor.query.LogsQueryAsyncClient;
import com.azure.monitor.query.MetricsQueryClient;
import com.azure.monitor.query.MetricsQueryClientBuilder;

✅ CORRECT: Authentication

import com.azure.identity.DefaultAzureCredentialBuilder;

1.2 Model Imports

✅ CORRECT: Query Models

import com.azure.monitor.query.models.LogsQueryResult;
import com.azure.monitor.query.models.LogsTableRow;
import com.azure.monitor.query.models.QueryTimeInterval;
import com.azure.monitor.query.models.MetricsQueryResult;
import com.azure.monitor.query.models.MetricResult;
import com.azure.monitor.query.models.LogsBatchQuery;
import com.azure.monitor.query.models.LogsQueryOptions;

---

2. Client Creation Patterns

2.1 ✅ CORRECT: LogsQueryClient

LogsQueryClient logsClient = new LogsQueryClientBuilder()
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

2.2 ✅ CORRECT: MetricsQueryClient

MetricsQueryClient metricsClient = new MetricsQueryClientBuilder()
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

---

3. Logs Query Operations

3.1 ✅ CORRECT: Basic Query

String workspaceId = System.getenv("LOG_ANALYTICS_WORKSPACE_ID");

LogsQueryResult result = logsClient.queryWorkspace(
    workspaceId,
    "AzureActivity | summarize count() by ResourceGroup | top 10 by count_",
    new QueryTimeInterval(Duration.ofDays(7))
);

for (LogsTableRow row : result.getTable().getRows()) {
    System.out.println(row.getColumnValue("ResourceGroup"));
}

3.2 ✅ CORRECT: Query with Model Mapping

List<ActivityLog> logs = logsClient.queryWorkspace(
    workspaceId,
    "AzureActivity | project ResourceGroup, OperationName | take 100",
    new QueryTimeInterval(Duration.ofDays(2)),
    ActivityLog.class
);

3.3 ✅ CORRECT: Batch Query

LogsBatchQuery batchQuery = new LogsBatchQuery();
String q1 = batchQuery.addWorkspaceQuery(workspaceId, "AzureActivity | count", new QueryTimeInterval(Duration.ofDays(1)));
String q2 = batchQuery.addWorkspaceQuery(workspaceId, "Heartbeat | count", new QueryTimeInterval(Duration.ofDays(1)));

LogsBatchQueryResultCollection results = logsClient
    .queryBatchWithResponse(batchQuery, Context.NONE)
    .getValue();

LogsBatchQueryResult result1 = results.getResult(q1);

---

4. Metrics Query Operations

4.1 ✅ CORRECT: Basic Metrics Query

String resourceId = System.getenv("AZURE_RESOURCE_ID");

MetricsQueryResult result = metricsClient.queryResource(
    resourceId,
    Arrays.asList("SuccessfulCalls", "TotalCalls")
);

for (MetricResult metric : result.getMetrics()) {
    System.out.println("Metric: " + metric.getMetricName());
}

---

5. Error Handling

5.1 ✅ CORRECT: Check Query Status

import com.azure.monitor.query.models.LogsQueryResultStatus;

LogsQueryResult result = logsClient.queryWorkspace(workspaceId, query, timeInterval);

if (result.getStatus() == LogsQueryResultStatus.PARTIAL_FAILURE) {
    System.err.println("Partial failure: " + result.getError().getMessage());
}

5.2 ✅ CORRECT: HTTP Exception Handling

import com.azure.core.exception.HttpResponseException;

try {
    logsClient.queryWorkspace(workspaceId, query, timeInterval);
} catch (HttpResponseException e) {
    System.err.println("Query failed: " + e.getMessage());
}

---

6. Best Practices Checklist

• [ ] Use batch queries to combine multiple queries
• [ ] Set appropriate timeouts for long queries
• [ ] Limit result size with top or take
• [ ] Use project to select only needed columns
• [ ] Handle PARTIAL_FAILURE results gracefully
• [ ] Plan migration to azure-monitor-query-logs and azure-monitor-query-metrics