Prometheusメトリクス公開

[yuu1111]

Summary

#38 (読み上げ文字数の集計) の後続PR。集計データをPrometheus /metrics で外部公開する

このPRは #38 の上に積まれています。 #38 がマージされるまでは差分に集計機能のコミットも含まれます。#38 マージ後、本PRの差分はメトリクス分のみに収束します。

• Micrometer + JDK標準HttpServerで /metrics 公開 (デフォルト 127.0.0.1:9095、設定で無効化可)
• 起動時にDB累計をCounterに注入し再起動後も整合
• JVM標準メトリクス (memory/processor/gc) も同梱

メトリクス例

• itts_up, itts_uptime_seconds
• itts_spoken_chars_total{bot_id, server_id}
• itts_spoken_messages_total{bot_id, server_id}
• JVM標準メトリクス

設定

config.json5 の metrics セクション:

metrics: {
  enable: false,        // デフォルトは無効
  bind_address: "127.0.0.1",
  port: 9095
}

外部公開はリバプロ前提のオプトイン。

検証

• ./gradlew :core:compileJava
• ./gradlew :core:checkstyleMain (warning 0)
• ./gradlew :selfhost:shadowJar

Test plan

• metrics.enable: true で起動 → curl http://127.0.0.1:9095/metrics で itts_spoken_chars_total が出ること
• Bot再起動後、itts_spoken_chars_total がDB累計から再開すること
• metrics.enable: false でHTTPサーバーが起動しないこと

留意点

• Counterはプロセス再起動で0リセットされるPrometheusセマンティクス通りの挙動。累計表示は /stat 側で対応
• 日付境界はUTC固定 (集計側と同じ)
• 読み上げ文字数の集計 #38 マージ後にrebaseしてレビューしやすい状態に整えます