datadog-checks-base

What it is and what it does

Datadog Checks Base is the toolkit that powers Datadog Agent integrations. It provides the base classes and utilities that checks use to collect metrics and send them to Datadog. The package serves two main purposes: when running inside the Datadog Agent's embedded Python interpreter, it supplies the full integration framework; when installed in a standalone Python environment, it mocks the Agent so checks can be tested and developed locally without a running Agent.

The package is designed for lean resource usage through lazy-loading and selective imports, balancing a simple API with minimal memory overhead. It is actively maintained and used by integrations-core, making it the standard foundation for anyone building or testing Datadog Agent checks.

Use it for:

• Develop and test custom Datadog Agent checks locally before deploying to production
• Build new integrations that collect metrics from applications or infrastructure
• Run integration tests for checks in CI/CD pipelines without a full Agent setup
• Mock Agent behavior in a standalone Python environment for check validation

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides the Python base classes and utilities that Datadog Agent integrations need to run, and mocks an Agent environment for standalone testing and development.

Yes. This is the official toolkit for Datadog Agent integration development, actively maintained with no known vulnerabilities, permissive licensing, and zero runtime dependencies. Install it if you are building, testing, or maintaining Datadog checks.

Install

datadog-checks-base on PyPI

pip install datadog-checks-base

uv add datadog-checks-base

poetry add datadog-checks-base

Installing datadog-checks-base

Before you install

Low friction install with no runtime dependencies. Actively maintained with a release 8 days ago.

License in practice

BSD-3-Clause is permissive and imposes minimal restrictions on use or redistribution.

Quickstart

pip install datadog-checks-base

Verify before relying

• Whether the package works with Python versions older than 3.13 despite no explicit requires_python constraint
• What lazy-loader and selective import strategies add to the actual install footprint
• How to instantiate and use the base classes in a standalone environment

Package facts

Evidence: datadog_checks_base-38.0.0-py2.py3-none-any.whl

Keywords: agent, checks, datadog

Tags

More Monitoring packages