tailpipe-mod-nginx-access-log-detections

## 概要 **Nginx Access Log Detections Mod** は、Nginx アクセスログの分析用に事前構築されたSQL検出とインタラクティブダッシュボードを備えたPowerpipe拡張機能です。PowerpipeにTailpipe CLI（およびNginxプラグイン）を組み合わせて使用することで、ログデータを収集し、セキュリティ集中型のベンチマークを実行し、アクティビティをリアルタイムで可視化できます。 ## 主な機能 - Tailpipeのファイルソースを使用した**ログ収集**：過去7日間のバックフィルと増分更新を自動実行。 - 不審なパターン、OWASP関連の問題、その他のセキュリティインサイトを表示する**SQLベース検出**。 - アクティビティ概要、リクエスト動向、ベンチマーク結果向けの**用意済みダッシュボード**。 - `powerpipe benchmark` による**コマンドラインベンチマーク**でクイックなターミナルレポート。 - `http://localhost:9033` でダッシュボードをホストする**ローカルサーバー**（`powerpipe server`）。 ## 始め方 1. **Powerpipe をインストール**（brew: `brew install turbot/tap/powerpipe`） 2. **Mod をインストール**： ```sh mkdir dashboards && cd dashboards powerpipe mod install github.com/turbot/tailpipe-mod-nginx-access-log-detections ``` 3. **Tailpipe と Nginx プラグインをインストール**： ```sh brew install turbot/tap/tailpipe tailpipe plugin install nginx ``` 4. **ログソースを設定**（例 `~/.tailpipe/config/nginx.tpc`）： ```hcl partition "nginx_access_log" "test" { source "file" { paths = ["/path/to/nginx_access_logs"] file_layout = "%{DATA}.log" } } ``` 5. **ログを収集**： ```sh tailpipe collect nginx_access_log ``` `--from` を使用して開始日または相対時刻（例：`T-60d`）を指定。 6. **ダッシュボードサーバーを開始**： ```sh powerpipe server ``` ブラウザで `http://localhost:9033` にアクセスしてダッシュボードを確認。 7. **ターミナルでベンチマークを実行**： ```sh powerpipe benchmark list powerpipe benchmark run nginx_access_log_detections.benchmark.access_log_detections ``` ## ドキュメント & リソース - ダッシュボード: https://hub.powerpipe.io/mods/turbot/tailpipe-mod-nginx-access-log-detections/dashboards - ベンチマーク & 検出: https://hub.powerpipe.io/mods/turbot/tailpipe-mod-nginx-access-log-detections/benchmarks - Tailpipe ドキュメント: https://tailpipe.io/docs/reference/cli/collect ## ライセンス & 貢献 本プロジェクトは Apache 2.0 ライセンスの下で公開されています。GitHub リポジトリ経由で貢献を歓迎し、行動規範が提供されています。Slack（`#tailpipe` および `#powerpipe`）でコミュニティに参加しましょう。 ## ユースケース - セキュリティチームは、Nginx ログ内の異常なリクエストパターンや OWASP 違反をすばやく検出できる。 - オペレーションチームは、カスタムパイプラインを構築することなくトラフィックの動向やパフォーマンス指標を監視できる。 - 開発者は、ログベースのアラートを CI/CD やインシデント対応ワークフローに統合できる。 Mod は自己完結型でローカルで動作し、Powerpipe と Tailpipe のバイナリのみが必要であるため、オンプレミス監視環境に適しています。