[AKS] Rename OpenTelemetry ports and add gRPC support for metrics/logs by ChFlick · Pull Request #10079 · Azure/azure-cli-extensions

ChFlick · 2026-07-06T16:23:08Z

🤖 PR Validation — ❌ Action needed

Breaking Changes
❌ 1

❌Azure CLI Extensions Breaking Change Test

❌aks-preview

rule cmd_name rule_message suggest_message

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter disable_opentelemetry_logs: updated property options from ['--disable-opentelemetry-logs'] to ['--disable-opentelemetry-logs-traces'] please change property options from ['--disable-opentelemetry-logs-traces'] to ['--disable-opentelemetry-logs'] for parameter disable_opentelemetry_logs of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter enable_opentelemetry_logs: updated property options from ['--enable-opentelemetry-logs'] to ['--enable-opentelemetry-logs-traces'] please change property options from ['--enable-opentelemetry-logs-traces'] to ['--enable-opentelemetry-logs'] for parameter enable_opentelemetry_logs of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter opentelemetry_logs_port: updated property options from ['--opentelemetry-logs-port'] to ['--opentelemetry-logs-traces-port-http'] please change property options from ['--opentelemetry-logs-traces-port-http'] to ['--opentelemetry-logs-port'] for parameter opentelemetry_logs_port of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter opentelemetry_metrics_port: updated property options from ['--opentelemetry-metrics-port'] to ['--opentelemetry-metrics-port-http'] please change property options from ['--opentelemetry-metrics-port-http'] to ['--opentelemetry-metrics-port'] for parameter opentelemetry_metrics_port of cmd aks create

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter disable_opentelemetry_logs: updated property options from ['--disable-opentelemetry-logs'] to ['--disable-opentelemetry-logs-traces'] please change property options from ['--disable-opentelemetry-logs-traces'] to ['--disable-opentelemetry-logs'] for parameter disable_opentelemetry_logs of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter enable_opentelemetry_logs: updated property options from ['--enable-opentelemetry-logs'] to ['--enable-opentelemetry-logs-traces'] please change property options from ['--enable-opentelemetry-logs-traces'] to ['--enable-opentelemetry-logs'] for parameter enable_opentelemetry_logs of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter opentelemetry_logs_port: updated property options from ['--opentelemetry-logs-port'] to ['--opentelemetry-logs-traces-port-http'] please change property options from ['--opentelemetry-logs-traces-port-http'] to ['--opentelemetry-logs-port'] for parameter opentelemetry_logs_port of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter opentelemetry_metrics_port: updated property options from ['--opentelemetry-metrics-port'] to ['--opentelemetry-metrics-port-http'] please change property options from ['--opentelemetry-metrics-port-http'] to ['--opentelemetry-metrics-port'] for parameter opentelemetry_metrics_port of cmd aks update

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter disable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter enable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_logs_port_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_logs_traces_port_grpc

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_metrics_port_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_metrics_port_grpc

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter disable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter enable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_logs_port_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_logs_traces_port_grpc

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_metrics_port_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_metrics_port_grpc

Testing notes:

installed the local aks-preview extension via azdev extension add aks-preview and confirmed it loads & verified new flags appear in az aks update --help with correct [Preview] (new port/enable flags) and [Deprecated] (renamed old flags) decoration
Ran az aks update against a live cluster with --enable-opentelemetry-metrics --opentelemetry-metrics-port-http/-grpc and used --debug to confirm the payload includes the new grpcPort / httpPort fields under azureMonitorProfile.appMonitoring.openTelemetryMetrics
Verified argument validation behaves as designed: port flags are correctly rejected when the corresponding --enable-opentelemetry-* flag isn't set / OTLP isn't already enabled
Confirmed deprecated aliases still work and emit the expected redirect warning to the new flag names

This checklist is used to make sure that common guidelines for a pull request are followed.

Related command

General Guidelines

Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
Have you run python scripts/ci/test_index.py -q locally? (azdev required; see .azure-pipelines/templates/azdev_setup.yml for the install command until azdev==0.2.11b1 is on PyPI)
My extension version conforms to the Extension version schema

For new extensions:

My extension description/summary conforms to the Extension Summary Guidelines.

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

azure-client-tools-bot-prd · 2026-07-06T16:23:14Z

❌Azure CLI Extensions Breaking Change Test

❌aks-preview

rule cmd_name rule_message suggest_message

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter disable_opentelemetry_logs: updated property options from ['--disable-opentelemetry-logs'] to ['--disable-opentelemetry-logs-traces'] please change property options from ['--disable-opentelemetry-logs-traces'] to ['--disable-opentelemetry-logs'] for parameter disable_opentelemetry_logs of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter enable_opentelemetry_logs: updated property options from ['--enable-opentelemetry-logs'] to ['--enable-opentelemetry-logs-traces'] please change property options from ['--enable-opentelemetry-logs-traces'] to ['--enable-opentelemetry-logs'] for parameter enable_opentelemetry_logs of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter opentelemetry_logs_port: updated property options from ['--opentelemetry-logs-port'] to ['--opentelemetry-logs-traces-port-http'] please change property options from ['--opentelemetry-logs-traces-port-http'] to ['--opentelemetry-logs-port'] for parameter opentelemetry_logs_port of cmd aks create

❌ 1010 - ParaPropUpdate aks create cmd aks create update parameter opentelemetry_metrics_port: updated property options from ['--opentelemetry-metrics-port'] to ['--opentelemetry-metrics-port-http'] please change property options from ['--opentelemetry-metrics-port-http'] to ['--opentelemetry-metrics-port'] for parameter opentelemetry_metrics_port of cmd aks create

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter disable_opentelemetry_logs: updated property options from ['--disable-opentelemetry-logs'] to ['--disable-opentelemetry-logs-traces'] please change property options from ['--disable-opentelemetry-logs-traces'] to ['--disable-opentelemetry-logs'] for parameter disable_opentelemetry_logs of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter enable_opentelemetry_logs: updated property options from ['--enable-opentelemetry-logs'] to ['--enable-opentelemetry-logs-traces'] please change property options from ['--enable-opentelemetry-logs-traces'] to ['--enable-opentelemetry-logs'] for parameter enable_opentelemetry_logs of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter opentelemetry_logs_port: updated property options from ['--opentelemetry-logs-port'] to ['--opentelemetry-logs-traces-port-http'] please change property options from ['--opentelemetry-logs-traces-port-http'] to ['--opentelemetry-logs-port'] for parameter opentelemetry_logs_port of cmd aks update

❌ 1010 - ParaPropUpdate aks update cmd aks update update parameter opentelemetry_metrics_port: updated property options from ['--opentelemetry-metrics-port'] to ['--opentelemetry-metrics-port-http'] please change property options from ['--opentelemetry-metrics-port-http'] to ['--opentelemetry-metrics-port'] for parameter opentelemetry_metrics_port of cmd aks update

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter disable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter enable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_logs_port_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_logs_traces_port_grpc

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_metrics_port_deprecated

⚠️ 1006 - ParaAdd aks create cmd aks create added parameter opentelemetry_metrics_port_grpc

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter disable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter enable_opentelemetry_logs_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_logs_port_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_logs_traces_port_grpc

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_metrics_port_deprecated

⚠️ 1006 - ParaAdd aks update cmd aks update added parameter opentelemetry_metrics_port_grpc

yonzhan · 2026-07-06T23:09:04Z

AKS

FumingZhang · 2026-07-14T00:29:44Z

/azp run

azure-pipelines · 2026-07-14T00:29:57Z

Azure Pipelines: Successfully started running 2 pipeline(s).

FumingZhang · 2026-07-15T01:45:44Z

/azp run

azure-pipelines · 2026-07-15T01:45:57Z

Azure Pipelines: Successfully started running 2 pipeline(s).

FumingZhang · 2026-07-16T00:43:38Z

/azp run

azure-pipelines · 2026-07-16T00:43:51Z

Azure Pipelines: Successfully started running 2 pipeline(s).

…le flags with deprecated aliases Renames the OTLP CLI parameters on 'az aks create/update' to distinguish the HTTP/protobuf port and to align logs with logs-and-traces, keeping the old names working as deprecated aliases: - --opentelemetry-metrics-port -> --opentelemetry-metrics-port-http - --opentelemetry-logs-port -> --opentelemetry-logs-traces-port-http - --enable-opentelemetry-logs -> --enable-opentelemetry-logs-traces - --disable-opentelemetry-logs -> --disable-opentelemetry-logs-traces Each renamed option is registered as two arguments sharing one destination: the new name carries is_preview=True and the old name is a separate deprecated argument (deprecate_info). This avoids the knack crash from combining is_preview with an option-level c.deprecate (Deprecated has no __len__), and lets the new names show [Preview] while the old names show [Deprecated] and redirect. A validator merges any value supplied via a deprecated alias onto the current destination so downstream logic reads a single dest. Updates help text, validator/decorator error messages, and tests to the new names; migrates the live integration scenarios and fixes stale API field assertions (openTelemetryLogs.port -> openTelemetryLogsAndTraces.httpPort).

Adds --opentelemetry-metrics-port-grpc and --opentelemetry-logs-traces-port-grpc (preview) to 'az aks create/update', wiring the new grpc_port field on the appMonitoring OpenTelemetry profiles (API 2026-04-02-preview). - Validation: all four OTLP ports (metrics/logs x http/grpc) must be in 1..65535 and distinct; grpc ports follow the same enable/disable gating as the http ports. - Disable paths now clear both http_port and grpc_port, including when the parent Azure Monitor metrics/logs are disabled. - Adds unit, validator, and live integration coverage; bumps version to 21.0.0b8 and updates HISTORY.

… and metrics Adds --opentelemetry-*-port-grpc flags and grpcPort assertions to the live OpenTelemetry integration scenarios so gRPC is exercised symmetrically for both the metrics and logs/traces signals (previously only metrics-create asserted grpcPort). The comprehensive monitoring test also now asserts that disabling OpenTelemetry metrics/logs clears both httpPort and grpcPort.

…res header The AzureMonitorAppMonitoringPreview capability is gated by subscription feature registration, not by a per-request AKSHTTPCustomFeatures header. The resource provider now rejects that header with '(BadRequest) Parameter aksHTTPCustomFeatures is not allowed', causing every OpenTelemetry @live_only scenario to fail before reaching its assertions. Removes '--aks-custom-headers AKSHTTPCustomFeatures=Microsoft.ContainerService/AzureMonitorAppMonitoringPreview' from the six OpenTelemetry live tests. Verified live that create/update with the OTLP flags succeeds once the header is dropped (feature registered on the subscription). The recorded app-monitoring tests are left unchanged, as they replay a cassette that still contains the header.

FumingZhang · 2026-07-20T04:48:24Z

/azp run

azure-pipelines · 2026-07-20T04:48:37Z

Azure Pipelines: Successfully started running 2 pipeline(s).

FumingZhang · 2026-07-28T02:09:30Z

@ChFlick are you still working on this PR?

ChFlick · 2026-07-28T12:59:13Z

@FumingZhang yes I'm still working on this - I needed to wait for end-to-end testing to be available and I'm waiting for reviews from my team

The gate guarding ensure_azure_monitor_profile_prerequisites in update_azure_monitor_profile treated every OpenTelemetry parameter as metrics-related. Setting only an OTLP logs/traces port therefore ran the full Prometheus onboarding path, creating an Azure Monitor Workspace, DCE, DCR, DCRA, a Grafana link and recording rules. OpenTelemetry logs and traces ride the Container Insights pipeline and have no dependency on those artifacts, so restrict the gate to Azure Monitor metrics and OpenTelemetry metrics parameters only. Add five regression tests that assert on the prerequisites mock. The existing OpenTelemetry tests patch it purely to suppress network calls and never assert on it, which is why this went unnoticed. Three cover the logs/traces cases and two guard against over-correcting by verifying that metrics-only and mixed-signal commands still onboard exactly once.

Resolves the aks-preview version collision: main released 21.0.0b11 ("Vendor new SDK and bump API version to 2026-05-02-preview") while this branch was also using 21.0.0b11. Moved this branch's changelog entries to a new 21.0.0b12 section and bumped setup.py accordingly. Verified the newly vendored SDK still exposes http_port and grpc_port on ManagedClusterAzureMonitorProfileAppMonitoringOpenTelemetryMetrics and ...OpenTelemetryLogsAndTraces (serialized as httpPort/grpcPort), so the OpenTelemetry port work on this branch remains compatible.

a0x1ab · 2026-07-28T16:56:35Z

/azp run

azure-pipelines · 2026-07-28T16:56:50Z

Azure Pipelines: Successfully started running 2 pipeline(s).

azure-client-tools-bot-prd Bot added this to the August 2026 (2026-08-04) milestone Jul 6, 2026

microsoft-github-policy-service Bot requested review from FumingZhang, yanzhudd and yonzhan July 6, 2026 16:23

microsoft-github-policy-service Bot assigned yanzhudd Jul 6, 2026

microsoft-github-policy-service Bot added Auto-Assign Auto assign by bot AKS labels Jul 6, 2026

ChFlick force-pushed the cbutz/aks-preview-otlp-grpc branch from 12eb037 to 81f1913 Compare July 13, 2026 16:31

ChFlick force-pushed the cbutz/aks-preview-otlp-grpc branch from 008c692 to 626a2f2 Compare July 15, 2026 15:30

Christoph Butz added 5 commits July 17, 2026 11:54

[aks-preview] Exclude required OpenTelemetry option names from lint

5e5c6b1

ChFlick force-pushed the cbutz/aks-preview-otlp-grpc branch from 626a2f2 to 5e5c6b1 Compare July 17, 2026 10:57

Christoph Butz added 2 commits July 28, 2026 15:43

rule	cmd_name	rule_message	suggest_message
❌ 1010 - ParaPropUpdate	aks create	cmd `aks create` update parameter `disable_opentelemetry_logs`: updated property `options` from `['--disable-opentelemetry-logs']` to `['--disable-opentelemetry-logs-traces']`	please change property `options` from `['--disable-opentelemetry-logs-traces']` to `['--disable-opentelemetry-logs']` for parameter `disable_opentelemetry_logs` of cmd `aks create`
❌ 1010 - ParaPropUpdate	aks create	cmd `aks create` update parameter `enable_opentelemetry_logs`: updated property `options` from `['--enable-opentelemetry-logs']` to `['--enable-opentelemetry-logs-traces']`	please change property `options` from `['--enable-opentelemetry-logs-traces']` to `['--enable-opentelemetry-logs']` for parameter `enable_opentelemetry_logs` of cmd `aks create`
❌ 1010 - ParaPropUpdate	aks create	cmd `aks create` update parameter `opentelemetry_logs_port`: updated property `options` from `['--opentelemetry-logs-port']` to `['--opentelemetry-logs-traces-port-http']`	please change property `options` from `['--opentelemetry-logs-traces-port-http']` to `['--opentelemetry-logs-port']` for parameter `opentelemetry_logs_port` of cmd `aks create`
❌ 1010 - ParaPropUpdate	aks create	cmd `aks create` update parameter `opentelemetry_metrics_port`: updated property `options` from `['--opentelemetry-metrics-port']` to `['--opentelemetry-metrics-port-http']`	please change property `options` from `['--opentelemetry-metrics-port-http']` to `['--opentelemetry-metrics-port']` for parameter `opentelemetry_metrics_port` of cmd `aks create`
❌ 1010 - ParaPropUpdate	aks update	cmd `aks update` update parameter `disable_opentelemetry_logs`: updated property `options` from `['--disable-opentelemetry-logs']` to `['--disable-opentelemetry-logs-traces']`	please change property `options` from `['--disable-opentelemetry-logs-traces']` to `['--disable-opentelemetry-logs']` for parameter `disable_opentelemetry_logs` of cmd `aks update`
❌ 1010 - ParaPropUpdate	aks update	cmd `aks update` update parameter `enable_opentelemetry_logs`: updated property `options` from `['--enable-opentelemetry-logs']` to `['--enable-opentelemetry-logs-traces']`	please change property `options` from `['--enable-opentelemetry-logs-traces']` to `['--enable-opentelemetry-logs']` for parameter `enable_opentelemetry_logs` of cmd `aks update`
❌ 1010 - ParaPropUpdate	aks update	cmd `aks update` update parameter `opentelemetry_logs_port`: updated property `options` from `['--opentelemetry-logs-port']` to `['--opentelemetry-logs-traces-port-http']`	please change property `options` from `['--opentelemetry-logs-traces-port-http']` to `['--opentelemetry-logs-port']` for parameter `opentelemetry_logs_port` of cmd `aks update`
❌ 1010 - ParaPropUpdate	aks update	cmd `aks update` update parameter `opentelemetry_metrics_port`: updated property `options` from `['--opentelemetry-metrics-port']` to `['--opentelemetry-metrics-port-http']`	please change property `options` from `['--opentelemetry-metrics-port-http']` to `['--opentelemetry-metrics-port']` for parameter `opentelemetry_metrics_port` of cmd `aks update`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `disable_opentelemetry_logs_deprecated`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `enable_opentelemetry_logs_deprecated`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `opentelemetry_logs_port_deprecated`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `opentelemetry_logs_traces_port_grpc`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `opentelemetry_metrics_port_deprecated`
⚠️ 1006 - ParaAdd	aks create	cmd `aks create` added parameter `opentelemetry_metrics_port_grpc`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `disable_opentelemetry_logs_deprecated`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `enable_opentelemetry_logs_deprecated`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `opentelemetry_logs_port_deprecated`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `opentelemetry_logs_traces_port_grpc`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `opentelemetry_metrics_port_deprecated`
⚠️ 1006 - ParaAdd	aks update	cmd `aks update` added parameter `opentelemetry_metrics_port_grpc`

Uh oh!

Conversation

ChFlick commented Jul 6, 2026 • edited by azure-client-tools-agent Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🤖 PR Validation — ❌ Action needed

Related command

General Guidelines

About Extension Publish

Uh oh!

azure-client-tools-bot-prd Bot commented Jul 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

yonzhan commented Jul 6, 2026

Uh oh!

FumingZhang commented Jul 14, 2026

Uh oh!

azure-pipelines Bot commented Jul 14, 2026

Uh oh!

FumingZhang commented Jul 15, 2026

Uh oh!

azure-pipelines Bot commented Jul 15, 2026

Uh oh!

FumingZhang commented Jul 16, 2026

Uh oh!

azure-pipelines Bot commented Jul 16, 2026

Uh oh!

FumingZhang commented Jul 20, 2026

Uh oh!

azure-pipelines Bot commented Jul 20, 2026

Uh oh!

FumingZhang commented Jul 28, 2026

Uh oh!

ChFlick commented Jul 28, 2026

Uh oh!

a0x1ab commented Jul 28, 2026

Uh oh!

azure-pipelines Bot commented Jul 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

ChFlick commented Jul 6, 2026 •

edited by azure-client-tools-agent Bot

Loading

azure-client-tools-bot-prd Bot commented Jul 6, 2026 •

edited

Loading