kansatsu ドキュメント — ログを tail して、パターンを検知して、通知する CLI

## NAME

kansatsu — ログを tail し、正規表現パターンを検知し、閾値を超えたら通知する。それだけを、正確に。

現場のログ監視は複雑になりすぎた。ダッシュボードを開き、クエリを書き、契約プランを見比べる前に、 多くの現場が本当に必要としているのは「特定のエラーが3回起きたら教えてほしい」という一行の要求だけだ。 kansatsu は1バイナリ・設定ファイル1枚・依存ゼロで動く。tail -f の延長線上に、 パターン検知と通知を足しただけの道具として設計した。ログを溜め込まない。集計もしない。 見るべき瞬間にだけ、見るべき人に届ける。

## SYNOPSIS

kansatsu tail [--follow] [--pattern=<regex>] [--alert=<webhook|mail|slack>] [--since=<duration>] <path>
kansatsu watch --config=<file>
kansatsu replay --from=<date> --to=<date> --pattern=<regex>

単発の調査には tail、常駐監視には設定ファイルを渡す watch、 過去ログへの再検索には replay を使う。3つのサブコマンドで完結し、これ以上は増やさない方針。

## INSTALL

### Homebrew（macOS / Linuxbrew）

brew install kansatsu/tap/kansatsu

### curl（インストールスクリプト）

curl -fsSL https://get.kansatsu.dev/install.sh | sh

### APT（Debian / Ubuntu）

# リポジトリ登録は初回のみ
curl -fsSL https://get.kansatsu.dev/gpg | sudo apt-key add -
echo "deb https://get.kansatsu.dev/apt stable main" | sudo tee /etc/apt/sources.list.d/kansatsu.list
sudo apt update && sudo apt install kansatsu

いずれの方法でもバイナリは単体で動作する。ランタイムの追加インストールは不要。

## USAGE

主要コマンドは6つ。すべて kansatsu <command> --help でその場の一覧を確認できる。

## OPTIONS

### 主要フラグ

--follow, -f

ファイル末尾に追従し続ける（tail -f 相当）。指定しない場合は既存ログを一度走査して終了する

--pattern=<regex>

検知する正規表現パターン。複数指定した場合はいずれか一致で検知する

--alert=<dest>

検知時の通知先。webhook / mail / slack のいずれか。既定は未設定（通知しない）

--since=<duration>

何分前からのログを走査するか。例: 30m, 2h, 1d

--threshold=<n>

同一パターンの検知回数が n 回を超えたら通知する。既定は 1（単発検知で通知）

--config=<path>

設定ファイルのパス。既定は ./kansatsu.yml

### 設定ファイル例（kansatsu.yml）

# kansatsu.yml
watch:
  - path: /var/log/nginx/access.log
    pattern: "5\\d{2} "
    threshold: 5
    window: 60s
    alert: webhook

  - path: /var/log/app/worker.log
    pattern: "timeout connecting to"
    threshold: 3
    window: 90s
    alert: mail

alert:
  webhook:
    url: https://hooks.example.internal/kansatsu
  mail:
    to: ops@example.internal

## PRICING

## FAQ