rust
/
dipstick
mirror of https://github.com/fralalonde/dipstick
1
0
Fork 0
Code Issues Releases Wiki Activity

(cargo-release) start next development iteration 0.4.15-alpha.0

This commit is contained in:
Francis Lalonde 2017-12-07 16:23:47 -05:00
parent 1475731c58
commit caa7ab7f07
5 changed files with 53 additions and 32 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
Cargo.lock generated
View File

@ -2,7 +2,7 @@
name = "aggregate_print"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -34,14 +34,14 @@ dependencies = [
name = "counter_timer_gauge"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
name = "custom_publish"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -56,7 +56,7 @@ dependencies = [
[[package]]
name = "dipstick"
version = "0.4.14-alpha.0"
version = "0.4.15-alpha.0"
dependencies = [
"derivative 1.0.0 (registry+https://github.com/rust-lang/crates.io-index)",
"lazy_static 0.2.11 (registry+https://github.com/rust-lang/crates.io-index)",
@ -84,7 +84,7 @@ name = "graphite"
version = "0.0.0"
dependencies = [
"badlog 1.0.0 (registry+https://github.com/rust-lang/crates.io-index)",
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -131,7 +131,7 @@ dependencies = [
name = "multi_print"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -170,7 +170,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
name = "queued"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -182,7 +182,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
name = "raw_sink"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
]
[[package]]
@ -211,7 +211,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
name = "static_metrics"
version = "0.0.0"
dependencies = [
"dipstick 0.4.14-alpha.0",
"dipstick 0.4.15-alpha.0",
"lazy_static 0.2.11 (registry+https://github.com/rust-lang/crates.io-index)",
]

4
Cargo.toml
View File

@ -13,7 +13,7 @@ members = [
[package]
name = "dipstick"
version = "0.4.14"
version = "0.4.15-alpha.0"
authors = ["Francis Lalonde <fralalonde@gmail.com>"]
description = """A fast and modular metrics library decoupling app instrumentation from reporting backend.
@ -24,7 +24,7 @@ documentation = "https://docs.rs/dipstick"
homepage = "https://github.com/fralalonde/dipstick"
repository = "https://github.com/fralalonde/dipstick"
readme = "README.md"
keywords = ["metrics", "statsd", "timer", "counter", "monitoring"]
keywords = ["metrics", "statsd", "graphite", "timer", "monitoring"]
license = "MIT/Apache-2.0"
[badges]

31
README.md
View File

@ -1,19 +1,30 @@
# dipstick
[![Cargo](https://img.shields.io/crates/v/dipstick.svg)](https://crates.io/crates/dipstick)
[![Docs.rs](https://docs.rs/dipstick/badge.svg)](https://docs.rs/dipstick)
A fast and modular metrics toolkit for all Rust applications.
Similar to popular logging frameworks, but with counters, markers, gauges and timers.
Out of the box, Dipstick _can_ aggregate, sample, cache and queue metrics (async).
If aggregated, statistics can be published on demand or on schedule.
Dipstick does not bind application code to a single metrics output implementation.
Outputs `to_log`, `to_stdout`, `to_graphite` and `to_statsd` are currently provided.
Dipstick is a modular metrics toolkit for Rust applications.
It is similar to popular logging frameworks, but with counters, markers, gauges and timers.
Dipstick builds on stable Rust with minimal dependencies.
Dipstick is available on [crates.io](https://crates.io/crates/dipstick).
## Features
- Send metrics to stdout, log, statsd or graphite (one or many)
- Synchronous, asynchronous or mixed operation
- Optional fast random statistical sampling
- Immediate propagation or local aggregation of metrics (count, sum, average, min/max)
- Periodic or programmatic publication of aggregated metrics
- Customizable output statistics and formatting
- Global or scoped (e.g. per request) metrics
- Per-application and per-output metric namespaces
- Predefined or ad-hoc metrics
## Cookbook
Dipstick is easy to add to your code:
```rust
use dipstick::*;
let app_metrics = metrics(to_log("metrics:"));
let app_metrics = metrics(to_graphite("host.com:2003"));
app_metrics.counter("my_counter").count(3);
```

2
README.tpl
View File

@ -1,4 +1,6 @@
# {{crate}}
[![Cargo](https://img.shields.io/crates/v/dipstick.svg)](https://crates.io/crates/dipstick)
[![Docs.rs](https://docs.rs/dipstick/badge.svg)](https://docs.rs/dipstick)
{{readme}}

30
src/lib.rs
View File

@ -1,19 +1,27 @@
/*!
A fast and modular metrics toolkit for all Rust applications.
Similar to popular logging frameworks, but with counters, markers, gauges and timers.
Out of the box, Dipstick _can_ aggregate, sample, cache and queue metrics (async).
If aggregated, statistics can be published on demand or on schedule.
Dipstick does not bind application code to a single metrics output implementation.
Outputs `to_log`, `to_stdout` and `to_statsd` are currently provided,
and defining new modules is easy.
Dipstick is a modular metrics toolkit for Rust applications.
It is similar to popular logging frameworks, but with counters, markers, gauges and timers.
Dipstick builds on stable Rust with minimal dependencies.
Dipstick is available on [crates.io](https://crates.io/crates/dipstick).
# Features
- Send metrics to stdout, log, statsd or graphite (one or many)
- Synchronous, asynchronous or mixed operation
- Optional fast random statistical sampling
- Immediate propagation or local aggregation of metrics (count, sum, average, min/max)
- Periodic or programmatic publication of aggregated metrics
- Customizable output statistics and formatting
- Global or scoped (e.g. per request) metrics
- Per-application and per-output metric namespaces
- Predefined or ad-hoc metrics
# Cookbook
Dipstick is easy to add to your code:
```rust
use dipstick::*;
let app_metrics = metrics(to_log("metrics:"));
let app_metrics = metrics(to_graphite("host.com:2003"));
app_metrics.counter("my_counter").count(3);
```