---
schema_version: "1"
id: e27578f3c8f161a3555b5efbeac9058fa0ba501f3c985ce989ae43048d2b87fa
title: Runtime Manager エージェントのトラブルシューティング
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-manager/debugging-the-runtime-manager-agent.md
canonical_url: https://docs.mulesoft.com/jp/runtime-manager/debugging-the-runtime-manager-agent
source_site: docs.mulesoft.com
content_type: documentation
content_hash: d776c2aeb3f1884b376c010435309d8c13bc50763319375b306328ea4dcddafb
description: MuleSoft Documentation Site
latest: true
---
# Runtime Manager エージェントのトラブルシューティング

 [![logo server active](/mulesoft/current/ja-jp/_/img/icons/server-cloud.svg "Anypoint Platform PCE")Private Cloud Edition](deployment-strategies#anypoint-platform-private-cloud-edition)

オンプレミス Mule Runtime Engine と Runtime Manager エージェント間の接続に問題があると、Runtime Manager のサーバー監視ダッシュボードにメトリクスが表示されないなど、不一致が生じる可能性もあります。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><code>$MULE_HOME</code>​ は、Mule をインストールした場所を指定する環境変数です。 次の手順では、Mac または Linux 用のパスを使用しています。Windows を使用している場合は、​<code>$MULE_HOME</code>​ パスを ​<code>%MULE_HOME%</code>​ に置き換えてください。</td></tr></tbody></table>

## [](#エージェントと-mule-間の接続の問題をトラブルシューティングする)エージェントと Mule 間の接続の問題をトラブルシューティングする

接続の問題をトラブルシューティングする手順は、次のとおりです。

1. 使用している JVM を確認します。
    
    IBM JVM を使用している場合、Runtime Manager エージェントによってインストールされたデフォルトのトラストストアとは異なるトラストストアファイルを使用する必要があります。
    
    [「IBM JVM」](https://docs.mulesoft.com/jp/runtime-manager/servers-create#ibm-jvm)​を参照してください。
2. 必ず最新のエージェントバージョンを使用してください。
    
    1. エージェントバージョンを確認します。
        
        Runtime Manager ナビゲーションメニューで ​**\[Servers (サーバー)\]**​ を選択し、サーバー名をクリックします。 エージェントバージョンが ​**\[Dashboard (ダッシュボード)\]**​ ページに表示されます。
        
        ![サーバーの \[Dashboard (ダッシュボード)\] ページに表示された Runtime Manager エージェントバージョン](_images/rtm-agent-version.png)
        
        Figure 1. 矢印は、サーバーの ​**\[Dashboard (ダッシュボード)\]**​ ページに表示された Runtime Manager エージェントバージョンを示しています。
    2. ご使用の Mule バージョンと互換性がある最新のエージェントバージョンを判断するには、​[Runtime Manager エージェントのリリースノート](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​を確認してください。
    3. 必要に応じてエージェントを更新します。
        
        [「エージェントを更新する」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#update-the-agent)​を参照してください。
3. ライセンスと証明書の有効期限が切れていないことを確認します。
    
    1. Runtime Manager ナビゲーションメニューで ​**\[Servers (サーバー)\]**​ を選択し、サーバー名をクリックします。 有効期限は ​**\[Dashboard (ダッシュボード)\]**​ ページに表示されます。
        
        ![「Dashboard (ダッシュボード)」 ページに表示された有効期限](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-expirations.png)
        
        Figure 2. 矢印は、サーバーの ​**\[Dashboard (ダッシュボード)\]**​ ページに表示された有効期限を示しています。
        
        サーバーグループまたはクラスター内のサーバーのダッシュボードを表示するには、詳細ペインでサーバー名をクリックします。
        
        - ライセンスの有効期限が切れている場合は、​[「Enterprise ライセンスのインストール」](https://docs.mulesoft.com/on-premises/latest/installing-an-enterprise-license)​を参照してください。
        - 証明書の有効期限が切れている場合、​[「サーバー証明書の更新」](https://docs.mulesoft.com/jp/runtime-manager/servers-cert-renewal)​を参照してください。
4. すべての必要なホストとの接続を確認します。
    
    1. 必ず、Anypoint Platform サービス用に必要なホストおよびポートへのアクセスを許可してください。
        
        [「ポート、IP アドレス、ホスト名の許可」](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-allowlists)​を参照してください。
    2. ファイアウォールまたはプロキシサーバーによって Runtime Manager 証明書が傍受されていないことを確認します。
        
        [「プロキシサーバーが Runtime Manager 証明書を変更しないことの確認」](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config#verify-that-the-proxy-server-does-not-modify-the-runtime-manager-certificate)​を参照してください。
5. `mule-agent.yml`​ ファイルが破損していない、または空でないことを確認します。
    
    `mule-agent.yml`​ ファイルには、エージェントの設定情報が含まれます。 `$MULE_HOME/conf/mule-agent.yml`​ ファイルに非 ASCII 文字が含まれているか空である場合は、次の手順を実行してください。
    
    - バックアップがある場合は、それを使用して破損した ​`mule-agent.yml`​ ファイルを復元します。
    - バックアップがない場合は、次の手順を実行します。
        
        1. Runtime Manager から Mule サーバーを削除します。
            
            [「サーバーのシャットダウン、再起動、削除」](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)​を参照してください。
        2. エージェントをアンインストールします。
            
            [「エージェントのアンインストール」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#uninstall-the-agent)​を参照してください。
        3. エージェントをサポートされる最新バージョンに更新します。
            
            [「Runtime Manager エージェントのリリースノート」](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​と​[「エージェントを更新する」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#update-the-agent)​を参照してください。
        4. Mule サーバーを Runtime Manager に追加します。
            
            [「Runtime Manager へのサーバーの追加」](https://docs.mulesoft.com/jp/runtime-manager/servers-create)​を参照してください。

## [](#サポートのためにエージェントインストール情報を収集する)サポートのためにエージェントインストール情報を収集する

`$MULE_HOME/bin/amc_debug`​ スクリプトを使用すると、Anypoint Runtime Manager エージェントのインストールに関する問題をサポートがトラブルシューティングするのに必要な情報を収集できます。 トラブルシューティング手順を実行しても Runtime Manager エージェントに関する問題が解決されない場合、サポートチケットを入力する前にスクリプトを実行し、出力を保存します。

`amc_debug`​ スクリプトは次のアクションを実行します。

1. Mule エージェントの JVM プロセスを検出します。
2. スレッドダンプを抽出します (可能な場合は強制されません)。
3. 必要に応じてヒープダンプを抽出します (​`-heap`​ オプションを指定した場合)。
    
    このステップにより実行中のアプリケーションが遅延する可能性があります。
4. Java バージョン、CPU 使用量、メモリ使用量、ディスク使用量を抽出します。
5. すべてのログをコピーします。
6. Runtime Manager エージェントの設定ファイルをコピーします。
7. 収集したすべての情報を ZIP ファイルにアーカイブします。

### [](#amc_debug-スクリプトの実行)amc\_debug スクリプトの実行

`amc_debug`​ スクリプトを実行してエージェントのインストールに関する情報を収集するには、次の手順を実行します。

1. ターミナルウィンドウを開いて ​`$MULE_HOME/bin`​ フォルダーに移動します。
2. スクリプトを実行します。
    
    `./amc_debug`
    
    `-heap`​ オプションを指定して、他のデータに加えてヒープも抽出します。
    
    スクリプトが完了すると、​`$MULE_HOME/bin`​ フォルダーには ​`snapshot_202103161626.zip`​ のようなファイル名が付けられた ZIP ファイルが格納されます。
3. ZIP ファイルをサポートに送信します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><code>amc_debug</code>​ スクリプトは、現時点では Linux/Unix ベースのシステムでのみ使用できます。</td></tr></tbody></table>

## [](#関連情報)関連情報

- [Runtime Manager エージェントのインストールまたは更新](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)
- [イベント追跡](https://docs.mulesoft.com/jp/runtime-manager/event-tracking)
- [Runtime Manager エージェント通知](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-notifications)
- [Runtime Manager エージェントの拡張](https://docs.mulesoft.com/jp/runtime-manager/extending-the-runtime-manager-agent)
- [内部ハンドラーバッファ](https://docs.mulesoft.com/jp/runtime-manager/internal-handler-buffering)