bounceHammer has been EOL'ed on February 29, 2016

製品ライフサイクルの終了

2010年3月にオープンソースソフトウェアとして公開して以来、多くのユーザ様・企業様にダウンロードし、 ご利用いただきましたbounceHammerは、2016年2月29日(月)を持ちまして製品ライフサイクルの終了(EOL: End Of Life) となりました。長きにわたりbounceHammerをご使用いただき誠に有り難う御座いました。 開発元では後継となるバウンスメール解析ライブラリとして、より高精度で高速なSisimai(シシマイ) を二条項BSDライセンスで公開しています。

Sisimai
商用サポート

  • 1一式導入・設定・保守・開発の補助
  • 2独自MTA用解析モジュールの開発
  • 3個別案件の対応とメールサポート
  • 4バウンス管理・運用コンサルティング
  • 5スポット解析・解析済みデータ提供

summarizer/解析済データの簡易統計

 

summarizer - バウンス記録のデータを集約

summarizerコマンドは、bounceHammer 2.4.0から利用可能な、 データベースのバウンス記録または生成された解析結果のログファイルの記録を 集約するコマンドです。 発信者アドレス(Addresser)、発信者ドメイン(Sender Domain)、宛先ドメイン(Destination)、 差戻理由(Reason)、宛先分類(Host Group)、宛先所属(Provider)毎にバウンスの記録を集約します。

また、bounceHammer 2.5.0から日々のバウンス数を記録した数値を参照する 機能(Daily Updates)が追加されました。

このコマンドはインストールしたディレクトリ/bin/summarizerにあります。

コマンドの使用例

summarizerは、mailboxparserlogger が作った解析済みログファイルを引数にとり、それらの内容を集約します。 またデータベースの記録を集約するオプション(-D, --database) を指定するとDBにあるバウンス記録を集約します。 summarizerコマンドとほぼ同等の操作が管理画面(WebUI)でも可能です。

解析済みファイル内の記録を、宛先分類(Host Group)で集約
# summarizer -a h /path/to/file
 
DBにあるバウンス記録を、発信者アドレス(Addresser)で集約
# summarizer -a a -D
 
DBにあるバウンス記録を、全ての項目で集約
# summarizer --aggregate-all -D
 
指定したファイル内のバウンス記録を、差戻理由で集約し、基本統計量も表示
# summarizer -a w -s /path/to/file
 
日々のバウンス記録を月別に集計して、統計情報と共に表示
# summarizer -Us --totalsby m
 
日々のバウンス記録を年単位で集計して表示
# summarizer --dailyupdates --totalsby y
 
ヘルプを表示
# summarizer --help

利用可能なオプション

集約オプション

-A, --aggregate-all
このオプションをつけてsummarizerを起動すると、発信者アドレス(Addresser)、 発信者ドメイン(Sender Domain)、宛先ドメイン(Destination)、差戻理由(Reason)、 宛先分類(Host Group)、宛先所属(Provider)の全ての項目で集約した結果を表示します。
-a, --aggregate 集約する項目
引数に指定した項目で集約をします。指定できる項目は、 a = 発信者アドレス(Addresser)、 s = 発信者ドメイン(Sender Domain)、 d = 宛先ドメイン(Destination)、 w または r = 差戻理由(Reason)、 h = 宛先分類(Host Group)、 p = 宛先所属(Provider)です。
-D, --database
summarizerにデータベース内の記録を集約させます。 データベース内の記録を集約して表示させるときは必ずこのオプションが必要です。

日々のバウンス記録数参照用オプション

-U, --dailyupdates (Ver. 2.5.0以降)
日々のバウンス記録数を参照するオプションです。 summarizerコマンドを使う場合、このオプションか集約オプション (-A,-a)のいずれかを指定する必要があります。
-p, --period 開始:終了 (Ver. 2.5.0以降)
日々のバウンス記録数を日付(期間)を指定して参照するオプションです。 有効な日付の形式は2009/04/29 または2009-04-29 で、例えば夏休みの間の バウンス記録数を参照するには、--period 2010/07/21:2010/08/31 のように指定します。
--totalsby 文字列 (Ver. 2.5.0以降)
日々のバウンス記録数を指定した文字が表す単位で集計して表示します。 指定可能な文字はday: 日, week: 週(デフォルト), month: 月, year: 年 です。

集約とバウンス記録数参照の共通オプション

-b, --before 日数
summarizerに解析済みファイル内の記録を集約させます。 設定ファイル(etc/bouncehammer.cf)のdirectory->logディレクトリで定義した ディレクトリの中にあるログファイルのうち、今日以外のログファイル内の記録を 集約したい場合はこの--beforeオプションで遡る日数を指定します。

--before 2 で一昨日、--before 10 で10日前のログファイル内の 記録を集約します。--before 1は後述の--yesterdayと等価です。
-d, --date 日付文字列 (Ver. 2.5.0以降)
集約対象、バウンス数記録の参照を指定した日付に限定します。 有効な日付の形式は2009/04/29 または2009-04-29 です。 -b(--before)で遡る日数が計算しにくい場合などに有効なオプションです。
-y, --yesterday
summarizerに昨日の解析済みファイル内の記録を集約させます。 設定ファイル(etc/bouncehammer.cf)のdirectory->logで定義される 集積用ディレクトリにある、昨日(summarizer実行日からみて)の ログファイル内の記録を集約対象とします。このオプションは--before 1と等価です。
-t, --today
summarizerに今日の解析済みファイル内の記録を集約させます。 設定ファイル(etc/bouncehammer.cf)のdirectory->logで定義される集積用ディレクトリにある、 今日(summarizer実行日)のログファイル内の記録を集約対象とします。 このオプションは--before 0と等価です。
-s, --summary
指定項目の集約結果の下に、基本統計量(最小値・平均値・最大値・標準偏差)を表示します。

その他のオプション

-C, --conf 設定ファイル
読み込む設定ファイルを指定します。このオプションを使用しない場合、 インストール先/etc/bouncehammer.cfが使用されます。 複数の設定ファイルを処理毎に使い分ける場合などでは有用でしょう。
-T, --test
テストモードで動作します。通常は動作に必要な設定値を インストール先/etc/bouncehammer.cfから読出しますが、 このオプションを指定するとbouncehammer.cfが無くても動作します。 -C test-run.cf と等価です。
-F, --fotmat 文字
検索結果を指定したフォーマットで出力します。このオプションを指定しない場合は、 アスキーテーブル形式で出力されます。 利用可能なフォーマットは次の通りです。
文字 説明
y YAML形式 | e.g.) -Fy
c CSV形式(2.5.0から) | -Fc
a アスキーテーブル | -Fa
--silent
このオプションを付けると、次の-v, --verboseオプションの有無にかかわらず 冗長なメッセージおよびエラーの出力がなくなります。 また、コマンドをsendmail等のデーモンが実行した場合、エラーが起きても exit(0)=成功で終了します。

--silentオプションを付けずにsendmail等MTAがコマンドを起動し、 エラーが発生した場合はexit(75)=EX_TEMPFAILで終了します。
-v, --verbose
処理過程が冗長に表示されます。
--help
コマンドのヘルプが表示されます。
--version
バージョン番号が表示されます。

コマンド実行結果のスクリーンショットでの説明

summarizer -a hostgroup -vvvv --database -s -p 2010/01/01:2010/12/31

下記のスクリーンショットは、データベースに保存されているバウンス記録を宛先分類 (Host Group)で集約した結果と基本統計量を表示するコマンドと出力内容の説明です。

summarizer -a destination -vvvv --yesterday -s

下記のスクリーンショットは、昨日(コマンド実行日の前日)バウンスした記録を 解析済みログファイルから読み出し、宛先ドメイン(Destination)で集約した結果と 基本統計量を表示するコマンドと出力内容の説明です。