ハイブリッドデプロイメントの Monitoring のセットアップ

オンプレミスサーバーに Anypoint Monitoring エージェントをインストールし、そのサーバー上で実行されていて、CloudHub で管理されているアプリケーションを監視できます。

Anypoint Monitoring エージェントは、監視データを Anypoint Monitoring クラウドエンドポイントに送信します。Anypoint Monitoring データの送信には、高効率の双方向バイナリチャネル経由でログデータを転送するためのオープンソースプロトコルが使用されます。データは相互 TLS 暗号化を使用してセキュアに送信されます。

サーバーグループまたはクラスター全体で Anypoint Monitoring を使用するには、個々のサーバーに Anypoint Monitoring をインストールする必要があります。

始める前に

Anypoint Monitoring エージェントをインストールする前に、サーバーで Mule Runtime Engine インスタンスをセットアップして実行します。案内については、Run Mule Runtime Engine On-Premisesを参照してください。

アウトバウンドファイアウォールがある場合は、ポート 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

ポート

リージョン 名前 ポート

US

anypoint.mulesoft.com

443

US

mule-manager.anypoint.mulesoft.com

443

US

runtime-manager.anypoint.mulesoft.com

443

US

analytics-ingest.anypoint.mulesoft.com

443

US

arm-auth-proxy.prod.cloudhub.io

443

US

data-authenticator.anypoint.mulesoft.com

443

US

exchange-files.anypoint.mulesoft.com

443

US

exchange2-asset-manager-kprod.s3.amazonaws.com

443

US-GOV

runtime-manager.gov.anypoint.mulesoft.com

443

US-GOV

gov.anypoint.mulesoft.com

443

US-GOV

exchange-files.gov.anypoint.mulesoft.com

443

US-GOV

exchange2-asset-manager-kgprod.s3.us-gov-west-1.amazonaws.com

443

EU

eu1.anypoint.mulesoft.com

443

EU

mule-manager.eu1.anypoint.mulesoft.com

443

EU

runtime-manager.eu1.anypoint.mulesoft.com

443

EU

analytics-ingest.eu1.anypoint.mulesoft.com

443

EU

arm-auth-proxy.prod-eu.msap.io

443

EU

data-authenticator.eu1.anypoint.mulesoft.com

443

EU

exchange2-asset-manager-kprod-eu.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 のサポート対象バージョン

サポート対象の Mule Runtime バージョンで Mule アプリケーションを実行します。サポート対象のバージョンについては、Mule Runtime Release Notesを参照してください。

Mule Runtime Manager エージェントのサポート対象バージョン

次のいずれかの Mule Runtime Manager エージェントバージョンが、サーバー上で実行されている Mule runtime engine にインストールされていることを確認します。

  • 2.6.x

  • 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 エージェントをインストールする

  1. 始める前に​の前提条件を満たします。

    Mule Runtime Engine がインストールおよび実行されている必要があります。

  2. CloudHub およびハイブリッド設定の管理の手順に従って、エージェントの ​am.zip​ ファイルをダウンロードし、Anypoint Monitoring の ​[Settings (設定)]​ からエージェントをインストールします。

    • am.zip​ ファイルを展開すると、ZIP を展開した場所に ​am​ というフォルダーが作成されます。

    • Anypoint Monitoring をサービスとしてインストールするかどうかをインストールスクリプトが尋ねます。

      • インストーラーによってサービスとしてプリセットしない場合は、​[No (いいえ)]​ を選択します。

      • -x​ 引数を指定したインストールスクリプトをコールすると、この確認を省略できます。この確認を省略すると、Anypoint Monitoring はサービスとしてインストールされません。

    • 既存の filebeat インスタンスが実行されているサーバーに Anypoint Monitoring エージェントをインストールすることはできません。

    • Anypoint Monitoring エージェントをサーバーグループのハイブリッドサーバーにインストールするときは、Runtime Manager を使用してサーバーを再起動し、Anypoint Monitoring がメトリクスの収集を開始できるようにします。

SOCKS5 プロキシ設定

データセンターから送信されるときに監視データをプロキシする場合、プロキシで SOCKS5 プロトコルがサポートされている必要があります。また、そのプロキシを介して通信するように Anypoint Monitoring エージェントを設定する必要があります。

SOCKS5 プロキシ用にエージェントを設定する手順は、次のとおりです。

  1. Runtime Manager と共にプロキシをセットアップします。​「Runtime Manager でのサーバーの作成」​を参照してください。

  2. 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 のエンコードルールに従ってパーセントエンコードする必要があります。

Anypoint Monitoring エージェントの稼働確認

  1. 設定が反映されるまで 10 分間待ちます。

  2. Anypoint Monitoring コンテンツへのアクセス権限​を持つユーザーアカウントを使用して Anypoint Platform にログインします。

  3. ナビゲーションバーまたは Anypoint Platform のメイン画面で ​[Monitoring (監視)]​ をクリックします。

  4. [Built-in Dashboards (組み込みダッシュボード)]​ ページで、Anypoint Monitoring エージェントをインストールしたサーバー上にデプロイされているアプリケーションを選択します。

  5. [CPU Utilization (CPU 使用率)] チャートと [Memory Utilization (メモリ使用量)] チャートにデータが表示されていることを確認します。
    チャートにデータが表示される場合、Anypoint Monitoring エージェントはインストールされて稼働しています。
    チャートにデータが表示されない場合、Anypoint Monitoring がエンドポイントに接続できることを確認します。

    必要に応じて、サーバーが接続を許可するように、エンドポイントをアウトバウンドファイアウォールルールの許可リストに追加できます。許可リストに追加するエンドポイントは、​「始める前に」​にリストされています。
  6. Anypoint Monitoring エージェントが稼働しているサーバーにログインします。

  7. データ転送エージェントのログファイルを開きます。ログファイルはパス ​./am/filebeat/logs​ にあります。

    Linux を使用しており、Anypoint Monitoring エージェントがサービスとして実行されている場合、ログファイルは ​/var/log/filebeat​ ディレクトリにあります。
  8. 接続の失敗または接続の再試行に関するエントリを探します。

Anypoint Monitoring エージェントの更新

Runtime Manager エージェントを更新する場合は、Anypoint Monitoring エージェントを再インストールする必要があります。

今後、いずれかの時点で Anypoint Monitoring エージェントの更新が必要になった場合は、次の手順に従います。

  1. Mule を停止します。

  2. am​ フォルダーで、次のコマンドを実行します。
    ./bin/uninstall

  3. am​ フォルダーを削除します。

  4. オンプレミスに ​Anypoint Monitoring エージェントをインストール​する手順を実行します。

  5. Mule を再起動します。

クラスターやサーバーグループの Mule Runtime を追加または削除する場合、Anypoint Monitoring エージェントを再インストールする必要があります。

パフォーマンスへの影響

監視を有効にすると、アプリケーション設定によっては CPU 使用率とメモリ使用量に影響を与えることがあります。最適なパフォーマンスとサイジングが維持できるように、本番環境で監視を有効化する前に、事前作業環境でパフォーマンスへの影響をテストしてください。

トラブルシューティング

  • 接続の失敗または再試行のエントリが見つかった場合は、アウトバウンドファイアウォールのポート 443 が開いていることを確認します。

  • 接続の失敗または再試行のエントリが見つからなかった場合は、MuleSoft テクニカルサポートまでお問い合わせください。

ハイブリッドランタイムサーバーでのログ転送の設定

高度な用途および Titanium サブスクリプションランク​で利用できる機能

AM インストーラーが v.2.5.10 以降であれば、Anypoint Monitoring へのログ転送を無効化できます。この機能を無効化するには、ログ転送を無効化する各ハイブリッドサーバーで JVM プロパティを設定する必要があります。アプリケーションごとにログ転送を無効化することはできません。

ログ転送を無効化する手順は、次のとおりです。

  1. Anypoint Monitoring エージェントを、ログ転送の無効化をサポートしているバージョン (am-2.5.10.0.zip 以降) にアップグレードします。

  2. Mule を停止します。

  3. MULE_HOME/conf/wrapper.conf​ ファイルに次の行を追加します (​<N>​ は次に空いているプロパティインデックス):
    wrapper.java.additional.<N>=-Danypoint.platform.monitoring.logs_forwarding.enabled=false

  4. Mule を再起動します。