PrometheusとGrafanaを使わない軽量Spring Bootモニタリング
Lightweight Spring Boot Monitoring Without Prometheus and Grafana (pvrlabs.xyz)
要約
PrometheusやGrafanaのようなフルスタックの監視システムを使わずに、Spring Bootアプリケーションの基本的な運用状況を把握するための軽量ツール「StatLite」を紹介します。StatLiteはSpring Boot Actuatorのエンドポイントを活用し、ヘルスチェック、リクエスト、エラー、レイテンシ、メモリ使用量、稼働時間、再起動などの重要な運用メトリクスに焦点を当てたダッシュボードを提供します。これは、小規模なデプロイメントや単一VPSでの運用に最適です。
全文翻訳
PrometheusとGrafanaを使わない軽量なSpring Bootモニタリング
1つまたは少数のSpring BootアプリケーションをVPSで実行する場合でも、基本的な運用上の可視性は必要です。アプリケーションが到達可能か、エラーが増加しているか、再起動したかを知る必要があります。これらの質問に答えるために、完全な監視プラットフォームは必要ないかもしれません。
Spring Boot Actuatorは、ヘルスエンドポイントとMicrometerメトリクスを通じて、それらの情報の多くをすでに公開しています。StatLiteは、それをヘルス、リクエスト、エラー、レイテンシ、メモリ、稼働時間、再起動に焦点を当てたダッシュボードに変換します。StatLiteはGoの単一バイナリとして動作し、履歴をSQLiteに保存します。
[画像: Spring Bootのヘルス、リクエストアクティビティ、レイテンシ、メモリ、CPU、稼働時間、再起動を表示するStatLiteダッシュボード]
動作を見てみたいですか? ライブダッシュボードデモをご覧ください。
通常の選択肢が過剰になる理由
ActuatorはSpring Bootアプリケーションに有用なヘルスおよびMicrometerメトリクスエンドポイントを提供します。これらは統合には優れていますが、JSONエンドポイントを繰り返し開くことは、日常的なダッシュボードとしては便利ではありません。
Spring Boot Adminは豊富なアプリケーション管理機能を提供しますが、監視のために別のSpring Bootアプリケーションを実行することは、小規模なVPSには負荷が大きい場合があります。PrometheusとGrafanaは、より大規模な監視システム、柔軟なクエリ、または多数のシステムにわたる長期的な保持が必要な場合に強力な選択肢となります。
1つのVPS上の少数のサービスであれば、より限定的なダッシュボードで十分です。StatLiteは、すでに持っているActuatorデータを読み取り、定期的なチェック中に最も役立つ運用シグナルを表示します。
簡単な比較
| ツール | 運用上の複雑さ | 最適な用途 |
|---|---|---|
| 生のActuatorエンドポイント | 低 | 時折の手動チェック |
| Spring Boot Admin | 中(Javaランタイムとメモリが必要) | アプリケーション管理と監視 |
| PrometheusとGrafana | 高 | 大規模デプロイメントと高度なオブザーバビリティ |
| StatLite | 非常に低い(単一Goバイナリ + SQLite) | 小規模サーバー上の少数のSpring Bootサービス |
これらのツールは共存することも可能です。今日、限定的なダッシュボードのためにStatLiteを選択しても、要件が増大した場合に後でPrometheusとGrafanaを採用することを妨げるものではありません。
数分でStatLiteを設定する
これらの手順は、Actuatorが設定済みの既存のSpring Bootアプリケーションを前提としています。StatLiteをそれなしで試すには、リポジトリに実行可能なSpring Actuatorデモとトラフィックジェネレーターが含まれています。
1. Spring BootからヘルスとPrometheusメトリクスを公開する
アプリケーションにまだ含まれていない場合は、io.micrometer:micrometer-registry-prometheusを追加し、ヘルスとPrometheusエンドポイントを公開します。Actuatorは信頼できるネットワークからのみ到達可能にし、デプロイメントで必要な場合は認証を追加してください。
management:
endpoints:
web:
exposure:
include: health,prometheus
endpoint:
health:
show-details: always
2. StatLiteをインストールする
macOSまたはLinuxでの推奨される方法は、リリースインストーラーを使用することです。これにより、statliteが~/.local/binにインストールされます。
curl -fsSL https://raw.githubusercontent.com/PVRLabs/statlite/main/install.sh | sh
~/.local/binがまだ含まれていない場合は、PATHに追加してください。Homebrewやその他のオプションについては、StatLiteインストールガイドを参照してください。
3. 1つのターゲット設定を追加する
以下の内容をstatlite.yamlとして保存します。
server:
listen: "127.0.0.1:9090"
storage:
sqlite_path: "./statlite.sqlite"
polling:
interval: "10s"
timeout: "5s"
targets:
- name: "my-spring-app"
type: "spring"
url: "http://127.0.0.1:8080/actuator"
listenはデフォルトでダッシュボードをローカルに保ちます。sqlite_pathはダッシュボード履歴に使用されるファイルです。urlはActuatorの管理ベースURLです。StatLiteはActuatorからヘルス情報を、/actuator/prometheusからアプリケーションメトリクスを収集します。Basic認証、複数のターゲット、保持期間、および本番環境でのセキュリティの詳細については、設定ドキュメントを参照してください。
4. ダッシュボードを開く
statlite --config ./statlite.yaml
ブラウザでhttp://127.0.0.1:9090を開きます。StatLiteは設定された間隔でポーリングするため、トラフィックを作成したりアプリケーションを再起動したりした後は、次のポーリングまで待ってください。
StatLiteが軽量である理由
- Javaエージェントやアプリケーションごとの監視エージェントがない
- ActuatorとMicrometer以外のカスタムアプリケーションインストルメンテーションがない
- 単一の設定で複数のSpring Bootターゲットをサポート
意図的にActuatorファーストです。必要に応じてActuatorを有効化または公開しますが、StatLiteはそのセットアップ手順を省略するものではありません。
StatLiteを使用しない場合
多数のサービスやホスト、長期的なデータ保持、高度なメトリクス検索、アラートルーティング、分散トレーシング、集中ログ、または組織全体のダッシュボードが必要な場合は、より広範なオブザーバビリティプラットフォームを使用してください。
StatLiteはエンタープライズオブザーバビリティの代替ではありません。これは、完全なPrometheusとGrafanaスタックを運用することなく、少数のSpring Bootアプリケーションを監視するという運用上のタスクがある場合に、焦点を絞った選択肢です。
関連リソース
Spring Bootとダッシュボードを含む512 MB VPSでの測定については、512 MB VPS上のSpring Boot:軽量監視が依然として適合する方法を参照してください。
CPU負荷の高いジョブ中にSpring Boot APIが遅くなる場合は、私のAPIは稼働していますが、遅いです。私のコードかサーバーのせいですか?を参照してください。
独自のSpring Bootアプリケーションを監視したいですか?