eventum-generator/content-packsEventum 用コンテンツパック
Eventum 向けのすぐに使えるジェネレータプロジェクトです。実際の SIEM データソースを模したリアルな合成イベントを生成します。各ジェネレータは ECS 準拠の JSON を出力し、Elasticsearch、OpenSearch、または任意の SIEM プラットフォームに直接取り込むことができます。
git clone https://github.com/eventum-generator/content-packs.git
cd content-packs
docker compose up -d
これにより、すべてのジェネレータが利用可能な状態で Eventum サーバがポート 9474 で起動します。インスタンスの管理は REST API を介して http://localhost:9474 で行います。
# Eventum のインストール
uv tool install eventum-generator
# このリポジトリのクローン
git clone https://github.com/eventum-generator/content-packs.git
cd content-packs
# ジェネレータの実行（出力先: generators/windows-security/output/events.json）
eventum generate \
--path generators/windows-security/generator.yml \
--id winlog \
--live-mode true
イベントはジェネレータディレクトリ内の output/events.json に JSON 形式で書き込まれ、1行に1イベントが記録されます。
{
"@timestamp": "2026-02-21T12:00:01.234567+00:00",
"event": {
"action": "logged-in",
"category": ["authentication"],
"code": "4624",
"kind": "event",
"outcome": "success"
},
"user": {
"domain": "CONTOSO",
"name": "jsmith"
},
"winlog": {
"channel": "Security",
"event_id": "4624",
"logon": { "type": "Network" }
}
}
各ジェネレータディレクトリには、対象となるイベントタイプ、パラメータ、使用例、サンプル出力を記載した README.md が含まれています。
content-packs/
├── config/
│ ├── eventum.yml # Eventum サーバ設定
│ └── startup.yml # ジェネレータインスタンスの起動設定
├── generators/
│ └── <category>-<source>/ # 例: windows-security
│ ├── generator.yml # パイプライン設定（入力 → イベント → 出力）
│ ├── README.md # データソースのドキュメント、パラメータ、使用例
│ ├── templates/ # Jinja2 テンプレート (.json.jinja)
│ ├── samples/ # CSV/JSON データファイル
│ └── scripts/ # Python スクリプト（必要な場合）
├── logs/ # 実行時ログ出力
├── docker-compose.yml # Eventum サーバ用 Docker Compose
└── LICENSE # Apache 2.0
各ジェネレータは 自己完結型 です。すべてのファイルパスはジェネレータディレクトリからの相対パスで記述されているため、ジェネレータを個別にコピー、移動、結合することが可能です。
# ライブモード — イベントを継続的に生成
eventum generate \
--path generators/windows-security/generator.yml \
--id winlog \
--live-mode true
# ライブモード — 停止するまで可能な限り高速に生成
eventum generate \
--path generators/windows-security/generator.yml \
--id winlog \
--live-mode false
イベントはジェネレータディレクトリ内の output/events.json に書き込まれます。
config/startup.yml でインスタンスを定義し、サーバを実行します。
# config/startup.yml
- id: winlog
path: windows-security
# CLI を使用する場合
eventum run
# Docker を使用する場合
docker compose up -d
Docker セットアップでは、config/、generators/、logs/ がコンテナにマウントされます。サーバ設定は config/eventum.yml にあります。
任意の generator.yml の input セクションを編集します。
input:
- cron:
expression: "* * * * * *"
count: 5 # 毎秒5イベント（約18,000/時間）
デフォルトでは、ジェネレータはジェネレータディレクトリ内の output/events.json にイベントを書き込みます。出力先を変更するには（例：OpenSearch、ClickHouse、HTTP）、generator.yml の output セクションを編集します。利用可能な出力プラグインの詳細は Eventum ドキュメント を参照してください。
コントリビューションを歓迎します！ご自身のユースケース用にジェネレータを作成し、他の方にも役立つと思われる場合は、ぜひ含めさせてください。
<カテゴリ>-<ソース>（例：linux-auditd、web-nginx）<イベントIDまたはタイプ>.json.jinja の形式で命名eventum generate でそのまま動作すること（ファイル出力は output/events.json）params を使用し、テンプレートにハードコードしないことREADME.md を必ず含めるこのプロジェクトは Apache License 2.0 の下でライセンスされています。