メトリックプラグイン - mackerel-plugin-accesslog

mackerel-plugin-accesslog は Web サーバーのアクセスログを毎分集計し、ステータスコード毎の件数などをメトリックとして監視できます。

対応するログフォーマット

ステータスコード毎のアクセス数を監視できます。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Total Count	custom.accesslog.access_num.total_count	-	-	アクセスの総数
HTTP 2xx Count	custom.accesslog.access_num.2xx_count	-	◯	2xx のアクセス数
HTTP 3xx Count	custom.accesslog.access_num.3xx_count	-	◯	3xx のアクセス数
HTTP 4xx Count	custom.accesslog.access_num.4xx_count	-	◯	4xx のアクセス数
HTTP 5xx Count	custom.accesslog.access_num.5xx_count	-	◯	5xx のアクセス数

ステータスコード毎の割合を監視できます。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
HTTP 2xx Percentage	custom.accesslog.access_rate.2xx_percentage	-	◯	2xx の割合
HTTP 3xx Percentage	custom.accesslog.access_rate.3xx_percentage	-	◯	3xx の割合
HTTP 4xx Percentage	custom.accesslog.access_rate.4xx_percentage	-	◯	4xx の割合
HTTP 5xx Percentage	custom.accesslog.access_rate.5xx_percentage	-	◯	5xx の割合

レイテンシを監視できます。

メトリック表示名	メトリック名	差分	積み上げ表示	説明
Average	custom.accesslog.latency.average	-	-	平均
90 Percentile	custom.accesslog.latency.90_percentile	-	-	90 パーセンタイル
95 Percentile	custom.accesslog.latency.95_percentile	-	-	95 パーセンタイル
99 Percentile	custom.accesslog.latency.99_percentile	-	-	99 パーセンタイル

オプション	説明	デフォルト値
--format	アクセスログのフォーマットを apache もしくは ltsv で指定	自動判別
--metric-key-prefix	メトリック名の接頭辞の指定	accesslog
--posfile	pos ファイルの保存先ディレクトリパスを指定	欄外参照
--no-posfile	pos ファイルを使用せずにすべてのログを集計の対象にする	指定なし

pos ファイルについて
- 最新のログの集計結果が保存されます。次回実行時はその差分がメトリックとして投稿されます。
- デフォルトでは /var/tmp/mackerel-agent/mackerel-plugin-accesslog.d に保存されます。

アクセスログ /path/to/access.log を監視する場合は以下のようになります。

toml

[plugin.metrics.accesslog]
command = ["mackerel-plugin-accesslog", "/path/to/access.log"]