Flex Gateway新着情報
Governance新着情報
Monitoring API Managerオンプレミスサーバーに Anypoint Monitoring エージェントをインストールし、そのサーバー上で実行されていて、CloudHub で管理されているアプリケーションを監視できます。
Anypoint Monitoring エージェントは、監視データを Anypoint Monitoring クラウドエンドポイントに送信します。Anypoint Monitoring データの送信には、高効率の双方向バイナリチャネル経由でログデータを転送するためのオープンソースプロトコルが使用されます。データは相互 TLS 暗号化を使用してセキュアに送信されます。
サーバーグループまたはクラスター全体で Anypoint Monitoring を使用するには、個々のサーバーに Anypoint Monitoring をインストールする必要があります。
アウトバウンドファイアウォールがある場合は、ポート 443 を開きます。
次のエンドポイントへの送信接続が行われます。
US コントロールプレーン
data-authenticator.anypoint.mulesoft.com:443
dias-ingestor-router.us-east-1.prod.cloudhub.io:443
s3.amazonaws.com:443
US-GOV コントロールプレーン
data-authenticator.gov.anypoint.mulesoft.com:443
dias-ingestor-router.us-gov-west-1.gprod.msap.io:443
EU コントロールプレーン
data-authenticator.eu1.anypoint.mulesoft.com:443
dias-ingestor-router.eu-central-1.prod-eu.msap.io:443
s3.eu-central-1.amazonaws.com:443
Anypoint Monitoring が、次のいずれかのオペレーティングシステムが稼働するサーバーにインストールされていることを確認します。
CentOS 7
RedHat Enterprise Linux 7
Ubuntu 16.04 および 18.04
Windows Server 2016、Windows Server 2019
エージェントをインストールするには、ルート権限または管理権限が必要です。
次の Mule Runtime Engine バージョンと Anypoint Monitoring を使用してください。
Mule 3 バージョン 3.8.7 以降
バージョン 3.8.6 以前はサポートされていません。さらに、-AM
サフィックスがあるすべてのランタイムバージョンは非推奨です。
インバウンドおよびアウトバウンドのメトリクスは、Mule Runtime Engine バージョン 3.9.5 以前を使用するハイブリッドプロキシアプリケーションでは使用できません。
Mule 4
API Analytics の拡張メトリクスを使用するには、Mule Runtime Engine バージョン 4.1.6 以降を使用してください。
次のいずれかの Mule Runtime Manager エージェントバージョンが、サーバー上で実行されている Mule runtime engine にインストールされていることを確認します。
2.5.x
2.4.x
2.3.0
2.2.x
2.1.9
2.1.7
2.1.6
1.14.x
1.13.0
1.12.x
1.11.x
1.10.0
Mule デプロイメントは Runtime Manager ユーザーインターフェースに表示され、管理される必要があります。表示されるようにするには、新規デプロイメントで Runtime Manager ユーザーインターフェースまたは ARM REST API を使用します。
サーバーが Anypoint Monitoring の次の最小ハードウェア要件を満たしていることを確認します。
2GHz CPU または 1 仮想 CPU
1GB RAM
4GB ディスク領域
Intel x86 または x64 互換の CPU アーキテクチャ
Anypoint Monitoring エージェントをダウンロードしてオンプレミスにインストールするための手順は、Anypoint Monitoring ユーザーインターフェースの [Setting (設定) ページ]にあります。[Settings (設定)] ページから Anypoint Monitoring インストール am.zip
ファイルをダウンロードすることもできます。
Anypoint Monitoring エージェントをインストールするときに、次の点に注意します。
am.zip
ファイルを展開すると、ZIP を展開した場所に am
というフォルダーが作成されます。
Anypoint Monitoring をサービスとしてインストールするかどうかをインストールスクリプトが尋ねます。
インストーラーによってサービスとしてプリセットしない場合は、[No (いいえ)] を選択します。
-x
引数を指定したインストールスクリプトをコールすると、この確認を省略できます。この確認を省略すると、Anypoint Monitoring はサービスとしてインストールされません。
既存の filebeat インスタンスが実行されているサーバーに Anypoint Monitoring エージェントをインストールすることはできません。
Anypoint Monitoring エージェントをサーバーグループのハイブリッドサーバーにインストールするときは、Runtime Manager を使用してサーバーを再起動し、Anypoint Monitoring がメトリクスの収集を開始できるようにします。
監視データがデータセンターから送信されるときにプロキシが必要な場合、Anypoint Monitoring エージェントのインストール時にコマンドラインパラメーター -p
を使用できます。
監視に SOCKS5 プロトコルを使用するには、以下を実行する必要があります。
Runtime Manager と共にプロキシをセットアップします。「Runtime Manager でのサーバーの作成」を参照してください。
SOCKS5 プロキシ設定手順を実行するには、環境に互換サーバーがデプロイされている必要があります。
Anypoint Monitoring エージェントをインストールし、-p
オプションを使用します。たとえば、Windows サーバーのコマンドラインで次のように入力します。
<location-of-am-folder\bin>powershell -file install.ps1 -p socks5://user:password@socks5-server:1080
Linux サーバーの場合は、次のように入力します。
$ ./install -p socks5://user:password@socks5-server:1080
SOCKS5 プロキシ設定のユーザーまたはパスワードに URI 予約文字が含まれている場合、RFC 3986 のエンコードルールに従ってパーセントエンコードする必要があります。
設定が反映されるまで 10 分間待ちます。
Anypoint Platform にログインします。
ナビゲーションバーまたは Anypoint Platform のメイン画面で [Monitoring (監視)] をクリックします。
[Built-in Dashboards (組み込みダッシュボード)] ページで、Anypoint Monitoring エージェントをインストールしたサーバー上にデプロイされているアプリケーションを選択します。
[CPU Utilization (CPU 使用率)] チャートと [Memory Utilization (メモリ使用量)] チャートにデータが表示されていることを確認します。
チャートにデータが表示される場合、Anypoint Monitoring エージェントはインストールされて稼働しています。
チャートにデータが表示されない場合、Anypoint Monitoring がエンドポイントに接続できることを確認します。
必要に応じて、サーバーが接続を許可するように、エンドポイントをアウトバウンドファイアウォールルールの許可リストに追加できます。許可リストに追加するエンドポイントは、「始める前に」にリストされています。 |
Anypoint Monitoring エージェントが稼働しているサーバーにログインします。
データ転送エージェントのログファイルを開きます。ログファイルはパス ./am/filebeat/logs
にあります。
Linux を使用しており、Anypoint Monitoring エージェントがサービスとして実行されている場合、ログファイルは /var/log/filebeat ディレクトリにあります。
|
接続の失敗または接続の再試行に関するエントリを探します。
Runtime Manager エージェントを更新する場合は、Anypoint Monitoring エージェントを再インストールする必要があります。
今後、いずれかの時点で Anypoint Monitoring エージェントの更新が必要になった場合は、次の手順に従います。
Mule を停止します。
am
フォルダーで、次のコマンドを実行します。
./bin/uninstall
am
フォルダーを削除します。
オンプレミスに Anypoint Monitoring エージェントをインストールする手順を実行します。
Mule を再起動します。
監視を有効にすると、アプリケーション設定によっては CPU 使用率とメモリ使用量に影響を与えることがあります。最適なパフォーマンスとサイジングが維持できるように、本番環境で監視を有効化する前に、事前作業環境でパフォーマンスへの影響をテストしてください。
接続の失敗または再試行のエントリが見つかった場合は、アウトバウンドファイアウォールのポート 443 が開いていることを確認します。
接続の失敗または再試行のエントリが見つからなかった場合は、MuleSoft テクニカルサポートまでお問い合わせください。
Titanium サブスクリプションでハイブリッドランタイムサーバーを使用している場合、AM インストーラーが v.2.5.10 以降であれば、Anypoint Monitoring へのログ転送を無効化できます。この機能を無効化するには、ログ転送を無効化する各ハイブリッドサーバーで JVM プロパティを設定する必要があります。アプリケーションごとにログ転送を無効化することはできません。
ログ転送を無効化する手順は、次のとおりです。
Anypoint Monitoring エージェントを、ログ転送の無効化をサポートしているバージョン (am-2.5.10.0.zip 以降) にアップグレードします。
Mule を停止します。
MULE_HOME/conf/wrapper.conf
ファイルに次の行を追加します (<N>
は次に空いているプロパティインデックス):
wrapper.java.additional.<N>=-Danypoint.platform.monitoring.logs_forwarding.enabled=false
Mule を再起動します。