# Doggy

Doggy manages your DataDog dashboards, alerts, monitors, and screenboards.

## Installation

Add this line to your Gemfile:

```ruby
gem 'doggy'
```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install doggy

## Authentication

To authenticate, you need to set API and APP keys for your DataDog account.

#### Environment variables

Export `DATADOG_API_KEY` and `DATADOG_APP_KEY` environment variables and `doggy` will catch them up automatically.

#### ejson

Set up `ejson` by putting `secrets.ejson` in your root object store.

#### json (plaintext)

If you're feeling adventurous, just put plaintext `secrets.json` in your root object store like this:

```json
{
  "datadog_api_key": "key1",
  "datadog_app_key": "key2"
}
```

## Usage

```bash
# Download selected items from DataDog
$ doggy pull ID ID

# Download all items
$ doggy pull

# Upload selected items to DataDog
$ doggy push ID ID ID

# Upload all items to DataDog
$ doggy push

# Edit a dashboard in WYSIWYG
$ doggy edit ID

# Delete selected items from both DataDog and local storage
$ doggy delete ID ID ID

# Mute monitor(s) forever
$ doggy mute ID ID ID

# Unmute monitor(s)
$ doggy unmute ID ID ID
```

## Example object definition

#### Ruby DSL

A DataDog object will be populated from `obj()` hash as shown below.

```ruby
created_at = Time.parse('2015-01-01 14:00:01').to_i * 1000

query = "sum(last_1m):sum:Engine.current_thrust.status{status:error}.as_count() < 50"

obj({
  created_at: created_at,
  id: 100500,
  message: "Houston, we have a problem @pagerduty-Houston",
  name: "Engine thrust",
  query: query,
  type: "query alert"
})
```

For more examples, check the `examples` directory.

## Development

After checking out the repo, run `bundle install` to install dependencies.

To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).

## Contributing

1. Fork it ( https://github.com/bai/doggy/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request