Update Otel Deps

Update OpenTelemetry collector dependencies in datadog-agent.

Arguments: $ARGUMENTS — optional <target-version> (e.g. v0.125.0). Note: inv collector.update always upgrades to the latest published OTel version; if a specific version is requested, a manual search-and-replace is needed instead (see Manual Step 1).

Step 0 — Check the automated workflow first

A scheduled GitHub Actions workflow (.github/workflows/collector-generate-and-update.yml) runs every other Wednesday and automatically opens a draft PR with the OTel update. Always check this before doing anything manually.

0a — Find the most recent run

unset GITHUB_TOKEN
gh run list --workflow=collector-generate-and-update.yml --branch=main --limit=5 \
  --json databaseId,status,conclusion,createdAt,event,displayTitle

If the latest run succeeded: find and review the auto-generated draft PR (Step 0c), then use /dd:ci:fix to fix any remaining CI failures and undraft.

If the latest run failed: go to Step 0b to diagnose and fix before falling back to a manual update.

If no run has ever succeeded or the workflow looks consistently broken: check #opentelemetry-agent and then fall back to Manual Step 1.

0b — Diagnose a workflow failure

Check #otel-agent-ops for the failure notification posted by the workflow; it includes a direct link to the failed run. Then fetch the logs:

RUN_ID=<id from step 0a>
unset GITHUB_TOKEN
gh run view $RUN_ID --log-failed 2>&1 | grep -E "error|Error|failed|exit code|XDG|bazel|OCB" | head -40

Common workflow failures and fixes:

After fixing the workflow, commit to main and re-trigger:

unset GITHUB_TOKEN
gh workflow run collector-generate-and-update.yml --ref main
gh run watch

If the workflow infrastructure succeeds but the resulting changes break CI (golden file mismatches, OCB build errors, etc.), that means the OTel version bump itself needs manual fixes. Proceed to Manual Step 2 using the auto-generated PR's branch as your working branch — don't start a new branch from scratch.

0c — Find and review the auto-generated PR

unset GITHUB_TOKEN
gh pr list --search "Update OTel Collector dependencies" --state open \
  --json number,title,url,headRefName

Review the diff, run /dd:ci:fix to fix CI failures, then undraft and request review once CI is green.

If a specific target version was requested that differs from what the workflow produced, fall back to Manual Step 1.

Manual Step 1 — Run the update

Use this only when: the automated workflow has a persistent infrastructure failure that can't be fixed quickly, or a specific target version (not latest) is requested.

dda inv collector.update   # bumps go.mod + OCB YAML files to latest OTel version
dda inv collector.generate # regenerates OTel Agent code from the new manifests
dda inv components.lint-components --fix
dda inv tidy               # reconcile transitive dependencies
dda inv modules.add-all-replace  # must run AFTER tidy (see note below)
bazel run //:go_mod_tidy_all
dda inv generate-licenses  # update license inventory

Run modules.add-all-replace after tidy, not before. collector.generate rewrites comp/otelcol/collector-contrib/impl/go.mod with short-form replace paths (=> ../../../logs-library) where the repo standard is the canonical form (=> ../../../../comp/logs-library). Running add-all-replace before tidy leaves the short form in place and check_modules_replace fails in CI. Verify it converged by re-running it and confirming no go.mod changes.

read_old_version trusts the OCB manifest, which can be stale. collector.update search-replaces the version recorded in comp/otelcol/collector-contrib/impl/manifest.yaml. If someone bumped the Go deps directly without running collector.update (as #53984 did), the manifest lags and every file referencing the actual previous version is silently skipped. Always compare the manifest version against a real dependency before trusting the bump: grep 'otelcol v' go.mod.

If a specific version was requested, skip inv collector.update and do a repo-wide search-and-replace of the old version string (find it in tasks/collector.py — the OCB_VERSION / OTEL_CONTRIB_VERSION constants). Then run the remaining commands above.

After the commands finish, scan for any files the task missed:

git diff HEAD --stat
OLD=$(git diff HEAD -- tasks/collector.py | grep '^-OCB_VERSION' | grep -oP '"[\d.]+"' | tr -d '"')
rg "$OLD" -g "*.go" -g "*.yml" -g "*.yaml" -g "*.mod" -g "*.sum" -l

Manually update any remaining files that still reference the old version.

Manual Step 2 — Fix ddflareextension runtime config test failures

This is the most common failure. The DD flare extension tests compare OTel runtime config output against golden files. Any upstream config field change breaks them.

Run the test locally to get the actual diff:

dda inv test --targets=./comp/otelcol/ddflareextension/impl/... --build-include=test,otlp -- -run TestGetConfDump

The test tag is required. --build-include replaces the default build-tag set rather than adding to it. With only otlp, the files gated behind //go:build test (configstore_test.go, extension_test.go, factory_test.go) never compile, so -run TestGetConfDump matches nothing — the run still reports "ALL TESTS PASSED" from the handful of untagged tests. Confirm the test really ran by checking test_output.json for "Test":"TestGetConfDump".

The failure output shows exactly which lines differ. Apply the diffs to the golden files in:

• comp/otelcol/ddflareextension/impl/testdata/ (unit test golden files)
• test/new-e2e/tests/otel/otel-agent/testdata/ (E2E test golden files — apply the same changes)

The E2E testdata mirrors the unit testdata for runtime config fields. Keep them in sync.

Manual Step 3 — Fix OCB build test failures

The CI job datadog_otel_components_ocb_build verifies OTel modules can be built with OCB (OTel Collector Builder). Run it locally:

test/otel/testdata/ocb_build_script.sh
# or find the CI definition:
rg "ocb_build" .gitlab/ -g "*.yml" -l

Check logs under /tmp/otel-ci/ for the exact error.

Common causes and fixes: