Azure / Azure/azure-rest-api-specs

[BUG] Missing channels Property in Activity Logs REST API Specification

Open
#36,103 0 comments 0 reactions 0 assignees View on GitHub
bug customer-reported Mgmt Monitor question Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

### API Spec link

https://github.com/Azure/azure-rest-api-specs/blob/05cfd9ee0ccb1825b042a0da182944d9630cfc55/specification/monitor/resource-manager/Microsoft.Insights/stable/2015-04-01/activityLogs_API.json#L148

### API Spec version

2015-04-01

### Describe the bug

The channels property is returned in the response when querying Azure Monitor Activity Logs via the REST API, but it is missing from the official api specification used to generate SDKs (e.g., Azure.ResourceManager.Monitor version 1.3.1). As a result, the SDK does not expose this property.

Reference to the spec:
[activityLogs_API.json#L148](https://github.com/Azure/azure-rest-api-specs/blob/05cfd9ee0ccb1825b042a0da182944d9630cfc55/specification/monitor/resource-manager/Microsoft.Insights/stable/2015-04-01/activityLogs_API.json#L148)

This issue was also raised in the Azure SDK for .NET repository:
https://github.com/azure/azure-sdk-for-net/issues/51348

The SDK team confirmed that the channels property is missing from the REST API specification and advised contacting the service team via this repository. Updating the spec would allow the SDK to surface this important property in future releases.

### Expected behavior

The channels property should be included in the API specification so that SDKs generated from it (like Azure.ResourceManager.Monitor) also expose this field. This property is important for filtering or analyzing logs by type (Admin, Operation, etc.).

### Actual behavior

The channels field is returned by the REST API response, but it is not documented in the API specification. Consequently, the SDK omits this field, limiting functionality for users relying solely on the SDK.

### Reproduction Steps

Use the REST API endpoint:
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/microsoft.insights/eventtypes/management/values?api-version=2015-04-01

- Observe that the JSON response includes a channels property.
- Check the corresponding OpenAPI spec and note that channels is not defined.
- Attempt to access the channels property using Azure.ResourceManager.Monitor SDK — it is not available.

### Environment

_No response_

Contributor guide

Open the contributing guide

Research direction

Start with specification/monitor/resource-manager/Microsoft.Insights/stable/2015-04-01/activityLogs_API.json at the referenced response schema and compare it with the documented REST response. Verify the GET activity-log endpoint response and the missing channels field. Done means the specification defines channels so generated SDKs can expose it.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, openapi
Domain
api, cloud
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
58/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.