Skip to main content

Data Kennel is a CLI tool for managing Datadog infrastructure.

Project description

data_kennel

Codacy Badge https://travis-ci.org/amplify-education/data_kennel.svg?branch=master https://camo.githubusercontent.com/890acbdcb87868b382af9a4b1fac507b9659d9bf/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667 https://badge.fury.io/py/data-kennel.svg

Data Kennel is a CLI tool for managing Datadog infrastructure.

About Amplify

Amplify builds innovative and compelling digital educational products that empower teachers and students across the country. We have a long history as the leading innovator in K-12 education - and have been described as the best tech company in education and the best education company in tech. While others try to shrink the learning experience into the technology, we use technology to expand what is possible in real classrooms with real students and teachers.

Learn more at https://www.amplify.com

Getting Started

Prerequisites

Data Kennel requires the following software to be installed: * python >= 2.7

For development: * rake >= 1.9.2

Installing/Building

Data Kennel can be installed from pip.

pip install data_kennel

For local development, Data Kennel also includes a setup script in the form of a rake task.

rake setup:develop

Credentials

Data Kennel expects your Datadog API and APP keys to be available as environment variables, as DATADOG_API_KEY and DATA_KENNEL_APP_KEY. Here is an example:

# Data Kennel Envvars
export DATADOG_API_KEY="change_me"
export DATA_KENNEL_APP_KEY="change_me"

You can create API and APP keys in the Datadog console.

Running Tests

Data Kennel has lint checks and unit tests for use when developing. Simply run the rake task.

rake test

Supported Operations

Monitor Management

Data Kennel currently supports listing, syncing, and deleting simple and composite monitors. Composite monitors are monitors that are composed of several other monitors. This is achieved through the dk_monitor command. dk_monitor has the following options available: * list * update * delete

See dk_monitor -h for more information and data_kennel.yml.example for an example of the configuration file.

Roadmap

  • Add support for OR boolean operator in composite monitors.

  • Add support for managing Datadog dashboards.

  • Add support for managing Datadog downtimes.

  • Add support for sending arbitrary Datadog events.

  • Add support for queryng arbitrary Datadog metrics.

Responsible Disclosure

If you have any security issue to report, contact project maintainers privately. You can reach us at github@amplify.com

Contributing

We welcome pull requests! For your pull request to be accepted smoothly, we suggest that you: 1. For any sizable change, first open a GitHub issue to discuss your idea. 2. Create a pull request. Explain why you want to make the change and what it’s for. We’ll try to answer any PRs promptly.

Project details


Download files

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

Source Distribution

data_kennel-1.0.3.tar.gz (13.8 kB view hashes)

Uploaded Source

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