https://github.com/brettlangdon/caddydogstatsd

Datadog dogstatsd middleware plugin for Caddy.
https://github.com/brettlangdon/caddydogstatsd

Last synced: about 1 month ago
JSON representation

Datadog dogstatsd middleware plugin for Caddy.

• Host: GitHub
• URL: https://github.com/brettlangdon/caddydogstatsd
• Owner: brettlangdon
• Created: 2016-08-16T15:06:00.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-07-14T00:35:28.000Z (over 5 years ago)
• Last Synced: 2024-04-16T15:15:26.345Z (8 months ago)
• Language: Go
• Size: 15.6 KB
• Stars: 2
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
caddy dogstatsd

===============

A [Caddy](https://caddyserver.com/) middleware plugin for reporting metrics to [Datadog](https://datadoghq.com).

## Installation

**Coming soon**

## Configuration

```

dogstatsd [{host:port} [samplerate]]

```

```

dogstatsd {

  host {host:port}

  samplerate {samplerate}

  namespace {namespace}

  tags {name:value} [{name:value}...]

}

```

### Configuration options

- `host` - the `host:port` where `dogstatsd` metrics should be sent - default: `127.0.0.1:8125`

- `samplerate` - a `float` indicating the sample rate of requests to record metrics for

  - For example, a `samplerate` of `0.5` means metrics will be emitted for only half of the requests

- `namespace` - an optional namespace to prepend to each metric emitted - by default there is none

  - For example, a `namespace` of `my_app` will yield `my_app.caddy.response.time` as a metric

- `tags` - an optional list of global tags to set for this server - by default there are none

  - Example tags, `env:production`, `app:my_app`

### Example config

```

dogstatsd {

  samplerate 0.75

  namespace my_app

  tags env:production service:caddy

}

```

## Metrics

- `[namespace.]caddy.response.count` - counter - number of requests handled

- `[namespace.]caddy.response.time` - histogram - milliseconds spent handling request