moni
v0.2.2
https://monibot.io のコマンド ライン ツール - 簡単なサーバーとアプリケーションの監視。
Moni は、Monibot REST API と対話するためのコマンドライン ツールです。慣れています
Monibot からウォッチドッグをクエリする
ウォッチドッグのハートビートを Monibot に送信する
Monibot からマシンにクエリを実行する
マシンリソース使用量サンプル (CPU/メモリ/ディスク/クロック/ネットワーク) を Monibot に送信
マシンテキスト (コマンド出力) を Monibot に送信します。
Monibot からのクエリメトリクス
メトリクス値をMonibotに送信する
Linux/amd64 で実行され、Go で書かれています。https://go.dev/ を参照してください。
ここからビルド済みの linux/amd64 バイナリをダウンロードします: https://github.com/cvilsmeier/moni/releases/latest
事前に構築されたバイナリをダウンロードしたくない場合は、コマンド ラインから moni をインストールできます。
$ go install github.com/cvilsmeier/moni@latest
事前にビルドされたバイナリをダウンロードしたくない場合は、コマンド ラインから moni をビルドできます。
$ git clone https://github.com/cvilsmeier/moni $ cd moni/ $ CGO_ENABLED=0 go build $ ./moni help
$ moni help
Moni - A command line tool for https://monibot.io
Usage
moni [flags] command
Flags
-url
Monibot URL, default is "https://monibot.io".
You can set this also via environment variable MONIBOT_URL.
-apiKey
Monibot API Key, default is "".
You can set this also via environment variable MONIBOT_API_KEY
(recommended). You can find your API Key in your profile on
https://monibot.io.
Note: For security, we recommend that you specify the API Key
via MONIBOT_API_KEY, and not via -apiKey flag. The flag will show
up in 'ps aux' outputs and can be eavesdropped.
-trials
Max. Send trials, default is 12.
You can set this also via environment variable MONIBOT_TRIALS.
-delay
Delay between trials, default is 5s.
You can set this also via environment variable MONIBOT_DELAY.
-v
Verbose output, default is false.
You can set this also via environment variable MONIBOT_VERBOSE
('true' or 'false').
Commands
ping
Ping the Monibot API. If an error occurs, moni will print
that error. It it succeeds, moni will print nothing.
watchdogs
List heartbeat watchdogs.
watchdog <watchdogId>
Get heartbeat watchdog by id.
heartbeat <watchdogId> [interval]
Send a heartbeat. If interval is not specified, moni sends
one heartbeat and exits. If interval is specified, moni
will stay in the background and send heartbeats in that
interval. Min. interval is 5m.
machines
List machines.
machine <machineId>
Get machine by id.
sample <machineId> <interval>
Send resource usage (load/cpu/mem/disk) samples for machine.
Moni consults various files (/proc/loadavg, /proc/cpuinfo,
etc.) and commands (/usr/bin/free, /usr/bin/df, etc.) to
calculate resource usage. Therefore it currently supports
linux only. Moni will stay in background and keep sampling
in specified interval. Min. interval is 5m.
text <machineId> <filename>
Send filename as text for machine.
Filename can contain arbitrary text, e.g. arbitrary command
outputs. It's used for information only, no logic is
associated with texts. Moni will send the file as text and
then exit. If an error occurs, moni will print an error
message. Otherwise moni will print nothing.
Max. filesize is 204800 bytes.
metrics
List metrics.
metric <metricId>
Get and print metric info.
inc <metricId> <value>
Increment a counter metric.
Value must be a non-negative 64-bit integer value.
set <metricId> <value>
Set a gauge metric value.
Value must be a non-negative 64-bit integer value.
values <metricId> <values>
Send histogram metric values.
Values is a comma-separated list of 'value:count' pairs.
Each value is a non-negative 64-bit integer value, each
count is an integer value greater or equal to 1.
If count is 1, the ':count' part is optional, so
values '13:1,14:1' and '13,14' are sematically equal.
A specific value may occur multiple times, its counts will
then be added together, so values '13:2,13:2' and '13:4'
are sematically equal.
config
Show config values.
version
Show moni program version.
sdk-version
Show the monibot-go SDK version moni was built with.
help
Show this help page.
Exit Codes
0 ok
1 error
2 wrong user inputBeat コマンドの名前を heartbeat に変更しました
値の更新コマンドドキュメント
ヒストグラム メトリック値を送信するための addvalues コマンド
マシンテキストを送信するための add text コマンド
重大な変更: ウォッチドッグの最小ビート間隔を 5 メートルに設定します
重大な変更: 最小マシンサンプル間隔を 5 メートルに設定します
コマンド名と間隔処理を変更する
ディスク読み取り/書き込みサンプリングを追加
ネットワーク受信/送信サンプリングを追加
最初のバージョン
