第6章 JBoss EAP で Micrometer の管理
6.1. 管理 CLI を使用して Micrometer サブシステムの追加 リンクのコピーリンクがクリップボードにコピーされました!
Micrometer サブシステムは、包括的なメトリクスの収集と公開を容易にすることで、JBoss EAP の監視機能を強化します。ただし、org.jboss.extension.micrometer サブシステムは、JBoss EAP ディストリビューション内のすべてのスタンドアロン設定で使用できますが、手動で追加する必要があります。
前提条件
- JBoss EAP 8.0 と JBoss EAP XP 5.0 がインストールされている。
- JBoss EAP 管理 CLI にアクセスでき、設定を変更する権限がある。
手順
- ターミナルを開きます。
次のコマンドを実行してサーバーに接続します。
./jboss-cli.sh --connect
./jboss-cli.sh --connectCopy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、Micrometer 拡張機能がすでに設定に追加されているかどうかを確認します。
[standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:read-resource
[standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:read-resourceCopy to Clipboard Copied! Toggle word wrap Toggle overflow Micrometer 拡張機能が利用できない場合は、次のコマンドを実行して追加します。
[standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:add
[standalone@localhost:9990 /] /extension=org.wildfly.extension.micrometer:addCopy to Clipboard Copied! Toggle word wrap Toggle overflow 必要な設定で Micrometer サブシステムを追加します。たとえば、次のコマンドを実行して、メトリクスコレクターのエンドポイント URL を指定します。
[standalone@localhost:9990 /] /subsystem=micrometer:add(endpoint="http://localhost:4318/v1/metrics")
[standalone@localhost:9990 /] /subsystem=micrometer:add(endpoint="http://localhost:4318/v1/metrics")Copy to Clipboard Copied! Toggle word wrap Toggle overflow 変更を適用するには、サーバーをリロードします。
[standalone@localhost:9990 /] reload
[standalone@localhost:9990 /] reloadCopy to Clipboard Copied! Toggle word wrap Toggle overflow
コレクターが実行されていない場合、またはそのコレクターエンドポイントが利用できない場合は、次のような警告メッセージがトリガーされます。
11:28:16,581 WARNING [io.micrometer.registry.otlp.OtlpMeterRegistry] (MSC service thread 1-5) Failed to publish metrics to OTLP receiver: java.net.ConnectException: Connection refused
11:28:16,581 WARNING [io.micrometer.registry.otlp.OtlpMeterRegistry] (MSC service thread 1-5) Failed to publish metrics to OTLP receiver: java.net.ConnectException: Connection refused
以下の手順に従うと、管理 CLI を使用して Micrometer サブシステムを JBoss EAP サーバーに追加し、アプリケーションの監視機能を強化できます。