Add HTTPXWrapper behind use_httpx flag

[mwdd146980]

What does this PR do?

Adds a minimum-viable HTTPXWrapper that implements the existing HTTPClientProtocol so checks can opt into an httpx-backed HTTP client via use_httpx: true in instance config. RequestsWrapper remains the default for every check that does not opt in.

Wires the selector into AgentCheck.http. Adds a parallel test suite for the wrapper. Opts kong and kuma in as the first integrations to use the new wrapper. Extends mock_http_response to also patch httpx.Client.request so existing test fixtures intercept both code paths transparently.

Motivation

This PR is part of a larger migration of datadog_checks_base's HTTP layer from requests to httpx. It ships only the minimum needed to prove the wrapper-swap mechanism works end-to-end through a real integration. It does NOT aim for RequestsWrapper feature parity. The full surface (auth tokens, proxies, UDS, Kerberos / NTLM / AWS / Digest auth, connection-pool tuning, HTTP/2, multipart uploads) is deferred to follow-up PRs.

Approach

MVP feature surface in datadog_checks_base/datadog_checks/base/utils/http_httpx.py:

• 7 HTTP methods: get, post, put, delete, head, patch, options_method
• Response surface via HTTPXResponseAdapter: .content, .text, .headers, .status_code, .json(), .raise_for_status(), .close(), .iter_lines(), .iter_content(), .encoding, .url, .cookies, .elapsed
• Standard request options: headers, params, json, data, timeout, verify, cert, allow_redirects
• Basic auth via username/password
• TLS verify, CA bundle, client cert
• Exception mapping from httpx.* into http_exceptions.* so existing widened catches keep working
• Single shared httpx.Client per check instance (matches RequestsWrapper's session sharing)
• Import-time ImportError if httpx is not installed (no soft-import branching)

AgentCheck.http selects between HTTPXWrapper and RequestsWrapper on is_affirmative(instance.get('use_httpx', False)). Default behavior is unchanged for every integration that does not opt in.

Verification

• Parallel unit test suite at datadog_checks_base/tests/base/utils/http_httpx/ (51 tests, all green) covering methods, config, basic auth, TLS, exception mapping, response surface, and lifecycle.
• kong and kuma test suites both pass with use_httpx: true set in their instance fixtures, exercising the OM v2 scraper path end-to-end through HTTPXWrapper.
• Confirmed via direct construction that KumaCheck(... use_httpx=True).http returns an HTTPXWrapper instance.

Review checklist (to be filled by reviewers)

• Feature or bugfix MUST have appropriate tests (unit, integration, e2e)
• Add qa/required if this PR needs QA validation, or qa/skip-qa if it does not. Exactly one of the two is required.
• If you need to backport this PR to another branch, you can add the backport/<branch-name> label to the PR and it will automatically open a backport PR once this one is merged

[datadog-prod-us1-4]

 

✨ Fix all issues with BitsAI

⚠️ Warnings

🚦 8 Pipeline jobs failed

PR All | test / j1e84c35 / Couchbase     

🔧 Fix in code (Fix with Cursor).

1 failed test: AssertionError: Needed at least 1 candidates for 'couchbase.index.avg_drain_rate', got 0 in tests/test_integration.py:128

PR All | test / jcc7e1d2 / Nutanix     

🔧 Fix in code (Fix with Cursor).

Undefined name 'mock_resp' and 'mocker' in tests/conftest.py with multiple linting errors found.

PR All | test / j5a9585a / IBM ACE     

🔄 Retry job. This looks flaky and may succeed on retry.

Job execution exceeded the timeout limit of 60 minutes during 'Prepare for testing'.

View all 8 failed jobs.

🧪 20 Tests failed in 1 job

PR All | run  

test_e2e_cisco_legacy_wlc from test_e2e_core.py   (Fix with Cursor)

Needed at least 1 candidates for 'snmp.device.reachable', got 0
Expected:
        MetricStub(name='snmp.device.reachable', type=0, value=1, tags=['agent_host:runnervmyxb0g', 'device_hostname:DDOGWLC', 'device_id:default:172.18.0.2', 'device_ip:172.18.0.2', 'device_namespace:default', 'device_vendor:cisco', 'snmp_device:172.18.0.2', 'snmp_host:DDOGWLC', 'snmp_profile:cisco-legacy-wlc'], hostname=None, device=None, flush_first_value=None)
Difference to closest:
        Expected tag agent_host:runnervmyxb0g
        Found agent_host:None
        Expected tag device_hostname:DDOGWLC
        Found device_hostname:None
        Expected tag device_id:default:172.18.0.2
        Found device_id:None
...

test_e2e_cisco_nexus from test_e2e_core.py   (Fix with Cursor)

Needed at least 1 candidates for 'snmp.device.reachable', got 0
Expected:
        MetricStub(name='snmp.device.reachable', type=0, value=1, tags=['agent_host:runnervmyxb0g', 'device_hostname:Nexus-eu1.companyname.managed', 'device_id:default:172.18.0.2', 'device_ip:172.18.0.2', 'device_namespace:default', 'device_vendor:cisco', 'snmp_device:172.18.0.2', 'snmp_host:Nexus-eu1.companyname.managed', 'snmp_profile:cisco-nexus'], hostname=None, device=None, flush_first_value=None)
Difference to closest:
        Expected tag agent_host:runnervmyxb0g
        Found agent_host:None
        Expected tag device_hostname:Nexus-eu1.companyname.managed
        Found device_hostname:None
        Expected tag device_id:default:172.18.0.2
        Found device_id:None
...

View all 20 test failures

ℹ️ Info

No other issues found (see more)

❄️ No new flaky tests detected

Useful? React with 👍 / 👎

_{This comment will be updated automatically if new data arrives.
🔗 Commit SHA: ade5123 | Docs | Datadog PR Page | Give us feedback!}

[codecov]

Codecov Report

❌ Patch coverage is 92.17134% with 53 lines in your changes missing coverage. Please review.
✅ Project coverage is 91.12%. Comparing base (dc5a6d5) to head (0d65e5a).

Additional details and impacted files

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[dd-octo-sts]

Validation Report

Validation	Description	Status
dep	Verify dependency pins are consistent and Agent-compatible	❌

Run ddev validate all changed --fix to attempt to auto-fix supported validations.

Passed validations (20)

Validation	Description	Status
agent-reqs	Verify check versions match the Agent requirements file	✅
ci	Validate CI configuration and Codecov settings	✅
codeowners	Validate every integration has a CODEOWNERS entry	✅
config	Validate default configuration files against spec.yaml	✅
http	Validate integrations use the HTTP wrapper correctly	✅
imports	Validate check imports do not use deprecated modules	✅
integration-style	Validate check code style conventions	✅
jmx-metrics	Validate JMX metrics definition files and config	✅
labeler	Validate PR labeler config matches integration directories	✅
legacy-signature	Validate no integration uses the legacy Agent check signature	✅
license-headers	Validate Python files have proper license headers	✅
licenses	Validate third-party license attribution list	✅
metadata	Validate metadata.csv metric definitions	✅
models	Validate configuration data models match spec.yaml	✅
openmetrics	Validate OpenMetrics integrations disable the metric limit	✅
package	Validate Python package metadata and naming	✅
qa-label	Validate the pull request declares whether it needs QA for the next Agent release	✅
readmes	Validate README files have required sections	✅
saved-views	Validate saved view JSON file structure and fields	✅
version	Validate version consistency between package and changelog	✅

View full run