Skip to main content

The Datadog Check Toolkit

Project description

Datadog Checks Base

Latest PyPI version Supported Python versions Documentation Status

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 API docs for details.

Installation

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

pip install datadog-checks-base

Development

Create a dedicated virtualenv and follow the instructions in this paragraph to work with the check.

To install the check in dev mode:

pip install -e .[dev]

To build the wheel package:

python setup.py bdist_wheel

To run the tests, install tox and just run:

tox

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

datadog_checks_base-10.0.1-py2.py3-none-any.whl (140.7 kB view hashes)

Uploaded Python 2 Python 3

Supported by

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