Skip to main content

The Datadog Check Toolkit

Project description

Datadog Checks Base

Latest PyPI version Supported Python versions

Overview

This package provides the Python bits needed by the Datadog Agent to run Agent-based Integrations (also known as Checks).

This package is used in two scenarios:

  1. When used from within the Python interpreter embedded in the Agent, it provides all the base classes and utilities needed by any Check.

  2. When installed in a local environment with a regular Python interpreter, it mocks the presence of a running Agent so checks can work in standalone mode, mostly useful for testing and development.

Please refer to the docs for details.

Installation

Checks from integrations-core already use the toolkit in a transparent way when you run the tests but you can install the toolkit locally and play with it:

pip install datadog-checks-base

Performance Optimizations

We strive to balance lean resource usage with a "batteries included" user experience. We employ a few tricks to achieve this.

One of them is the lazy-loader library that allows us to expose a nice API (simple, short imports) without the baseline memory overhead of importing everything all the time.

Another trick is to import some of our dependencies inside functions that use them instead of the more conventional import section at the top of the file. We rely on this the most in the AgentCheck base class.

Troubleshooting

Need help? Contact Datadog support.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

datadog_checks_base-37.30.0-py2.py3-none-any.whl (280.3 kB view details)

Uploaded Python 2Python 3

File details

Details for the file datadog_checks_base-37.30.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for datadog_checks_base-37.30.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 dc49a0e32c5f5757d6706fed6ccc13197861f4775d2982e227e7ae4e93e7c6c9
MD5 cc7d2152faa3a963176f9694a1c0fa84
BLAKE2b-256 0da041b952b2e0aa6bf03ef5f1b8f8f9dbe107d81ed32c0f87f268e73be78762

See more details on using hashes here.

Provenance

The following attestation bundles were made for datadog_checks_base-37.30.0-py2.py3-none-any.whl:

Publisher: release-base.yml on DataDog/integrations-core

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page