ブラウザで `http://localhost:3001` にアクセスしてください。特定のインスタンスを監視するには:```bash
docker run -d \
  --name betterdb \
  -p 3001:3001 \
  -e DB_HOST=your-valkey-host \
  -e DB_PORT=6379 \
  -e DB_PASSWORD=your-password \
  betterdb/monitor:latest

次に `kubectl port-forward -n betterdb svc/betterdb-monitor 3001:3001` を実行して `http://localhost:3001` を開くか、チャートの ingress を有効にします。PostgreSQL をバックエンドにした履歴、bring-your-own Secrets、エアギャップ環境でのライセンスは、[Kubernetes ガイド](https://docs.betterdb.com/kubernetes)と[チャート README](https://github.com/betterdb-inc/monitor/blob/master/charts/betterdb-monitor/README.md)で説明されています。

## クイックスタート (CLI)

Docker なしで BetterDB Monitor を実行します:```bash
npx @betterdb/monitor

監視対象としてNode.js >= 20.0.0とValkeyまたはRedisインスタンスが必要です。SQLiteストレージを使用する場合は、`npm install -g better-sqlite3`も必要です。

## 得られるもの

### すべてを見て、すべてを保持

- **履歴分析** - 任意の期間にわたってスローログ、コマンドパターン、クライアントアクティビティ、レイテンシをクエリできます。ログローテーション後に消えてしまっていたデータです。
- **COMMANDLOGサポート** - Valkey 8.1+専用。遅いリクエストだけでなく、大きなリクエストや大きなリプライも対象です。
- **MONITORキャプチャセッション** - オンデマンドで実際のトラフィックを記録: ライブテール、フィルタ、リプレイ、JSON/CSVへのエクスポート、接続履歴とのクロスリファレンス。
- **ホットキー追跡** - アクセス頻度順のトップキーと、時間経過に伴う順位変動。Key Analytics (Pro、早期アクセスでは無料) は、ライブサンプリングによる型、TTL、サイズ分布を追加します。
- **クラスタ可視化** - トポロジグラフ、SLOT-STATSヒートマップ、スロットごとのCPUとキー分布。
- **CPU & I/Oスレッドメトリクス** - 他のどのRedisツールも提供できないスレッドごとの可視化。
- **クライアント分析** - どのサービスが何の原因かを正確に把握。クライアント名とパターンで属性付けされます。
- **ACL監査証跡** - 誰が何にアクセスしたかを追跡し、コンプライアンスとインシデント後のデバッグのために永続化します。

### 理解して行動する

- **異常検知** (Pro、早期アクセスでは無料) - 相関イベントと平易な言葉による診断を伴う自動ベースライン学習。20以上の検出器、手動しきい値は不要です。
- **容量予測** - メモリ、ops/sec、CPU、フラグメンテーションの上限到達までの予測時間。
- **Webhook** - リトライと完全な配信ログを備えたHMAC署名付きアラート配信。
- **ライブマイグレーション** - 3フェーズの分析、実行、検証ワークフローでRedisとValkey間を移動できます。

### AI時代のために構築

- **ベクトル検索オブザーバビリティ** - [valkey-search](https://github.com/valkey-io/valkey-search)とRediSearchのFT.SEARCH ops/secとレイテンシ、インデックスごとのヘルス。詳細は[docs/vector-ai](https://github.com/betterdb-inc/monitor/blob/master/docs/vector-ai/README.md)を参照してください。
- **推論レイテンシ** - インデックスごとのp50/p95/p99、SLA違反アラート付き (Pro、早期アクセスでは無料)。
- **セマンティックキャッシュインテリジェンス** (Pro、早期アクセスでは無料) - ヒット率のヘルス、類似度しきい値の推奨、承認/却下の提案ワークフロー。エージェントメモリのオブザーバビリティも含まれます。
- **AIトレース** - AIアプリケーションからのOTLPスパンウォーターフォール。各リクエストの下にあるライブValkey状態と相関付けられます。詳細は[docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md)を参照してください。

### あらゆるものに接続

- **MCPサーバー** - [`@betterdb/mcp`](https://github.com/betterdb-inc/monitor/blob/master/packages/mcp)経由でClaude Code、Cursor、または任意のMCPクライアント向けの60のツール。
- **Prometheusエンドポイント** - 100以上の`betterdb_*`メトリクス。詳細は[docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md)を参照してください。
- **OpenTelemetry** - OTLPトレースを取り込み、メトリクスとイベントを任意のOTLPバックエンドにミラーリングします。詳細は[docs/opentelemetry.md](https://github.com/betterdb-inc/monitor/blob/master/docs/opentelemetry.md)を参照してください。
- **REST API** - UIのすべてがAPI呼び出しであり、OpenAPIで文書化されています。

## 自分のデータに自分の方法でアクセス

| インターフェース | 詳細 |
|-----------|---------|
| Web UI | `http://localhost:3001` |
| MCPサーバー | `npx @betterdb/mcp` (stdio) - Settings → MCP Tokensでトークンを作成 |
| Prometheus | `http://localhost:3001/api/prometheus/metrics` |
| REST API (OpenAPI) | `http://localhost:3001/docs` |
| ヘルスチェック | `http://localhost:3001/api/health` |

> **注意**: 本番ビルド (Docker、CLI) では、APIルートは`/api`プレフィックスの下で提供されます。ローカル開発 (`pnpm dev`) ではプレフィックスはありません - 例: `http://localhost:3001/health`。

## サポートされるデータベース

| データベース | 最小バージョン | サポートされる機能 |
|----------|----------------|-------------------|
| **Valkey** | 8.0+ | COMMANDLOG (8.1+) とCLUSTER SLOT-STATSを含むすべての機能 |
| **Redis** | 6+ | Valkey専用のCOMMANDLOGとCLUSTER SLOT-STATSを除くすべての機能 |

バックエンドは、ワイヤ互換の`iovalkey`クライアント上の統合アダプタを使用し、`INFO`レスポンスからValkeyかRedisかを自動検出します (`DB_TYPE=auto`)。COMMANDLOGやSLOT-STATSなどの機能はバージョンごとに検出され、機能が利用できない場合、UIは適切に機能を縮退させます。

マネージドサービスもサポートされています - AWS ElastiCache、MemoryDB、Redis Cloud、Upstashのガイドは[docs/providers](https://github.com/betterdb-inc/monitor/blob/master/docs/providers)にあり、[`@betterdb/agent`](https://github.com/betterdb-inc/monitor/blob/master/packages/agent)はアウトバウンドWebSocket経由でVPC専用インスタンスに到達します。

## Docker本番デプロイメント

Dockerイメージには監視アプリケーション (バックエンド + フロントエンド) が含まれています。必要なもの:
1. 監視対象のValkey/Redisインスタンス
2. データ永続化用のPostgreSQLインスタンス (またはメモリストレージを使用)

### PostgreSQLストレージで実行する```bash
docker run -d \
  --name betterdb-monitor \
  -p 3001:3001 \
  -e DB_HOST=your-valkey-host \
  -e DB_PORT=6379 \
  -e DB_PASSWORD=your-password \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://user:pass@postgres-host:5432/dbname \
  betterdb/monitor

### ホストネットワークで実行する（localhost サービスにアクセス）

Valkey と PostgreSQL が同じホスト上で動作している場合:```bash
docker run -d \
  --name betterdb-monitor \
  --network host \
  -e DB_HOST=localhost \
  -e DB_PORT=6380 \
  -e DB_PASSWORD=devpassword \
  -e STORAGE_TYPE=postgres \
  -e STORAGE_URL=postgresql://dev:devpass@localhost:5432/postgres \
  betterdb/monitor

`GET /api/license/status` で確認 → `source: offline-token`、`mode: offline`、
`airGapped: true`。

> **永続化:** 書き込み可能なボリュームを `/app/data` にマウントして、オフラインライセンスと
> オンライン障害猶予トークンが再起動後も保持されるようにします。コンテナは **UID 1001** で
> 実行されるため、新しく作成したボリュームはその UID に `chown` する必要があります（上記参照） -
> そうしないと永続化が `EACCES … license.jwt` で失敗します。

完全なフロー、検証の優先順位、鍵ローテーションのランブックについては
**[オフライン & エアギャップライセンス](https://github.com/betterdb-inc/monitor/blob/master/docs/offline-licenses.md)** および
**[設定リファレンス](https://github.com/betterdb-inc/monitor/blob/master/docs/configuration.md#license-configuration)** を参照してください。

### Docker イメージの詳細

- **ベースイメージ**: `node:20-alpine`
- **圧縮サイズ**: 約360MB（`latest` / `-no-ai`）/ 約640MB（実験的な AI Helper のローカル LLM 依存関係を含むバージョン付きイメージ）
- **プラットフォーム**: `linux/amd64`、`linux/arm64`
- **含まれるもの**: バックエンド API + フロントエンド静的ファイル（Fastify により配信）
- **除外**: SQLite サポート（PostgreSQL または Memory ストレージを使用）

### コンテナ操作```bash
docker logs -f betterdb-monitor        # follow logs
docker stop betterdb-monitor           # stop
docker rm betterdb-monitor             # remove

完全なメトリクスリファレンス: [docs/prometheus-metrics.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-metrics.md) および [docs/prometheus-integration.md](https://github.com/betterdb-inc/monitor/blob/master/docs/prometheus-integration.md)。

## 開発

### プロジェクト構成```
betterdb-monitor/
├── apps/
│   ├── api/                 # NestJS backend (Fastify)
│   └── web/                 # React frontend (Vite)
├── packages/                # Published packages (see below)
├── docs/                    # Documentation site (Jekyll)
├── docker-compose.yml       # Local Valkey (port 6380) and Redis (port 6382) for testing
└── package.json             # Workspace root

Redis に接続するには、Valkey の代わりに `.env` で `DB_PORT=6382` を設定します。```bash
pnpm dev:api           # API only
pnpm dev:web           # frontend only
pnpm docker:dev:down   # stop local databases
pnpm build             # production build
pnpm test              # API tests

### 新機能の追加

1. `apps/api/src/` に新しいエンドポイントを追加する
2. `apps/web/src/api/` に対応する API 呼び出しを追加する
3. `packages/shared/src/types/` に共有型を追加する

### コードスタイル

- TypeScript strict モード、明示的な戻り値の型、`any` は使用しない
- ESLint + Prettier を設定済み

## ライセンス

- `docs/` 配下のコンテンツは CC BY-SA 4.0 の下でライセンスされています。
- `proprietary/` 配下のコンテンツは商用ライセンスの対象です（`proprietary/LICENSE` を参照）。これらの機能はアーリーアクセス期間中は無料です。
- それ以外はすべて [MIT](https://github.com/betterdb-inc/monitor/blob/master/LICENSE) です。