Bosun Emitter

Bosun Emitter 是一个命令行工具和 Rust 库，用于向 Bosun 发送指标数据。

概述

Bosun 是 Stack Exchange 开源、MIT 许可的监控和警报系统。它具有用于评估警报和创建详细通知的易于理解的领域特定语言。它还允许您通过历史数据测试警报，以实现更快的开发体验。 ^[1]

Bosun 主要通过 scollector 收集指标数据，scollector 是在每台监控主机上运行的 Boson 代理。scollector 定期运行内置和外部收集器以收集和传输其主机的指标。

虽然创建适合大多数需求的外部收集器很容易，但在某些情况下，发送单个单个指标数据可能很有用。这种情况可能包括任何单独运行的程序，如用于备份的 Cron 作业或任何其他 shell 脚本。此外，从您自己的应用程序发送指标数据可能也很有用。

bosun_emitter 是一个库，它使得发送指标数据和描述指标的相关元数据变得容易。此外，这个包包含一个名为 emit_bosun 的 CLI 独立二进制文件，可以从命令行或任何 shell 脚本中用来发送单个指标数据。

库

请参阅 Rustdoc 了解最新构建的文档。您也可以在 crates.io 和 Cargo 中找到 crate。

命令行工具

帮助

Emit a Bosun

USAGE:
    emit_bosun [FLAGS] [OPTIONS]

FLAGS:
    -h, --help           Prints help information
        --show-config    Prints config
    -V, --version        Prints version information
        --verbose        Enables verbose output

OPTIONS:
    -c, --config <FILE>                         Sets a custom config file
    -d, --description <DESCRIPTION>             Sets metric description
        --host <HOST:PORT>                      Sets Bosun server connection parameters; may include basic auth and https
        --hostname <HOSTNAME>                   Sets hostname
    -m, --metric <METRIC NAME>                  Sets metric name
    -r, --rate <RATE>                           Sets rate type [values: gauge, counter, rate]
    -t, --tags <KEY1=VALUE1,KEY2=VALUE2,...>    Sets tags
    -u, --unit <UNIT>                           Sets metric value unit
    -v, --value <VALUE>                         Sets metric value

Two modes are supported, i.e., sending a datum with meta data or sending only
meta data.  The modes are controlled whether a value `--value` is passed or
not. Please mind that in both cases the meta data is required.

示例

emit_bosun -c examples/scollector.toml --host https://user:password@localhost:8070 --tags 'key1=value1,key2=value2' \
  --metric lukas.test --value 10 \
  --rate gauge --unit Tests -d "Amount of Lukas Tests" \
  --verbose

版本

源代码

您可以在 GitHub 发布页面 上找到每个版本的源代码。

二进制文件

Travi CI 为每个发布版本创建 emit_bosun 的 Ubuntu Trusty 软件包。请参阅 仓库 了解详情。

Cargo

Rust 包的发布可以在 Crates.io 上找到。

贡献

我很乐意接受建议和拉取请求。