# mulesoft Runtime Manager - Full Documentation

<!-- document id=c6a902914dc5b73d17eb74c631e0289b01132444cdb3d7feda37feb378e4302d url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-REST-connections.md -->

# amc\_setup パラメーターによる REST 接続の設定

 [![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)

REST 接続 ​`amc_setup`​ パラメーターは、Anypoint Platform の両方のバージョン (クラウドとオンプレミス) で動作し、Mule Runtime Engine と任意の外部クライアントとの直接の REST 接続が可能です。これによって、外部クライアントは ​[Runtime Manager エージェントの REST API](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-api)​ を使用して直接 Mule Runtime Engine にアクセスし、管理できます。

Runtime Manager エージェントを設定して、非セキュア接続またはセキュア接続のいずれかを許可できます。

セキュア REST 設定では、有効なデジタル証明書を使用して Runtime Manager エージェントを設定します。非セキュア REST 設定では、このステップをスキップできます。

## [](#非セキュア接続チャネル)非セキュア接続チャネル

暗号化されていない接続を使用するように Runtime Manager エージェントを設定するには、インストールコマンドラインで ​`-I`​ パラメーターを指定します。これは、REST トランスポートでのみ有効です。ブラウザーや、HTTP 要求を実行するその他のツールを使用して、API とのやりとりを行うことができます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-I</code>​</p>
</div>
<div class="paragraph">
<p><code>--insecure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Runtime Manager エージェントが暗号化されていない接続を使用するように設定します。</p>
</div>
<div class="paragraph">
<p>デフォルトの TCP ポートは 9999 です。そのため、ベース URL ​<code>http://localhost:9999/mule/agent/</code>​ で Runtime Manager エージェントに接続できます。</p>
</div></div></td>
</tr>
</tbody>
</table>

`-I`​ パラメーターによって生成された ​`mule-agent.yml`​ ファイルの例を次に示します。

```yaml
transports:
  websocket.transport:
    enabled: false

  rest.agent.transport:
    port: 9999

services:
  mule.agent.jmx.publisher.service:
    enabled: true
    frequency: 15
    frequencyTimeUnit: MINUTES
```

## [](#セキュア接続チャネル)セキュア接続チャネル

インストールコマンドラインで ​`-S`​ 引数を使用することで、TLS 接続を確立するように Runtime Manager エージェントを設定できます。このオプションでは、REST 通信用の TLS チャネルのみが有効になります。

このオプションは、エージェントを手動で管理する場合に使用できます。詳細な手順については、「​[コントロールプレーンを使用しない Mule Runtime Engine の双方向 TLS の設定](#コントロールプレーンを使用しない-mule-runtime-engine-の双方向-tls-の設定)​」を参照してください。

Anypoint Platform Runtime Manager クラウドコンソールを使用してエージェントを管理している場合は、「​[コントロールプレーンで管理される Mule Runtime Engine の双方向 TLS の設定](#コントロールプレーンで管理される-mule-runtime-engine-の双方向-tls-の設定)​」を参照してください。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-S</code>​</p>
</div>
<div class="paragraph">
<p><code>--secure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Runtime Manager エージェントがオンプレミス管理コンソールと TLS 接続を確立するように設定します。</p>
</div>
<div class="paragraph">
<p>キーストア (公開/非公開キーペア) とトラストストアのファイルを JKS 形式で提供します。</p>
</div></div></td>
</tr>
</tbody>
</table>

セキュア接続チャネルモードを選択すると、次のメニューが表示されます。

The communication channel for the agent will be encrypted using
public/private key certificates. The following steps prompt you
for the keystore and truststore.
Both keystore and truststore format must be JKS.

Keystore location (?):
Truststore location (?):
Keystore Password (?):
Keystore Alias (?):
Keystore Alias Password (?):
INFO: Mule agent was successfully configured to use a TLS channel for REST communications.

- **Keystore location (キーストアの場所)**​ (必須)
    
    通信チャネルを暗号化するためのキーストアファイルの場所を指定します。キーストアファイルは JKS 形式である必要があります。
- **Truststore location (トラストストアの場所)**
    
    管理コンソールからの要求を受信するためのトラストストアの場所を指定します。トラストストアは JKS 形式である必要があります。またパスワードは設定しないでください。
- **Keystore Password (キーストアパスワード)**
    
    エージェントがキーストアを読むために使用するパスワードを指定します。エージェントは、キーストアを開くときにもこのパスワードを使用します。
- **Keystore Alias (キーストアの別名)**
    
    キーストア内に保存された鍵の別名を指定します。
- **Keystore Alias Password (キーストアの別名のパスワード)**
    
    キーストア内の別名のパスワード。

`-S`​ パラメーターによって生成された ​`mule-agent.yml`​ ファイルの例を次に示します。

```yaml
transports:
  websocket.transport:
    enabled: false

  rest.agent.transport:
    restSecurity:
      keyStoreFile: server.jks
      keyStorePassword: P@ssword
      keyStoreAlias: serverkey
      keyStoreAliasPassword: P@ssword
    port: 9999

services:
  mule.agent.jmx.publisher.service:
    enabled: true
    frequency: 15
    frequencyTimeUnit: MINUTES
```

### [](#コントロールプレーンを使用しない-mule-runtime-engine-の双方向-tls-の設定)コントロールプレーンを使用しない Mule Runtime Engine の双方向 TLS の設定

Mule がコントロールプレーンに接続されていない場合に双方向 TLS を設定するには、​`amc_setup -S`​ オプションを使用します。

1. Runtime Manager エージェント (サーバー) を識別するキーストア (公開/非公開キーペア) を生成します。
    
    Runtime Manager エージェントのホスト名または IP アドレスに一致する CN を設定します。
    
    ```console
    echo "Generate a new keystore to identify the Runtime Manager agent. Use CN=localhost"
    
    keytool -keystore rmakeystore.jks -genkey -keyalg RSA -keypass mulesoft -storepass mulesoft -noprompt \
    -alias rma \
    -dname "CN=localhost, OU=Runtime Manager Agent, O=MuleSoft, L=San Francisco, S=Califorina, C=US"
    ```
2. Runtime Manager エージェントの証明書 (公開キーのみ) を DES 形式の証明書ファイルにエクスポートします。
    
    ```console
    echo "Export the rma alias' certificate from the rmakeystore.jks key store"
    keytool -export -alias rma -file rma.crt -keystore rmakeystore.jks -storepass mulesoft
    ```
3. Runtime Manager エージェントに接続する各 REST クライアントに対して、REST クライアントを識別するキーストア (公開/非公開キーペア) を生成します。
    
    ```console
    echo "Generate a new keystore to be used by client requestors. Use CN=localhost"
    keytool -keystore clientkeystore.jks -storepass mulesoft -genkey -keyalg RSA -keypass mulesoft -noprompt \
    -alias client \
    -dname "CN=localhost, OU=RMA Client, O=MuleSoft, L=San Francisco, S=California, C=US"
    ```
4. REST クライアントの証明書 (公開キーのみ) を DES 形式の証明書ファイルにエクスポートします。
    
    ```console
    echo "Export the client alias' certificate from the clientkeystore.jks key store"
    keytool -export -alias client -file client.crt -keystore clientkeystore.jks -storepass mulesoft
    ```
5. トラストストアファイルを作成します。
    
    ```console
    echo "Import client and server public keys into a common cacerts.jks truststore file"
    
    keytool -import -v -trustcacerts -alias rma -file rma.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    
    keytool -import -v -trustcacerts -alias client -file client.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    ```
    
    証明書ファイルは自己署名されているため、クライアントは認証機関 (CA) で証明書を検証することはできません。証明書に署名する CA をエミュレートするには、クライアント証明書と RMA 証明書 (公開キー) の両方が入ったトラストストアファイルを作成する必要があります。本番環境では、サーバーとクライアントの両方の証明書は信頼された CA によって署名され、クライアントマシンとサーバーマシンに対して公開または共有されます。
6. `rmakeystore.jks`​ ファイルと ​`cacerts.jks`​ トラストストアを使用して Mule Runtime Engine を設定します。
    
    `$MULE_HOME/bin`​ フォルダーで ​`./amc_setup -S`​ を実行します。
7. 生成した値の入力を促されたら、入力します。
    
    たとえば、これまでのコマンドを ​`/security`​ フォルダーから実行した場合は、次の値を入力します。
    
    ```console
    -> Mule Agent Unpacked
    
    
    
    The communication channel for the agent will be encrypted using public/private key certificates.
    The following steps prompt you for the keystore and truststore.
    Both keystore and truststore formats must be JKS.
    
    
    Keystore location (?):/security/rmakeystore.jks
    Keystore Password (?): mulesoft
    Truststore location (?):/security/cacerts.jks
    Keystore Alias (?):rma
    Keystore Alias Password (?): mulesoft
    
            INFO: Mule agent was successfully configured to use a TLS channel for REST communications.
    
    
    > more ..\conf\mule-agent.yml
    
    transports:
      websocket.transport:
        enabled: false
    
      rest.agent.transport:
        restSecurity:
          keyStoreFile: clientkeystore.jks
          keystorePassword: mulesoft
          keyStoreAlias: client
          keyStoreAliasPassword: mulesoft
        port: 9999
    
    services:
      mule.agent.jmx.publisher.service:
        enabled: true
        frequency: 15
        frequencyTimeUnit: MINUTES
    ```
    
    このコマンドは、​`/security/cacerts.jks`​ トラストストアファイルを ​`$MULE_HOME/conf`​ フォルダーにインポートして、名前を ​`anypoint-truststore.jks`​ に変更します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Runtime Manager エージェントバージョン 1.11.0 以降では、デフォルトのトラストストアの名前は ​<code>anypoint-truststore.jks</code>​ になります。Runtime Manager エージェントの以前のバージョンでは、デフォルトの名前は ​<code>truststore.jks</code>​ でした。</td></tr></tbody></table>
8. Mule Runtime Engine を再起動し、Runtime Manager エージェントの REST インターフェースが正常に起動したことを確認します。
9. Mule Runtime Engine のログに SSL デバッグを追加します。
    
    `./mule -M-Djavax.net.debug=all`

### [](#コントロールプレーンで管理される-mule-runtime-engine-の双方向-tls-の設定)コントロールプレーンで管理される Mule Runtime Engine の双方向 TLS の設定

Mule がコントロールプレーンに接続されている場合に双方向 TLS を設定する手順は、次のとおりです。

1. Runtime Manager エージェント (サーバー) を識別するキーストア (公開/非公開キーペア) を生成します。
    
    Runtime Manager エージェントのホスト名または IP アドレスに一致する CN を設定します。
    
    ```console
    echo "Generate a new keystore to identify the Runtime Manager agent. Use CN=localhost"
    
    keytool -keystore rmakeystore.jks -genkey -keyalg RSA -keypass mulesoft -storepass mulesoft -noprompt \
    -alias rma \
    -dname "CN=localhost, OU=Runtime Manager Agent, O=MuleSoft, L=San Francisco, S=Califorina, C=US"
    ```
2. Runtime Manager エージェントの証明書 (公開キーのみ) を DES 形式の証明書ファイルにエクスポートします。
    
    ```console
    echo "Export the rma alias' certificate from the rmakeystore.jks key store"
    keytool -export -alias rma -file rma.crt -keystore rmakeystore.jks -storepass mulesoft
    ```
3. Runtime Manager エージェントに接続する各 REST クライアントに対して、REST クライアントを識別するキーストア (公開/非公開キーペア) を生成します。
    
    ```console
    echo "Generate a new keystore to be used by client requestors. Use CN=localhost"
    keytool -keystore clientkeystore.jks -storepass mulesoft -genkey -keyalg RSA -keypass mulesoft -noprompt \
    -alias client \
    -dname "CN=localhost, OU=RMA Client, O=MuleSoft, L=San Francisco, S=California, C=US"
    ```
4. REST クライアントの証明書 (公開キーのみ) を DES 形式の証明書ファイルにエクスポートします。
    
    ```console
    echo "Export the client alias' certificate from the clientkeystore.jks key store"
    keytool -export -alias client -file client.crt -keystore clientkeystore.jks -storepass mulesoft
    ```
5. クライアント証明書と RMA 証明書の両方が入ったトラストストアファイルを作成します。
    
    ```console
    echo "Import client and server public keys into a common cacerts.jks truststore file"
    
    keytool -import -v -trustcacerts -alias rma -file rma.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    
    keytool -import -v -trustcacerts -alias client -file client.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    ```
    
    証明書ファイルは自己署名されているため、クライアントは認証機関 (CA) で証明書を検証することはできません。証明書に署名する CA をエミュレートするには、クライアント証明書と RMA 証明書 (公開キー) の両方が入ったトラストストアファイルを作成する必要があります。本番環境では、サーバーとクライアントの両方の証明書は信頼された CA によって署名され、クライアントマシンとサーバーマシンに対して公開または共有されます。
6. `anypoint-truststore.jks`​ ファイルと ​`mule-agent.yml`​ ファイルをバックアップします。
    
    ```console
    cp anypoint-truststore.jks anypoint-truststore.jks.bkp
    cp mule-agent.yml mule-agent.yml.bkp
    ```
7. Anypoint Platform 証明書を DES 形式の証明書ファイルにエクスポートします。
    
    パスワードが求められた場合は Enter を押します。
    
    ```console
    keytool -export -alias hybrid -file hybrid.crt -keystore anypoint-truststore.jks
    ```
8. クライアント、RMA、および Anypoint Platform の証明書が入ったトラストストアファイルを作成します。
    
    keytool -import -v -trustcacerts -alias rma -file rma.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    keytool -import -v -trustcacerts -alias client -file client.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    keytool -import -v -trustcacerts -alias hybrid -file hybrid.crt -keystore cacerts.jks -keypass mulesoft -storepass mulesoft -noprompt
    
    証明書ファイルは自己署名されているため、クライアントは認証機関 (CA) で証明書を検証することはできません。これらの証明書に署名する CA をエミュレートするには、クライアント証明書と RMA 証明書の両方が入ったトラストストアファイルを作成する必要があります。コントロールプレーンとの接続を維持するには、トラストストアファイルに Anypoint Platform 証明書も入っている必要があります。本番環境では、サーバーとクライアントの両方の証明書は信頼された CA によって署名され、クライアントマシンとサーバーマシンに対して公開または共有されます。
9. Mule Runtime Engine をシャットダウンし、​`mule-agent.yml`​ ファイルを修正してセキュア REST API エンドポイントを設定します。
    
    transports:
      rest.agent.transport:
        restSecurity:
          keyStoreFile: rmakeystore.jks
          keyStorePassword: mulesoft
          keyStoreAlias: rma
          keyStoreAliasPassword: mulesoft
        port: 9995
10. 新しく作成した​`cacerts.jks`​ ファイルの名前を ​`anypoint-truststore.jks`​ に変更します。このファイルが、Runtime Manager エージェントと Anypoint Platform 接続で使用する新しいトラストストアになります。
    
    mv cacerts.jks anypoint-truststore.jks
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Runtime Manager エージェントバージョン 1.10.0 以降では、デフォルトのトラストストアの名前は ​<code>anypoint-truststore.jks</code>​ になります。Runtime Manager エージェントの以前のバージョンでは、デフォルトの名前は ​<code>truststore.jks</code>​ でした。</td></tr></tbody></table>
11. Mule Runtime Engine を起動して、Runtime Manager エージェント REST インターフェースが正常に立ち上がることと、まだ Anypoint Platform の Runtime Manager に接続されていることを確認します。
12. Mule のログに SSL デバッグを追加します。
    
    `./mule -M-Djavax.net.debug=all`

### [](#双方向-tls-rest-要求の送信)双方向 TLS REST 要求の送信

双方向 TLS REST 要求を送信するには、次の手順を実行します。

1. JKS キーストアを P12 キーストアに変換します。
    
    ```console
    echo "Export client keystore PKCS12 format from JKS"
    keytool -importkeystore -srckeystore clientkeystore.jks -srcstoretype JKS -srcstorepass mulesoft \
    -destkeystore clientkeystore.p12 -deststoretype PKCS12 -deststorepass mulesoft \
    -srcalias client -destalias client
    ```
2. `openssl`​ ツールを使用して、base64 でエンコードされた完全なクライアント証明書 (公開キーと非公開キー) のテキストファイルをエクスポートします。
    
    ```console
    echo "Export full PEM (public and private keys) for use by client requests (cURL)"
    openssl pkcs12 -in clientkeystore.p12 -passin pass:mulesoft \
    -out clientkeystore.pem -passout pass:mulesoft
    ```
    
    `clientkeystore.pem`​ ファイルを表示して、公開キーと非公開キーの両方がこのファイルにエクスポートされたことを確認できます。
3. クライアントホストから Runtime Manager エージェントホストに REST 要求を送信します。
    
    SSL エラーが表示されないことと、Runtime Manager エージェントから応答を受信したことを確認します。
    
    `--insecure`​ オプションを使用して、サーバー (Runtime Manager エージェント) の証明書の検証をスキップします。
    
    ```console
    $ curl -X GET https://localhost:9999/mule/agent/components --cert clientkeystore.pem --insecure
    
    Enter PEM pass phrase:
    
    [{"componentId":"components.configure.request.handler","enabled":true},{"componentId":"clustering.request.handler","enab
    led":true},{"componentId":"applications.request.handler","enabled":true},{"componentId":"domains.request.handler","enabl
    ed":true},{"componentId":"flows.request.handler","enabled":true},{"componentId":"installer.request.handler","enabled":tr
    ue},{"componentId":"logging.request.handler","enabled":true},{"componentId":"monitoring.request.handler","enabled":true}
    ,{"componentId":"properties.request.handler","enabled":true},{"componentId":"tracking.request.handler","enabled":true},{
    "componentId":"application.deployment.notification.internal.message.handler","enabled":true},{"componentId":"domain.depl
    oyment.notification.internal.message.handler","enabled":true},{"componentId":"flow.status.notification.internal.message.
    handler","enabled":true},{"componentId":"membership.change.notification.internal.message.handler","enabled":true},{"comp
    onentId":"primary.node.notification.internal.message.handler","enabled":true},{"componentId":"tracking.notification.inte
    rnal.message.handler","enabled":false},{"componentId":"mule.agent.tracking.handler.log","enabled":false},{"componentId":
    "mule.agent.gw.http.handler.log","enabled":false},{"componentId":"mule.agent.nagios.jmx.internal.handler","enabled":fals
    e},{"componentId":"mule.agent.tracking.handler.splunk","enabled":false},{"componentId":"mule.agent.gw.http.handler.splun
    k","enabled":false},{"componentId":"mule.agent.application.service","enabled":true},{"componentId":"mule.agent.clusterin
    g.service","enabled":true},{"componentId":"mule.agent.domain.service","enabled":true},{"componentId":"mule.agent.gw.http
    .service","enabled":false},{"componentId":"mule.agent.installer.service","enabled":true},{"componentId":"mule.agent.logg
    ing.service","enabled":true},{"componentId":"mule.agent.application.metrics.publisher.service","enabled":true},{"compone
    ntId":"mule.agent.jmx.publisher.service","enabled":true},{"componentId":"mule.agent.properties.service","enabled":true},
    {"componentId":"mule.agent.tracking.service","enabled":true}]
    ```

<!-- document id=fe2408c8dde69bdb92d60dfd53e733889859421154c797981e3bc7ffb0268c64 url=/mulesoft/current/ja-jp/runtime-manager/index.md -->

# Anypoint Runtime Manager

 [![logo cloudhub 2.0 active](/mulesoft/current/ja-jp/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)[ ![logo rtf active](/mulesoft/current/ja-jp/_/img/icons/cloud-gear.svg "Runtime Fabric")Runtime Fabric](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Runtime Manager は、アプリケーション、サーバー、API の統一されたビューを提供する [Anypoint Platform](https://anypoint.mulesoft.com)​ に対するインターフェースです。

Runtime Manager を使用すれば、Sandbox 環境、ステージング環境、本番環境で、1 か所から Mule アプリケーションをデプロイし、管理して監視できます。アプリケーションがクラウドまたはオンプレミスのどちらにデプロイされている場合でも使用できます。

Runtime Manager は次のシナリオで使用できます。

CloudHub

MuleSoft で CloudHub のアプリケーションデプロイメントがホストされ、 [Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールを使用してこれを管理します。

CloudHub は完全なサービスとしてのインテグレーションプラットフォーム (iPaaS) であり、オブジェクトストアインフラストラクチャ、監視、トラブルシューティング、スケジュールを含めて、設定やカスタマイズを行うことなく、自動的にあらゆるサーバーニーズに対応します。

CloudHub にデプロイされているアプリケーションの場合、インサイトを使用して分析と監視を行うことができます。

ハイブリッド

オンプレミス Mule サーバーでアプリケーションデプロイメントがホストされ、 [Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールを使用してこれを管理します。

オンプレミスでデプロイしているアプリケーションの場合、サードパーティの分析アプリケーションにデータを送信できます。

MuleSoft Government Cloud を使用している場合は、Mule Runtime Engine を非公開クラウドまたはオンプレミスの環境にデプロイして、MuleSoft Government Cloud コントロールプレーンを使用してアプリケーションデプロイメントを管理できます。MuleSoft Government Cloud の要件は、​[「Standalone Mule Support (スタンドアロン Mule のサポート)」](https://docs.mulesoft.com/jp/gov-cloud/gov-cloud-standalone)​を参照してください。

Anypoint Platform Private Cloud Edition

ローカル Mule サーバーでアプリケーションデプロイメントがホストされ、Anypoint Platform PCE が用意されているオンプレミスの Runtime Manager インスタンスを使用してこれを管理します。

オンプレミスの Runtime Manager を使用している場合は、CloudHub ​_以外の_​どこにでもデプロイできます。

プライベートクラウドサーバーにデプロイされているアプリケーションの場合、サードパーティの分析アプリケーションにデータを送信できます。

Anypoint Runtime Fabric

ローカルでホストされている Runtime Fabric インスタンスでアプリケーションデプロイメントがホストされ、 [Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールを使用してこれを管理します。

![rtm overview](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-overview.png)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Anypoint Studio でアプリケーションを実行すると、Studio の埋め込みテストサーバーにアプリケーションがデプロイされます。 このサーバーは本番デプロイメント用ではなく、アップタイム制限が適用されるため、Runtime Manager でサポートされているいずれかのデプロイメントオプションを使用して Mule アプリケーションをデプロイしてください。</td></tr></tbody></table>

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

- [CloudHub](https://docs.mulesoft.com/cloudhub/)
- [Anypoint Platform Private Cloud Edition](https://docs.mulesoft.com/private-cloud/latest/)
- [Anypoint Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/)
- [CloudHub へのデプロイ](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)
- [インサイト](https://docs.mulesoft.com/jp/runtime-manager/insight)
- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)

<!-- document id=f8a6d1ccf92977d685d954640d3fe46e6183f595524de31c90e4b21d0964e6b0 url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-jar-signature-validator.md -->

# JAR 署名バリデーター

デフォルトでは、アプリケーションバリデーターサービスは JAR 署名バリデーターを実装し、認証されていないアーティファクトのデプロイを禁止します。 アーティファクト JAR ファイルのそれぞれの署名済みエントリが、キーストアのいずれかの別名と一致する必要があります。 ランタイムにデプロイされたすべてのアーティファクトを検証するために使用するキーストアの別名を指定できます。期限切れの証明書で署名されたアーティファクトも使用できます。

## [](#jar-signatureバリデーターを設定する)JAR Signatureバリデーターを設定する

`$MULE_HOME/conf/mule-agent.yml`​ ファイルを変更して次を含めます。

```java
 services:
  mule.agent.artifact.validator.service:
    enabled: true
    validators:
    - type: jarSignatureValidator
      name: defaultJarSignatureValidator
      enabled: true
      args:
        truststore: signers-truststore.jks
        truststoreType: JKS
        truststoreAlias: code-signer-alias-1
        truststorePassword: '![PBEWITHSHA1ANDDESEDE,U/nA0wV714oNi9LHoAkDtiwg22ngG6b7yFTtg7fk2d4=]'
```

次のプロパティを使用して、JAR 署名バリデーターを設定します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 85.7143%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>type</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必須。  <code>jarSignatureValidator</code>​ は、Mule Runtime のデプロイメントに使用されるすべての JAR ファイルの署名を検証するために、Runtime Manager エージェントプラグインで実装されるバリデーター種別です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>name</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>必須。1 つのバリデーター種別は複数の実装を持つことができます。Runtime Manager エージェントで実装される ​<code>jarSignatureValidator</code>​ 種別の名前は ​<code>defaultJarSignatureValidator</code>​ です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>enabled</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能。バリデーターの実装を有効にするには ​<code>true</code>​、無効にするには ​<code>false</code>​ に設定します。デフォルト値は ​<code>true</code>​ です。</p>
</div></div></td>
</tr>
</tbody>
</table>

次の引数を使用して、JAR 署名バリデーターを設定します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 85.7143%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>トラストストア</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能。デプロイメントに使用するすべての JAR ファイルの署名を検証するために使用する 1 つ以上の証明書を含むトラストストアのファイル名。デフォルトの場所は ​<code>$MULE_HOME/conf</code>​ です。相対パスを使用してトラストストアファイルを参照できます。パスを指定しないと、バリデーターは JVM で使用する cacerts トラストストアファイルを読み込みます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>truststoreType</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能。  <code>JKS</code>​ (デフォルト) または ​<code>PKCS12</code>​。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>truststoreAlias</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>省略可能。トラストストアファイルに保存されている各証明書は、別名文字列で識別されます。このプロパティは、すべての JAR ファイルの検証に使用する単一の別名を指定します。別名を指定しなかった場合、バリデーターはトラストストアのすべての証明書を使用して JAR ファイルの署名を検証します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>truststorePassword</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JKS では省略可能ですが、PKCS12 では必須です。トラストストアファイルのパスワード。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#mule-runtime-engine-を起動する)Mule Runtime Engine を起動する

Mule Runtime Engine を起動し、バリデーターが正常に設定されたことを確認します。コンソールに次のログが表示されます。

```console
AgentApplicationValidatorService: Initializing Artifact Validator service
AgentApplicationValidatorService: Total validators loaded: 1
AgentApplicationValidatorService: Validators listed by type:
AgentApplicationValidatorService: Type: jarSignatureValidator Names: [defaultJarSignatureValidator]
```

## [](#ユースケース-1-信頼できるコード署名者によって署名された-jar-ファイルのデプロイ-成功)ユースケース 1: 信頼できるコード署名者によって署名された JAR ファイルのデプロイ - 成功

必要なファイル:

- `app-signed-by-trust-signer-01.jar`
- `signers-truststore.jks`

ファイル: `mule-agent.yaml`

```java
 services:
  mule.agent.artifact.validator.service:
    enabled: true
    validators:
    - type: jarSignatureValidator
      name: defaultJarSignatureValidator
      enabled: true
      args:
        truststore: signers-truststore.jks
        truststoreType: JKS
        truststorePassword: mulesoft
```

curl コマンド:

```copy
curl -X PUT 'http://localhost:9999/mule/applications/app-signed-by-trust-signer-01' \
     -H 'Content-Type: application/json' \
     -d '{"url": "file:/tmp/yahoo/app-signed-by-trust-signer-01.jar", \
          "configuration": {}
         }'
```

応答:

```json
{
  "application": {
     "name": "app-signed-by-trust-signer-01"
   },
  "status": "Deployment attempt started"
}
```

コンソールログ:

```console
AgentApplicationService: Deploying the app-signed-by-trust-signer-01 application from URL file:/tmp/yahoo/app-signed-by-trust-signer-01.jar
KeystoreUtils: Loading Jar Signers Truststore from '/private/tmp/trash/server-yahoo/conf/signers-truststore.jks'
JarSigner: Jar Signature verified: File /var/folders/sq/71l1hxdn171dpc46fn675yk80000gq/T/mule-received-artifact-5158252349422012120/app-signed-by-trust-signer-01.jar
AgentApplicationValidatorService: Application validation success for application: 'app-signed-by-trust-signer-01'
```

## [](#ユースケース-2-信頼できるコード署名者によって署名された-jar-ファイルをデプロイしトラストストアの別名署名者で検証-成功)ユースケース 2: 信頼できるコード署名者によって署名された JAR ファイルをデプロイし、トラストストアの別名署名者で検証 - 成功

必要なファイル:

- `app-signed-by-trust-signer-01.jar`
- `signers-truststore.jks`

ファイル: `mule-agent.yaml`

```java
 services:
  mule.agent.artifact.validator.service:
    enabled: true
    validators:
    - type: jarSignatureValidator
      name: defaultJarSignatureValidator
      enabled: true
      args:
        truststore: signers-truststore.jks
        truststoreType: JKS
        truststoreAlias: code-signer-alias-01
        truststorePassword: mulesoft
```

curl コマンド:

```copy
curl -X PUT http://localhost:9999/mule/applications/app-signed-by-trust-signer-01
     -H "Content-Type: application/json"
     -d '{"url": "file:/tmp/yahoo/app-signed-by-trust-signer-01.jar",\
          "configuration": {}
         }'
```

応答:

```json
{
  "application": {
     "name": "app-signed-by-trust-signer-01"
    },
  "status": "Deployment attempt started"
}
```

コンソールログ:

```console
AgentApplicationService: Deploying the app-signed-by-trust-signer-01 application from URL file:/tmp/yahoo/app-signed-by-trust-signer-01.jar
KeystoreUtils: Loading Jar Signers Truststore from '/private/tmp/trash/server-yahoo/conf/signers-truststore.jks'
JarSigner: Jar Signature verified using certificate alias 'code-signer-alias-01': File '/var/folders/sq/71l1hxdn171dpc46fn675yk80000gq/T/mule-received-artifact-3796117303843373481/app-signed-by-trust-signer-01.jar'
AgentApplicationValidatorService: Application validation success for application: 'app-signed-by-trust-signer-01'
```

## [](#ユースケース-3-期限切れのコード署名者によって署名された-jar-ファイルのデプロイ-失敗)ユースケース 3: 期限切れのコード署名者によって署名された JAR ファイルのデプロイ - 失敗

必要なファイル:

- `app-signed-by-expired-trusted-signer.jar`
- `signers-truststore.jks`

ファイル: `mule-agent.yaml`

```java
services:
  mule.agent.artifact.validator.service:
    enabled: true
    validators:
    - type: jarSignatureValidator
      name: defaultJarSignatureValidator
      enabled: true
      args:
        truststore: signers-truststore.jks
        truststoreType: JKS
        truststoreAlias: expired-code-signer
        truststorePassword: mulesoft
```

curl コマンド:

```copy
curl -X PUT http://localhost:9999/mule/applications/app-signed-by-expired-trusted-signer \
     -H "Content-Type: application/json"
     -d '{"url": "file:/tmp/yahoo/app-signed-by-expired-trusted-signer.jar", \
          "configuration": {}
         }'
```

応答:

```json
{
  "type": "class com.mulesoft.agent.exception.ApplicationValidationException",
  "message": "CertificateExpiredException - NotAfter: Wed Dec 22 14:45:54 AST 2021"
}
```

コンソールログ:

```console
AgentApplicationService: Deploying the app-signed-by-expired-trusted-signer application from URL file:/tmp/yahoo/app-signed-by-expired-trusted-signer.jar
KeystoreUtils: Loading Jar Signers Truststore from '/private/tmp/trash/server-yahoo/conf/signers-truststore.jks'
MuleAgentSignatureValidator: There was an error validating the certificate with the alias 'expired-code-signer' - CertificateExpiredException Reason: 'NotAfter: Wed Dec 22 14:45:54 AST 2021'
ApplicationsRequestHandler: Error performing the deployment of app-signed-by-expired-trusted-signer. Cause: ApplicationValidationException: CertificateExpiredException - NotAfter: Wed Dec 22 14:45:54 AST 2021
```

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

- [Runtime Manager エージェント](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent)
- [高度な用途](https://docs.mulesoft.com/jp/runtime-manager/advanced-usage)
- [アプリケーションバリデーターサービス](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-app-validator)

<!-- document id=08bc083256cde18747312e7f1305adfc535b9eed3c3af18ea0532e0c08056871 url=/mulesoft/current/ja-jp/runtime-manager/jmx-service.md -->

# JMX サービス

 [![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)

Runtime Manager エージェント JMX サービスを使用すると、特定の JMX メトリクスを追跡し、それらを外部サービスにパブリッシュできます。サービスを設定して、特定の bean を追跡したり、値をパブリッシュする頻度を変更したりできます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Runtime Manager エージェントでは、Mule 3.x のみで ​<code>mule.agent.jmx.publisher.service</code>​ を使用した JMX bean の監視をサポートしています。 Mule 4.x では、bean が JMX に公開されません。</td></tr></tbody></table>

## [](#jmx-パブリッシャー)JMX パブリッシャー

JMX サービスは、収集したすべてのメトリクスをパブリッシャーに送信し、パブリッシャーはメトリクスを外部監視ツールにパブリッシュします。サービス自体に、一般的に使用されるツール用のパブリッシャー例がいくつか用意されています。さらに、ニーズに合わせて独自のパブリッシャーを作成できます。

## [](#jmx-サービスの設定)JMX サービスの設定

### [](#操作-設定の取得)操作: 設定の取得

JMX サービス設定を取得します。

**要求:**

GET <Runtime Manager Agent URL>/mule/agent/mule.agent.jmx.publisher.service HTTP/1.1

**例:**

GET http://localhost:9999/mule/agent/mule.agent.jmx.publisher.service HTTP/1.1

**応答:**

```json
{
    "serviceHandlerTypes": [
        "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
    ],
    "injectedHandlers": [
        {
            "name": "com.mulesoft.agent.monitoring.publisher.CloudwatchMonitorPublisher",
            "path": "/mule/agent/cloudwatch.agent.monitor.publisher/configuration",
            "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
        },
        {
            "name": "com.mulesoft.agent.monitoring.publisher.GraphiteMonitorPublisher",
            "path": "/mule/agent/mule.agent.graphite.jmx.internal.handler/configuration",
            "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
        },
        {
            "name": "com.mulesoft.agent.monitoring.publisher.NagiosMonitorPublisher",
            "path": "/mule/agent/mule.agent.nagios.jmx.internal.handler/configuration",
            "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
        },
        {
            "name": "com.mulesoft.agent.monitoring.publisher.ZabbixMonitorPublisher",
            "path": "/mule/agent/mule.agent.zabbix.jmx.internal.handler/configuration",
            "type": "java.util.List<com.mulesoft.agent.domain.monitoring.Metric>"
        }
    ],
    "configurableFields": [
        {
            "name": "frequency",
            "valueType": "java.lang.Integer",
            "value": 15,
            "configurableType": "DYNAMIC"
        },
        {
            "name": "frequencyTimeUnit",
            "valueType": "java.util.concurrent.TimeUnit",
            "value": "MINUTES",
            "configurableType": "DYNAMIC"
        },
        {
            "name": "beans",
            "valueType": "[Lcom.mulesoft.agent.services.monitoring.JMXBean;",
            "value": [],
            "configurableType": "DYNAMIC"
        }
    ]
}
```

応答には、現在読み込まれているパブリッシャーのリストに加え、サービスの設定可能な項目とその値が含まれています (サービスの設定についての詳細は、「管理サービス」を参照してください)。

### [](#操作-設定の変更)操作: 設定の変更

次の操作は、サービスの現在の設定を変更します。

**要求:**

```json
PATCH <Runtime Manager Agent URL>/mule/agent/mule.agent.jmx.publisher.service HTTP/1.1

{
  "<parameter>": "<value>",
}
```

**例:**

```json
PATCH http://localhost:9999/mule/agent/myservice HTTP/1.1

{
  "frequencyTimeUnit": "SECONDS",
  "frequency": "150"
}
```

**応答 (成功した場合):**

HTTP 200

### [](#新しい-jmx-パブリッシャーの追加)新しい JMX パブリッシャーの追加

新しい JMX パブリッシャーを追加するには、Runtime Manager エージェントの ​`InternalMessageHandler`​ インターフェースを実装します。

カスタム JMX パブリッシャーは、次の要件を満たす必要があります。

- スレッドセーフである。
- `InternalMessageHandler`​ で定義されたハンドラーメソッドのすべてのパブリッシュロジックを実装している。

#### [](#jmx-パブリッシャーの記述)JMX パブリッシャーの記述

```java
@Named("my.company.jmx.publisher")
@Singleton
public class MyJMXPublisher<T> extends InternalMessageHandler<List<Metric>>{

    boolean handle(List<Metric> metrics){
          // TODO handle message
    }

    @Override
    public void enable(boolean state) throws AgentEnableOperationException {
        // TODO: enable the Handler
    }

    @Override
    public boolean isEnabled() {
        // TODO: return Handler status
    }
}
```

メトリクスクラスは次の項目を含む POJO です。

```java
/**
 * Time stamp when the metric was taken
 */
long timestamp;

/**
 * Name of the metric. In the case of a JXM metric it is the bean that was tracked + message
 */
String name;

/**
 * The numeric value of the metric
 */
Number value;
```

新しい JMX パブリッシャーを追加するには、クラスを含む JAR を Runtime Manager エージェントプラグイン内の ​`lib`​ フォルダーに置きます。

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

- [Runtime Manager エージェント API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/mule-agent-plugin-api/minor/1.1/pages/home/)

<!-- document id=3c3481543bcd0c8d5c5100ab2d31006bb90af638fa798e2479e5875dc3d2bef3 url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-config-yaml.md -->

# mule-agent.yml でのエージェント設定の更新

 [![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)

Runtime Manager エージェントをインストールするためのパラメーターを使用して ​`amc_setup`​ を実行すると、エージェントの設定が ​`$MULE_HOME/conf/mule-agent.yml`​ ファイルに書き込まれます。エージェントは、起動時にこのファイルから設定を読み込みます。

`mule-agent.yml`​ ファイルのパラメーターを手動で追加したり編集したりすることで、エージェントをさらに設定したり設定を変更したりできます。

一部のエージェントコンポーネントは、エージェント API を使用して実行中に設定できます。

## [](#mule-agent-yml-ファイルの構造)mule-agent.yml ファイルの構造

`mule-agent.yml`​ ファイルは次の構造を持ちます。

1. コンポーネント種別
    
    トランスポート、サービス、内部ハンドラー、外部ハンドラー
    
    1. コンポーネント名
        
        (例: `mule.agent.jmx.publisher.service`​)。
        
        1. コンポーネント設定
            
            コンポーネントには、複数の再帰的なレベルを含む複雑なオブジェクト設定を定義できます。

`mule-agent.yml`​ ファイルの例を次に示します。

```yaml
transports:
  rest.agent.transport:
    enabled: false
  websocket.transport:
    enabled: true
    consoleUri: wss://runtime-manager.anypoint.mulesoft.com:443/mule
    handshake:
      enabled: true
      body: null
globalConfiguration:
  security:
    keyStorePassword: keyStorePass
    keyStoreAlias: agent
    keyStoreAliasPassword: keyStoreAliasPass
  authenticationProxy:
    endpoint: https://data-authenticator.anypoint.mulesoft.com
internalHandlers:
  mule.agent.tracking.handler.analytics:
    enabled: false
services:
  mule.agent.logging.service:
    applicationLogLevels:
    - artifactName: application-1
      scopeLoggingConfigurations: []
    - artifactName: application-2
      scopeLoggingConfigurations: []
    enabled: true
```

## [](#rest-エージェントトランスポートと-websocket-トランスポートの両方の有効化)REST エージェントトランスポートと WebSocket トランスポートの両方の有効化

Runtime Manager に Mule Runtime Engine を登録すると、生成された ​`mule-agent.yml`​ によって REST エージェントトランスポートが無効になり、既存のすべての設定が置き換えられます。

反対に、​`./amc_setup -I`​ を実行すると、REST エージェントトランスポートが有効になり、WebSocket トランスポートが無効になります (Runtime Manager に接続するために使用された既存の WebSocket トランスポート設定が置き換えられます)。

両方のトランスポートを実行するには、​`mule-agent.yml`​ ファイルを次のように変更します。

```yaml
transports:
  websocket.transport:
    consoleUri: wss://mule-manager.anypoint.mulesoft.com:443/mule
    security:
      keyStorePassword: _password_
      keyStoreAlias: agent
      keyStoreAliasPassword: _password_
      handshake:
        enabled: true
        body:
          agentVersion: 1.1.0
          muleVersion: 3.7.0
          gatewayVersion: 2.0.2
  rest.agent.transport:
    port: 8888

services:
  mule.agent.jmx.publisher.service:
    enabled: true
    frequency: 15
    frequencyTimeUnit: MINUTES
```

## [](#外部分析ツールへのデータの送信)外部分析ツールへのデータの送信

Runtime Manager エージェントを使用して Runtime Manager から Splunk、ELK スタック、またはその他の外部ソフトウェアにデータを送信する場合は、​[「外部分析ツールへのデータのエクスポート」](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)​を参照してください。

## [](#jmx-監視公開サービス)JMX 監視公開サービス

MuleSoft には、いくつかのオープンソース JMX 監視公開モジュールがあり、Cloudwatch、Graphite、Nagios、Zabbix に対応しています。

- Cloudwatch パブリッシャー: ユーザーは Amazon Cloudwatch に JMX メトリクスを送信できます。
- Graphite: Graphite JMX メトリクスインテグレーションを提供します。
- Nagios: Nagios とのインテグレーションを提供します。
    
    このモジュールは、Mule Runtime Engine にすでに含まれています。
- Zabbix は、Zabbix インスタンスにメトリクスを送信します。

詳細は​[「JMX」](https://docs.mulesoft.com/jp/runtime-manager/jmx-service)​を参照してください。

## [](#ログの場所の設定)ログの場所の設定

エージェントが状態を記録するログの場所をデフォルトの ​`mule_agent.log`​ ファイル以外に変更できます。詳細は、​[「ログの設定」](https://docs.mulesoft.com/mule-runtime/latest/logging-in-mule#configuring-logs-for-runtime-manager-agent)​を参照してください。

このオプションは、Runtime Manager エージェント 1.5.2 以降を使用している場合のみサポートされます。

## [](#コールバック-url-の設定)コールバック URL の設定

Runtime Manager エージェントからの通知を外部または内部の URL に転送する場合は、​`mule-agent.yml`​ ファイルで REST エージェントトランスポート用の ​`callback`​ URL を設定してください。

詳細は、​[「Mule エージェント通知のコールバック URL の設定」](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-notifications#configure-the-mule-agent-notifications-callback-url)​を参照してください。

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

- [プロキシサーバー経由のエージェントへの接続](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config)
- [ポート、IP アドレス、ホスト名の許可](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-allowlists)
- [外部分析ツールへのデータのエクスポート (ハイブリッド)](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [JMX サービス](https://docs.mulesoft.com/jp/runtime-manager/jmx-service)
- [イベント追跡](https://docs.mulesoft.com/jp/runtime-manager/event-tracking)
- [Runtime Manager エージェント通知](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-notifications)
- [Runtime Manager エージェント API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/mule-agent-plugin-api/minor/1.1/pages/home/)

<!-- document id=5b199d886e84cb732c0cfa8798f7a70293f14e724ef6a985c1da903ad4278606 url=/mulesoft/current/ja-jp/runtime-manager/release-notes.md -->

# Runtime Manager Release Notes

- [Runtime Manager Release Notes](https://docs.mulesoft.com/jp/release-notes/runtime-manager/runtime-manager-release-notes)
- [Runtime Manager Agent Release Notes](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)

## [](#see-also)See Also

- [Known Issues](https://help.salesforce.com/s/issues)

<!-- document id=85ec0bba8aef7f3321fd6fd2868e59aed0e9cf73b25a7eb7958f99491a36266b url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-api.md -->

# Runtime Manager REST API

 [![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)

Runtime Manager REST API を使用すると、Runtime Manager の次の機能にプログラムでアクセスできます。

- サーバーの管理:
    
    - サーバーを登録する。
    - 登録済みサーバーのリストを取得する。
    - サーバーに関する情報を取得する。
    - サーバー名を変更する。
    - サーバーをシャットダウン、再起動、削除する。
    - サーバー証明書を更新する。
    - サーバーの登録トークンを取得する。
- サーバーグループの管理:
    
    - サーバーのリストからサーバーグループを作成する。
    - 登録済みサーバーグループのリストを取得する。
    - サーバーグループに関する情報を取得する。
    - サーバーグループに名前を付ける。
    - サーバーグループのサーバーを追加または削除する。
    - サーバーグループを削除する。
- クラスターの管理:
    
    - クラスターを作成する。
    - 登録済みクラスターのリストを取得する。
    - クラスターに関する情報を取得する。
    - クラスター名を変更する。
    - クラスターのサーバーを追加または削除する。
    - サーバーのクラスタリング情報を変更する。
    - クラスターを削除する。
- サーバー上のアプリケーションデプロイメントの管理:
    
    - アプリケーションをデプロイ、再デプロイ、アンデプロイする。
    - アプリケーションのデプロイメントと状況に関する情報を取得する。
    - デプロイ済みアプリケーションのフロー、スケジューラー、アラートを管理する。

API によってサポートされるすべての操作の対話型リファレンスは、 [「Runtime Manager REST サービス」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)​を参照してください。

Runtime Manager REST API マネージャーは、サーバーにデプロイされているオンプレミスアプリケーションのみを管理します。API を使用して CloudHub にデプロイされているアプリケーションを管理する方法は、 [「CloudHub API」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/cloudhub-api/)​を参照してください。

## [](#runtime-manager-api-の使用)Runtime Manager API の使用

Runtime Manager API の操作にアクセスするには、以下を行う必要があります。

1. API を使用して認証するには認証ベアラートークン (​AUTH\_BEARER\_TOKEN​) を生成します。
    
    アクセストークンを取得するには、組織のシステム管理者ロールが割り当てられたユーザーの Anypoint Platform ユーザー名とパスワードが必要です。 [「アクセス管理 API」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/pages/home/)​の [「認証」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/pages/Authentication/)​を参照してください。
    
    ユーザー名により、アクセスする環境が指定されます。 たとえば、ユーザー名が ​`consuela`​ で環境が ​`Development`​ の場合、ユーザー名は ​`consuela@Development`​ になります。 環境を指定しない場合の API のデフォルトは ​`Production`​ です。
2. 組織 ID (​ORG\_ID​) を取得します。
    
    [「アクセス管理 API」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/pages/home/)​の [`/api/me`](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/console/method/%234250/)​ エンドポイントを参照してください。
3. 環境 ID (​ENV\_ID​) を取得します。
    
    [「アクセス管理 API」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/pages/home/)​の [`/api/organizations/_ORG_ID_/environments`​_ORG\_ID_](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/minor/1.0/console/method/%234762/)​ エンドポイントを参照してください。

### [](#アプリケーションのリストの取得)アプリケーションのリストの取得

Runtime Manager を使用してオンプレミスでデプロイされたアプリケーションのリストを取得するには、次の ​`curl`​ コマンドを実行します。

curl -X GET \\
  --url https://anypoint.mulesoft.com/hybrid/api/v1/applications \\
  -H 'authorization: Bearer AUTH\_BEARER\_TOKEN' \\
  -H 'X-ANYPNT-ENV-ID: ENV\_ID' \\
  -H 'X-ANYPNT-ORG-ID: ORG\_ID'

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

- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [継続的デプロイメント](https://docs.mulesoft.com/jp/runtime-manager/continuous-deployment)

<!-- document id=4892037385c5386fe8d75b2e52b4e7d45b91b091da74feebb89161ba1a0c460e url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-agent.md -->

# 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)

Anypoint Runtime Manager エージェントは、Mule Runtime Engine との通信を可能にする Mule Runtime Engine のプラグインです。 Runtime Manager (MuleSoft が管理するクラウドコンソールと Anypoint Platform Private Cloud Edition の両方) では、このエージェントを使用して登録済みの Mule インスタンスと通信します。

Runtime Manager エージェントと Runtime Manager との通信がどのように行われるかについては、​[「デプロイメントオプション」](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)​を参照してください。

Runtime Manager は、Mule の Enterprise バージョンのみで使用でき、Community バージョンでは使用できません。 エージェントでは、Mule バージョン 3.6.0 以降がサポートされています。

外部システムからエージェント API をコールして Runtime Manager エージェントを使用し、Mule インスタンスを監視および制御したり、Mule のデータを外部システムに公開したりできます。Runtime Manager エージェントには次のような機能があります。

- アプリケーション、ドメイン、サーバーの制御:
    
    - アプリケーションをリスト、デプロイ、アンデプロイ、状況の取得、開始または停止する
    - ドメインをリスト、デプロイ、アンデプロイ、または再デプロイする (REST トランスポートのみ)
- 外部分析システムへの Mule メトリクスの公開

## [](#前提条件)前提条件

- Mule の最新バージョンがインストールされていること。
    
    最新バージョンのエージェントをダウンロードするには、​[「Download the Agent From MuleSoft Help Center (MuleSoft ヘルプセンターからのエージェントのダウンロード)」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#download-the-agent-from-the-support-portal)​を参照してください。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">エージェントのダウンロードには Enterprise サポートアカウントが必要です。</td></tr></tbody></table>
- Enterprise ライセンスが最新であること。
    
    Enterprise ライセンスの入手とインストールについては、​[「Enterprise ライセンスのインストール」](https://docs.mulesoft.com/on-premises/latest/installing-an-enterprise-license)​を参照してください。

## [](#インストールの場所)インストールの場所

Runtime Manager エージェントは、​`$MULE_HOME/plugins`​ ディレクトリにインストールされ、1 つの ​`mule-agent.yml`​ ファイルから設定を読み込みます。インストール手順とダウンロードリンクについては、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。

## [](#通信プロトコル)通信プロトコル

Runtime Manager エージェントでは、2 つの通信プロトコルがサポートされています。

- **WebSockets**
    
    エージェントから Runtime Manager (クラウドベースまたは PCE コンソール) への接続を確立します。
    
    エージェントを Runtime Manager に登録すると、エージェントは最初に Runtime Manager とのアウトバウンド HTTPS 接続を確立します。この接続は、Runtime Manager とエージェント間で、新しいセキュアな全二重 WebSocket 接続を確立します。Mule が起動すると、エージェントは Runtime Manager に安全に接続して、Runtime Manager コンソールを使用して Mule をリモートで監視してできるようにします。
    
    Mule の実行中にこのリンクがダウンすると、統計や分析のデータは WebSocket 接続が再確立されるまでバッファに格納されます。また、WebSockets 接続が切断された場合に備えた再接続戦略もあります。
    
    詳細は、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。
- **REST**
    
    Mule と外部クライアントとの直接 REST 接続 (セキュアまたは非セキュア) を可能にします。
    
    これによって、外部クライアントは ​[Runtime Manager エージェントの REST API](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-api)​ を使用して直接 Mule にアクセスし、管理できます。
    
    詳細は、​[「amc\_setup パラメーターによる REST 接続の設定」](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections)​を参照してください。

`mule-agent.yml`​ ファイルを手動で編集して、両方の通信接続でエージェントを設定できます。​[「REST エージェントトランスポートと WebSocket トランスポートの両方の有効化」](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-config-yaml#enable-both-rest-agent-transport-and-websocket-transport)​を参照してください。

## [](#外部システムへの接続)外部システムへの接続

Mule を外部システムに接続するようにエージェントのプラグインを設定できます。インストールスクリプト (​`amc_setup`​) のパラメーターを使用して、通信方式と外部システムを選択します。

また、MuleSoft は Runtime Manager 外部からの監視を可能にするオープンソースの Runtime Manager エージェントモジュールを提供しています。これらのモジュールは無保証で提供されており、MuleSoft からサポートを受けることはできません。これらのモジュールにアクセスするには、以下の GitHub リポジトリを参照してください。

エージェントモジュール (一般)

- [Mule 4.x エージェント](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-4.x/mule-agent-modules)
- [Mule 3.x エージェント](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-3.x/mule-agent-modules)

JMX パブリッシャーモジュール

- [Mule 4.x エージェント](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-4.x/mule-agent-modules/mule-agent-monitoring-publishers)
- [Mule 3.x エージェント](https://github.com/mulesoft/mule-agent-plugin/tree/master-mule-3.x/mule-agent-modules/mule-agent-monitoring-publishers)

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

- [Runtime Manager エージェントのインストールまたは更新](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)
- [amc\_setup パラメーター](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#amc_setup-parameters)
- [Runtime Manager エージェントアーキテクチャ](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-architecture)
- [JMX サービス](https://docs.mulesoft.com/jp/runtime-manager/jmx-service)
- [Runtime Manager エージェントの拡張](https://docs.mulesoft.com/jp/runtime-manager/extending-the-runtime-manager-agent)

<!-- document id=10689cd86e88239fa9feda2f4a456d1e3b6094a0323fdad18c8b4b59981fb354 url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-agent-api.md -->

# Runtime Manager エージェント API

Runtime Manager エージェント API により、REST API を使用してオンプレミスの Mule Runtime Engine を直接管理できます。

大半のユースケースでは、Runtime Manager エージェントのみをインストールして設定する必要があります。 Runtime Manager とオンプレミスの Mule インスタンス間の通信を管理する以外に Runtime Manager エージェントを使用するには、Runtime Manager エージェント API を使用します。

Runtime Manager エージェントの REST API を使用すると、次のエージェント機能にプログラムでアクセスできます。

- Mule アプリケーションのデプロイ。
- Mule ドメインのデプロイ。
- Mule サーバークラスターの作成。
- JMX beans の監視。
- システムプロパティの設定。
- ログレベルの設定。
- 次のような Mule エージェントプラグインの設定:
    
    - イベント追跡
    - Splunk の統合
    - ELK の統合

API によってサポートされるすべての操作の対話型リファレンスは、Exchange の [「Runtime Manager エージェント API」](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/mule-agent-plugin-api/minor/1.1/pages/home/)​を参照してください。

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

- [Runtime Manager エージェントのインストールまたは更新](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)
- [JMX サービス](https://docs.mulesoft.com/jp/runtime-manager/jmx-service)
- [Runtime Manager エージェント通知](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-notifications)

<!-- document id=f216d9bffac6475ba1c0562eb83716a2f618d7eb7850787dca83bc352b2646dd url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-agent-architecture.md -->

# 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)

Anypoint Runtime Manager エージェントは Mule JAVA API をサービスとして公開する Mule プラグインで、ユーザーは外部システムから Mule インスタンスを操作および監視することができます。

このドキュメントでは、Runtime Manager エージェントのアーキテクチャと主要コンポーネントの概要を説明します。

## [](#runtime-manager-エージェントの主要コンポーネント)Runtime Manager エージェントの主要コンポーネント

### [](#mule-サービス)Mule サービス

Mule に接続します。このコンポーネントでは、トランスポート層 (メッセージがユーザーによって、またはユーザーに伝達される方法) は認識されません。

### [](#トランスポート)トランスポート

通信層を処理します。キープアライブ状況、セキュリティ、プロトコルが含まれます。

### [](#外部メッセージハンドラー)外部メッセージハンドラー

Web サービス API をユーザーに公開します。受信メッセージ (デプロイメント要求など) はすべて外部メッセージハンドラーによって処理されます。要求に応じて 1 つまたは複数の Mule サービスが実行されます。

### [](#内部メッセージハンドラー)内部メッセージハンドラー

Mule 通知を受信するたびに Mule サービスによってコールされます。

## [](#メッセージング)メッセージング

エージェントには、次に示すように Mule と通信を行う 3 通りの方法があります。

### [](#同期通信)同期通信

例: デプロイされたアプリケーションを取得する。

![synchronous](/mulesoft/current/ja-jp/runtime-manager/_images/synchronous.png)

### [](#非同期通信)非同期通信

例: デプロイし、デプロイメントフェーズについて通知する。

![非同期](/mulesoft/current/ja-jp/runtime-manager/_images/asynchronous-agent.png)

### [](#プッシュ通信)プッシュ通信

例: JMX 情報を外部システムにプッシュする。

![プッシュ](/mulesoft/current/ja-jp/runtime-manager/_images/push-agent.png)

## [](#アーキテクチャ図)アーキテクチャ図

エージェントのアーキテクチャは非常に単純です。

- トランスポートが通信を処理します。
- 外部メッセージハンドラーがメッセージをディスパッチします。
- サービスが Mule に接続します。
- 内部メッセージハンドラーが Mule 通知をディスパッチします。

3 種類 (同期、非同期、プッシュ) のメッセージそれぞれについて、各コンポーネントの相互動作を次の図に示します。

![アーキテクチャ](/mulesoft/current/ja-jp/runtime-manager/_images/architecture-agent.png)

## [](#コンポーネントの相互動作)コンポーネントの相互動作

コンポーネントの相互動作の典型的な順序を次に示します。

1. 外部システムがエージェントに要求を送信します。
2. 外部メッセージハンドラーが実行され、インターフェースを使用して Mule サービスをコールします。
3. Mule サービスが Mule をコールし、対応するアクションを実行します。
4. Mule が通知で応答します。
5. サービスがその通知をエージェントの通知にマップし、その通知種別を処理する内部メッセージハンドラーを見つけます。
6. 対応する内部メッセージハンドラーが実行されます。

## [](#runtime-manager-エージェント設定)Runtime Manager エージェント設定

Runtime Manager エージェントは起動時に `$MULE_HOME/conf/mule-agent.yml` ファイルから設定を読み込みます。このファイルにインストールの設定パラメーターを手動で追加し、編集する必要があります。形式は一目瞭然です。サンプルファイルをダウンロードできます。

インストール時に、クイックスタートスクリプトを使用して Runtime Manager エージェントを設定することもできます。詳細は、 [「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)を参照してください。

## [](#設定可能なコンポーネント)設定可能なコンポーネント

コンポーネントの属性を `mule-agent.yml` ファイルで設定することができます。この目的のために、クラス属性に `@Configurable` として注釈を付けることができます。

```java
@Singleton
public class MyRequestHandler implements ExternalMessageHandler
{
    @Inject
    private MuleService muleService;

    @Configurable
    public String host;
    ...
}
```

## [](#runtime-manager-エージェントの-websocket-プロトコル)Runtime Manager エージェントの WebSocket プロトコル

エージェントへの WebSockets 経由の通信では HTTP プロトコルが実装されます。エージェントとの間で送受信されるすべてのメッセージは、WebSocket 経由で (エージェント設定に応じて) バイナリメッセージまたはテキストとして送信される HTTP メッセージです。これらの HTTP メッセージは、エージェントの REST 通信で使用されるものと同じです。

### [](#websocket-ハンドシェイク)WebSocket ハンドシェイク

ハンドシェイクは、WebSocket トランスポートに固有のプロセスです。スタートアップ時に、エージェントはコンソールに対応する (エージェント設定から取得される) WebSocket アドレスにハンドシェイク要求を送信します。この後、エージェントはハンドシェイク要求として認識できないすべての受信メッセージを無視します。ハンドシェイク要求として識別されるメッセージを受信すると、その応答が有効かどうかチェックされます。有効な場合は、エージェントはすべての受信メッセージへの応答を開始します。

#### [](#ハンドシェイク要求)ハンドシェイク要求

ハンドシェイク要求の例を次に示します。

POST handshake HTTP/1.1
Content-Type: application/json
Message-Id: ${messageId}
accept: application/json
Content-length: 1234

{
"agentVersion": "1.0.0",
"muleVersion": "${muleVersion}",
"uniqueId": "${uniqueId}"
}

#### [](#ハンドシェイク要求-2)ハンドシェイク要求

承認:

HTTP 200 OK
Message-Id: ${messageId}

未承認:

HTTP 401 UNAUTHORIZED
Message-Id: ${messageId}

<!-- document id=886e4d20b7146c0c2d27fe7d637ccf450bd19f8f8ea1d58e614b2e40a363c998 url=/mulesoft/current/ja-jp/runtime-manager/installing-and-configuring-runtime-manager-agent.md -->

# 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)

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

Runtime Manager エージェントは Mule Runtime Engine (Mule) を Runtime Manager に登録します。Mule を登録した後は、登録された特定の環境と Anypoint Platform ビジネスグループ内で Runtime Manager によって管理できます。単一の Mule を複数の Runtime Manager ビジネスグループまたは環境には登録できません。

エージェントを接続するコンソールの種別に応じたパラメーターを使用して、​`amc_setup`​ コマンドでエージェントをインストールして設定します。

- [Anypoint Platform Runtime Manager のクラウドベースコンソール](https://docs.mulesoft.com/jp/runtime-manager/%3C#Register Mule with the Cloud-Based Runtime Manager>)
- [Anypoint Platform Private Cloud Edition Runtime Manager コンソール](https://docs.mulesoft.com/jp/runtime-manager/%3C#Register Mule with Anypoint Platform PCE Runtime Manager>)

`amc_setup`​ を実行すると、エージェントは指定された設定オプションで ​`$MULE_HOME/conf/mule-agent.yml`​ を作成します。

最初のインストール後は、以下を行うことができます。

- `amc_setup`​ を再実行してエージェントの設定を変更する、またはエージェントのバージョンを更新する。
- `mule-agent.yml`​ を修正してエージェントの設定を変更する。
    
    JMX 監視の外部サービスへの拡張など、一部の設定オプションは ​`amc_setup`​ では使用できません。これらは手動で ​`mule-agent.yml`​ ファイルに追加する必要があります。​[mule-agent.yml でのエージェント設定の更新](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-config-yaml)​を参照してください。

<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 Runtime Engine を複数の Runtime Manager ビジネスグループまたは環境には登録しないでください。
- Mule を Runtime Manager に複数回登録しないでください。
- 古い Mule Management Console (MMC) と Runtime Manager の両方に Mule Runtime Engine を登録しないでください。
    
    Mule が MMC で管理されている場合は、​`amc_setup`​ を実行する前に MMC から登録を解除してください。
    
    MuleSoft サポートは、MMC から Runtime Manager への移行に役立つ移行スクリプトを提供しています。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">個別の JVM で Runtime Manager エージェントを実行することはできません。</td></tr></tbody></table>

## [](#互換性)互換性

使用している Mule Runtime Manager のバージョンをサポートしている Runtime Manager エージェントのバージョンが必要です。互換性については、​[Runtime Manager エージェントのリリースノート](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​で確認してください。

Mule 3.7.x 以前と API ゲートウェイバージョン 2.x 以前には、外部の分析ツールへのデータのエクスポートをサポートしない旧バージョンの Runtime Manager エージェントが含まれています。これらのバージョンを使用している場合は、エージェントの最新バージョンをダウンロードして更新してください。

### [](#runtime-manager-エージェントの互換性)Runtime Manager エージェントの互換性

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 60%;">
<col style="width: 20%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">Mule バージョン</th>
<th class="tableblock halign-left valign-top">Runtime Manager エージェントのバージョン</th>
<th class="tableblock halign-left valign-top">Java バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.3.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.3 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.4.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.27 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.4.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.4.28 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.5.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.5.6 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">4.6.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2.6.0 以降</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8,11,17</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">互換性の表に記載されているバージョンより前の Runtime Manager エージェントバージョンでは、互換性がなかったり、不整合が生じたりする可能性があります。</td></tr></tbody></table>

Java の互換性についての詳細は、[Java サポート](https://docs.mulesoft.com/jp/general/java-support)を参照してください。

## [](#前提条件)前提条件

- Enterprise ライセンスが最新であること。
- Mule 3.6.0 以降および API ゲートウェイ 2.1 以降が動作していること。
- エージェントをダウンロードする場合は、Enterprise サポートアカウントが必要です。

## [](#mule-インストールからのエージェントのインストール)Mule インストールからのエージェントのインストール

エージェントは、Mule Runtime Engine のインストールにバンドルされています。

ツールをインストールするには、次の手順を実行します。

1. [Mule をダウンロードしてインストールします](https://docs.mulesoft.com/on-premises/latest/runtime-installation-task)​。
2. 環境に応じたパラメーターを指定して ​`$MULE_HOME/bin/amc_setup`​ を実行します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。

## [](#zip-ファイルからエージェントをインストールします).zip ファイルからエージェントをインストールします。

使用しているソフトウェア配布に含まれているバージョン以外のエージェントが必要な場合は、サポートポータルからダウンロードしてください。

### [](#サポートポータルからのエージェントのダウンロード)サポートポータルからのエージェントのダウンロード

Mule Runtime Engine と Runtime Manager との互換性については、対応する ​[Runtime Manager エージェントのリリースノート](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-release-notes)​で確認してください。

エージェントをダウンロードするには、次の手順を実行します。

1. [MuleSoft ヘルプセンター](https://help.mulesoft.com/s/)​を開きます。
2. **\[Support (サポート)\]**​ タイルをクリックします。
3. 右上にある ​**\[Login (ログイン)\]**​ をクリックし、自分の Anypoint Platform 認証情報を使用してログインします。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">エージェントのダウンロードには Enterprise サポートアカウントが必要です。</td></tr></tbody></table>
4. MuleSoft サポートページで ​**\[Downloads (ダウンロード)\]**​ タブをクリックします。
5. **\[Mule Agent (Mule エージェント)\]**​ をクリックします。
6. エージェントを探して選択し、\[Action (アクション)\] 列で ​**\[Download (ダウンロード)\]**​ をクリックします。

### [](#エージェントのインストール)エージェントのインストール

ダウンロードした .zip ファイルからエージェントをインストールするには、次の手順を実行します。

1. Mule または API ゲートウェイランタイムを停止します。
2. ダウンロードした ​`agent-setup-​_VERSION_​.zip`​ ファイルを ​`$MULE_HOME/bin`​ に展開します。
    
    確認メッセージが表示されたら、競合するファイルをすべて上書きします。
3. 環境に応じたパラメーターを指定して ​`$MULE_HOME/bin/amc_setup`​ を実行します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
4. Mule または API ゲートウェイランタイムを再起動します。

## [](#エージェントを更新する)エージェントを更新する

以前のバージョンの ​`amc_setup`​ でエージェントをインストールしてある場合は、エージェントを更新して、現在のエージェント設定を ​`$MULE_HOME/conf/mule-agent.yml`​ に保持できます。

`mule-agent.yml`​ ファイルを保持する場合は、以下の変更が適用されます。

- バージョン 1.12.0 以降にアップグレードする場合:
    
    [「アップグレードの要件」](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-1.12.x-release-notes#1-12-0)​を参照してください。
- バージョン 2.2.0 以降にアップグレードする場合:
    
    [「アップグレードの要件」](https://docs.mulesoft.com/jp/release-notes/runtime-manager-agent/runtime-manager-agent-2.2.x-release-notes#2-2-0)​を参照してください。

既存の Runtime Manager エージェントを更新する手順は、次のとおりです。

1. Mule または API ゲートウェイランタイムを停止します。
2. ダウンロードした ​`agent-setup-​_VERSION_​.zip`​ ファイルを ​`$MULE_HOME/bin`​ に展開します。
3. 確認メッセージが表示されたら、競合するファイルをすべて上書きします。
4. `$MULE_HOME/bin/amc_setup -U`​ を実行します。
    
    `-U`​ パラメーターを使用して ​`amc_setup`​ を実行する場合は、コマンドラインで他のパラメーターを指定することはできません。
5. Mule または API ゲートウェイランタイムを再起動します。

Runtime Manager エージェントをアップグレードする場合は、Anypoint Monitoring エージェントのアンインストールスクリプトを実行してから、Anypoint Monitoring エージェントを再インストールする必要もあります。 [「Anypoint Monitoring エージェントの更新」](https://docs.mulesoft.com/jp/monitoring/am-installing#update-the-anypoint-monitoring-agent)​を参照してください。

### [](#エージェントを更新するときの処理)エージェントを更新するときの処理

エージェントを更新すると、​`amc_setup`​ スクリプトは以下の処理を行います。

- エージェントの現在のバージョンをバックアップします。
    
    - `$MULE_HOME/server-plugins/mule-agent-plugin`​ を ​`$MULE_HOME/tools/mule-agent-backup.zip`​ にアーカイブします。
    - カスタムモジュール (通常は ​`$MULE_HOME/server-plugins/mule-agent-plugin/lib/modules`​ にあります) を ​`$MULE_HOME/tools/mule-agent-modules-backup.zip`​ にアーカイブします。
- `$MULE_HOME/server-plugins/mule-agent-plugin/lib`​ 内のエージェントライブラリを更新します。
- 現在の ​`$MULE_HOME/conf/mule-agent.yml`​ 設定ファイルを保持します。
- `$MULE_HOME/server-plugins/mule-agent-plugin/lib/modules`​ のモジュールは変更しません。
    
    このディレクトリには、エージェントに追加された (エージェントの配布には含まれていない) カスタムモジュールが入っています。
- デフォルトのエージェントトラストストア名を ​`truststore.jks`​ から ​`anypoint-truststore.jks`​ に変更します (バージョン 1.11.0 または 2.1.4 以降への更新)。

## [](#エージェントをロールバックする)エージェントをロールバックする

エージェントの更新時に問題が発生するなどしてエージェントをロールバックする必要がある場合は、​`mule-agent-backup.zip`​ ファイルから以前のバージョンに復元します。 この ZIP ファイルには、エージェントのライブラリ、設定ファイル、コンパイルされたクラスが含まれます。

エージェントをロールバックする手順は、次のとおりです。

1. Mule または API ゲートウェイランタイムを停止します。
2. `mule-agent-plugin`​ ディレクトリに移動します。
    
    `cd $MULE_HOME/server-plugins/mule-agent-plugin`
3. `mule-agent-plugin`​ ディレクトリにいることを確認します。
    
    `pwd`
4. 既存のエージェントファイルを削除します。
    
    `rm -r *`
5. バックアップ ZIP ファイルを ​`mule-agent-plugin`​ フォルダーにコピーします。
    
    `cp $MULE_HOME/tools/mule-agent-backup.zip .`
6. バックアップ ZIP ファイルから以前のバージョンのエージェントを復元します。
    
    `unzip mule-agent-backup.zip`
7. バックアップ ZIP ファイルを削除します。
    
    `rm mule-agent-backup.zip`
8. Mule または API ゲートウェイランタイムを再起動します。

## [](#エージェントを無効化する)エージェントを無効化する

エージェントを無効化するには、次の手順を実行します。

1. Mule または API ゲートウェイランタイムを停止します。
2. 次のファイルを削除します。
    
    ```console
    $MULE_HOME/conf/mule-agent.jks
    $MULE_HOME/conf/mule-agent.yml
    ```
3. Mule または API ゲートウェイランタイムを再起動します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">エージェントは無効化されても起動しますが、いかなる操作も実行しません。</td></tr></tbody></table>

## [](#amc_setup-パラメーター)amc\_setup パラメーター

`amc_setup`​ のパラメーターを指定することにより、以下を行うことができます。

- Runtime Manager コンソールへの Mule の登録。
    
    - [\[Register Mule with the Cloud-Based Runtime Manager\]](<#Register Mule with the Cloud-Based Runtime Manager>)​。
    - [\[Register Mule with Anypoint Platform PCE Runtime Manager\]](<#Register Mule with Anypoint Platform PCE Runtime Manager>)​。
        
        Anypoint Platform PCE を使用して Mule を登録するには、追加の ​`amc_setup`​ パラメーターが必要です。​[\[PCE Runtime Manager amc\_setup Parameters\]](<#PCE Runtime Manager amc_setup Parameters>)​を参照してください。
- [プロキシサーバー経由で接続するためのエージェントの設定](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config#configure-the-agent-to-connect-through-a-proxy-server)​。
- [`mule-agent.yml`​ ファイルでのパスワードの暗号化](#encrypt_password)​。
- [ローカル Runtime Manager エージェントの REST API インターフェースを使用した Mule の管理](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections)​。
- [\[Update the Agent\]](<#Update the Agent>)​。

使用できるオプションを見るには、​`./amc_setup --help`​ を実行します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--help</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コマンドのヘルプをコマンドラインに表示します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-U</code>​</p>
</div>
<div class="paragraph">
<p><code>--update</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の ​<code>mule-agent.yml</code>​ 設定ファイルを保持したままエージェントを更新します。</p>
</div>
<div class="admonitionblock important">
<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<code>-U</code>​ を使用して以前のバージョンのエージェントを更新する場合は、コマンドラインで他のパラメーターを指定することはできません。
</td>
</tr>
</tbody></table>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-E</code>​</p>
</div>
<div class="paragraph">
<p><code>--encrypt</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>既存の ​<code>mule-agent.yml</code>​ ファイルでパスワードを暗号化します。</p>
</div>
<div class="paragraph">
<p>このオプションのみを使用してパスワードを暗号化します。
詳細は、​<a href="#Encrypt Passwords in an Existing mule-agent.yml File">[Encrypt Passwords in an Existing mule-agent.yml File]</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--decrypt</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>たとえばメインパスワードを変更する前に、既存の ​<code>mule-agent.yml</code>​ ファイルでパスワードを復号化します。</p>
</div>
<div class="paragraph">
<p>このオプションのみを使用してパスワードを復号化します。
詳細は、​<a href="#Update the Main Password">[Update the Main Password]</a>​および​<a href="#Display Passwords in mule-agent.yml in Plain Text">[Display Passwords in mule-agent.yml in Plain Text]</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--mule-home</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>mule-home-directory</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>$MULE_HOME</code>​ ディレクトリの場所を指定します。</p>
</div>
<div class="paragraph">
<p>インストールスクリプトを ​<code>$MULE_HOME/bin</code>​ 以外の場所から実行した場合は、このオプションを使用します。</p>
</div>
<div class="paragraph">
<p><em>amc_setup</em> スクリプトは、​<code>--mule-home</code>​ で指定されたディレクトリに対して相対的な ​<code>../conf</code>​ から ​<code>mule-agent.yml</code>​ ファイルを読み込みます。たとえば、​<code>--mule-home</code>​ の値が ​<code>/tmp/Mule/bin</code>​ であれば <em>amc_setup</em> は ​<code>mule-agent.yml</code>​ を ​<code>/tmp/Mule/conf</code>​ から読み込みます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--skip-gateway-clientid</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API ゲートウェイの ​<code>client_id</code>​ と ​<code>client_secret</code>​ の設定をスキップします。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-I</code>​</p>
</div>
<div class="paragraph">
<p><code>--insecure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>暗号化されていない REST 接続を使用するようにエージェントを設定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections#insecure-connection-channel" class="xref page">非セキュア接続チャネル</a>​を参照してください。</p>
</div>
<div class="paragraph">
<p>このパラメーターは、​<a href="#PCE Runtime Manager amc_setup Parameters">PCE ​<code>amc_setup</code>​ パラメーター</a>​と一緒に使用しないでください。</p>
</div>
<div class="paragraph">
<p>このオプションは、​<code>$MULE_HOME/conf/mule-agent.yml</code>​ のコンテンツを置き換えます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-S</code>​</p>
</div>
<div class="paragraph">
<p><code>--secure</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>オンプレミス管理コンソールと TLS 接続を確立するようにエージェントを設定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-REST-connections#secure-connection-channel" class="xref page">セキュア接続チャネル</a>​を参照してください</p>
</div>
<div class="paragraph">
<p>このパラメーターは、​<a href="#PCE Runtime Manager amc_setup Parameters">PCE ​<code>amc_setup</code>​ パラメーター</a>​と一緒に使用しないでください。</p>
</div>
<div class="paragraph">
<p>このオプションは、​<code>$MULE_HOME/conf/mule-agent.yml</code>​ のコンテンツを置き換えます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-H</code>​</p>
</div>
<div class="paragraph">
<p><code>--hybrid</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>token</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>server-name</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Anypoint Platform PCE または MuleSoft が管理するクラウドベースの Anypoint Platform のどちらかと接続するようにエージェントを設定します。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code><em>token</em></code>​ は、base64 でエンコードされた文字列で、Mule を Runtime Manager に登録するビジネスグループと環境を正確に指定します。</p>
</li>
<li>
<p><code><em>server-name</em></code>​ はインスタンス名で、Runtime Manager コンソールでこの Mule を識別します。</p>
<div class="paragraph">
<p>この名前は、ビジネスグループの環境内で一意である必要があります。</p>
</div>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-P</code>​</p>
</div>
<div class="paragraph">
<p><code>--proxy</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>proxy-host</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-port</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-user</em></code>​</p>
</div>
<div class="paragraph">
<p><code><em>proxy-password</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>接続に登録するときに使用するプロキシ設定を指定します。</p>
</div>
<div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config" class="xref page">「プロキシサーバー経由のエージェントへの接続」</a>​を参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-R</code>​</p>
</div>
<div class="paragraph">
<p><code>--region</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>region</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デプロイ先のリージョンを指定します。使用できるリージョンは ​<code>prod</code>​、​<code>eu1</code>​、​<code>us_gov</code>​ です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--fips</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>*nix ベースのサーバーで Mule 4 ランタイムの FIPS 140-2 コンプライアンスを有効にします。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#クラウドベースの-runtime-manager-を使用した-mule-の登録)クラウドベースの Runtime Manager を使用した Mule の登録

[![logo cloud disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-disabled.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-disabled.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Platform Runtime Manager のクラウドベースコンソールを使用して Mule を登録するには、以下が必要です。

- Anypoint Platform の特定のビジネスグループ用の特定の環境を識別する有効な登録トークン
- Runtime Manager コンソールで Mule を識別するインスタンス名

Mule を登録するには、次の手順を実行します。

1. Runtime Manager の左側のメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
2. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
3. サーバーの一意な名前を入力します。
    
    サーバー名には最大 60 文字の英数字 (a-z, A-Z、0-9)、ピリオド (.)、ハイフン (-)、アンダースコア (\_) を含めることができますが、スペースやその他の特殊文字は含めることができません。 Runtime Manager では、サーバー名で Unicode 文字がサポートされています。
    
    サーバー名は環境内で一意である必要がありますが、同じ組織が異なる環境に存在している場合は、同じサーバー名を使用できます。
    
    Runtime Manager により、​`amc_setup`​ コマンドが生成されます。 このコマンドには、指定したサーバー名 (​`_server-name_`​) と環境に Mule を登録するために必要な登録トークン (​`_token_`​) が含まれます。 登録トークンには、組織 ID と現在の環境が含まれます。
    
    ![「Add Server (サーバーを追加)」 ウィンドウの amc\_setup コマンド](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-add-server.png)
    
    Figure 1. 矢印は、​**\[Add Server (サーバーを追加)\]**​ ウィンドウの ​`amc_setup`​ コマンドを示しています。
4. **\[Copy command (コマンドをコピー)\]**​ をクリックしてコマンドをコピーします。
5. ターミナルウィンドウで次の操作を実行します。
    
    1. 登録する Mule インスタンスの ​`$MULE_HOME/bin`​ ディレクトリに変更します。
    2. `mule-agent.yml`​ ファイルでパスワードを暗号化する場合、​`AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
        
        `export AGENT_VAR_master_password=myPassword`
    3. コマンドラインにコマンドを貼り付けます。
    4. `amc_setup`​ コマンドラインで他のパラメーターを指定します。
        
        [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
        
        `amc_setup`​ コマンドの例を次に示します。
        
        ```console
        ./amc_setup -H myToken myMuleServer --proxy myProxy-host myProxy-port myProxy-user myProxy-password
        ```

`amc_setup`​ コマンドは ​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを生成します。

### [](#mule-agent-yml-ファイルの例)mule-agent.yml ファイルの例

暗号化されたパスワードを含めて、​`-H`​ オプションによって生成された ​`mule-agent.yml`​ ファイルの例を次に示します。

```yaml
transports:
  rest.agent.transport:
    enabled: false
  websocket.transport:
    consoleUri: wss://runtime-manager.anypoint.mulesoft.com:443/mule
    handshake:
      enabled: true
      body:
globalConfiguration:
  security:
    keyStorePassword: "![PBEWITHSHA1ANDDESEDE,WdPmAQMIC8Atr5iK4phjmbZbs9XFLLiH1eDhA7AmnpKUaPDhp40OB4uKZ6JUMW44]"
    keyStoreAlias: agent
    keyStoreAliasPassword: "![PBEWITHSHA1ANDDESEDE,WdPmAQMIC8Atr5iK4phjmbZbs9XFLLiH1eDhA7AmnpKUaPDhp40OB4uKZ6JUMW44]"
  authenticationProxy:
    endpoint: https://data-authenticator.anypoint.mulesoft.com:443
  proxyConfiguration:
    password: '![PBEWITHSHA1ANDDESEDE,VIs82yFDp66lnsL/Rss8q8js/zPDQ8+HJpdNepdZtA9obeDj5u+z4HIocsbLvXow]'
```

## [](#anypoint-platform-pce-runtime-manager-を使用した-mule-の登録)Anypoint Platform PCE Runtime Manager を使用した Mule の登録

[![logo cloud disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-disabled.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-disabled.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Platform Private Cloud Edition (Anypoint Platform PCE) を使用すると、すべての Runtime Manager サービスは、MuleSoft が管理するクラウド環境ではなくオンプレミスで実行されます。

PCE Runtime Manager で Mule を登録するには、次の手順を実行します。

1. Anypoint Platform PCE アカウントにログインします。
2. プラットフォームの DNS エントリが正しくセットアップされていることを確認します。
    
    [DNS or IP (DNS または IP)](https://docs.mulesoft.com/jp/access-management/private-cloud-edition-features#dns-or-ip)​ を参照してください。
3. Mule を登録するビジネスグループと環境を選択します。
4. 選択した環境の左側のメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
5. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
    
    Runtime Manager は、Mule を環境に登録するために使用する ​`_token_`​ および ​`_server-name_`​ と共に ​`amc_setup`​ コマンドを生成します。
    
    登録トークンには、組織の ID と現在の環境が含まれます。
6. **\[Copy (コピー)\]**​ をクリックしてこのコマンドをコピーします。
7. ターミナルウィンドウで、登録する Mule インスタンスの ​`$MULE_HOME/bin`​ ディレクトリに変更します。
8. コマンドラインにコマンドを貼り付けます。
9. インスタンス名 ​`server-name`​ を、Runtime Manager コンソールで Mule の表示ラベルとして使用する一意のインスタンス名に変更します。
10. `amc_setup`​ コマンドラインで他のパラメーターを指定します。
    
    [\[amc\_setup Parameters\]](<#amc_setup Parameters>)​を参照してください。
11. Runtime Manager が Mule インスタンスを管理するのに使用するサービスの URL を指定するパラメーターをコマンドラインに付加します。
    
    [\[PCE Runtime Manager amc\_setup Parameters\]](<#PCE Runtime Manager amc_setup Parameters>)​を参照してください。
    
    `amc_setup`​ コマンドの例を次に示します。
    
    ```console
    ./amc_setup -H myToken myMuleServer -A +http://$DOCKER_IP_ADDRESS:443/hybrid/api/v1+ -W "wss://AnypointPlatformHost:8889/mule" -C https://AnypointPlatformHost/accounts -F https://AnypointPlatformHost/apiplatform
    ```

`amc_setup`​ コマンドは ​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを生成します。

### [](#pce-runtime-manager-の-amc_setup-パラメーター)PCE Runtime Manager の amc\_setup パラメーター

Anypoint Platform PCE Runtime Manager を使用した Mule の登録で必要な追加のパラメーターを下表に示します。これらのパラメーターは、​`./amc_setup -H ​_token_​ ​_server-name_`​ コマンドに追加します。

これらのパラメーターは、REST API 接続を設定する ​`-I`​ パラメーターや ​`S`​ パラメーターとは一緒に使用しないでください。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 30%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">パラメーター</th>
<th class="tableblock halign-left valign-top">値</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-A</code>​</p>
</div>
<div class="paragraph">
<p><code>--amc-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>amc-host</em></code>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Runtime Manager のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.1:443/hybrid/v1</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>AMC_HOST</em>/hybrid/v1</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-W</code>​</p>
</div>
<div class="paragraph">
<p><code>--mcm-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>mcm-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>MCM のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>wss://10.0.0.2:8889/mule</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>MCM_HOST</em>/mule</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-C</code>​</p>
</div>
<div class="paragraph">
<p><code>--cs-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>core-services-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アクセス管理のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.3:443/accounts</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>core-services-host</em>​/accounts</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-D</code>​</p>
</div>
<div class="paragraph">
<p><code>--contract-caching-service-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>contract-caching-service-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>コントラクトキャッシュサービスのローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.4:8080</code>​)。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-F</code>​</p>
</div>
<div class="paragraph">
<p><code>--api-platform-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>api-platform-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>API Manager のローカルインスタンスのサービスの場所を示す URL を指定します (例: <code>https://10.0.0.5:443/apiplatform</code>​)。</p>
</div>
<div class="paragraph">
<p>サービスが使用可能かどうかは、​<code><em>API_PLATFORM_HOST</em>/apiplatform</code>​ でテストできます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>-Z</code>​</p>
</div>
<div class="paragraph">
<p><code>--auth-proxy-host</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code><em>auth-proxy-host</em></code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>認証プロキシのサービスの場所を示す URL を指定します (例:​<code>https://10.0.0.3:8080</code>​)。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#encrypt_password)既存の mule-agent.yml ファイルでのパスワードの暗号化

エージェントを Runtime Manager に登録するときに ​`AGENT_VAR_master_password`​ 環境変数を設定しなかった場合、後から ​`mule-agent.yml`​ ファイルで次のパスワードを暗号化できます。

- `keystorePassword`​: `mule-agent.jks`​ ファイルにアクセスするために使用するキーストアパスワード
- `keystoreAliasPassword`​: `mule-agent.jks`​ ファイルにアクセスするために使用するキーストアの別名パスワード
- `password`​: プロキシサーバーに対する認証に使用するパスワード

### [](#前提条件-2)前提条件

- Runtime Manager エージェントバージョン 2.4.17
    
    以前のバージョンのエージェントを更新するには、​[\[Update the Agent\]](<#Update the Agent>)​を参照してください。

### [](#パスワードを暗号化する)パスワードを暗号化する

`mule-agent.yml`​ ファイルのパスワードを暗号化する手順は、次のとおりです。

1. `AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myPassword`
2. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`
    
    暗号化ユーティリティでは、​`mule-agent.yml`​ ファイルの ​`keystorePassword`​ 項目、​`keystoreAliasPassword`​ 項目、​`password`​ 項目のパスワードが暗号化されたパスワードに置き換えられます。たとえば、次のようになります。
    
    ```yaml
    globalConfiguration:
      security:
        keyStorePassword: '![PBEWITHSHA1ANDDESEDE,Fe4kl2UBnGRoyh7H2v9lq+QSG7Pe6ZP8k34xmZEHmcAb1jABAwPLk2xWrGtSt1iE]'
        keyStoreAlias: agent
        keyStoreAliasPassword: '![PBEWITHSHA1ANDDESEDE,EtqRDPq7UTxDHzZGpOGazfcveEi832Pqm1mqhlwYRGLZGh9NSNXie6nAZr09b3iT]'
      authenticationProxy:
        endpoint: https://data-authenticator.anypoint.mulesoft.com:443
      proxyConfiguration:
        password: '![PBEWITHSHA1ANDDESEDE,VIs82yFDp66lnsL/Rss8q8js/zPDQ8+HJpdNepdZtA9obeDj5u+z4HIocsbLvXow]'
    ```

暗号化されたパスワードは、先頭が ​`!`​ で角括弧 ​`[ ]`​ で囲まれます。

### [](#パスワードを更新して再暗号化する)パスワードを更新して再暗号化する

`mule-agent.yml`​ ファイルの暗号化されたパスワードを更新する手順は、次のとおりです。

1. `mule-agent.yml`​ を編集します。
2. 暗号化されたパスワードを新しいプレーンテキストのパスワードに置き換えます。
3. `AGENT_VAR_master_password`​ 環境変数を設定します。
    
    `export AGENT_VAR_master_password=myPassword`
4. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`

### [](#プレーンテキストでの-mule-agent-yml-のパスワードの表示)プレーンテキストでの mule-agent.yml のパスワードの表示

`mule-agent.yml`​ のパスワードをプレーンテキストで表示するには、復号化ユーティリティを実行します。

`$MULE_HOME/bin/amc_setup --decrypt`

このコマンドにより、プレーンテキストのパスワードが含まれる ​`mule-agent.yml`​ ファイルのコンテンツが出力されます。

### [](#メインパスワードを更新する)メインパスワードを更新する

メインパスワードを更新する手順は、次のとおりです。

1. 復号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --decrypt`
2. `AGENT_VAR_master_password`​ 環境変数を新しいメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myNewPassword`
3. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt`

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

- [Enterprise ライセンスのインストール](https://docs.mulesoft.com/on-premises/latest/installing-an-enterprise-license)
- [Mule の開始と停止](https://docs.mulesoft.com/on-premises/latest/starting-and-stopping-mule-esb)
- [Runtime - API ゲートウェイ](https://docs.mulesoft.com/jp/mule-gateway/mule-gateway-overview)
- [Runtime Manager エージェントアーキテクチャ](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-architecture)
- [Runtime Manager でのサーバーの作成 (ハイブリッド)](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [Anypoint Private Cloud インストーラー](https://docs.mulesoft.com/private-cloud/latest/install-workflow)

<!-- document id=e27578f3c8f161a3555b5efbeac9058fa0ba501f3c985ce989ae43048d2b87fa url=/mulesoft/current/ja-jp/runtime-manager/debugging-the-runtime-manager-agent.md -->

# 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)

<!-- document id=d9c6422eebc27fbce69e42307bf9005dafd7a71bc83c431651c28ef794647985 url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-agent-notifications.md -->

# 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)

Anypoint Runtime Manager エージェントは、Mule インスタンスで発生するイベントに関する通知を JSON 形式でパブリッシュします。 これによって、通知を受信および処理するシステムを実装できます。 通知は REST および WebSocket トランスポートの両方で送信されます。 トランスポートについての詳細は、​[「Runtime Manager エージェントのアーキテクチャ」](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-architecture)​を参照してください。

## [](#エージェント通知のコールバック-url-の設定)エージェント通知のコールバック URL の設定

Runtime Manager エージェント通知を REST トランスポートで特定の URL に転送するには、​`mule-agent.yml`​ ファイルで ​`callback`​ URL を設定してください。

`callback`​ URL を設定する手順は次のとおりです。

1. `mule-agent.yml`​ ファイルに ​`callback`​ URL を追加します。
    
    ```yaml
    transports:
      rest.agent.transport:
        enabled: true
        callback:
          url: http://localhost:8080/
        port: 8888
    ```
    
    `port`​ と ​`url`​ の値は、通知を受け取る外部サーバーによって異なります。
    
    URL の末尾には URL へのパスがエージェントによって付加されるため、設定する URL の最後はスラッシュ (​`/`​) である必要があります。
2. Mule Runtime Engine を再起動します。

## [](#アプリケーションデプロイメントの通知)アプリケーションデプロイメントの通知

アプリケーションのデプロイ中またはアンデプロイ中に状態が変化するたびに、Runtime Manager エージェントから通知が送信されます。通知は ​`PUT`​ 要求によって ​`applications/<appname>/deployment`​ パスに送信されます。

PUT <callback URL>/applications/<application name>/deployment HTTP/1.1

### [](#通知の例)通知の例

```json
{
  "application": {
    "name": "applicationName",
    "domain": "domainName",
    "state": "STARTED"
  },
  "status": "DEPLOYED",
  "message": "Application successfully deployed."
}
```

### [](#通知の項目)通知の項目

各アプリケーションデプロイメントの通知の項目は次のとおりです。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>application</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションに関する次の情報が含まれます。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>アプリケーション名</p>
</li>
<li>
<p>アプリケーションがデプロイされるドメインの名前</p>
</li>
<li>
<p>アプリケーションの現在の状態</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>アプリケーションの全状態のリストは、「​<a href="#アプリケーションの状態とデプロイメントの状況">アプリケーションの状態とデプロイメントの状況</a>​」セクションを参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>status</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デプロイメントの現在の状況。デプロイメント操作の完了後、メッセージは ​<code>DEPLOYED</code>​ のまま変わりません。アンデプロイメント操作の後、メッセージは ​<code>UNDEPLOYED</code>​ のまま変わりません。</p>
</div>
<div class="paragraph">
<p>すべての状況メッセージのリストは、「​<a href="#アプリケーションの状態とデプロイメントの状況">アプリケーションの状態とデプロイメントの状況</a>​」セクションを参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>message</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">現在のデプロイメントフェーズについての情報メッセージ。デプロイメントが失敗した場合、失敗の理由についての情報がこのメッセージ含まれます。</p></td>
</tr>
</tbody>
</table>

## [](#ドメインデプロイメントの通知)ドメインデプロイメントの通知

ドメインのデプロイ中またはアンデプロイ中に状態が変化するたびに、Runtime Manager エージェントから通知が送信されます。

通知は PUT 要求によって ​`domains/<domainname>/deployment`​ パスに送信されます。

PUT <callback URL>/domains/<domain name>/deployment HTTP/1.1

### [](#通知の例-2)通知の例

```json
"domain": {
    "name": "domainName",
    "applications": [
      {
        "name": "application1",
        "domain": "domainName",
        "state": "STARTED"
      },
      {
        "name": "application2",
        "domain": "domainName",
        "state": "STOPPED"
      },
    ]
  },
  "status": "DEPLOYED",
  "message": "Domain successfully deployed."
}
```

### [](#通知の項目-2)通知の項目

各ドメインデプロイメントの通知の項目は次のとおりです。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>domain</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ドメインに関する次の情報が含まれます。</p>
</div>
<div class="ulist">
<ul>
<li>
<p>ドメイン名</p>
</li>
<li>
<p>次を含む、ドメインにデプロイされたアプリケーションのリスト。</p>
<div class="ulist">
<ul>
<li>
<p>アプリケーション名</p>
</li>
<li>
<p>ドメイン名</p>
</li>
<li>
<p>アプリケーションの状況</p>
</li>
</ul>
</div>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>status</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>デプロイメントの現在の状況。デプロイメント操作の完了後、メッセージは ​<code>DEPLOYED</code>​ のまま変わりません。アンデプロイメント操作の後、メッセージは ​<code>UNDEPLOYED</code>​ のまま変わりません。</p>
</div>
<div class="paragraph">
<p>すべての状況メッセージのリストは、「​<a href="#アプリケーションの状態とデプロイメントの状況">アプリケーションの状態とデプロイメントの状況</a>​」セクションを参照してください。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>message</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">現在のデプロイメントフェーズについての情報メッセージ。デプロイメントが失敗した場合、失敗の理由についての情報がこのメッセージ含まれます。</p></td>
</tr>
</tbody>
</table>

## [](#キープアライブ通知)キープアライブ通知

Runtime Manager エージェントは、定期的にキープアライブ通知を送信し、Mule インスタンスがまだ実行中であることを確認します。通知は、​`POST`​ 要求に空の本文を含めて ​`keepAlive`​ パスに送信されます。

POST <callback URL>/keepAlive HTTP/1.1

## [](#アプリケーションの状態とデプロイメントの状況)アプリケーションの状態とデプロイメントの状況

### [](#アプリケーション状態)アプリケーション状態

アプリケーションの状態は、Mule アプリケーションのライフサイクルのさまざまなフェーズを表します。

アプリケーションの状態のリストについては、​[「アプリケーションの状況の状態」](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#application_status_states)​を参照してください。

### [](#デプロイメントの状況)デプロイメントの状況

デプロイメントの状況は、アプリケーションまたはドメインの正常なデプロイメントまたはアンデプロイメントのさまざまなステップを表します。

有効なデプロイメントの状況のリストについては、​[「アプリケーションのデプロイメントの状態」](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#application_deploy_states)​を参照してください。

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

- [mule-agent.yml でのエージェント設定の更新](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-config-yaml)

<!-- document id=bbbf1811bce3e906918ba1602d06e4281357c073dd7b14d4696413bec43294ff url=/mulesoft/current/ja-jp/runtime-manager/sending-api-analytics-from-arm-to-db.md -->

# Runtime Manager から外部データベースへの API Analytics の送信

API ゲートウェイランタイムで動作している Mule アプリケーションからの HTTP API Analytics データをデータベースに保存するように Runtime Manager を設定できます。

サードパーティソフトウェアへのデータの送信は、ローカルサーバーにデプロイされたアプリケーションのみで行えます。 CloudHub にデプロイされたアプリケーションでは使用できません。

このデータを Splunk、ELK、またはその他のサードパーティソフトウェアに送信する方法については、​[「外部分析ツールへのデータのエクスポート」](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)​を参照してください。

## [](#前提条件)前提条件

次のソフトウェアがインストールされていることを確認してください。

- API ゲートウェイスタンドアロンバージョン 2.1.0 以降
- Runtime Manager エージェントバージョン 1.3.0 以降
    
    エージェントの更新については、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。

## [](#api-analytics-追跡データベース内部ハンドラーのインストール)API Analytics 追跡データベース内部ハンドラーのインストール

使用している Runtime Manager エージェントのバージョンによっては、API Analytics 追跡データベース内部ハンドラーの ZIP ファイルをインストールする必要があります。

次のエージェントバージョンでは、必要な JAR ファイルがエージェントプラグインに含まれているため、ZIP ファイルのインストールは不要です。

- 1.14.3 以降
- 2.4.5 以降

次のエージェントバージョンでは、ZIP ファイルを手動でダウンロードしてインストールする必要があります。

- 1.14.2 以前
- 2.4.4 以前

ZIP ファイルをインとする手順は次のとおりです。

1. API Analytics 追跡データベース内部ハンドラーの ZIP ファイル (​`mule-agent-internal-handlers-db-1.5.1.zip`​) をサポートに要求します。
2. ZIP ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ フォルダーに展開します。

## [](#エージェントの設定可能項目)エージェントの設定可能項目

最新の Runtime Manager エージェントと API Analytics 追跡データベース内部ハンドラーを API ゲートウェイスタンドアロンサーバーにインストールしたら、​`{MULE_HOME}/conf/mule-agent.yml`​ 設定ファイルを変更して内部ハンドラーを有効にします。

次の MySQL Server、Oracle、Microsoft SQL Server の設定例では、必須項目は ​`driver`​、​`jdbcUrl`​、​`user`​、​`pass`​ です。 分析が保存される場所を指定する ​`apiAnalyticsTable`​ 項目も設定できます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">データ型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>driver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーとの通信に使用される JDBC ドライバー。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>jdbcUrl</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーの JDBC URL。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>user</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーに接続するために使用するユーザー名。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>pass</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーに接続するために使用するパスワード。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>apiAnalyticsTable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントがイベントを保存するテーブルの名前。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">省略可能</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>MULE_API_ANALYTICS</code>​</p></td>
</tr>
</tbody>
</table>

## [](#mysql-の設定例)MySQL の設定例

次の例は、MySQL データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ)スキーマ

```sql
CREATE TABLE MULE_API_ANALYTICS (
  id                           CHAR(36)     NOT NULL,
  api_id                       INT          NOT NULL,
  api_name                     VARCHAR(64)  NULL,
  api_version                  VARCHAR(150) NULL,
  api_version_id               INT          NOT NULL,
  application_name             VARCHAR(42)  NULL,
  client_id                    VARCHAR(255) NULL,
  client_ip                    VARCHAR(45)  NOT NULL,
  event_id                     VARCHAR(36)  NOT NULL,
  host_id                      VARCHAR(255) NULL,
  org_id                       VARCHAR(36)  NULL,
  path                         VARCHAR(500) NOT NULL,
  policy_violation_policy_id   VARCHAR(50)  NULL,
  policy_violation_policy_name VARCHAR(150) NULL,
  policy_violation_outcome     VARCHAR(10)  NULL,
  received_ts                  VARCHAR(30)  NOT NULL,
  replied_ts                   VARCHAR(30)  NOT NULL,
  request_bytes                INT          NOT NULL,
  request_disposition          VARCHAR(10)  NOT NULL,
  response_bytes               INT          NOT NULL,
  status_code                  INT          NOT NULL,
  transaction_id               VARCHAR(36)  NULL,
  user_agent                   VARCHAR(500) NULL,
  verb                         VARCHAR(8)   NOT NULL,
  PRIMARY KEY (id)
);
```

バージョン 2.3.0 より前の Runtime Manager エージェントから移行する場合、スキーマを更新する必要があります。 次の移行スクリプトを使用して、MySQL で ​`policy_violation_policy_id`​ データ種別を更新できます。

```sql
ALTER TABLE MULE_API_ANALYTICS MODIFY policy_violation_policy_id VARCHAR(50) NULL;
```

### [](#内部ハンドラー設定)内部ハンドラー設定

1. 次の場所から MySQL JDBC ドライバーをダウンロードします。
    
    `[http://dev.mysql.com/downloads/connector/j/](http://dev.mysql.com/downloads/connector/j/)`
2. ZIP ファイルを抽出します。
3. `mysql-connector-java-{VERSION}.jar`​ ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.gw.http.handler.database:
        enabled: true
        driver: com.mysql.jdbc.Driver
        jdbcUrl: jdbc:mysql://192.168.61.128/mule
        user: root
        pass: test
    ```

## [](#oracle-の設定例)Oracle の設定例

次の例は、Oracle データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ-2)スキーマ

```sql
CREATE TABLE MULE_API_ANALYTICS (
  id                           CHAR(36)     NOT NULL,
  api_id                       INT          NOT NULL,
  api_name                     VARCHAR(64)  NULL,
  api_version                  VARCHAR(150) NULL,
  api_version_id               INT          NOT NULL,
  application_name             VARCHAR(42)  NULL,
  client_id                    VARCHAR(255) NULL,
  client_ip                    VARCHAR(45)  NOT NULL,
  event_id                     VARCHAR(36)  NOT NULL,
  host_id                      VARCHAR(255) NULL,
  org_id                       VARCHAR(36)  NULL,
  path                         VARCHAR(500) NOT NULL,
  policy_violation_policy_id   VARCHAR(50)  NULL,
  policy_violation_policy_name VARCHAR(150) NULL,
  policy_violation_outcome     VARCHAR(10)  NULL,
  received_ts                  VARCHAR(30)  NOT NULL,
  replied_ts                   VARCHAR(30)  NOT NULL,
  request_bytes                INT          NOT NULL,
  request_disposition          VARCHAR(10)  NOT NULL,
  response_bytes               INT          NOT NULL,
  status_code                  INT          NOT NULL,
  transaction_id               VARCHAR(36)  NULL,
  user_agent                   VARCHAR(500) NULL,
  verb                         VARCHAR(8)   NOT NULL,
  PRIMARY KEY (id)
);
```

バージョン 2.3.0 より前の Runtime Manager エージェントから移行する場合、スキーマを更新する必要があります。 たとえば、次の移行スクリプトを使用して、Oracle 11g XE で ​`policy_violation_policy_id`​ データ種別を更新できます。

```sql
ALTER TABLE MULE_API_ANALYTICS ADD temp VARCHAR(50);
update MULE_API_ANALYTICS set temp=cast(policy_violation_policy_id as VARCHAR(50));
ALTER TABLE MULE_API_ANALYTICS DROP COLUMN policy_violation_policy_id;
ALTER TABLE MULE_API_ANALYTICS RENAME COLUMN temp TO policy_violation_policy_id;
```

### [](#内部ハンドラー設定-2)内部ハンドラー設定

1. 次の場所から Oracle JDBC ドライバーをダウンロードします。
    
    `[https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)`
2. GZ ファイルを抽出します。
3. JAR ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.gw.http.handler.database:
        enabled: true
        driver: oracle.jdbc.OracleDriver
        jdbcUrl: jdbc:oracle:thin:@192.168.61.128/XE
        user: root
        pass: test
    ```

## [](#microsoft-sql-server-の設定例)Microsoft SQL Server の設定例

次の例は、Microsoft SQL Server データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ-3)スキーマ

```sql
CREATE TABLE MULE_API_ANALYTICS (
  id                           CHAR(36)     NOT NULL,
  api_id                       INT          NOT NULL,
  api_name                     VARCHAR(64)  NULL,
  api_version                  VARCHAR(150) NULL,
  api_version_id               INT          NOT NULL,
  application_name             VARCHAR(42)  NULL,
  client_id                    VARCHAR(255) NULL,
  client_ip                    VARCHAR(45)  NOT NULL,
  event_id                     VARCHAR(36)  NOT NULL,
  host_id                      VARCHAR(255) NULL,
  org_id                       VARCHAR(36)  NULL,
  path                         VARCHAR(500) NOT NULL,
  policy_violation_policy_id   VARCHAR(50)  NULL,
  policy_violation_policy_name VARCHAR(150) NULL,
  policy_violation_outcome     VARCHAR(10)  NULL,
  received_ts                  VARCHAR(30)  NOT NULL,
  replied_ts                   VARCHAR(30)  NOT NULL,
  request_bytes                INT          NOT NULL,
  request_disposition          VARCHAR(10)  NOT NULL,
  response_bytes               INT          NOT NULL,
  status_code                  INT          NOT NULL,
  transaction_id               VARCHAR(36)  NULL,
  user_agent                   VARCHAR(500) NULL,
  verb                         VARCHAR(8)   NOT NULL,
  PRIMARY KEY (id)
);
```

バージョン 2.3.0 より前の Runtime Manager エージェントから移行する場合、スキーマを更新する必要があります。 次の移行スクリプトを使用して、Microsoft SQL Server 2014 で ​`policy_violation_policy_id`​ データ種別を更新できます。

```sql
ALTER TABLE MULE_API_ANALYTICS ALTER COLUMN policy_violation_policy_id VARCHAR(50) NULL;
```

### [](#内部ハンドラー設定-3)内部ハンドラー設定

1. 次の場所から SQL Server 用の Microsoft JDBC ドライバーをダウンロードします。
    
    `[https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=11774](https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=11774)`
2. `sqljdbc%version%.tar.gz`​ ファイルを抽出します。
3. 適切な ​`sqljdbc%version%.jar`​ ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.gw.http.handler.database:
        enabled: true
        driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
        jdbcUrl: jdbc:sqlserver://192.168.61.128:1433;databaseName=Mule;
        user: root
        pass: test
    ```

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

- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [Runtime Manager REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=020e26f7f3012432b47c71bcc42b94393e5b91079d299d3ca374792625c6581d url=/mulesoft/current/ja-jp/runtime-manager/sending-event-data-from-arm-to-db.md -->

# 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 Manager を設定できます。

サードパーティソフトウェアへのデータの送信は、ローカルサーバーにデプロイされたアプリケーションのみで行えます。 CloudHub にデプロイされたアプリケーションではサポートされません。

## [](#前提条件)前提条件

次のソフトウェアがインストールされていることを確認してください。

- Mule バージョン 3.6 以降
- API ゲートウェイスタンドアロンバージョン 2.1.0 以降
- Runtime Manager エージェントバージョン 1.3.0 以降
    
    エージェントの更新については、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。

## [](#イベント追跡データベース内部ハンドラーのインストール)イベント追跡データベース内部ハンドラーのインストール

使用している Runtime Manager エージェントのバージョンによっては、イベント追跡データベース内部ハンドラーの ZIP ファイルをインストールする必要があります。

次のエージェントバージョンでは、必要な JAR ファイルがエージェントプラグインに含まれているため、ZIP ファイルのインストールは不要です。

- 1.14.3 以降
- 2.4.5 以降

次のエージェントバージョンでは、ZIP ファイルを手動でダウンロードしてインストールする必要があります。

- 1.14.2 以前
- 2.4.4 以前

ZIP ファイルをインとする手順は次のとおりです。

1. イベント追跡データベース内部ハンドラーの ZIP ファイル (​`mule-agent-internal-handlers-db-1.5.1.zip`​) をサポートに要求します。
2. ZIP ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ フォルダーに展開します。

## [](#エージェントの設定可能項目)エージェントの設定可能項目

最新の Runtime Manager エージェントとイベント追跡データベース内部ハンドラーを API ゲートウェイにインストールしたら、​`{MULE_HOME}/conf/mule-agent.yml`​ 設定ファイルを変更して内部ハンドラーを有効にします。

次の MySQL Server、Oracle、Microsoft SQL Server の設定例では、必須項目は ​`driver`​、​`jdbcUrl`​、​`user`​、​`pass`​ です。 イベントデータが保存される場所を指定する ​`eventsTable`​ 項目、​`annotationsTable`​ 項目、​`businessTable`​ 項目も設定できます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
<col style="width: 20%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">データ型</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">型</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>driver</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーとの通信に使用される JDBC ドライバー。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>jdbcUrl</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーの JDBC URL。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>user</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーに接続するために使用するユーザー名。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>pass</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">データベースサーバーに接続するためのパスワード。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必須</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>eventsTable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントがイベントを保存するテーブルの名前。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">省略可能</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>MULE_EVENTS</code>​</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>annotationsTable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントがメインイベントに関連付けられた注釈を保存するテーブルの名前。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">省略可能</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>MULE_EVENTS_ANNOTATIONS</code>​</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>businessTable</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String (文字列)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントがメインイベントに関連付けられたカスタムビジネスイベントを保存するテーブルの名前。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">省略可能</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>MULE_EVENTS_BUSINESS</code>​</p></td>
</tr>
</tbody>
</table>

## [](#mysql-の設定例)MySQL の設定例

次の例は、MySQL データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ)スキーマ

```sql
CREATE TABLE MULE_EVENTS (
  id                  CHAR(36)     NOT NULL,
  action              VARCHAR(500) NULL,
  application         VARCHAR(500) NULL,
  mule_message        LONGTEXT     NULL,
  mule_message_id     VARCHAR(36)  NULL,
  notification_type   VARCHAR(500) NULL,
  path                VARCHAR(500) NULL,
  resource_identifier VARCHAR(500) NULL,
  timestamp           BIGINT       NOT NULL,
  source              TEXT         NULL,
  PRIMARY KEY (id)
);

CREATE TABLE MULE_EVENTS_ANNOTATIONS (
  id               CHAR(36)     NOT NULL,
  event_id         CHAR(36)     NOT NULL,
  annotation_type  VARCHAR(100) NULL,
  annotation_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  KEY FK_MULE_EVENTS_ANNOTATIONS_MULE_EVENTS_IDX (event_id),
  CONSTRAINT FK_MULE_EVENTS_ANNOTATIONS_MULE_EVENTS
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id)
    ON DELETE CASCADE
);

CREATE TABLE MULE_EVENTS_BUSINESS (
  id             CHAR(36)     NOT NULL,
  event_id       CHAR(36)     NOT NULL,
  business_key   VARCHAR(30)  NOT NULL,
  business_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  KEY FK_MULE_EVENTS_BUSINESS_IDX (event_id),
  CONSTRAINT FK_MULE_EVENTS_BUSINESS_MULE_EVENTS
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id)
    ON DELETE CASCADE
);
```

### [](#内部ハンドラー設定)内部ハンドラー設定

1. 次の場所から MySQL JDBC ドライバーをダウンロードします。
    
    `[http://dev.mysql.com/downloads/connector/j/](http://dev.mysql.com/downloads/connector/j/)`
2. ZIP ファイルを抽出します。
3. `mysql-connector-java-{VERSION}.jar`​ ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.tracking.handler.database:
        enabled: true
        driver: com.mysql.jdbc.Driver
        jdbcUrl: jdbc:mysql://192.168.61.128/mule
        user: root
        pass: test
    ```

## [](#oracle-の設定例)Oracle の設定例

次の例は、Oracle データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ-2)スキーマ

```sql
CREATE TABLE MULE_EVENTS (
  id                  CHAR(36)     NOT NULL,
  action              VARCHAR(500) NULL,
  application         VARCHAR(500) NULL,
  mule_message        CLOB         NULL,
  mule_message_id     VARCHAR(36)  NULL,
  notification_type   VARCHAR(500) NULL,
  path                VARCHAR(500) NULL,
  resource_identifier VARCHAR(500) NULL,
  timestamp           NUMBER       NOT NULL,
  source              CLOB         NULL,
  PRIMARY KEY (id)
);

CREATE TABLE MULE_EVENTS_ANNOTATIONS (
  id               CHAR(36)     NOT NULL,
  event_id         CHAR(36)     NOT NULL,
  annotation_type  VARCHAR(100) NULL,
  annotation_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  CONSTRAINT FK_MEA_ME
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id) ON DELETE CASCADE
);

CREATE INDEX FK_MAE_IDX ON MULE_EVENTS_ANNOTATIONS (event_id);

CREATE TABLE MULE_EVENTS_BUSINESS (
  id             CHAR(36)     NOT NULL,
  event_id       CHAR(36)     NOT NULL,
  business_key   VARCHAR(30)  NOT NULL,
  business_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  CONSTRAINT FK_MEB_ME
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id) ON DELETE CASCADE
);

CREATE INDEX FK_MEB_IDX ON MULE_EVENTS_BUSINESS (event_id);
```

### [](#内部ハンドラー設定-2)内部ハンドラー設定

1. 次の場所から Oracle JDBC ドライバーをダウンロードします。
    
    `[https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html](https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html)`
2. GZ ファイルを抽出します。
3. JAR ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.tracking.handler.database:
        enabled: true
        driver: oracle.jdbc.OracleDriver
        jdbcUrl: jdbc:oracle:thin:@192.168.61.128/XE
        user: root
        pass: test
    ```

## [](#microsoft-sql-server-の設定例)Microsoft SQL Server の設定例

次の例は、Microsoft SQL Server データベースと連携させるための Runtime Manager エージェントのセットアップ方法を示しています。

### [](#スキーマ-3)スキーマ

```sql
CREATE TABLE MULE_EVENTS (
  id                  CHAR(36)     NOT NULL,
  action              VARCHAR(500) NULL,
  application         VARCHAR(500) NULL,
  mule_message        VARCHAR(MAX) NULL,
  mule_message_id     VARCHAR(36)  NULL,
  notification_type   VARCHAR(500) NULL,
  path                VARCHAR(500) NULL,
  resource_identifier VARCHAR(500) NULL,
  timestamp           BIGINT       NOT NULL,
  source              VARCHAR(MAX) NULL,
  PRIMARY KEY (id)
);

CREATE TABLE MULE_EVENTS_ANNOTATIONS (
  id               CHAR(36)     NOT NULL,
  event_id         CHAR(36)     NOT NULL,
  annotation_type  VARCHAR(100) NULL,
  annotation_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  CONSTRAINT FK_MULE_EVENTS_ANNOTATIONS_MULE_EVENTS
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id)
    ON DELETE CASCADE
);

CREATE INDEX FK_MULE_EVENTS_ANNOTATIONS_MULE_EVENTS_IDX ON MULE_EVENTS_ANNOTATIONS (event_id);

CREATE TABLE MULE_EVENTS_BUSINESS (
  id             CHAR(36)     NOT NULL,
  event_id       CHAR(36)     NOT NULL,
  business_key   VARCHAR(30)  NOT NULL,
  business_value VARCHAR(255) NULL,
  PRIMARY KEY (id),
  CONSTRAINT FK_MULE_EVENTS_BUSINESS_MULE_EVENTS
  FOREIGN KEY (event_id) REFERENCES MULE_EVENTS (id)
    ON DELETE CASCADE
);

CREATE INDEX FK_MULE_EVENTS_BUSINESS_IDX ON MULE_EVENTS_BUSINESS (event_id);
```

### [](#内部ハンドラー設定-3)内部ハンドラー設定

1. 次の場所から SQL Server 用の Microsoft JDBC ドライバーをダウンロードします。
    
    `[https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=11774](https://www.microsoft.com/en-us/download/details.aspx?displaylang=en&id=11774)`
2. `sqljdbc%version%.tar.gz`​ ファイルを抽出します。
3. 適切な ​`sqljdbc%version%.jar`​ ファイルを ​`{MULE_HOME}/plugins/mule-agent-plugin/lib/modules`​ にコピーします。
4. `{MULE_HOME}/conf/mule-agent.yml`​ ファイルを変更して次を含めます。
    
    ```yaml
      mule.agent.tracking.handler.database:
        enabled: true
        driver: com.microsoft.sqlserver.jdbc.SQLServerDriver
        jdbcUrl: jdbc:sqlserver://192.168.61.128:1433;databaseName=Mule;
        user: root
        pass: test
    ```

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

- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [Runtime Manager REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=52696e48bc8df2f523abd93cb1d65cc30f1d2a97826d43d4fe09d077c239abb4 url=/mulesoft/current/ja-jp/runtime-manager/sending-data-from-arm-to-external-analytics-software.md -->

# Runtime Manager から外部分析ツールへのデータのエクスポート

データを外部の分析ツールにエクスポートするように Runtime Manager エージェントを設定できます。

Runtime Manager クラウドコンソールまたは Anypoint Platform Private Cloud Edition を使用すると、以下を行うことができます。

- フローの実行や例外などの Mule イベント通知を Splunk や ELK に送信する。
    
    [\[Splunk のインテグレーション\]](<#Splunk のインテグレーション>)​と ​[\[ELK スタックのインテグレーション\]](<#ELK スタックのインテグレーション>)​を参照してください。
- API Analytics の Splunk および ELK への送信。
    
    [API Analytics と Splunk または ELK のインテグレーション](#api-analytics-と-splunk-または-elk-のインテグレーション)​を参照してください。

ペイロードのコンテンツをログにエクスポートする場合は、すべての形式をエクスポートできるわけではないことを考慮してください。 [「ペイロード形式とログ記録」](https://docs.mulesoft.com/jp/runtime-manager/about-logging-of-payload-formats)​を参照してください。

[CloudHub](https://docs.mulesoft.com/cloudhub/)​ にデプロイされたアプリケーションでは、サードパーティツールへのデータ送信はサポートされていません。 CloudHub カスタムログアペンダーを使用することで、自分のログシステムと統合できます。 [「Log4j を使用したログシステムとのインテグレーション」](https://docs.mulesoft.com/cloudhub/custom-log-appender)​を参照してください。

## [](#前提条件)前提条件

次のソフトウェアがインストールされていることを確認してください。

- Mule Runtime Engine バージョン 3.6 以降
    
    イベントを API Analytics から外部ツールと Anypoint Platform の両方に転送するには、以下のバージョンが必要です。
    
    - Mule バージョン 4.2.0 以降
    - Mule バージョン 3.9.3 以降
- API ゲートウェイスタンドアロンバージョン 2.1.0 以降
- Runtime Manager エージェント 1.2.0 以降
    
    HTTP イベントコレクターを使用するか、または TCP 経由でデータを Splunk に送信するには、Runtime Manager agent 1.3.1 以降が必要です。
    
    エージェントの更新については、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。

### [](#splunk-の前提条件)Splunk の前提条件

HTTP イベントコレクターを使用してデータを Splunk に送信するには、事前にデータ入力を設定して、Splunk からトークンを取得する必要があります。

1. Splunk アカウントにサインインします。
2. **\[Settings (設定)\]**​ → ​**\[Data Inputs (データ入力)\]**​ に移動します。
3. **\[HTTP Event Collector (HTTP イベントコレクター)\]**​ 種別で ​**\[Add new (新規追加)\]**​ をクリックします。
    
    ![「Splunk Data Inputs (Splunk データ入力)」 ページの HTTP イベントコレクターの 「Add new (新規追加)」 オプション](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-config-http-collector.png)
    
    Figure 1. 矢印は、\[Splunk Data Inputs (Splunk データ入力)\] ページの HTTP イベントコレクターの ​**\[Add new (新規追加)\]**​ オプションを示しています。
4. ステップに従ってデータ入力をセットアップし、トークンを取得します。

TCP 経由でデータを Splunk に送信するには、事前に Splunk で入力元を有効化する必要があります。

1. Splunk アカウントにサインインします。
2. **\[Settings (設定)\]**​ → ​**\[Data Inputs (データ入力)\]**​ に移動します。
3. **\[TCP\]**​ 種別で ​**\[Add new (新規追加)\]**​ をクリックします。
    
    ![「Splunk Data Inputs (Splunk データ入力)」 ページの TCP の 「Add new (新規追加)」 オプション](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-config-tcp.png)
    
    Figure 2. 矢印は、\[Splunk Data Inputs (Splunk データ入力)\] ページの TCP の ​**\[Add new (新規追加)\]**​ オプションを示しています。
4. ステップに従ってデータ入力をセットアップします。

データ入力の設定に関する詳細は、 [Splunk ドキュメント](https://docs.splunk.com/Documentation/Splunk/8.0.2/Data/WhatSplunkcanmonitor)​を参照してください。

## [](#ログレベルオプション)ログレベルオプション

Splunk または ELK とのインテグレーションを設定する場合は、以下のログレベルを使用できます。

ビジネスイベント

フローの開始または終了、非同期メッセージ、例外、カスタムイベント

追跡

ビジネスイベントに加えて例外戦略とエンドポイントメッセージ

Debug (デバッグ)

追跡に加えてメッセージプロセッサーの起動と終了

## [](#splunk-とのインテグレーション)Splunk とのインテグレーション

[Splunk](http://www.splunk.com/)​ を使用して、Mule イベント通知を検索可能なリポジトリに取得およびインデックス化し、このリポジトリからグラフ、レポート、アラート、ダッシュボード、視覚化を生成することができます。

1. [Splunk インスタンスでのエージェントの設定](#splunk-インスタンスでのエージェントの設定)​。
2. [Runtime Manager での Splunk のインテグレーションの設定](#runtime-manager-での-splunk-のインテグレーションの設定)​。

### [](#splunk-インスタンスでのエージェントの設定)Splunk インスタンスでのエージェントの設定

Splunk と統合するためには、Splunk インスタンスで新しい接続元種別を作成して、Runtime Manager エージェントから送信された HTTP イベントを解析できるように設定する必要があります。

1. 必要に応じて ​`$SPLUNK_HOME/opt/splunk/etc/system/local/props.conf`​ ファイルを作成します。
2. `props.conf`​ ファイルに次の接続元種別を追加します。
    
    ```yaml
    [mule]
    TRUNCATE = 0
    LINE_BREAKER = ([\r\n]+)
    SHOULD_LINEMERGE = false
    INDEXED_EXTRACTIONS = JSON
    KV_MODE = JSON
    category = Mule Splunk Integration
    description = Mule Agent event information
    ```
3. Splunk インスタンスを再起動して変更内容を有効にします。

### [](#runtime-manager-での-splunk-のインテグレーションの設定)Runtime Manager での Splunk のインテグレーションの設定

Runtime Manager エージェントから Splunk に Mule イベント通知を送信する手順は次のとおりです。

1. HTTP イベントコレクターを使用するか、または TCP 経由でデータを Splunk に送信する場合は、​[Splunk の前提条件](#splunk-の前提条件)​を参照してください。
2. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
3. **\[Servers (サーバー)\]**​ タブをクリックします。
4. **\[Type (種別)\]**​ 列をクリックして、設定するサーバーの詳細ペインを表示します。
5. **\[Manage Server (サーバーを管理)\]**​ をクリックします。
6. **\[Plugins (プラグイン)\]**​ タブをクリックします。
    
    ![「Event Tracking (イベント追跡)」 オプション、「Level (レベル)」 メニュー、「Plugins (プラグイン)」 タブの歯車アイコン。](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-elk.png)
    
    Figure 3. このスクリーンショットには、(​**1**​) ​**\[Event Tracking (イベント追跡)\]**​ オプション、(​**2**​) ​**\[Level (レベル)\]**​ メニュー、(​**3**​) ​**\[Plugins (プラグイン)\]**​ タブの歯車アイコンが表示されています。
7. **\[Event Tracking (イベント追跡)\]**​ で ​**\[Splunk\]**​ を有効化します。
8. 送信する情報の種別を ​**\[Level (レベル)\]**​ メニューから選択します。
    
    [ログレベルオプション](#ログレベルオプション)​を参照してください。
9. 歯車アイコンをクリックして、Splunk 設定を指定します。
    
    ![Splunk 設定ウィンドウのプロトコルオプション、データ入力種別、「Show more options (その他のオプションを表示)」 スイッチ](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-configure.png)
    
    Figure 4. このスクリーンショットには、Splunk 設定ウィンドウの (​**1**​) プロトコルオプション、(​**2**​) データ入力種別、(​**3**​) ​**\[Show more options (その他のオプションを表示)\]**​ スイッチが表示されています。
    
    [Splunk 設定オプション](#splunk-設定オプション)​を参照してください。
10. Splunk が動作しているサーバーのホスト (IP アドレスまたはホスト名) と管理ポートを指定します。
    
    - REST API を使用してデータを Splunk に送信する場合は、​**\[Rest API\]**​ を選択して、自分の Splunk アカウントのユーザー名とパスワードを入力します。
    - TCP 経由でデータを Splunk に送信する場合は、メニューから ​**\[tcp\]**​ を選択して、自分の Splunk アカウントのユーザー名とパスワードを入力します。
    - HTTP イベントコレクターを使用してデータを Splunk に送信する場合は、​**\[HTTP Event Collector (HTTP イベントコレクター)\]**​ を選択して、Splunk からのトークンを ​**\[Token (トークン)\]**​ 項目に貼り付けます。
        
        ![Splunk 設定ウィンドウの 「HTTP Event Collector (HTTP イベントコレクター)」 オプションと 「Token (トークン)」 項目](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-configure-http.png)
        
        Figure 5. このスクリーンショットには、Splunk 設定ウィンドウの (​**1**​) ​**\[HTTP Event Collector (HTTP イベントコレクター)\]**​ オプションと (​**2**​) ​**\[Token (トークン)\]**​ 項目が表示されています。
11. 必要に応じて、​**\[Show more options (その他のオプションを表示)\]**​ をクリックして、送信データの書式設定プロパティを指定します。
    
    ![Splunk 設定ウィンドウで展開されたオプション](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-configure-advanced.png)
    
    Figure 6. 矢印は、Splunk 設定ウィンドウで展開されたオプションを示しています。
    
    [Splunk 設定オプション](#splunk-設定オプション)​を参照してください。
    
    **\[SSL Protocol (SSL プロトコル)\]**​ オプションは、REST API データ入力種別にのみ適用されます。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">Splunk でデータ入力を登録したときに Splunk インデックス、Splunk 接続元、Splunk 接続元種別の値を設定してある場合は、このウィンドウで指定した値がそれらの値よりも優先されます。</td></tr></tbody></table>
12. **\[Apply (適用)\]**​ をクリックして変更内容を保存します。

### [](#splunk-設定オプション)Splunk 設定オプション

Splunk のインテグレーションには、以下の設定オプションがあります。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 28.5714%;">
<col style="width: 42.8571%;">
<col style="width: 28.5715%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Username (ユーザー名)
(必須)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk に接続するためのユーザー名</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Password (パスワード)
(必須)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk ユーザー名に関連付けられているパスワード</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">host (ホスト)
(必須)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk を実行中のサーバーの IP アドレスまたはホスト名</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">port (ポート)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk 管理ポート</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8089</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">protocol (プロトコル)</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Splunk 管理ポートとの接続用プロトコル</p>
</div>
<div class="paragraph">
<p>選択できる値は http、https、tcp です。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">https</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">SSL Protocol (SSL プロトコル) (REST API のみ)</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>HTTPS 接続で使用される SSL セキュリティプロトコル</p>
</div>
<div class="paragraph">
<p>可能な値は TLSv1_2、TLSv1_1、TLSv1、SSLv3 です。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">TLSv​1_2​</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk Index (Splunk インデックス)</p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>すべてのイベントの送信先となる Splunk インデックスの名前</p>
</div>
<div class="paragraph">
<p>指定したインデックスが存在しない場合は、ユーザー名に関連付けられている権限が適切であれば、内部ハンドラーによってインデックスが作成されます。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">main</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk Source (Splunk 送信元種別)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk に送信されるイベントで使用される送信元</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">mule-events</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk Type (Splunk 種別)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Splunk に送信されるイベントで使用される送信元種別</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">mule</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Date Format (日付形式)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">タイムスタンプで使用される日付形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">yyyy-MM-dd’T’HH:mm:ssSZ</p></td>
</tr>
</tbody>
</table>

## [](#elk-スタックとのインテグレーション)ELK スタックとのインテグレーション

ELK (Elasticsearch、Logstash、Kibana) スタックにより、ログデータを保存、検索、分析できます。

Mule フローからのイベント通知を設定可能なログファイルに保存するように Runtime Manager を設定できます。 まず、Logstash でデータを取得してインデックス化します。 次に、Elasticsearch と Kibana を使用して、グラフ、レポート、アラート、ダッシュボード、視覚化を生成します。

### [](#elk-スタックのログファイルの設定)ELK スタックのログファイルの設定

自分の ELK スタックが読み取るフォルダーにイベント通知を送信する手順は次のとおりです。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. **\[Type (種別)\]**​ 列をクリックして、設定するサーバーの詳細ペインを表示します。
4. **\[Manage Server (サーバーを管理)\]**​ をクリックします。
5. **\[Plugins (プラグイン)\]**​ タブをクリックします。
    
    ![「Event Tracking (イベント追跡)」 オプション、「Level (レベル)」 メニュー、「Plugins (プラグイン)」 タブの歯車アイコン。](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-splunk-elk.png)
    
    Figure 7. このスクリーンショットには、(​**1**​) ​**\[Event Tracking (イベント追跡)\]**​ オプション、(​**2**​) ​**\[Level (レベル)\]**​ メニュー、(​**3**​) ​**\[Plugins (プラグイン)\]**​ タブの歯車アイコンが表示されています。
6. 送信する情報の種別を ​**\[Level (レベル)\]**​ メニューから選択します。
    
    [ログレベルオプション](#ログレベルオプション)​を参照してください。
7. **\[Event Tracking (イベント追跡)\]**​ で ​**\[ELK\]**​ を有効化します。
8. 歯車アイコンをクリックして、ELK のログファイルの場所を設定します。
    
    ![ELK 設定ウィンドウのログファイルの場所と 「Show more options (その他のオプションを表示)」 スイッチ](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-elk-configure.png)
    
    Figure 8. このスクリーンショットには、ELK 設定ウィンドウの (​**1**​) ログファイルの場所と (​**2**​) ​**\[Show more options (その他のオプションを表示)\]**​ スイッチが表示されています。
    
    デフォルトの場所は ​`$MULE_HOME/logs/events.log`​ であり、​`$MULE_HOME`​ は ​`wrapper.conf`​ ファイルの ​`-Dmule.home`​ パラメーターによって指定される場所です。 デフォルトの場所を変更するには、​`/var/logs/elk/events.log`​ のように、ELK ログファイルの場所の絶対パスを指定します。 `/var/logs/elk`​ など、指定したディレクトリが存在している必要があります。
9. 必要に応じて、​**\[Show more options (その他のオプションを表示)\]**​ をクリックして、その他のログファイルプロパティを指定します。
    
    ![ELK 設定ウィンドウで展開されたオプション](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-elk-configure-advanced.png)
    
    Figure 9. 矢印は、ELK 設定ウィンドウで展開されたオプションを示しています。
10. **\[Apply (適用)\]**​ をクリックして変更内容を保存します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">イベント追跡ログファイル (​<code>$MULE_HOME/logs/events-%d{yyyy-dd-MM}-%i.log</code>​) は自動的には削除されません。定期的に手動でログを削除する必要があります。</td></tr></tbody></table>

## [](#api-analytics-と-splunk-または-elk-のインテグレーション)API Analytics と Splunk または ELK のインテグレーション

API Analytics と Splunk または ELK を統合する手順は次のとおりです。

1. [\[API ゲートウェイを設定します\]](<#API ゲートウェイを設定します>)​。
2. [\[Splunk or ELK と接続するように API Analytics を設定します\]](<#Splunk or ELK と接続するように API Analytics を設定します>)​。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">API ゲートウェイ ​<code>wrapper.conf</code>​ を設定しても (ステップ 1)、データの外部宛先を割り当てないと (ステップ 2)、分析データは API ゲートウェイサーバーのキューに累積し、システムクラッシュの原因となることがあります。</td></tr></tbody></table>

### [](#api-ゲートウェイを設定する)API ゲートウェイを設定する

外部分析ツールとの接続を設定するには、API ゲートウェイを設定します。

1. API ゲートウェイスタンドアロンのディレクトリで、​`conf/wrapper.conf`​ ファイルを開きます。
    
    コードスニペットの ​`.<n>`​ 値は、​`wrapper.conf`​ 内で一意の整数です。
2. 次のプロパティが ​`true`​ に設定されていて、行がコメント解除されていることを確認します。
    
    ```java
    wrapper.java.additional.<n>=-Danypoint.platform.analytics_enabled=true
    ```
3. 次の行から URL を削除します。
    
    ```java
    wrapper.java.additional.<n>=-Danypoint.platform.analytics_base_uri=https://analytics-ingest.anypoint.mulesoft.com
    ```
    
    行は次のようになります。
    
    ```java
    wrapper.java.additional.<n>=-Danypoint.platform.analytics_base_uri=
    ```
4. Anypoint Platform Private Cloud Edition を使用している場合は、​`anypoint.platform.on_prem`​ パラメーターを ​`true`​ に変更します。
    
    ```java
    wrapper.java.additional.<n>=-Danypoint.platform.on_prem=true
    ```
    
    Runtime Manager クラウドコンソールを使用している場合は、このパラメーターはデフォルトの ​`false`​ のままにしておきます。

#### [](#複数のコンシューマーの設定)複数のコンシューマーの設定

Mule バージョン 4.2.0 および 3.9.3 以降では、イベントを外部ツールと Anypoint Platform の両方に転送できます。

複数のコンシューマーを設定するには、​`wrapper.conf`​ ファイルに次の行を追加します。

```java
wrapper.java.additional.<n>=-Danypoint.platform.analytics_multiple_consumers_enabled=true
```

### [](#splunk-または-elk-に接続するための-api-analytics-の設定)Splunk または ELK に接続するための API Analytics の設定

API ゲートウェイを設定したら、Runtime Manager で Splunk または ELK を設定します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. **\[Type (種別)\]**​ 列をクリックして、設定するサーバーの詳細ペインを表示します。
4. **\[Manage Server (サーバーを管理)\]**​ をクリックします。
5. **\[Plugins (プラグイン)\]**​ タブをクリックします。
    
    ![サーバーの 「Plugins (プラグイン)」 タブの 「API Analytics」 オプション。](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-export-api-analytics.png)
    
    Figure 10. 矢印は、サーバーの ​**\[Plugins (プラグイン)\]**​ タブの ​**\[API Analytics\]**​ オプションを示しています。
6. **\[API Analytics\]**​ で ​**\[ELK\]**​ または ​**\[Splunk\]**​ を有効化します。
7. 歯車アイコンをクリックし、以下のセクションのステップ 8 から続行して設定を完了します。
    
    - [Runtime Manager での Splunk のインテグレーションの設定](#runtime-manager-での-splunk-のインテグレーションの設定)
    - [ELK スタックのログファイルの設定](#elk-スタックのログファイルの設定)

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

- [既存の mule-agent.yml ファイルでのパスワードの暗号化](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#encrypt_password)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [アプリケーションとサーバーの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [Anypoint Platform Private Cloud Edition](https://docs.mulesoft.com/private-cloud/latest/)
- [Runtime Manager REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=4e322f7f52890c9e2acc9ca50d148d4fa4ca19bf5755b739354d60394e030669 url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-cli.md -->

# Runtime Manager コマンドラインインターフェース

 [![logo cloudhub 2.0 active](/mulesoft/current/ja-jp/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)[ ![logo rtf active](/mulesoft/current/ja-jp/_/img/icons/cloud-gear.svg "Runtime Fabric")Runtime Fabric](deployment-strategies#anypoint-runtime-fabric-deployments)

Anypoint Platform には、Runtime Manager のスクリプトおよびコマンドラインツールが用意されています。 コマンドラインインターフェース (CLI) は、対話型シェルと標準 CLI モードの両方をサポートしており、以下で動作します。

- [ローカルにデプロイされていて Runtime Manager で管理されるアプリケーション](#standalone-apps)
- [ローカルにデプロイされていて Runtime Manager で管理されるアプリケーションのアラート](#standalone-alerts)
- [ローカルサーバー](#servers)
- [ローカルサーバーグループ](#server-groups)
- [ローカルクラスターサーバー](#server-clusters)
- [CloudHub 2.0 の CLI](#cloudhub-2)
- [CloudHub の CLI](#cloudhub)
- [Anypoint Runtime Fabric の CLI](#rtf)

## [](#standalone-apps)ローカルにデプロイされていて Runtime Manager で管理されるアプリケーション

<table><tbody><tr><td class="icon"><i class="fa icon-caution" title="Caution"></i></td><td class="content">Anypoint Platform CLI で対象サーバーを認識できるように、手動で各サーバーをプラットフォームに登録する必要があります。</td></tr></tbody></table>

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 35%;">
<col style="width: 65%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コマンド</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-artifact" class="xref page">runtime-mgr:standalone-application:artifact</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションアーティファクトバイナリをダウンロードする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-deploy" class="xref page">runtime-mgr:standalone-application:deploy</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>オンプレミスサーバー、サーバーグループ、クラスターにアプリケーションをデプロイまたは再デプロイする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-modify" class="xref page">runtime-mgr:standalone-application:modify</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションアーティファクトを変更する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-start" class="xref page">runtime-mgr:standalone-application:start</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションを開始する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-delete" class="xref page">runtime-mgr:standalone-application:delete</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションを削除する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-describe" class="xref page">runtime.mgr:standalone-application:describe</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションの詳細情報を表示する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-list" class="xref page">runtime-mgr:standalone-application:list</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>環境内のすべてのスタンドアロンアプリケーションをリストする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-restart" class="xref page">runtime-mgr:standalone-application:restart</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションを再起動する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-stop" class="xref page">runtime-mgr:standalone-application:stop</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションを停止する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-apps#runtime-mgr-standalone-application-copy" class="xref page">runtime-mgr:standalone-application:copy</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションをコピーする</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-standalone-application-artifact)runtime-mgr:standalone-application:artifact

\> runtime-mgr:standalone-application:artifact \[flags\] <identifier> <directory>

このコマンドは、​`identifier`​ アプリケーションのアプリケーションアーティファクトを ​`directory`​ で渡されるディレクトリにダウンロードします。 `identifier`​ フラグは、アプリケーション ID または名前のいずれかになります。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-standalone-application-deploy)runtime-mgr:standalone-application:deploy

\> runtime-mgr:standalone-application:deploy \[flags\] <targetIdentifier> <name> <zipfile>

このコマンドは、パス ​`zipfile`​ の ZIP ファイルとして渡されるアプリケーションを ​`targetIdentifier`​ で渡されるオンプレミスの対象にデプロイまたは再デプロイします。

`targetIdentifier`​ フラグは、対象 ID または名前のいずれかになります。

対象は、サーバー、サーバーグループ、クラスターのいずれかになります。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

アプリケーションを再デプロイしてログレベルを設定したり、インサイトイベント追跡を有効にしたりするには、「​[runtime-mgr:standalone-application:modify](#runtime-mgr-standalone-application-modify)​」を参照してください。

### [](#runtime-mgr-standalone-application-modify)runtime-mgr:standalone-application:modify

\> runtime-mgr:standalone-application:modify \[flags\] <identifier> <zipfile>

このコマンドでは、パスとして ​`zipfile`​ で渡される ZIP ファイルアプリケーションを使用して、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを変更します。

`identifier`​ オプションでは、アプリケーション識別子を指定します。 識別子を取得するには、「​[runtime-mgr:standalone-application:list](#runtime-mgr-standalone-application-list)​」を参照してください。

このコマンドでは、デフォルトの ​`--help`​ フラグ以外に次のフラグも受け入れます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 37.5%;">
<col style="width: 62.5%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フラグ</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--insight</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>各 Mule トランザクションのメッセージメタデータを保存する。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--log [level:scope]</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ログレベルとスコープのペアを設定する。</p>
</div>
<div class="ulist">
<ul>
<li>
<p><code>level</code>​: TRACE、DEBUG、INFO、WARN、ERROR、FATAL、OFF</p>
</li>
<li>
<p><code>scope</code>​: 記録するクラス、コネクタ、モジュールのパッケージ名 (FTP 用 Anypoint Connector の ​<code>org.mule.extension.ftp</code>​ など)</p>
</li>
</ul>
</div>
<div class="paragraph">
<p>複数のログレベルを設定するには、​<code>--log INFO:org.apache --log WARN:org.mule</code>​ のように複数の ​<code>--log</code>​ フラグを指定します。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-standalone-application-start)runtime-mgr:standalone-application:start

\> runtime-mgr:standalone-application:start \[flags\] <identifier>

このコマンドでは、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを開始します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-standalone-application-delete)runtime-mgr:standalone-application:delete

\> runtime-mgr:standalone-application:delete \[flags\] <identifier>

このコマンドでは、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを削除します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">このコマンドは、削除する前に 2 回入力を促しません。削除命令を送信する場合、確認を求められることはありません。</td></tr></tbody></table>

### [](#runtime-mgr-standalone-application-describe)runtime-mgr:standalone-application:describe

\> runtime-mgr:standalone-application:describe \[flags\] <identifier>

このコマンドでは、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションの状況、作成日、最終更新日などの詳細情報を表示します。

フラグ ​`-o json`​ を使用して、​`<name>`​ で指定するアプリケーションの未加工の JSON 応答を取得します。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-standalone-application-list)runtime-mgr:standalone-application:list

\> runtime-mgr:standalone-application:list \[flags\]

このコマンドでは、すべてのスタンドアロン (オンプレミス) アプリケーションをリストします。

このコマンドでは、デフォルトの ​`--help`​ フラグ以外に次のフラグも受け入れます。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フラグ</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--limit &lt;num&gt;</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>取得する結果の数を指定する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--offset &lt;num&gt;</code>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>渡されるアプリケーションの数をオフセットする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>--output</code>​ &lt;value&gt;</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>応答形式を指定する。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-standalone-application-restart)runtime-mgr:standalone-application:restart

\> runtime-mgr:standalone-application:restart \[flags\] <identifier>

このコマンドでは、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを再起動します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-standalone-application-stop)runtime-mgr:standalone-application:stop

\> runtime-mgr:standalone-application:stop \[flags\] <identifier>

このコマンドでは、​`identifier`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを停止します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-standalone-application-copy)runtime-mgr:standalone-application:copy

\> runtime-mgr:standalone-application:copy \[flags\] <source> <target> <targetIdentifier>

このコマンドでは、​`source`​ で渡されるスタンドアロン (オンプレミス) アプリケーションを ​`target`​ で渡される対象およびサーバー、サーバーグループ、クラスター ID (​`targetIdentifier`​ で渡される名前) にコピーします。

`source`​ と ​`destination`​ の引数はどちらも、次のように ​`<organizationName>:<environmentName>/<appName>`​ の形式を使用して表されます。

\> runtime-mgr:standalone-application:copy Services:QA/application-1 Development:QA/application-2 123456

`application-1`​ という名前のアプリケーションを​_サービス_​組織の QA 環境からサーバー ID 123456 の ​`_Development_`​ 組織の QA 環境にコピーします。

Anypoint Platform CLI でサービス組織の QA 環境を使用する場合、コマンドの ​`source`​ としてアプリケーション名を使用できます。

\> runtime-mgr:standalone-application:copy application-1 Development/QA/application-2 123456

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドを実行するには、ユーザーに OS の ​<code>/tmp</code>​ ディレクトリ (CLI のインストール先) への参照/更新アクセス権が必要です。</td></tr></tbody></table>

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

## [](#standalone-alerts)ローカルにデプロイされていて Runtime Manager で管理されるアプリケーションのアラート

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 35%;">
<col style="width: 65%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コマンド</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-alerts#runtime-mgr-standalone-alert-describe" class="xref page">runtime-mgr:standalone-alert:describe</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アラートの情報を表示する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-alerts#runtime-mgr-standalone-alert-create" class="xref page">runtime-mgr:standalone-alert:create</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンランタイムの新しいアラートを作成する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-alerts#runtime-mgr-standalone-alert-modify" class="xref page">runtime-mgr:standalone-alert:modify</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンランタイムのアラートを変更する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/standalone-alerts#runtime-mgr-standalone-alert-list" class="xref page">runtime-mgr:standalone-alert:list</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>環境内のスタンドアロンランタイムのすべてのアラートをリストする</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-standalone-alert-describe)runtime-mgr:standalone-alert:describe

\> runtime-mgr:standalone-alert:describe \[flags\] <alertId>

このコマンドは、​`alertId`​ で渡されるアラートの情報を表示します。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-standalone-alert-create)runtime-mgr:standalone-alert:create

\> runtime-mgr:standalone-alert:create <name> \[flags\]

このコマンドは、​`name`​ で渡される ID を使用して、スタンドアロンランタイムの新しいアラートを作成します。 アラート ​`name`​ は 256 文字に制限されます。

このコマンドでは、デフォルトの ​`--help`​ フラグ以外に次のフラグも受け入れます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フラグ</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--severity &lt;val&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートの重要度</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--resourceType &lt;type&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのリソース種別</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--resource [id]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのリソース ID。複数回使用できます。指定されていない場合、すべてのリソースでアラートがトリガーされます。​<code>resourceType</code>​ に応じて、リソースはアプリケーション、サーバー、サーバーグループ、クラスターになります。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--condition &lt;val&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのトリガー条件</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--period [minutes]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">条件の期間 (分)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--threshold [num]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">条件のしきい値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--operator [type]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">しきい値に関する値を記述する条件演算子。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--subject &lt;string&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知メールの件名</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--content &lt;string&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知メールの本文</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--recipient [username]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知を送信するユーザー名。複数回使用して、最大 20 件のプラットフォームユーザー ID を指定できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--email [emailAddress]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知を送信するメールアドレス。複数回使用して、最大 20 件のメールアドレスを指定できます。</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドには複数オプションのフラグがあります。コマンドで複数オプションのフラグを使用する場合は、フラグの前にパラメーターを置くか、パラメーターの前に ​`-- `​ (2 つのダッシュの後にスペース) を使用します。</td></tr></tbody></table>

### [](#runtime-mgr-standalone-alert-modify)runtime-mgr:standalone-alert:modify

\> runtime-mgr:standalone-alert:modify <alertId> \[flags\]

このコマンドは、​`alertId`​ で渡されるアラートを変更します。

このコマンドでは、デフォルトの ​`--help`​ フラグ以外に次のフラグも受け入れます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フラグ</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--name &lt;value&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート名</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--severity &lt;value&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートの重要度</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--resourceType &lt;type&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのリソース種別</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--resource [id]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのリソース ID。複数回使用できます。指定されていない場合、すべてのリソースでアラートがトリガーされます。​<code>resourceType</code>​ に応じて、リソースはアプリケーション、サーバー、サーバーグループ、クラスターになります。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--condition &lt;value&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートのトリガー条件</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--period [minutes]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">条件の期間 (分)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--threshold [num]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">条件のしきい値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--operator [type]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">しきい値に関する値を記述する条件演算子。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--subject &lt;string&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知メールの件名</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--content &lt;string&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知メールの本文</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--recipient [username]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知を送信するユーザー名。複数回使用して、最大 20 件のプラットフォームユーザー ID を指定できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--email [emailAddress]</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラート通知を送信するメールアドレス。複数回使用して、最大 20 件のメールアドレスを指定できます。</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドには複数オプションのフラグがあります。コマンドで複数オプションのフラグを使用する場合は、フラグの前にパラメーターを置くか、パラメーターの前に ​`-- `​ (2 つのダッシュの後にスペース) を使用します。</td></tr></tbody></table>

### [](#runtime-mgr-standalone-alert-list)runtime-mgr:standalone-alert:list

\> runtime-mgr:standalone-alert:list \[flags\]

このコマンドは、現在の環境のスタンドアロン Mule のすべてのアラートをリストします。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

## [](#servers)ローカルサーバー

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 35%;">
<col style="width: 65%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コマンド</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/servers#runtime-mgr-server-describe" class="xref page">runtime-mgr:server:describe</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーの情報を表示する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/servers#runtime-mgr-server-modify" class="xref page">runtime-mgr:server:modify</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーを変更する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/servers#runtime-mgr-server-token" class="xref page">runtime-mgr:server:token</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバー登録トークンを取得する。新しいサーバーを登録するには、このトークンを使用する必要があります。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/servers#runtime-mgr-server-delete" class="xref page">runtime-mgr:server:delete</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーを削除する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/servers#runtime-mgr-server-list" class="xref page">runtime-mgr:server:list</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スタンドアロンアプリケーションアーティファクトを変更する</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-server-describe)runtime-mgr:server:describe

\> runtime-mgr:server:describe \[flags\] <serverId>

このコマンドは、​`serverId`​ で渡されるサーバーの情報を表示します。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-server-modify)runtime-mgr:server:modify

\> runtime-mgr:server:modify \[flags\] <serverId>

このコマンドは、​`serverId`​ で渡されるサーバーを変更します。

クラスターの ID を更新するには、​`--name`​ フラグを渡す必要があります。

このコマンドでは、​`--name`​ フラグ以外にデフォルトの ​`--help`​ フラグも使用できます。

### [](#runtime-mgr-server-token)runtime-mgr:server:token

\> runtime-mgr:server:token \[flags\]

このコマンドは、サーバー登録トークンを取得します。新しいサーバーを登録するには、このトークンを使用する必要があります。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-server-delete)runtime-mgr:server:delete

\> runtime-mgr:server:delete \[flags\] <serverId>

このコマンドは、​`serverId`​ で渡されるサーバーを削除します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">このコマンドは、削除する前に 2 回入力を促しません。削除命令を送信する場合、確認を求められることはありません。</td></tr></tbody></table>

### [](#runtime-mgr-server-list)runtime-mgr:server:list

\> runtime-mgr:server:list \[flags\]

このサーバーは、環境内のすべてのサーバーをリストします。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

## [](#server-groups)ローカルサーバーグループ

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 35%;">
<col style="width: 65%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コマンド</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-create" class="xref page">runtime-mgr:serverGroup:create</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーのサーバーグループを作成する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-describe" class="xref page">runtime-mgr:serverGroup:describe</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーグループの情報を表示する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-modify" class="xref page">runtime-mgr:serverGroup:modify</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーグループを変更する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-add-server" class="xref page">runtime-mgr:serverGroup:add:server</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーをサーバーグループに追加する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-delete" class="xref page">runtime-mgr:serverGroup:delete</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーグループを削除する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-list" class="xref page">runtime-mgr:serverGroup:list</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>環境内のすべてのサーバーグループをリストする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-groups#runtime-mgr-servergroup-remove-server" class="xref page">runtime-mgr:serverGroup:remove:server</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーグループのサーバーを削除する</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-servergroup-create)runtime-mgr:serverGroup:create

\> runtime-mgr:serverGroup:create \[flags\] <name> \[serverIds...\]

このコマンドは、後で引数として渡されるサーバー ID を使用して、​`name`​ で渡される名前でサーバーグループを作成します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-servergroup-describe)runtime-mgr:serverGroup:describe

\> runtime-mgr:serverGroup:describe \[flags\] <serverGroupId>

このコマンドは、​`serverGroupId`​ で渡されるサーバーグループの情報を表示します。 このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。 このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-servergroup-modify)runtime-mgr:serverGroup:modify

\> runtime-mgr:serverGroup:modify \[flags\] <serverGroupId>

このコマンドは、​`serverGroupId`​ で渡されるサーバーグループを変更します。 クラスターの ID を更新するには、​`--name`​ フラグを渡す必要があります。 このコマンドでは、​`--name`​ フラグ以外にデフォルトの ​`--help`​ フラグも使用できます。

### [](#runtime-mgr-servergroup-add-server)runtime-mgr:serverGroup:add:server

\> runtime-mgr:serverGroup:add:server \[flags\] <serverGroupId> <serverId>

このコマンドは、​`serverId`​ で渡されるサーバーを ​`serverGroupId`​ で渡されるサーバーグループに追加します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-servergroup-delete)runtime-mgr:serverGroup:delete

\> runtime-mgr:serverGroup:delete \[flags\] <serverGroupId>

このコマンドは、​`serverGroupId`​ で渡されるサーバーグループを削除します。 このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">このコマンドは、削除する前に 2 回入力を促しません。削除命令を送信する場合、確認を求められることはありません。</td></tr></tbody></table>

### [](#runtime-mgr-servergroup-list)runtime-mgr:serverGroup:list

\> runtime-mgr:serverGroup:list \[flags\]

このコマンドは、環境内のすべてのサーバーグループをリストします。 このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。 このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-servergroup-remove-server)runtime-mgr:serverGroup:remove:server

\> runtime-mgr:serverGroup:remove:server \[flags\] <serverGroupId> <serverId>

このコマンドでは、​`serverGroupId`​ で渡されるサーバーグループから ​`serverId`​ で渡されるサーバーを削除します。 このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

## [](#server-clusters)ローカルクラスターサーバー

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 35%;">
<col style="width: 65%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コマンド</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-add-server" class="xref page">runtime-mgr:cluster:add:server</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーをクラスターに追加する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-delete" class="xref page">runtime-mgr:cluster:delete</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターを削除する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-list" class="xref page">runtime-mgr:cluster:list</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>環境内のすべてのクラスターをリストする</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-remove-server" class="xref page">runtime-mgr:cluster:remove:server</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターからサーバーを削除する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-create" class="xref page">runtime-mgr:cluster:create</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>新しいクラスターを作成する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-describe" class="xref page">runtime-mgr:cluster:describe</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバークラスターの情報を表示する</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><a href="https://docs.mulesoft.com/jp/anypoint-cli/latest/server-clusters#runtime-mgr-cluster-modify" class="xref page">runtime-mgr:cluster:modify</a></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クラスターを変更する</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#runtime-mgr-cluster-add-server)runtime-mgr:cluster:add:server

\> runtime-mgr:cluster:add:server \[flags\] <clusterId> <serverId>

このコマンドは、​`clusterId`​ のクラスターを ​`serverId`​ で渡されるサーバーに追加します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-cluster-delete)runtime-mgr:cluster:delete

\> runtime-mgr:cluster:delete \[flags\] <clusterId>

このコマンドは、​`clusterId`​ で渡されるクラスターを削除します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">このコマンドは、削除する前に 2 回入力を促しません。削除命令を送信する場合、確認を求められることはありません。</td></tr></tbody></table>

### [](#runtime-mgr-cluster-list)runtime-mgr:cluster:list

\> runtime-mgr:cluster:list \[flags\]

このコマンドは、環境内のすべてのクラスターをリストします。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-cluster-remove-server)runtime-mgr:cluster:remove:server

\> runtime-mgr:cluster:remove:server \[flags\] <clusterId> <serverId>

このコマンドは、​`clusterId`​ で渡されるクラスターから ​`serverId`​ で渡されるサーバーを削除します。

このコマンドでは、デフォルトのフラグ ​`--help`​ のみを受け入れます。

### [](#runtime-mgr-cluster-create)runtime-mgr:cluster:create

\> runtime-mgr:cluster:create <name> \[flags\]

このコマンドは、​`name`​ で渡される ID を使用してクラスターを作成します。

このコマンドでは、デフォルトの ​`--help`​ フラグ以外に次のフラグも受け入れます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 30%;">
<col style="width: 70%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フラグ</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--multicast</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クラスターをマルチキャストにする必要があるかどうか</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>--server &lt;id:ip&gt;</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバー ID と IP アドレスのペア。マルチキャストクラスターの場合、後者は省略可能です。複数のサーバーを追加するには、複数の値を指定します。</p></td>
</tr>
</tbody>
</table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このコマンドには複数オプションのフラグがあります。コマンドで複数オプションのフラグを使用する場合は、フラグの前にパラメーターを置くか、パラメーターの前に ​`-- `​ (2 つのダッシュの後にスペース) を使用します。</td></tr></tbody></table>

### [](#runtime-mgr-cluster-describe)runtime-mgr:cluster:describe

\> runtime-mgr:cluster:describe \[flags\] <clusterId>

このコマンドは、​`clusterId`​ で渡されるクラスターの情報を表示します。

このコマンドには ​`--output`​ フラグを使用できます。​`--output`​ フラグを使用して、応答形式を指定します。サポートされている値は、​`table`​ (デフォルト) および ​`json`​ です。

このコマンドでは、デフォルトのフラグ ​`--help`​ も受け入れます。

### [](#runtime-mgr-cluster-modify)runtime-mgr:cluster:modify

\> runtime-mgr:cluster:modify \[flags\] <clusterId>

このコマンドは、​`clusterId`​ で渡されるクラスターを変更します。  
クラスターの ID を更新するには、​`--name`​ フラグを渡す必要があります。

このコマンドでは、​`--name`​ フラグ以外にデフォルトの ​`--help`​ フラグも使用できます。

## [](#cloudhub-2)CloudHub 2.0 の CLI

これらのコマンドを使用して、Cloudhub 2.0 でアプリケーションをデプロイおよび管理できます。

- [Anypoint CLI を使用したアプリケーションのデプロイ](https://docs.mulesoft.com/jp/anypoint-cli/latest/cloudhub2-apps)

## [](#cloudhub)CloudHub の CLI

Anypoint CLI では次の CloudHub 機能の管理がサポートされます。

- [CloudHub アプリケーション](https://docs.mulesoft.com/jp/anypoint-cli/latest/cloudhub-apps)
- [CloudHub 専用ロードバランサー](https://docs.mulesoft.com/jp/anypoint-cli/latest/cloudhub-dlb)
- [Anypoint Virtual Private Cloud](https://docs.mulesoft.com/jp/anypoint-cli/latest/cloudhub-vpc)

## [](#rtf)Anypoint Runtime Fabric の CLI

Anypoint CLI では次の Runtime Fabric 機能の管理がサポートされます。

- [Runtime Fabric アプリケーション管理](https://docs.mulesoft.com/jp/anypoint-cli/latest/runtime-fabric-apps)
- [Runtime Fabric インスタンス](#anypoint-cli::rtf-instances.adoc)

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

- [Anypoint Platform CLI 4.x の使用開始](https://docs.mulesoft.com/jp/anypoint-cli/latest/)

<!-- document id=f2c0b4416c141fe674fe339f8dddd0e9839ebff2e8bec73552ee43577d328817 url=/mulesoft/current/ja-jp/runtime-manager/cluster-create.md -->

# Runtime Manager でのクラスターの作成

アプリケーションをクラスターにデプロイするには、最初に Runtime Manager にサーバーを追加してからクラスターを作成するか、または先にクラスターを作成してからサーバーを追加できます。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">ユニキャストクラスターにサーバーを追加すると、クラスター内のすべての既存のサーバーが再起動されます。</td></tr></tbody></table>

クラスターのすべてのサーバーでオブジェクトストアの永続性を保持するには、クラスターを手動で作成し、クォーラム管理を使用します。

## [](#制限)制限

サーバーをクラスターに追加する前に、以下の制限事項に注意してください。

- サーバーには、すでにデプロイされているアプリケーションを含めることはできません。
- サーバーは、他のクラスターやグループには所属できません。
- マルチキャストサーバーの状態は、​**\[Running (実行中)\]**​ または ​**\[Disconnected (切断済み)\]**​ のどちらでも構いません。
- ユニキャストサーバーの状態は \[Running (実行中)\] である必要があります。
- クラスター内のすべてのサーバーが同じ Mule Runtime Engine バージョン (月 1 回の更新を含む) と Runtime Manager エージェントバージョンを実行している必要があります。
    
    月 1 回の更新についての詳細は、​[「月 1 回の日付パッチ更新」](https://docs.mulesoft.com/cloudhub/cloudhub-app-runtime-version-updates#monthly-date-patch-updates)​を参照してください。

## [](#クラスターの作成)クラスターの作成

クラスターを作成するには次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Create Cluster (クラスターを作成)\]**​ ボタンをクリックします。
    
    ![「Create Cluster (クラスターを作成)」 ボタン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-cluster-create.png)
    
    Figure 1. **\[Servers (サーバー)\]**​ ページの ​**\[Create Cluster (クラスターを作成)\]**​ ボタンを示す矢印。
4. **\[Create Cluster (クラスターを作成)\]**​ ページで、クラスターの名前を入力します。
    
    クラスター名では、3 ～ 40 文字の英数字 (a-z、A-Z、0-9) とハイフン (-) を使用できます。先頭や末尾をハイフンにしたり、スペースや他の文字を含めたりすることはできません。
5. **\[Unicast (ユニキャスト)\]**​ または ​**\[Multicast (マルチキャスト)\]**​ を選択します。
6. 新しいクラスターに含めるサーバーを選択します。
7. **\[Create Cluster (クラスターを作成)\]**​ ボタンをクリックします。

**\[Servers (サーバー)\]**​ リストに新しいクラスターが表示されます。サーバーが ​**\[Servers (サーバー)\]**​ リストから消えます。クラスター内のサーバーのリストを表示するには、クラスター名をクリックします。

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

- [クラスター](https://docs.mulesoft.com/jp/runtime-manager/cluster-about)
- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [オブジェクトストアの永続性](https://docs.mulesoft.com/on-premises/latest/creating-and-managing-a-cluster-manually#object-store-persistence)
- [クォーラム管理](https://docs.mulesoft.com/on-premises/latest/creating-and-managing-a-cluster-manually#quorum-management)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)
- [デプロイメントとサーバーの拡張](https://docs.mulesoft.com/jp/runtime-manager/runtime-dep-serv-limits)

<!-- document id=bd45c580569601fc15827262fbfeb0e0a88c3252123fd31613e24844570333a5 url=/mulesoft/current/ja-jp/runtime-manager/runtime-manager-switch-env.md -->

# Runtime Manager での異なる環境の使用

Anypoint Platform では、デプロイメントを管理するために、本番、QA、開発など、さまざまな環境を作成して使用できます。使用するデプロイメントオプションには関係なく、アプリケーションは常に特定の環境にデプロイされます。

サーバーとアプリケーションは必ず特定の環境に関連付けられ、作成される環境内でのみ表示されます。各環境では異なる​[権限](https://docs.mulesoft.com/jp/access-management/managing-permissions)​のセットが必要なため、組織のさまざまなチーム間で役割を明確に分けることができます。

アプリケーションが Sandbox 環境でテストされ、本番への移行準備が整ったら、アプリケーションをアップロードし直さなくても、本番環境に直接昇格することができます。

## [](#runtime-manager-を使用した環境の切り替え)Runtime Manager を使用した環境の切り替え

組織に複数の環境がある場合、環境を切り替えることができます。Anypoint Platform の任意のアプリケーションから別の環境に切り替えることができます。

![managing deployed applications 0e10f](/mulesoft/current/ja-jp/runtime-manager/_images/managing-deployed-applications-0e10f.png)

1. Runtime Manager の左上隅の現在の環境をクリックします。
2. 切り替える先の環境を選択します。
3. **\[Switch (切り替え)\]**​ をクリックします。

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

- [環境](https://docs.mulesoft.com/jp/access-management/environments)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)

<!-- document id=6c862a7ac130c8da589ae8588813438f28748dfe86030ef4068340d5b1ddbe21 url=/mulesoft/current/ja-jp/runtime-manager/monitoring-dashboards.md -->

# Runtime Manager の監視ダッシュボード

Anypoint Runtime Manager の監視ダッシュボードには、デプロイされたアプリケーションとデプロイ先のシステムの両方の使用状況メトリクスの詳細が表示されます。

Anypoint Platform Private Cloud Edition では、Anypoint の監視ダッシュボード機能はサポートされていません。

ダッシュボードを表示するには、Runtime Manager の「Read Application (アプリケーションの参照)」権限または Runtime Manager の「Read Servers (サーバーの参照)」権限が必要です。

Anypoint Runtime Manager には以下のダッシュボードがあります。

- [アプリケーション監視ダッシュボード](#アプリケーション監視ダッシュボード)
    
    デプロイメント対象や状況など、アプリケーションに関する情報を表示します。
    
    Runtime Manager は、組み込みとクラシックの 2 種類のアプリケーションダッシュボードインターフェースを提供しています。表示されるダイアログボックスは、選択したアプリケーションのバージョン、種別、デプロイメント方法によって異なります。
- [サーバー監視ダッシュボード](#サーバー監視ダッシュボード)
    
    ヒープメモリと CPU のパーセンテージや、詳細なメモリ使用状況メトリクスなど、サーバーに関する高レベル情報を表示します。
- [サーバーグループまたはクラスター監視ダッシュボード](#サーバーグループまたはクラスター監視ダッシュボード)
    
    グループまたはクラスター内で選択されたサーバーの集計メトリクスを表示します。

これらのダッシュボードから収集した情報を使用して、以下を行うことができます。

- アプリケーションとサーバーのアラートを設定し、いずれかのメトリクスが長時間にわたって重大値を示すと自動的に通知されるようにします。
- 失敗の根本原因の分析、パフォーマンスのボトルネックの特定、会社の手続きに準拠しているかどうかのテストにインサイトを活用します。

## [](#アプリケーション監視ダッシュボード)アプリケーション監視ダッシュボード

[![logo cloud2 active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud2-active.png "CloudHub 2.0")](deployment-strategies#cloudhub-2-0) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](deployment-strategies#hybrid-deployments) [![logo rtf active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-active.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

アプリケーション監視ダッシュボードは、統合されたアプリケーションに関する次のような質問に答えるのに役立ちます。

- 使用量のピークが発生したのいつか?
- 高トラフィックのピークが応答時間に与える影響は?
- アプリケーションの背後の処理能力はこれらの高トラフィックのピークに適切に対処できているか?
- 高トラフィックのピークがメッセージの失敗率に与える影響は?
- 同じサーバーで実行されている他のアプリケーションの高トラフィックのピークが、特定のアプリケーションのパフォーマンスに与える影響は?

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ワーカーの再起動後は、CPU とメモリの情報はダッシュボードには表示されません。これらの情報を維持するには、​<code>dashboardStats</code>​ API を使用してください。または、Anypoint Monitoring で Titanium サブスクリプションを使用することで、このデータを保存できます。</td></tr></tbody></table>

### [](#組み込み-anypoint-monitoring-ダッシュボード)組み込み Anypoint Monitoring ダッシュボード

Anypoint Monitoring ダッシュボードは、クラシックアプリケーション監視ダッシュボードよりも多くの監視メトリクスを提供し、いろいろな種類のグラフを表示する複数のページがあります。

このダイアログボックスは、選択したアプリケーションが以下の場合に表示されます。

- CloudHub または Runtime Fabric にデプロイされている
- Mule 3.8.7-AM または 3.9.0 以降で実行されている
- Anypoint Monitoring が有効になっている

詳細については、Anypoint Monitoring ドキュメントの​[「組み込みアプリケーションダッシュボード」](https://docs.mulesoft.com/jp/monitoring/app-dashboards)​を参照してください。

### [](#クラシックアプリケーション監視ダッシュボード)クラシックアプリケーション監視ダッシュボード

クラシックアプリケーション監視ダッシュボードは、Mule メッセージ、CPU、およびメモリのメトリクスを表示します。

このダイアログボックスは、選択したアプリケーションが以下の場合に表示されます。

- CloudHub にデプロイされている
- 3.8.7 より前の Mule バージョンで実行されている
- オンプレミスでデプロイされている (ハイブリッド)
    
    ハイブリッドアプリケーションでは、監視が有効で、過去 24 時間に渡って監視された CPU メトリクスが存在する場合にダッシュボードが表示されます。
- 監視が有効化されていない

### [](#アプリケーション監視ダッシュボードにアクセスする)アプリケーション監視ダッシュボードにアクセスする

アプリケーションの監視ダッシュボードにアクセスしたときに表示されるダイアログボックスは、選択したアプリケーションのバージョン、種別、デプロイメント方法によって異なります。

アプリケーション監視ダッシュボードにアクセスするには、次の手順を実行します。

1. Runtime Manager で ​**\[Applications (アプリケーション)\]**​ をクリックします。
2. 監視するアプリケーションの名前を選択します。

### [](#アプリケーション監視ダッシュボードの操作)アプリケーション監視ダッシュボードの操作

表示しているダッシュボードの右上隅にある目的の期間を選択することで、異なる時間範囲でグラフを表示できます。

- 組み込み Anypoint Monitoring ダッシュボード:
    
    ![monitoring dashboards time ranges](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-time-ranges.png)
- クラシックアプリケーション監視ダッシュボード
    
    ![monitoring dashboards cbd92](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-cbd92.png)
    
    選択された各時間範囲の時間単位を下表に示します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 25%;">
<col style="width: 25%;">
<col style="width: 25%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top"></th>
<th class="tableblock halign-left valign-top" colspan="3"><strong>グラフに表示される平均、最小、最大:</strong></th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>選択された時間範囲</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Mule メッセージ数</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>エラー数</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>応答時間 (ミリ秒)</strong></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>3 時間</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎分</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎分</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎分</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>24 時間</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 分ごと</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 分ごと</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8 分ごと</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>7 日間</strong>​</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎時</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎時</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">毎時</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><strong>2 週間</strong></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2 時間ごと</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2 時間ごと</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2 時間ごと</p></td>
</tr>
</tbody>
</table>
    
    アプリケーションが同時に複数のワーカーで実行される場合は、異なる色で区別した曲線として、同じグラフ上に表示されます。
    
    アプリケーションがサーバーグループまたはクラスターで実行されている場合は、グループまたはクラスターに含まれるサーバーの集計メトリクスが 1 本の折れ線として各グラフに表示されます。メトリクスを個々のサーバーレベルで表示するには、個々のサーバーのダッシュボードを参照してください。サーバーで複数のアプリケーションが実行中の場合、表示されるのはサーバーの総合的なパフォーマンスで、実行中のアプリケーションごとに区別されません。

## [](#サーバー監視ダッシュボード)サーバー監視ダッシュボード

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments)

サーバー監視ダッシュボードは、ヒープメモリと CPU のパーセンテージや、詳細なメモリ使用状況メトリクスなど、サーバーに関する高レベル情報を表示します。

### [](#アプリケーション監視ダッシュボードにアクセスする-2)アプリケーション監視ダッシュボードにアクセスする

サーバー監視ダッシュボードにアクセスするには、次の手順を実行します。

1. Runtime Manager で ​**\[Servers (サーバー)\]**​ をクリックします。
2. 監視するサーバーの名前を選択します。
    
    サーバーのダッシュボードが表示されます。
    
    ![monitoring dashboards server](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-server.png)

サーバーの監視ダッシュボードには、サーバーが含まれる​[サーバーグループダッシュボードまたはクラスターダッシュボード](#サーバーグループダッシュボードまたはクラスターダッシュボードにアクセスする)​から移動することもできます。

### [](#サーバー監視ダッシュボードの操作)サーバー監視ダッシュボードの操作

サーバー監視ダッシュボードでは、メトリクスを 2 つのタブで表示します。

- [Overview (概要) タブ](#overview-概要-タブ)
    
    サーバーのメモリと CPU の使用量を概要レベルで表示します。
- [Breakdown (詳細分析) タブ](#breakdown-詳細分析-タブ)
    
    サーバーメモリの各部を別々に追跡する詳細なメトリクスを表示します。

表示しているダッシュボードの右上隅にある目的の期間を選択することで、異なる時間範囲でグラフを表示できます。

![monitoring dashboards cbd92](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-cbd92.png)

グラフ上にマウスポインターを置くことで、その時点で発生したアクティビティに関する数値の詳細がフロート表示されます。

![monitoring dashboards hover](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-hover.png)

サーバーで複数のアプリケーションが実行されている場合は、アプリケーションのチェックボックスをオンにすることで右側にデータの詳細ペインを表示して、別々のグラフセットで各アプリケーションのパフォーマンスを確認できます。

ダッシュボードのメモリ使用量のグラフは以下の値を追跡します。

- **使用量**
    
    現在使用中のメモリの量 (MB 単位)。
    
    Java VM が使用メモリを増量してコミット済みメモリよりも大きくしようとすると、使用量が合計未満であっても、メモリの割り当てが失敗します。
- **Total (合計)**
    
    サーバーが使用できるメモリの最大量 (MB 単位)。最大量は変動するか、または未定義の場合があります。
- **Committed (コミット済み)**
    
    Java VM で使用できるメモリの量 (MB 単位)。この量は時間と共に変動します。コミット済みメモリの量は、常に使用メモリの量以上になります。

#### [](#overview-概要-タブ)Overview (概要) タブ

\[Overview (概要)\] タブのグラフには、メモリと CPU の使用量に高レベルのメトリクスが表示されます。

ヒープメモリ

合計ヒープメモリ使用量 (MB 単位)。

- ヒープメモリの使用量
- メモリ合計
- コミット済みヒープメモリ
    
    ![monitoring dashboards heap](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-heap.png)

ヒープメモリの各コンポーネントの詳細は、​[Breakdown (詳細分析) タブ](#breakdown-詳細分析-タブ)を参照してください。

CPU

Windows ではこのメトリクスは使用できません。

サーバーの合計 CPU 使用量:

- CPU 使用量
- Available Processors (使用可能なプロセッサー)
- Load Average (負荷平均)

![monitoring dashboards cpu](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-cpu.png)

**\[CPU Usage (CPU 使用量)\]**​ は、サーバーの使用済み処理容量を示すパーセンテージ値です。 **\[Available Processors (使用可能なプロセッサー)\]**​ は、サーバーで使用可能なプロセッサー数を示す整数値です。 CPU 負荷とは、サーバーの CPU によって実行されている、または実行を待機しているタスクの数です。 **\[Load Average (負荷平均)\]**​ は、指定された期間の実行中、または CPU 時間の割り当てを待機中のプロセスの平均数を示す整数値です。

#### [](#breakdown-詳細分析-タブ)Breakdown (詳細分析) タブ

\[Breakdown (詳細分析)\] タブのグラフは、サーバーメモリの各部を別々に追跡する詳細なメトリクスを表示します。

- ヒープメモリメトリクスは、JVM ヒープを構成するサーバーメモリ部分に関連します。
    
    - [Eden](#eden)
    - [Survivor](#survivor)
    - [Old Gen (旧世代)](#old_gen)
- 非ヒープメモリメトリクスは、JVM ヒープの外側に存在するメモリを指します。
    
    - [Code Cache (コードキャッシュ)](#code_cache)
    - [Compressed Class Space (圧縮クラス領域)](#compressed_class)
    - [メタ領域](#metaspace)

Thread Count (スレッド数)

個々の Java スレッド数の推移。

![monitoring dashboards threads](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-threads.png)

ガベージコレクション

ヒープの以下の領域のメトリクス:

- Young Generation (新世代)、すべての新しいオブジェクトが割り当てられます。
- Old Generation (旧世代)、存続しているオブジェクトが格納されます。
    
    ![monitoring dashboards garbage](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-garbage.png)

Class Loading (クラスローディング)

JVM にあるすべてのアプリケーションを合計した、現在ロード済みまたはロード中のクラスの量:

![monitoring dashboards classloading](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-classloading.png)

Eden

ほとんどのオブジェクトに最初に割り当てられるメモリが含まれているヒープ領域内のプール。

![monitoring dashboards eden](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-eden.png)

Survivor

Eden 領域のガベージコレクションを耐え抜いたオブジェクトが含まれているヒープ内のプール。

![monitoring dashboards survivor](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-survivor.png)

Old Gen (旧世代)

Survivor 領域内にしばらく存在したオブジェクトが含まれているヒープ内のプール。

![monitoring dashboards tenure](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-tenure.png)

Code Cache (コードキャッシュ)

ネイティブコードのコンパイルと保存に使用されるメモリが含まれる領域。

![monitoring dashboards cache](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-cache.png)

Compressed Class Space (圧縮クラス領域)

このメトリクスは、JDK 8+ を使用する場合にのみ使用できます。

![monitoring dashboards class space](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-class-space.png)

Metaspace (メタ領域)

クラスのメタデータの表現にネイティブメモリが使用される JVM のメモリ領域。

このメトリクスは、JDK 8+ を使用する場合にのみ使用できます。

![monitoring dashboards meta](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-meta.png)

現時点のメタ領域の上限は 256 MB です。

## [](#サーバーグループまたはクラスター監視ダッシュボード)サーバーグループまたはクラスター監視ダッシュボード

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments)

サーバーグループまたはクラスター監視ダッシュボードを使用すると、グループまたはクラスター内のサーバーの集計メトリクスを表示できます。

サーバーグループまたはクラスター監視ダッシュボードには、以下の集計メトリクスが表示されます。

- CPU usage (CPU 使用量) (最大量に対する割合)
- Memory usage (メモリ使用量) (MB 単位)
- Heap total (ヒープ合計) (MB 単位)

選択されたサーバーの集計メトリクスは、1 本の折れ線として各グラフに表示されます。

### [](#サーバーグループダッシュボードまたはクラスターダッシュボードにアクセスする)サーバーグループダッシュボードまたはクラスターダッシュボードにアクセスする

オンプレミスデプロイでサーバーグループまたはクラスター内のサーバーの集計メトリクスを表示するには、次の手順を実行します。

1. Runtime Manager で ​**\[Servers (サーバー)\]**​ をクリックします。
2. ダッシュボードを表示するクラスターまたはサーバーグループの名前をクリックします。
3. 集計メトリクスを詳細ペインに表示する 1 つ以上のサーバーまたはアプリケーションをリストから選択します。

### [](#グループダッシュボードまたはクラスターダッシュボードの操作)グループダッシュボードまたはクラスターダッシュボードの操作

右上隅にある期間を選択することで、異なる時間間隔でグラフを表示できます。

![monitoring dashboards cbd92](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-cbd92.png)

適切なタブをクリックすることで、サーバーまたはアプリケーションの情報を表示できます。

![monitoring dashboards 6fe9f](/mulesoft/current/ja-jp/runtime-manager/_images/monitoring-dashboards-6fe9f.png)

このダイアログボックスで、​[サーバー](#サーバー監視ダッシュボードにアクセスする)​または​[アプリケーション](#アプリケーション監視ダッシュボードにアクセスする)​の名前をクリックすると、それぞれのダッシュボードにアクセスできます。

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

- [Anypoint Monitoring の概要](https://docs.mulesoft.com/jp/monitoring/)
- [CloudHub API ダッシュボード統計](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/cloudhub-api/1.0.11/console/method/%231708/)
- [Mule アプリケーションの Anypoint Monitoring の設定と有効化 (CloudHub)](https://docs.mulesoft.com/jp/monitoring/configure-monitoring-cloudhub)
- [組み込みアプリケーションダッシュボード](https://docs.mulesoft.com/jp/monitoring/app-dashboards)
- [CloudHub](https://docs.mulesoft.com/cloudhub/)
- [クラスタリング](https://docs.mulesoft.com/cloudhub/cloudhub-fabric)
- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [インサイト](https://docs.mulesoft.com/jp/runtime-manager/insight)

<!-- document id=454604e7f755b791269f3126d8cf0a8fa8e167c1ca5ed60b1aef94d69bf93192 url=/mulesoft/current/ja-jp/runtime-manager/servers-create.md -->

# Runtime Manager へのサーバーの追加

Runtime Manager コンソールに Mule サーバーを追加するには、最初にサーバーを Runtime Manager エージェントに登録する必要があります。​`amc_setup`​ スクリプトを使用して、Runtime Manager と通信するように Runtime Manager エージェントを設定します。

## [](#前提条件)前提条件

- Enterprise ライセンスが最新であること。
- Mule 3.6.0 以降および API ゲートウェイ 2.1 以降が動作していること。
    
    Mule 3.6.x の場合は、Runtime Manager エージェントをインストールします。
    
    Mule 3.7.x 以降の Mule 3.x バージョンでは、必要に応じて Runtime Manager エージェントを最新バージョンに更新して、すべてのバグ修正と新機能を利用できます。
    
    詳細は、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​を参照してください。
- エージェントをダウンロードする場合は、Enterprise サポートアカウントが必要です。
- 追加するサーバーが Runtime Manager の別のインスタンスにすでに登録されている場合は、先にそのインスタンスへの登録を解除してください。

## [](#サーバーを追加する)サーバーを追加する

Runtime Manager にサーバーを追加する手順は、次のとおりです。

1. Anypoint Platform の ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
3. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
4. サーバーの名前を入力します。
    
    サーバー名には最大 60 文字の英数字 (a-z, A-Z、0-9)、ピリオド (.)、ハイフン (-)、アンダースコア (\_) を含めることができますが、スペースやその他の特殊文字は含めることができません。 Runtime Manager では、サーバー名で Unicode 文字がサポートされています。
    
    サーバー名は環境内で一意である必要がありますが、同じ組織が異なる環境に存在している場合は、同じサーバー名を使用できます。
    
    Runtime Manager により、​`amc_setup`​ コマンドが生成されます。 このコマンドには、指定したサーバー名 (​`_server-name_`​) と環境に Mule を登録するために必要な登録トークン (​`_token_`​) が含まれます。 登録トークンには、組織 ID と現在の環境が含まれます。
    
    ![Add Server (サーバーを追加) ウィンドウの amc\_setup コマンド](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-add-server.png)
    
    Figure 1. 矢印は、​**\[Add Server (サーバーを追加)\]**​ ウィンドウの ​`amc_setup`​ コマンドを示しています。
5. **\[Copy command (コマンドをコピー)\]**​ をクリックして ​`amc_setup`​ コマンドをコピーします。
    
    このボタンは、指定したサーバー名が有効である場合にのみ表示されます。
6. ターミナルウィンドウで、登録する Mule インスタンスの ​`$MULE_HOME/bin`​ ディレクトリに変更します。
7. コマンドラインにコマンドを貼り付けます。
8. `amc_setup`​ コマンドラインで他のパラメーターを指定します。
    
    詳細は、​[「amc\_setup パラメーター」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#amc_setup-parameters)​を参照してください。
9. すべてのアウトバウンドコールがプロキシを経由する必要がある環境の場合は、​`$MULE_HOME/conf/mule-agent.yml`​ ファイルまたは ​`$MULE_HOME/conf/wrapper.conf`​ ファイルでプロキシ設定を指定してください。
    
    [「プロキシサーバー経由のエージェントへの接続」](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-proxy-config)​を参照してください。
10. IBM JVM を使用している場合は、​[IBM JVM](#ibm-jvm)​ を参照してください。

`amc_setup`​ が正常に完了すると、次のメッセージが表示されます。

Mule Agent configured successfully
Connecting to Access Management to extract client\_id and client\_secret
Credentials extracted correctly, updating wrapper conf file

スクリプトが正常に完了した後、サーバー名が Runtime Manager の ​**\[Servers (サーバー)\]**​ タブに ​`Created`​ の状況で表示されます。

`amc_setup`​ スクリプトを実行したときにサーバーが実行中であった場合は、サーバーを再起動して Runtime Manager と再接続してください。

## [](#ibm-jvm)IBM JVM

IBM の Java 仮想マシン (JVM) を使用してサーバーを作成する場合、Runtime Manager エージェントによってインストールされたデフォルトのトラストストアとは異なるトラストストアファイルを使用する必要があります。

1. 次のナレッジ記事からカスタムトラストストアをダウンロードします。
    
    [Connectivity issues between Mule and Anypoint Runtime Manager using an IBM JVM (IBM JVM を使用する場合の Mule と Anypoint Runtime Manager 間の接続の問題)](https://help.mulesoft.com/s/article/Connectivity-issues-between-Mule-Runtime-and-Anypoint-Runtime-manager-using-an-IBM-JVM)
2. 使用している Mule バージョンに応じて、​`$MULE_HOME/conf`​ の ​`truststore`​ ファイルの名前を次のいずれかに変更してください。
    
    - `anypoint-truststore.jks`
        
        Mule 4.1.3 (エージェント 2.1.4) 以降
    - `truststore.jks`
        
        Mule 4.1.2 (エージェント 2.1.3)
3. カスタムトラストストアを ​`$MULE_HOME/conf`​ フォルダーにコピーします。
4. Mule を再起動します。

## [](#別の-runtime-manager-インスタンスからサーバーを削除する)別の Runtime Manager インスタンスからサーバーを削除する

追加するサーバーが Runtime Manager の別のインスタンスにすでに登録されている場合は、先のそのインスタンスからサーバーを削除しないと別のインスタンスには登録できません。

Runtime Manager からサーバーを削除する手順は、次のとおりです。

1. Runtime Manager で、​**\[Server (サーバー)\]**​ タブからサーバーを削除します。
    
    [「サーバーのシャットダウン、再起動、削除」](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)​を参照してください。
2. `$MULE_HOME/conf`​ ディレクトリで ​`mule-agent.yaml`​ および ​`mule-agent.jks`​ ファイルを削除します。

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

- [オンプレミスでの Mule Runtime Engine の実行](https://docs.mulesoft.com/on-premises/latest/)
- [Runtime Manager エージェントのインストールまたは更新](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)
- [ポート、IP アドレス、ホスト名の許可](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-allowlists)

<!-- document id=3a1853a876a6b5488f8afa6355bfe561d1b8793240dc1de9f77ee4be7b20b928 url=/mulesoft/current/ja-jp/runtime-manager/monitoring.md -->

# アプリケーションとサーバーの監視

アプリケーションをデプロイしたら、Runtime Manager の監視ダッシュボードを使用して、アプリケーションのパフォーマンスを監視します。アプリケーションをオンプレミスサーバーにデプロイした場合は、サーバーも監視できます。

使用している​[デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)​により、アラート、ダッシュボード、通知、フローメトリクスなど、使用できるリソースが異なります。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">CloudHub 2.0 デプロイメントでは、Runtime Manager の監視機能はアプリケーションでのみ使用できます。詳細は、​<a href="https://docs.mulesoft.com/cloudhub-2/ch2-monitor-apps" class="xref page">「CloudHub 2.0 にデプロイされたアプリケーションの監視」</a>​を参照してください。</td></tr></tbody></table>

## [](#サーバーの監視)サーバーの監視

オンプレミスでデプロイしたアプリケーションでは、以下のツールを使用してサーバーの情報を取得できます。

- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager#conditions-on-mule-servers) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments)
    
    重要なイベントが発生したらメールアラートを送信します。これらのアラートがトリガーされた日時の履歴にアクセスすることもできます。
- [ダッシュボードの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards#the-dashboard-for-a-server) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-active.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)
    
    サービス使用量と利用可能な処理能力に関するパフォーマンスの重要なメトリクスの推移を参照します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">Mule が Windows で動作している場合に Runtime Manager の監視ダッシュボードを使用するには、​<strong>パフォーマンスログユーザー</strong>​グループに属するユーザーが Mule サービスを起動する必要があります。</td></tr></tbody></table>

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

- [ダッシュボードの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)
- [Mule の起動と停止](https://docs.mulesoft.com/on-premises/latest/starting-and-stopping-mule-esb#starting-mule-as-a-windows-service)
- [アラートの設定](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [Runtime Manager の通知](https://docs.mulesoft.com/cloudhub/notifications-on-runtime-manager)
- [カスタムアプリケーションアラートおよび通知](https://docs.mulesoft.com/cloudhub/custom-application-alerts)
- [フローメトリクス](https://docs.mulesoft.com/jp/runtime-manager/flow-metrics)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)
- [インサイト](https://docs.mulesoft.com/jp/runtime-manager/insight)

<!-- document id=0c48bd234aebfe20f665145dcc78411d3c979592a0f6b289287b098ee2dfc8a2 url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-app-validator.md -->

# アプリケーションバリデーターサービス

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

アプリケーションバリデーターサービスを使用すると、独自のカスタムバリデーターを作成し、特定の条件を満たさなかった場合にアプリケーションがデプロイされるのを防止できます。 Mule Runtime Agent 設定に応じて、このサービスではカスタムバリデーターを呼び出し、署名検証、命名規則、モラトリアム日などのビジネスルールを適用します。

![アプリケーション検証フローチャート](/mulesoft/current/ja-jp/runtime-manager/_images/app-validator-chart.png)

## [](#アプリケーションバリデーターの作成)アプリケーションバリデーターの作成

次の手順に従って、アプリケーションプロパティの値を確認し、指定された条件を満たさない場合はデプロイメントを停止するカスタムバリデーターを作成します。

- [Maven プロジェクトを作成する](#create-a-maven-project)
- [プロジェクトオブジェクトモデル (POM) ファイルを作成する](#create-the-project-object-model-pom-file)
- [バリデータークラスを作成する](#create-the-validator-class)
- [ビジネスロジックを実装する](#implement-business-logic)
- [カスタム例外を実装する](#implement-custom-exceptions)
- [Guice 設定を追加する](#add-the-guice-configuration)
- [アプリケーションバリデーターを作成する](#build-the-application-validator)
- [アプリケーションバリデーターをインストールする](#install-the-application-validator)
- [`mule-agent.yml`​ ファイルを更新する](#update-the-mule-agent-yml-file)
- [Mule Runtime を起動する](#start-mule-runtime)

### [](#maven-プロジェクトを作成する)Maven プロジェクトを作成する

ターミナルを開き、Java プロジェクトを作成するフォルダーに移動して、次のコマンドを入力します。

```console
mvn archetype:generate \
	-DgroupId=org.example.agent \
	-DartifactId=mule-agent-hello-validator \
	-DarchetypeArtifactId=maven-archetype-quickstart \
	-DinteractiveMode=false
```

#### [](#maven-ディレクトリレイアウト)Maven ディレクトリレイアウト

前のコマンドにより、次のプロジェクトディレクトリ構造が作成されます。

```java
./mule-agent-hello-validator
./mule-agent-hello-validator/pom.xml
./mule-agent-hello-validator/src
./mule-agent-hello-validator/src/test
./mule-agent-hello-validator/src/test/java
./mule-agent-hello-validator/src/test/java/org
./mule-agent-hello-validator/src/test/java/org/example
./mule-agent-hello-validator/src/test/java/org/example/agent
./mule-agent-hello-validator/src/test/java/org/example/agent/AppTest.java
./mule-agent-hello-validator/src/main
./mule-agent-hello-validator/src/main/java
./mule-agent-hello-validator/src/main/java/org
./mule-agent-hello-validator/src/main/java/org/example
./mule-agent-hello-validator/src/main/java/org/example/agent
./mule-agent-hello-validator/src/main/java/org/example/agent/App.java
```

### [](#project-object-model-pom-ファイルを作成する)Project Object Model (POM) ファイルを作成する

次の設定の詳細で POM ファイルを作成します。

#### [](#プロパティ)プロパティ

1. 生成されたフォルダーにアクセスして、生成された ​`pom.xml`​ を特定します。
2. 次のプロパティを追加します。

```xml
<properties>
    <maven.compiler.source>8</maven.compiler.source>
    <maven.compiler.target>8</maven.compiler.target>
    <mule.agent.version>2.4.28</mule.agent.version>
    <javax.servlet-api.version>3.1.0</javax.servlet-api.version>
    <javax.ws.version>2.0</javax.ws.version>
    <log4j.version>2.17.1</log4j.version>
    <guice.version>5.0.1</guice.version>
    <javax.inject.version>1</javax.inject.version>
</properties>
```

前のプロパティは、次の必須の連動関係に使用されるバージョンを表します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>mule-agent-api</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Mule エージェントプラグイン用の Java API</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>javax.ws.rs-api</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>RESTful Web サービス用の Java API</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>javax.servlet-api</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Java Servlet API</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>javax.inject</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>javax.inject API</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>guice</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Google Guice コアライブラリ</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>log4j-api</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Apache Log4j API</p>
</div></div></td>
</tr>
</tbody>
</table>

#### [](#連動関係)連動関係

`com.mulesoft.agent:mule-agent-api`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>com.mulesoft.agent</groupId>
            <artifactId>mule-agent-api</artifactId>
            <version>${mule.agent.version}</version>
            <scope>provided</scope>
        </dependency>
```

`javax.ws.rs:javax.ws.rs-api`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>javax.ws.rs</groupId>
            <artifactId>javax.ws.rs-api</artifactId>
            <version>${javax.ws.version}</version>
        </dependency>
```

`javax.servlet:javax.servlet-api`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>${javax.servlet-api.version}</version>
        </dependency>
```

`javax.inject:javax.inject`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>javax.inject</groupId>
            <artifactId>javax.inject</artifactId>
            <version>${javax.inject.version}</version>
        </dependency>
```

`com.google.inject:guice`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>com.google.inject</groupId>
            <artifactId>guice</artifactId>
            <version>${guice.version}</version>
        </dependency>
```

`log4j`​ の連動関係を追加します。

```xml
        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-api</artifactId>
            <version>${log4j.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-core</artifactId>
            <version>${log4j.version}</version>
            <scope>compile</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.logging.log4j</groupId>
            <artifactId>log4j-slf4j-impl</artifactId>
            <version>${log4j.version}</version>
            <scope>compile</scope>
        </dependency>
```

#### [](#リポジトリ)リポジトリ

MuleSoft リポジトリとスナップショットリポジトリを追加します。

```xml
    <repositories>
        <repository>
            <id>mulesoft-ci-releases</id>
            <name>Mulesoft Release Repository</name>
            <url>https://repository-master.mulesoft.org/nexus/content/repositories/releases-ee/</url>
        </repository>
        <repository>
            <id>mulesoft-ci-snapshots</id>
            <name>MuleSoft Snapshot Repository</name>
            <url>https://repository-master.mulesoft.org/nexus/content/repositories/ci-snapshots/</url>
        </repository>
    </repositories>
```

### [](#バリデータークラスを作成する)バリデータークラスを作成する

1. デフォルトのクラスの名前を ​`MuleAgentHelloValidator`​ に変更します。
    
    **変更前**​: `mule-agent-hello-validator/src/main/java/org/example/App.java`
    
    **変更後**​: `mule-agent-hello-validator/src/main/java/org/example/MuleAgentHelloValidator.java`
2. 次のアノテーションを追加します。
    
    ```java
    @Named("MuleAgentHelloValidator")
    @Singleton
    ```
3. 次のプロパティを追加し、バリデータークラスに基づいて指定ロガーを取得します。
    
    ```java
    private static final Logger LOGGER = LogManager.getLogger(MuleAgentHelloWorld.class);
    ```
4. アーティファクトバリデーターインターフェースを実装します。
    
    ```java
    public class MuleAgentHelloWorld implements ApplicationValidator {
    
        private static final Logger LOGGER = LogManager.getLogger(MuleAgentHelloWorld.class);
    
    
        // Type represents a group of validator implementations
        public String getType() {
            return "helloValidator";
        }
    
    
        // Custom name for the implementation.
        // Represent a specific use case related to the validator type
        // Must be unique in the type.
        public String getName() {
            return "defaultHelloValidator";
        }
    
        public void validate(Map<String, Object> args) throws ArtifactValidationException {
    
        }
    }
    ```
5. `mule-agent.yml`​ ファイルで提供されるバリデーター設定を含む ​`args`​ パラメーターを追加します。
    
    ```java
      services:
    	mule.agent.artifact.validator.service:
    		enabled: true
    		validators:
    		- type: helloValidator
    			name: defaultHelloValidator
    			enabled: true
    			args:
    				business: finance
    				welcomeMessage: 'Hi, welcome to Finance Cluster Runtimes'
    				errorMessage: 'I am sorry, you are not allowed to deploy in this Cluster'
    ```
    
    また、サービスによって挿入される次の値も含まれます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キー</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>_APPLICATION_NAME</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションの名前を表す文字列。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>_APPLICATION_FILE_PATH</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションのデプロイに使用される一時ファイルのパスを表す文字列値。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>_APPLICATION_PROPERTIES</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションのプロパティを表す Map&lt;String, String&gt;。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#ビジネスロジックの実装)ビジネスロジックの実装

次の例では、Mule Runtime にデプロイされるすべてのアプリケーションに ​`business`​ というアプリケーションプロパティが必要です。このプロパティ値は、アプリケーションの部門オーナーを表します。

```java
    string applicationBusiness =
       (applicationProperties == null)
          ? null
          : applicationProperties.get("business");

    if (applicationBusiness != null && applicationBusiness.equals(allowedBusiness)) {
        LOGGER.info(welcomeMessage);
        return;
    }

    throw new ArtifactValidationException(errorMessage);
```

### [](#カスタム例外の実装)カスタム例外の実装

前のエラーを表すカスタム例外を作成します。

パッケージ ​`org.example`​ で、​`exceptions`​ という名前の新しいパッケージを追加し、次のクラスを作成します。

```java
public class BusinessNotAllowedException extends ApplicationValidationException {

    public BusinessNotAllowedException(String message) {
        super(message);
    }
}
```

プロジェクトディレクトリのレイアウトは次のようになります。

```java
./mule-agent-hello-validator/src/main/java/org/example/agent/exceptions
./mule-agent-hello-validator/src/main/java/org/example/agent/exceptions/BusinessNotAllowedException.java
```

汎用の ​`ApplicationValidationException`​ を ​`BusinessNotAllowedException`​ に置き換えます。

```java
    throw new BusinessNotAllowedException(errorMessage);
```

### [](#guice-設定を追加する)Guice 設定を追加する

1. `BaseModuleProvider`​ クラスを作成します。
    
    パッケージ ​`org.example`​ で、​`configuration.guice`​ という名前の新しいパッケージを追加し、次のクラスを作成します。
    
    ```java
    public class MuleAgentHelloValidatorProvider extends BaseModuleProvider {
        @Override
        protected void configureModule(Binder binder) {
            bindNamedSingleton(binder, ApplicationValidator.class, MuleAgentHelloValidator.class);
        }
    }
    ```
2. `BaseModuleProvider`​ クラスを作成します。
    
    ディレクトリ ​`src/main`​ で、​`META-INF/services`​ という名前の新しいフォルダーを追加し、次のファイルを作成します。
    
    名前: `com.mulesoft.agent.configuration.guice.ModuleProvider`
    
    コンテンツ: `com.example.configuration.guice.MuleAgentHelloValidatorProvider`

プロジェクトディレクトリのレイアウトは次のようになります。

```java
./mule-agent-hello-validator/src/main/resources
./mule-agent-hello-validator/src/main/resources/META-INF
./mule-agent-hello-validator/src/main/resources/META-INF/services
./mule-agent-hello-validator/src/main/resources/META-INF/services/com.mulesoft.agent.configuration.guice.ModuleProvider
./mule-agent-hello-validator/src/main/java/org/example/agent/configuration
./mule-agent-hello-validator/src/main/java/org/example/agent/configuration/guice
./mule-agent-hello-validator/src/main/java/org/example/agent/configuration/guice/MuleAgentHelloValidatorProvider.java
```

### [](#アプリケーションバリデーターを作成する)アプリケーションバリデーターを作成する

次のコマンドを実行します。

```console
mvn clean install
```

対象ディレクトリに JAR ファイルが生成されます。

```java
./mule-agent-hello-validator/target
./mule-agent-hello-validator/target/mule-agent-hello-validator-1.0-SNAPSHOT.jar
```

### [](#アプリケーションバリデーターをインストールする)アプリケーションバリデーターをインストールする

1. JAR ファイルを ​`$MULE_HOME/server-plugins/mule-agent-plugin/lib`​ に配置します。
2. `args`​ パラメーターの鍵と値にアクセスして、コンソールに出力します。
    
    ```java
    public void validate(Map<String, Object> args) throws ApplicationValidationException {
    
        // Values injected by the MuleAgentApplicationValidator service
        String applicationName = (String) args.get("_APPLICATION_NAME");
        String applicationFilePath = (String) args.get("_APPLICATION_FILE_PATH");
        Map<String, String> applicationProperties = (Map) args.get("_APPLICATION_PROPERTIES");
    
        // Validator configuration values
        String business = (String) args.get("business");
        String welcomeMessage = (String) args.get("welcomeMessage");
        String errorMessage = (String) args.get("errorMessage");
    
        LOGGER.info("Values injected by the service:");
        LOGGER.info("\tApplication name: {}", applicationName);
        LOGGER.info("\tApplication file path: {}", applicationFilePath);
        LOGGER.info("\tApplication properties: {}", applicationProperties);
    
        LOGGER.info("Validator configurations:");
        LOGGER.info("\tBusiness: {}", business);
        LOGGER.info("\tWelcome message: {}", welcomeMessage);
        LOGGER.info("\tError message: {}", errorMessage);
    }
    ```

### [](#mule-agent-yml-ファイルの更新)mule-agent.yml ファイルの更新

サービスの検証設定を追加します。

```java
services:
	mule.agent.artifact.validator.service:
		enabled: true
		validators:
		- type: helloValidator
			name: defaultHelloValidator
			enabled: true
			args:
				business: finance
				welcomeMessage: 'Hi, welcome to Finance Cluster Runtimes'
				errorMessage: 'I am sorry, you are not allowed to deploy in this Cluster'
```

### [](#mule-runtime-を起動する)Mule Runtime を起動する

Mule Runtime を起動し、バリデーターが正常に設定されたことを確認します。コンソールに次のログが表示されます。

```console
AgentArtifactValidatorService: Total validators loaded: 1
AgentArtifactValidatorService: Validators listed by type:
AgentArtifactValidatorService: 	Type: helloValidator Names: [defaultHelloValidator]
```

## [](#アプリケーションをデプロイする)アプリケーションをデプロイする

バリデーターを作成してインストールすると、エージェントバリデーターサービスは、アプリケーションのデプロイ時にカスタムバリデーターを呼び出します。

curl コマンド:

```console
curl -X PUT 'http://localhost:9999/mule/applications/app-01' \
-H 'Content-Type: application/json' \
-d '{
  "url": "file:/tmp/app-01.jar",
  "configuration": {
    "mule.agent.application.properties.service": {
      "applicationName": "app-01",
      "properties": {
          "business": "finance"
      }
    }
  }
}'
```

応答:

```console
{
  "application": {
    "name": "app-01"
  },
  "status": "Deployment attempt started"
}
```

コンソールログ:

```console
MuleAgentHelloValidator: Values injected by the service:
MuleAgentHelloValidator:   Application name: app-01
MuleAgentHelloValidator:   Application file path: /tmp/mule-received-artifact-1793122713159733968/app-01.jar
MuleAgentHelloValidator:   Application properties: {business=finance}
MuleAgentHelloValidator: Validator configurations:
MuleAgentHelloValidator:   Allowed Business: finance
MuleAgentHelloValidator:   Welcome message: Hi, welcome to Finance Cluster Runtimes
MuleAgentHelloValidator:   Error message: I am sorry you not allowed to be deployed in this Cluster
MuleAgentHelloValidator: Hi, welcome to Finance Cluster Runtimes
```

## [](#バリデーター設定で値を暗号化する)バリデーター設定で値を暗号化する

バリデーターが ​`mule-agent.yml`​ で指定されたシークレットを必要とする場合は、​`amc_setup.sh`​ スクリプトを使用してシークレットおよびパスワードや、その他の値を暗号化することができます。 詳細は​[「パスワードを暗号化する」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#encrypt-passwords)​を参照してください。

1. 単一値を暗号化します。
    
    `AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myPassword`
2. 暗号化ユーティリティを実行します。
    
    `$MULE_HOME/bin/amc_setup --encrypt my-secret-value`
    
    出力:
    
    ```console
    Mule Agent Installer
    -----------------------------
    
    
    	INFO: The encrypted value to paste on the mule-agent.yml file is: '![PBEWITHSHA1ANDDESEDE,wFE1D5V4DMb0uG77mzU+gibrlmnj3Kzb]'
    ```
3. バリデーター設定サービスで暗号化された値を追加します。

```yaml
  mule.agent.artifact.validator.service:
    enabled: true
    validators:
    - type: helloValidator
      name: defaultHelloValidator
      enabled: true
      args:
        business: finance
        welcomeMessage: 'Hi, welcome to Finance Cluster Runtimes'
        errorMessage: 'I am sorry you not allowed to be deployed in this Cluster'
        secret: '![PBEWITHSHA1ANDDESEDE,wFE1D5V4DMb0uG77mzU+gibrlmnj3Kzb]'
```

## [](#バリデーターで値を復号化する)バリデーターで値を復号化する

暗号化サービスを使用して値を復号化することができます。

1. バリデータークラスに暗号化サービスを挿入します。
    
        @Inject
        EncryptionService encryptionService;
2. 値を復号化します。
    
    ```java
    String secret = (String) args.get("secret");
    
    String secretPlainText = null;
    
    try {
       secretPlainText = encryptionService.decrypt(secret);
    } catch (AgentEncryptionException e) {
       LOGGER.error(e);
    }
    
    LOGGER.info("\tSecret: {}", secret);
    LOGGER.info("\tSecret (plain text): {}", secretPlainText);
    ```

## [](#ユースケース-バリデーターに暗号化された値を渡す)ユースケース: バリデーターに暗号化された値を渡す

curl コマンド:

```console
curl -X PUT 'http://localhost:9999/mule/applications/app-01' \
-H 'Content-Type: application/json' \
-d '{
  "url": "file:/tmp/app-01.jar",
  "configuration": {
    "mule.agent.application.properties.service": {
      "applicationName": "app-01",
      "properties": {
          "business": "finance"
      }
    }
  }
}'
```

応答:

```console
{
  "application": {
    "name": "app-01"
  },
  "status": "Deployment attempt started"
}
```

コンソールログ:

```console
AgentApplicationService: Deploying the app-01 application from URL file:/tmp/app-01.jar
MuleAgentHelloValidator: Values injected by the service:
MuleAgentHelloValidator: Application name: app-01
MuleAgentHelloValidator: Application file path: /tmp/mule-received-artifact-6683649864468336756/app-01.jar
MuleAgentHelloValidator: Application properties: {business=finance}
MuleAgentHelloValidator: Validator configurations:
MuleAgentHelloValidator: Allowed Business: finance
MuleAgentHelloValidator: Welcome message: Hi, welcome to Finance Cluster Runtimes
MuleAgentHelloValidator: Secret: ![PBEWITHSHA1ANDDESEDE,wFE1D5V4DMb0uG77mzU+gibrlmnj3Kzb]
MuleAgentHelloValidator: Secret (plain text): my-secret-value
MuleAgentHelloValidator: Hi, welcome to Finance Cluster Runtimes
```

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

- [Runtime Manager エージェント](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent)
- [高度な用途](https://docs.mulesoft.com/jp/runtime-manager/advanced-usage)
- [JAR 署名バリデーター](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-jar-signature-validator)

<!-- document id=3d12c962abd848555cee7e84ff82080c8bb5f2ab2ba2c4337cce456473ad6ee3 url=/mulesoft/current/ja-jp/runtime-manager/alerts-on-runtime-manager.md -->

# アラート

アプリケーションまたはサーバーのイベントが発生したときにメール通知を送信するアラートをセットアップできます。

Runtime Manager には、次のような一般的なイベントの通知をトリガーするいくつかの標準アラートタイプが用意されています。

- 指定した期間内に特定の数を超えるイベントがアプリケーションで処理された。
- デプロイメントが成功または失敗で完了した。
- ワーカー監視システムにより、CloudHub にアプリケーションのワーカーの問題について通知された。
- サーバーが切断または削除された。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>Runtime Manager アラートでは 30 日間のアラート履歴が保持されます。</p>
</div>
<div class="paragraph">
<p>アラートは、条件が指定されたしきい値を超えるとトリガーされます。</p>
</div>
</td>
</tr>
</tbody></table>

CloudHub と CloudHub 2.0 にデプロイされているアプリケーションのカスタムアラートを作成することもできます。

CloudHub のカスタムアラートは、CloudHub 用 Anypoint Connector (CloudHub Connector) を使用してアプリケーションから Runtime Manager コンソールに通知が送信されるとトリガーされます。詳細は、​[「カスタムアプリケーションアラート」](https://docs.mulesoft.com/cloudhub/custom-application-alerts)​を参照してください。

CloudHub 2.0 にデプロイされたアプリケーションの場合、アプリケーションが正常にデプロイされたかどうか、そして想定通りに動作しているかどうかがカスタムアラートによって示されます。詳細は、[Configuring Application Alerts](https://docs.mulesoft.com/cloudhub-2/ch2-config-app-alerts)を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">CloudHub 2.0 では、アラートはアプリケーションのみに適用され、サーバーには適用されません。</td></tr></tbody></table>

## [](#アラートのレート制限)アラートのレート制限

Anypoint Platform では、アラートをトリガーする頻度を決定するレート制限が適用され、過度なメール送信を回避します。 現在のところ、Runtime Manager アラートの数に対する制限は定義されていません。

## [](#アラートの作成)アラートの作成

アラートを作成する手順は、次のとおりです。

1. Runtime Manager の左側のナビゲーションペインで ​**\[Alerts (アラート)\]**​ をクリックします。
    
    - アラートがセットアップされていない場合、次のように表示されます。
        
        ![アラートがセットアップされていないアラートページ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-no-alerts.png)
        
        Figure 1. 矢印は、​**\[Create your first alert (最初のアラートの作成)\]**​ オプションを示しています。
    - アカウントにすでに関連付けられたアラートがある場合、次のように表示されます。
        
        ![青いプラス (+) アイコンがあるアラートページ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-create-additional-alert.png)
        
        Figure 2. 矢印は、​**\[Alerts (アラート)\]**​ ページの青いプラス (​**+**​) アイコンを示しています。
2. 青いプラス (​**+**​) アイコンをクリックしてアラートを作成します。
    
    ![「Create an Alert (アラートの作成)」 ページ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-create-alert.png)
3. 必須項目に入力します。
    
    - **Name (名前)**
        
        アラートの一意のわかりやすい名前。
        
        **\[Name (名前)\]**​ は 40 文字に制限されます。
    - **Severity level (重要度レベル)**
        
        アラートの重要度: **\[Critical (重大)\]**​、​**\[Warning (警告)\]**​、​**\[Info (情報)\]**​。
    - **提供元**
        
        アラートの提供元: アプリケーションまたはサーバー。
        
        この項目は Anypoint Platform アカウントでローカルサーバーがサポートされている場合のみ表示されます。
    - **Application type (アプリケーション種別)**
        
        提供元が ​**\[Applications (アプリケーション)\]**​ の場合、アプリケーションは CloudHub またはローカルサーバーにデプロイされています。Runtime Fabric アプリケーションアラートは、Anypoint Monitoring を使用した場合のみサポートされます。
        
        CloudHub にデプロイされているアプリケーションとローカルサーバーにデプロイされているアプリケーションの両方に適用されるアラートは作成できません。 各デプロイメント種別に個別のアラートを作成する必要があります。
    - **Server type (サーバー種別)**
        
        提供元が ​**\[Servers (サーバー)\]**​ の場合、サーバーの種別は 1 つのサーバー、サーバーグループ、またはクラスターです。
        
        メニューでサーバーが使用できない場合、​[「サーバー、サーバーグループ、クラスター」](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)​を参照してください。
    - **\[Applications (アプリケーション)\]**​ または ​**\[Servers (サーバー)\]**
        
        アラートを適用するアプリケーションまたはサーバー。
    - **Conditional (条件)**
        
        アラートをトリガーする条件。
        
        使用可能なオプションは、アラートのリンク先 (サーバー、CloudHub で実行されているアプリケーション、ローカルで実行されているアプリケーション) によって異なります。 一部の条件では、追加のデータが必要です。 [\[Alert Conditions\]](<#Alert Conditions>)​を参照してください。
    - **Subject (件名)**
        
        アラートがトリガーされたときのアラートメールの件名。
        
        件名には変数を含めることができます。 [\[Alert Variables\]](<#Alert Variables>)​を参照してください。
    - **メッセージ**
        
        アラートがトリガーされたときに送信されるメールの本文テキスト。 メッセージ本文には変数を含めることができます。 [\[Alert Variables\]](<#Alert Variables>)​を参照してください。
    - **Recipients (受信者)**
        
        メールの受信者。
        
        最大 20 個のプラットフォームユーザー ID を選択し、最大 20 個のメールアドレスを入力できます。
4. **\[Create Alert (アラートを作成)\]**​ をクリックします。

アラート条件を満たすイベントが発生すると、Runtime Manager によって次のようなメールが送信されます。

![Anypoint Platform アラート通知メール](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-alert-email.png)

## [](#アラート条件)アラート条件

アラートの提供元に応じて異なる条件を選択できます。 条件には、​`Deployment success`​ のような単純な成功または失敗の通知もあります。 フォームに新しい項目として表示されるパラメーターを定義する必要のあるより複雑な通知もあります。

### [](#cloudhub-にデプロイされているアプリケーションの条件)CloudHub にデプロイされているアプリケーションの条件

[![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](/runtime-manager/deployment-strategies#cloudhub-deployments)

CloudHub にデプロイされているアプリケーションの場合、次のアラート条件が適用されます。

CPU usage - Cloudhub (CPU 使用量 - Cloudhub)

アプリケーションを実行している CloudHub ワーカーの CPU 使用量が指定した期間の割合を上回ったか下回った。

![CPU usage - Cloudhub (CPU 使用量 - Cloudhub)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-apps-cpu.png)

この条件を有効にするには、アラートをトリガーする割合と期間を指定します。

Custom application alert (カスタムアプリケーションアラート)

カスタム通知に指定したテキストが含まれる。

![カスタムアプリケーションアラート](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-custom.png)

この条件を有効にするには、Mule アプリケーションで CloudHub Connector から通知テキストを指定します。 いずれかの通知のテキストが指定した文字列に一致すると、アラートが送信されます。 詳細は、​[「カスタムアプリケーションアラート」](https://docs.mulesoft.com/cloudhub/custom-application-alerts)​を参照してください。

Exceeds event traffic threshold (イベントトラフィックしきい値を超過しています)

任意の種別のイベントの件数が指定した期間のしきい値を超えた。

![Exceeds event traffic threshold (イベントトラフィックしきい値を超過しています)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-exceeds-traffic.png)

この条件を有効にするには、アラートをトリガーする容量のしきい値と期間を指定します。 このアラート条件は、アプリケーションで追跡しているイベントによって異なります。 詳細は​[「ビジネスイベント」](https://docs.mulesoft.com/mule-runtime/latest/business-events)​を参照してください。

Memory usage - Cloudhub (メモリ使用量 - Cloudhub)

メモリ使用量は「使用されている JVM ヒープ量/JVM 合計メモリ量」のパーセンテージです。指定した期間においてメモリ使用量が制限を上回るか下回ると、アラートがトリガーされます。

![Memory usage - Cloudhub (メモリ使用量 - Cloudhub)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-apps-memory.png)

この条件を有効にするには、アラートをトリガーする割合と期間を指定します。

CloudHub にデプロイされているアプリケーションの次のアラートには追加のパラメーターが必要ありません。

- Deployment failed (デプロイに失敗しました)
- Deployment success (デプロイメントに成功しました)
- Secure data gateway connected (ソースデータゲートウェイが接続されました)
- Secure data gateway disconnected (ソースデータゲートウェイが切断されました)
- Worker not responding (ワーカーが応答していません)

### [](#ローカルサーバーにデプロイされているアプリケーションの条件)ローカルサーバーにデプロイされているアプリケーションの条件

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](/runtime-manager/deployment-strategies#hybrid-deployments)

ローカルサーバーにデプロイされているアプリケーションの場合、次のアラート条件が適用されます。

Number of errors (エラー数)

Mule Runtime サーバーによって報告される 1 分間のメッセージングエラー数が指定した制限に達した。 報告されるエラー数は、アプリケーションのエラー処理設定によって異なります。 Mule エラーについては、​[「Mule エラー」](https://docs.mulesoft.com/mule-runtime/latest/mule-error-concept)​を参照してください。

![Number of errors (エラー数)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-number-errors.png)

この条件を有効にするには、アラートをトリガーする 1 分あたりのエラー数を指定します。

Number of Mule messages (Mule メッセージ数)

アプリケーションが開始されてからの Mule メッセージ数が指定した制限に達した。

![Number of Mule messages (Mule メッセージ数)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-number-mule-messages.png)

この条件を有効にするには、アラートをトリガーする Mule メッセージ数を指定します。

Response time (応答時間)

応答時間が指定した制限に達した。

![Response time (応答時間)](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-response-time.png)

この条件を有効にするには、アラートをトリガーする最大応答時間を指定します。

ローカルサーバーにデプロイされているアプリケーションの次のアラートには追加のパラメーターが必要ありません。

- Application undeployed (アプリケーションがデプロイされていません)
- Deployment failure (デプロイメントに失敗しました)
- Deployment success (デプロイメントに成功しました)

### [](#ローカルサーバーの条件)ローカルサーバーの条件

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](/runtime-manager/deployment-strategies#hybrid-deployments)

使用可能なアラートイベントは、サーバー種別によって異なります。 次のアラートは、すべての提供先種別 (サーバーグループおよびクラスターのサーバーおよびノード) で使用できます。

Server CPU usage (サーバーの CPU 使用量)

アプリケーションを実行しているサーバーの CPU 使用量が指定した期間の割合を上回ったか下回った。

![サーバーの CPU 使用量のアラート条件](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-servers-cpu.png)

この条件を有効にするには、アラートをトリガーする CPU の割合と期間を指定します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">CloudHub 複数ワーカーアプリケーションのアラートでは、アプリケーション全体の CPU しきい値が考慮されます。</td></tr></tbody></table>

Server Load average (サーバー負荷の平均)

サーバーの平均処理負荷が指定した期間の量を上回ったか下回った。

![サーバー負荷の平均のアラート条件](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-servers-load-avg.png)

この条件を有効にするには、アラートをトリガーする平均負荷と期間を指定します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Windows 環境では、この情報が提供されないため、このメトリクスを使用できません。</td></tr></tbody></table>

Server Memory usage (サーバーのメモリ使用量)

サーバーの合計メモリ使用量 (MB) が指定した期間の量を上回ったか下回った。

![サーバーのメモリ使用量のアラート条件](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-servers-memory.png)

この条件を有効にするには、アラートをトリガーするメモリ使用量と期間を指定します。

Server Thread count (サーバースレッド数)

JVM のスレッド数が指定した期間のレベルを上回ったか下回った。

![サーバースレッド数のアラート条件](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-conditions-servers-thread-count.png)

この条件を有効にするには、アラートをトリガーするスレッド数と期間を指定します。

次のアラートは、対象種別 (サーバー、サーバーグループ、クラスター) によって異なり、追加パラメーターが必要になります。

サーバー

- **Agent version changed (エージェントのバージョンが変更されました)**
- **Runtime version changed (ランタイムのバージョンが変更されました)**
- **Server connected (サーバーが接続されました)**
- **Server deleted (サーバーが削除されました)**
- **Server disconnected (サーバーが切断されました)**

サーバーグループ

- **Server Group connected (サーバーグループが接続されました)**
- **Server Group deleted (サーバーグループが削除されました)**
- **Server Group disconnected (サーバーグループが切断されました)**
- **Server Group’s node connected (サーバーグループのノードが接続されました)**
- **Server Group’s node disconnected (サーバーグループのノードが切断されました)**
- **Server added to Server Group (サーバーグループにサーバーが追加されました)**
- **Server removed from Server Group (サーバーグループからサーバーが削除されました)**

クラスター

- **Cluster connected (クラスターが接続されました)**
- **Cluster deleted (クラスターが削除されました)**
- **Cluster disconnected (クラスターが切断されました)**
- **Cluster presents visibility issues (クラスターに表示の問題が発生しました)**
- **Cluster’s node connected (クラスターのノードが接続されました)**
- **Cluster’s node disconnected (クラスターのノードが切断されました)**
- **Server added to Cluster (クラスターにサーバーが追加されました)**
- **Server removed from Cluster (クラスターからサーバーが削除されました)**

## [](#アラート変数)アラート変数

アラートメールの ​**\[Subject (件名)\]**​ 項目と ​**\[Message (メッセージ)\]**​ 項目で次の変数を使用できます。 各変数の説明については、​[変数定義](#var-defs)​を参照してください。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">文字 ​<em>$&amp;</em>​ の組み合わせは使用できません。</td></tr></tbody></table>

<table class="tableblock frame-all grid-all stretch">
<caption class="title">Table 1. アラートの変数</caption>
<colgroup>
<col style="width: 26.3157%;">
<col style="width: 52.6315%;">
<col style="width: 21.0528%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アラートタイプ</th>
<th class="tableblock halign-left valign-top">アラート</th>
<th class="tableblock halign-left valign-top">該当する変数</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top" colspan="2"><div class="content"><div class="paragraph">
<p>All Alerts (すべてのアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${resource}</code> ​<code>${severity}</code> ​<code>${state}</code>​</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" rowspan="7"><div class="content"><div class="paragraph">
<p>CloudHub App Alerts (CloudHub アプリケーションアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>CPU usage - CloudHub (CPU 使用量 - CloudHub)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="2"><div class="content"><div class="paragraph">
<p><code>${operator}</code> ​<code>${value}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Memory usage - CloudHub (メモリ使用量 - CloudHub)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Custom application notification (カスタムアプリケーション通知)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${user}</code> ​<code>${priority}</code> ​<code>${transactionId}</code> ​<code>${message}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Deployment failed (デプロイに失敗しました)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${user}</code> ​<code>${message}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Deployment success (デプロイメントに成功しました)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="2"><div class="content"><div class="paragraph">
<p><code>${user}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Worker not responding (ワーカーが応答していません)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Exceeds event traffic threshold (イベントトラフィックしきい値を超過しています)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${period}</code> ​<code>${periodTimeUnit}</code>​</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" rowspan="4"><div class="content"><div class="paragraph">
<p>Hybrid App Alerts (ハイブリッドアプリケーションアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>All Hybrid App Alerts (すべてのハイブリッドアプリケーションアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${name}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Number of Mule messages (Mule メッセージ数)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="3"><div class="content"><div class="paragraph">
<p><code>${currentValue}</code> ​<code>${threshold}</code> ​<code>${location}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Number of errors (エラー数)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Response time (応答時間)</strong>​</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" rowspan="7"><div class="content"><div class="paragraph">
<p>Server Alerts (サーバーアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>All Server Alerts (すべてのサーバーアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${name}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Agent version changed (エージェントのバージョンが変更されました)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="2"><div class="content"><div class="paragraph">
<p><code>${oldVersion}</code> ​<code>${newVersion}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Runtime version changed (ランタイムのバージョンが変更されました)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server CPU usage (サーバーの CPU 使用量)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="4"><div class="content"><div class="paragraph">
<p><code>${currentValue}</code> ​<code>${comparison}</code> ​<code>${threshold}</code> ​<code>${location}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Load average (サーバー負荷の平均)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Memory average (サーバーメモリの平均)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Thread count (サーバースレッド数)</strong>​</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" rowspan="9"><div class="content"><div class="paragraph">
<p>Server Group Alerts (サーバーグループアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>All Server Group Alerts (すべてのサーバーグループアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${name}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node CPU usage (サーバーグループのノード CPU 使用量)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="4"><div class="content"><div class="paragraph">
<p><code>${memberName}</code> ​<code>${groupName}</code> ​<code>${currentValue}</code> ​<code>${comparison}</code> ​<code>${threshold}</code> ​<code>${location}</code> ​<code>${parentResource}</code> ​<code>${parentLocation}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node Load average (サーバーグループのノード負荷の平均)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node Memory usage (サーバーグループのノードメモリ使用量)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node Thread count (サーバーグループのノードスレッド数)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node connected (サーバーグループのノードが接続されました)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="4"><div class="content"><div class="paragraph">
<p><code>${memberName}</code> ​<code>${groupName}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server Group’s node disconnected (サーバーグループのノードが切断されました)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server added to Server Group (サーバーグループにサーバーが追加されました)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server removed from Server Group (サーバーグループからサーバーが削除されました)</strong>​</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top" rowspan="9"><div class="content"><div class="paragraph">
<p>Cluster Alerts (クラスターアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>All Cluster Alerts (すべてのクラスターアラート)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${name}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node CPU usage (クラスターのノード CPU 使用量)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="4"><div class="content"><div class="paragraph">
<p><code>${memberName}</code> ​<code>${clusterName}</code> ​<code>${currentValue}</code> ​<code>${comparison}</code> ​<code>${threshold}</code> ​<code>${location}</code> ​<code>${parentResource}</code> ​<code>${parentLocation}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node Load average (クラスターのノード負荷の平均)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node Memory usage (クラスターのノードメモリ使用量)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node Thread count (クラスターのノードスレッド数)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node disconnected (クラスターのノードが切断されました)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>${resource}</code> ​<code>${memberName}</code> ​<code>${clusterName}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Cluster’s node connected (クラスターのノードが接続されました)</strong>​</p>
</div></div></td>
<td class="tableblock halign-left valign-top" rowspan="3"><div class="content"><div class="paragraph">
<p><code>${memberName}</code> ​<code>${clusterName}</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server added to Cluster (クラスターにサーバーが追加されました)</strong></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Server removed from Cluster (クラスターからサーバーが削除されました)</strong></p>
</div></div></td>
</tr>
</tbody>
</table> <table id="var-defs" class="tableblock frame-all grid-all fit-content spread">
<caption class="title">Table 2. 変数定義</caption>
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">変数</th>
<th class="tableblock halign-left valign-top">定義</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${clusterName}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">クラスターの名前</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${currentValue}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートをトリガーするメトリクスの現在の値</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${comparison}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">上回るまたは下回る</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${groupName}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバーグループの名前</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${location}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートに関する詳細を検索する場所</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${memberName}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバーグループまたはクラスターのノードの名前</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${message}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートをトリガーする通知のメッセージ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${name}</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アラートをトリガーする項目の名前</p>
</div>
<div class="ulist">
<ul>
<li>
<p>Hybrid Apps (ハイブリッドアプリケーション): アラートをトリガーするアプリケーションの名前</p>
</li>
<li>
<p>Servers (サーバー): アラートをトリガーする提供先 (サーバー、サーバーグループ、クラスター) の名前</p>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${newVersion}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントまたはランタイムの新しいバージョン番号</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${oldVersion}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">エージェントまたはランタイムの以前のバージョン番号</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${operator}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>&lt; &gt; =</code>​ などの演算子。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${parentLocation}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ノードの親クラスターのアラートに関する詳細を検索する場所</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${parentResource}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートをトリガーするノードの親クラスターのリソース (サーバーやアプリケーションなど) の名前</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${period}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">測定する期間。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${periodTimeUnit}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">期間の単位。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${priority}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートをトリガーする通知の優先度</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${resource}</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アラートをトリガーする項目の名前</p>
</div>
<div class="ulist">
<ul>
<li>
<p>CloudHub Apps (CloudHub アプリケーション): アラートをトリガーするアプリケーションの名前</p>
</li>
<li>
<p>Hybrid Apps (ハイブリッドアプリケーション): アラートをトリガーするアプリケーションのリソースの名前</p>
</li>
</ul>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${severity}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートの重要度。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${state}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">実行中や切断済みなど、アラートをトリガーするリソースの状態</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${threshold}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アラートをトリガーする期間での数</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${transactionId}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションで定義された、または Mule によって割り当てられたトランザクション ID</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${user}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform 組織名</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>${value}</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">要素に関連付けられている値</p></td>
</tr>
</tbody>
</table>

## [](#runtime-manager-でのアラートへのアクセス)Runtime Manager でのアラートへのアクセス

Runtime Manager のアラートにアクセスする方法はいくつかあります。

アカウントに関連付けられたすべてのアラートを表示するには、左側のナビゲーションペインで ​**\[Alerts (アラート)\]**​ をクリックします。

![「Alerts (アラート)」 メニュー](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-view-all-alerts-tab.png)

Figure 3. 矢印は、​**\[Alerts (アラート)\]**​ メニューを示しています。

このページから、次の操作ができます。

- アラートを作成する。
- アラート名で文字列を検索する。
- 提供元、条件、重要度、状況で表示されるアラートを絞り込む。
- アラート名をクリックしてその設定を変更する。
- アラートを選択して詳細ペインにその状況、設定、履歴を表示する。
    
    ![詳細ペインのアラート履歴](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-history.png)
    
    Figure 4. 矢印は、詳細ペインのアラート履歴を示しています。

アプリケーションまたはサーバーに関連付けられたアラートを表示する手順は、次のとおりです。

1. **\[Applications (アプリケーション)\]**​ または ​**\[Servers (サーバー)\]**​ のリストで、アプリケーションまたはサーバーの ​**\[Status (状況)\]**​ 列をクリックします。
2. 詳細ペインで ​**\[View Associated Alerts (関連付けられたアラートを表示)\]**​ リンクをクリックします。
    
    ![詳細ペインの 「View Associated Alerts (関連付けられたアラートを表示)」 リンク](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-view-details-pane.png)
    
    Figure 5. 矢印は、詳細ペインの ​**\[View Associated Alerts (関連付けられたアラートを表示)\]**​ リンクを示しています。

サーバー、サーバーグループ、またはクラスター、またはローカルサーバーにデプロイされているアプリケーションのアラート履歴を表示する手順は、次のとおりです。

1. **\[Applications (アプリケーション)\]**​ または ​**\[Servers (サーバー)\]**​ のリストで、アプリケーション名またはサーバー名をクリックします。
2. 左側のナビゲーションペインで、​**\[Settings (設定)\]**​ をクリックします。
3. **\[Alerts History (アラート履歴)\]**​ タブをクリックします。
    
    ![「Settings (設定)」 ページの 「Alerts History (アラート履歴)」 タブ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-settings-alerts-history-tab.png)
    
    Figure 6. 矢印は、​**\[Settings (設定)\]**​ ページの ​**\[Alerts History (アラート履歴)\]**​ タブを示しています。

## [](#runtime-manager-でのアラートの管理)Runtime Manager でのアラートの管理

**\[Alerts (アラート)\]**​ ページからアラートを管理するには、リストで 1 つ以上のアラートを選択して、詳細ペインでアクションを選択します。

![「選択切り替え、アラート状態スイッチ、「Duplicate (重複)」 アイコン、「Delete (削除)」 アイコン」](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-multi-select-manage.png)

Figure 7. このスクリーンショットは、(​**1**​) 選択切り替え、(​**2**​) アラート状態スイッチ、(​**3**​) ​**\[Duplicate (重複)\]**​ アイコン、(​**4**​) ​**\[Delete (削除)\]**​ アイコンを示しています。

アラートのオンとオフの切り替え

Anypoint Platform のすべてのユーザーは、アラートを作成する権限がなくても、アラートをオンまたはオフに切り替えて、メールアラートを送信するかどうかを制御できます。

アラートの状態を変更すると、そのアラートのメール通知を受信するすべてのユーザーにその変更が適用されます。

- アラートをオフにするには、切り替えスイッチをクリックします。
    
    ![オンのアラートスイッチ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-switch-on.png)
    
    Figure 8. 矢印は、オンのアラートスイッチを示しています。
    
    **\[Active (アクティブ)\]**​ 列の値が ​**\[Yes (はい)\]**​ から ​**\[No (いいえ)\]**​ に変更されます。
- アラートをオンにするには、切り替えスイッチをクリックします。
    
    ![オフのアラートスイッチ](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-switch-off.png)
    
    Figure 9. 矢印は、オフのアラートスイッチを示しています。
    
    **\[Active (アクティブ)\]**​ 列の値が ​**\[No (いいえ)\]**​ から ​**\[Yes (はい)\]**​ に変更されます。

アラートのコピーの作成

1 つ以上のアラートを選択し、詳細ペインの ​**\[Duplicate (重複)\]**​ アイコンをクリックします。

![「Duplicate (重複)」 アラートアイコン](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-duplicate.png)

Figure 10. 矢印は、​**\[Duplicate (重複)\]**​ アラートアイコンを示しています。

Runtime Manager によってアラートのコピーが作成され、元のアラートの名前に ​`-copy`​ が付加されます。

アラートの削除

1 つ以上のアラートを選択し、詳細ペインの ​**\[Delete (削除)\]**​ (ごみ箱) アイコンをクリックします。

![「Delete (削除)」 (ごみ箱) アイコン](/mulesoft/current/ja-jp/runtime-manager/_images/alerts-delete.png)

Figure 11. 矢印は、​**\[Delete (削除)\]**​ アラート (ごみ箱) アイコンを示しています。

要求されたら、​**\[OK\]**​ をクリックして削除を確定します。

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

- [カスタムアプリケーションアラート](https://docs.mulesoft.com/cloudhub/custom-application-alerts)
- [ダッシュボードの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)
- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [デフォルトイベント追跡の設定](https://docs.mulesoft.com/mule-runtime/latest/business-events-in-components)
- [Anypoint Monitoring の基本アラートのセットアップ](https://docs.mulesoft.com/jp/monitoring/basic-alerts)

<!-- document id=1502240acc072af7949d74b889ef30b5073952c6e3f8a09dc0d3861129250202 url=/mulesoft/current/ja-jp/runtime-manager/event-tracking.md -->

# イベント追跡

 [![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 サーバー上でのビジネストランザクションやイベントを表示することができ、特定のメッセージのフローと処理を追跡して分析できます。たとえば、このデータを使用して、ビジネストランザクション内の障害の根本原因分析を実行したり、メッセージ処理のボトルネックを特定したりできます。

## [](#通知種別)通知種別

Mule Runtime Engine は、フローコンポーネントの実行に関する情報を通知します。 [「Mule イベント」](https://docs.mulesoft.com/mule-runtime/latest/about-mule-event)​を参照してください。

Mule が提供する通知の種別については、​[「通知インターフェース」](https://docs.mulesoft.com/mule-runtime/latest/mule-server-notifications#notification-interfaces)​を参照してください。

## [](#転送イベント情報)転送イベント情報

各通知について、Runtime Manager エージェントは、次の情報をイベント追跡サービスに転送します。

- `timestamp`
    
    イベントのタイムスタンプ
- `notificationType`
    
    イベント種別 (メッセージプロセッサーイベント、インバウンドエンドポイントイベントなど)
- `action`
    
    イベントアクション (開始、終了、完了、ロールバックなど)
- `resourceIdentifier`
    
    フローの名前
- `muleMessage`
    
    (設定されている場合) シリアル化された Mule メッセージまたはエラーメッセージ。

Runtime Manager エージェントは、次の情報は送信しません。

- Mule Message ID (Mule メッセージ ID)
- Exception (例外)
    
    例外が発生した場合のメッセージとスタック追跡
- Path (パス)
    
    コンポーネントの Mule パス
- Annotations (アノテーション)
    
    コンポーネントのアノテーション (ある場合)
- Application (アプリケーション)

## [](#イベント追跡通知)イベント追跡通知

Runtime Manager エージェントは、Mule アプリケーションのイベント追跡通知を保存して、イベント追跡サービスにストリーミングします。ネットワークトポロジーと Mule アプリケーションのデザインによっては、イベント追跡通知を Runtime Manager エージェントからオンラインイベント追跡サービスにネットワーク経由でコピーすると、パフォーマンスに大きな影響が出る場合があります。

追跡レベルの粒度を変更することで、パフォーマンスへの影響を抑えることができます。グローバルイベント追跡レベルを指定してから、指定した Mule アプリケーションでレベルを変更できます。さらに Mule アプリケーション内の特定のフローでもイベント追跡レベルを変更できます。

イベント追跡レベルのほかにも、メッセージ再生機能ですべてのメッセージを保存して後で再生できます。これは、メッセージ処理の重複につながる可能性もありますが、再生機能が提供するメカニズムによって、運用チームは失敗したトランザクションを復元して再生できます。追跡レベルと同じように、再生レベルはグローバルに設定しておいて、特定の Mule アプリケーションでレベルを上書きしたり、Mule アプリケーション内の特定のフローで上書きしたりできます。

## [](#イベント追跡レベル)イベント追跡レベル

使用できるイベント追跡レベルは次のとおりです。

- `None`
    
    デバッグを行わないように指定します。
- `BE`
    
    ビジネスイベントに関連するイベントのみが追跡されます。
- `Tracking`
    
    `BE`​ レベルに加えて、エンドポイント、例外戦略、トランザクション関連の通知を追跡します。
- `Debug`​ +​`Tracking`​ レベルに加えて、追加コンポーネントとメッセージプロセッサー通知を指定します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">イベント追跡を ​<code>Debug</code>​ に設定するとパフォーマンスが低下することがあるため、この追跡レベルはデバッグ時にのみ使用してください。</td></tr></tbody></table>

次の表は、各デバッグレベルでアクティブな通知の種別を示しています。

Mule 種別は、通知種別を定義する (​`org.mule.context.notification`​ パッケージにある) ​`org.mule.api.context.notification.ServerNotification`​ サブクラスです。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">通知</th>
<th class="tableblock halign-left valign-top">Mule 種別</th>
<th class="tableblock halign-left valign-top">None (なし)</th>
<th class="tableblock halign-left valign-top">BE (ビジネスイベント)</th>
<th class="tableblock halign-left valign-top">Tracking (追跡)</th>
<th class="tableblock halign-left valign-top">Debug (デバッグ)</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Pipeline Message (パイプラインメッセージ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">PipelineMessageNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Async Message (非同期メッセージ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AsyncMessageNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">例外</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ExceptionStrategyNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Event (イベント)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">EventNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Exception Strategy (例外戦略)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ExceptionStrategyNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Transaction (トランザクション)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">TransactionNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Endpoint Message (エンドポイントメッセージ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">EndpointMessageNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Message Processor (メッセージプロセッサー)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">MessageProcessorNotification</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Component Message (コンポーネントメッセージ)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ComponentMessageNotifications</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">√</p></td>
</tr>
</tbody>
</table>

## [](#イベント追跡の設定)イベント追跡の設定

すべてのアプリケーション (グローバル)、単一のアプリケーション、またはフローに対して追跡レベルを設定できます。

- Global (グローバル)
    
    Mule Runtime Engine にデプロイされているすべてのアプリケーションとそれらのフローの追跡方法を指定します。
- App (アプリケーション)
    
    特定のアプリケーションのグローバル追跡レベルを上書きします。
- Flow (フロー)
    
    特定のフローのグローバルまたはアプリケーション追跡レベルを上書きします。

### [](#mule-agent-yml-でのイベント追跡の設定)mule-agent.yml でのイベント追跡の設定

イベント追跡は ​`mule-agent.yml`​ で設定できます。

- [Mule にデプロイされているすべてのアプリケーションに対してグローバルに設定する](#すべての-mule-アプリケーションに対するイベント追跡のグローバル設定)
- [単一の Mule アプリケーションに対して設定する](#mule-アプリケーションに対する追跡の設定)
- [Mule アプリケーション内のフローに対して設定する](#mule-アプリケーションのフローに対する追跡の設定)

#### [](#すべての-mule-アプリケーションに対するイベント追跡のグローバル設定)すべての Mule アプリケーションに対するイベント追跡のグローバル設定

Mule Runtime Engine にデプロイされているすべてのアプリケーションとそれらのフローの追跡方法を指定します。追跡レベルは ​`mule-agent.yml`​ ファイルの ​`services/mule.agent.tracking.service`​ セクションで設定します。

次の例では、グローバル追跡レベルを ​`TRACKING`​ に設定しています。追跡レベルの説明は、「​[イベント追跡レベル](#イベント追跡レベル)​」を参照してください。

`mule-agent.yml`​ 内で次のように設定します。

```yaml
services:
 mule.agent.tracking.service:
 globalTrackingLevel: TRACKING
```

#### [](#mule-アプリケーションに対する追跡の設定)Mule アプリケーションに対する追跡の設定

Mule アプリケーションの追跡レベルを設定することで、そのアプリケーションにおいてグローバル追跡設定を上書きできます。

Mule アプリケーションの追跡プロパティは、​`trackingLevel`​、​`replayLevel`​、​`trackedFlows`​ です。

- `trackingLevel`
    
    `NONE`​、​`BE`​、​`TRACKING`​、または ​`DEBUG`​ のいずれかの追跡レベルを指定します。この追跡レベルは、Mule アプリケーションのすべてのフローに影響します。「​[イベント追跡レベル](#イベント追跡レベル)​」を参照してください。
- `replayLevel`​'
    
    Mule アプリケーションのすべてのフローで、各メッセージを後で再生できるように保存する方法を指定します。​`NONE`​、​`SOURCED`​、または ​`ALL`​ を指定できます。

<table id="Replay" class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">再生レベルオプション</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>NONE</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">メッセージの再生に関するデータを保存せず、これらのフローに対して再生機能を無効にします。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>SOURCED</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mule アプリケーション内の、メッセージソースで始まる各フローのメッセージのみを後で再生するために保存します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ALL</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mule アプリケーションのすべてのフローのメッセージを再生用に保存します。</p></td>
</tr>
</tbody>
</table>

次の例では、​`mule-flights`​ アプリケーションとそのフローの追跡レベルを ​`TRACKING`​ に設定し、メッセージ再生機能を無効にしています。​`mule-flights`​ アプリケーションは、一部の通知をイベント追跡サービスに送信しますが、受信した各メッセージはコピーしません。​`mule-flights`​ アプリケーションのフローは、いずれもイベント追跡サービスから再生することはできません。

次の例でも ​`globalTrackingLevel`​ を ​`BE`​ に設定しており、デフォルト値の ​`NONE`​ を上書きしています。この設定により、他の Mule アプリケーションも ​`BE`​ レベルで追跡されます。

`mule-agent.yml`​ 内で次のように設定します。

```yaml
services:
 mule.agent.tracking.service:
 globalTrackingLevel: BE
 trackedApplications:
    - appName: mule-flights
      trackingLevel: TRACKING
      replayLevel: NONE
```

#### [](#mule-アプリケーションのフローに対する追跡の設定)Mule アプリケーションのフローに対する追跡の設定

`trackedFlows`​ 要素を追加することにより、指定した Mule アプリケーション内でフローのグローバルおよびアプリケーション設定を上書きできます。この要素は、フローで追跡する対象と、メッセージ再生の動作を指定します。

フロー追跡オプションを下表に示します。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">フロー追跡オプション</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>flow name</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Mule アプリケーション XML 設定ファイルで指定されているフローの名前。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>tracking level</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>NONE</code>​、​<code>BE</code>​、​<code>TRACKING</code>​、または ​<code>DEBUG</code>​ を指定します。「​<a href="#イベント追跡レベル">イベント追跡レベル</a>​」を参照してください。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>replayLevel</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>NONE</code>​、​<code>SOURCED</code>​、または ​<code>ALL</code>​ を指定します。​<a href="#再生">再生レベル</a>​のテーブルを参照してください。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>payloadExcluded</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">メッセージペイロードも後で再生するために保存するか、メッセージメタデータのみを保存するかを指定します (​<code>replayLevel</code>​ が ​<code>SOURCED</code>​ または ​<code>ALL</code>​ の場合)。</p></td>
</tr>
</tbody>
</table>

次の例では、​`mule-flights`​ アプリケーションのフローに追跡を追加しています。グローバルおよび Mule アプリケーション追跡には、デフォルト値 (​`NONE`​) を使用しています。

`mule-agent.yml`​ 内で次のように設定します。

```yaml
services:
  mule.agent.tracking.service:
    trackedApplications:
      - appName: mule-flights
        trackedFlows:
          - flowName: purchaseFlight
            trackingLevel: DEBUG
            replayLevel: ALL
```

#### [](#複雑な追跡例)複雑な追跡例

次の例では、グローバル、Mule アプリケーション、およびフローの追跡レベルを設定しています。

グローバル:

- `globalTrackingLevel`​ を ​`NONE`​ (​`globalTrackingLevel`​ を指定しなかった場合のデフォルト) に設定します。

アプリケーション ​`mule-flights`​:

- trackingLevel: アプリケーションに対して ​`TRACKING`​ レベルを設定します。
- replayLevel: アプリケーションに対して ​`NONE`​ を設定します。メッセージは保存されず、再生は無効です。
    
    - フロー ​`purchaseFlight`
        
        - trackingLevel: この 1 つのフローに対して ​`DEBUG`​ (デバッグ) レベル (​`TRACKING`​ (追跡) レベルを上書き)。
        - replayLevel: この 1 つのフローに対して ​`ALL`​ を設定します。フローにメッセージソースがない場合でも、すべてのメッセージを再生用に保存します。

アプリケーション ​`mule-ticketing`​:

- trackingLevel: アプリケーションに対して ​`BE`​ を設定します。
- replayLevel: アプリケーションに対して ​`SOURCE`​ を設定します。メッセージは保存されず、再生は無効です。
    
    - フロー ​`confirmReservation`
        
        - trackingLevel: この 1 つのフローに対して ​`DEBUG`​ (デバッグ) レベル (​`TRACKING`​ (追跡) レベルを上書き)。
        - replayLevel: この 1 つのフローに対して ​`ALL`​。フローにメッセージソースがない場合でも、すべてのメッセージを再生用に保存します。

Mule インスタンス内のその他のすべてのアプリケーションとそのフロー:

- trackingLevel: `NONE`​ (デフォルト)

`mule-agent.yml`​ 内で次のように設定します。

```yaml
services:
  mule.agent.tracking.service:
    globalTrackingLevel: NONE
    trackedApplications:
      - appName: mule-flights
        trackingLevel: TRACKING
        replayLevel: NONE
        trackedFlows:
          - flowName: purchaseFlight
            trackingLevel: DEBUG
            replayLevel: ALL
          - flowName: help
            trackingLevel: NONE
            replayLevel: NONE
      - appName: mule-ticketing
        trackingLevel: BE
        replayLevel: SOURCE
        trackedFlows:
          - flowName: confirmReservation
            trackingLevel: DEBUG
            replayLevel: ALL
```

### [](#エージェント-api-を使用した実行中の追跡の設定)エージェント API を使用した実行中の追跡の設定

エージェント API を使用すると、実行中にエージェント追跡設定を変更できます。たとえば、API を使用して実行中のアプリケーションの追跡設定を変更できます。

#### [](#現在の設定の取得)現在の設定の取得

次の例では、追跡サービスに関する情報を取得しています。取得される情報には、設定可能な項目とその現在の値が含まれています。

要求:

GET <Runtime Manager Agent URL>/mule/agent/mule.agent.tracking.service

応答:

```json
"configurableFields": [
    {
      "name": "globalTrackingLevel",
      "valueType": "com.mulesoft.agent.services.tracking.TrackingLevel",
      "value": "NONE",
      "configurableType": "DYNAMIC",
      "description": ""
    },
    {
      "name": "trackedApplications",
      "valueType": "[Lcom.mulesoft.agent.services.tracking.TrackedApplication;",
      "value": [],
      "configurableType": "DYNAMIC",
      "description": ""
    }
  ],
  "injectedHandlers": [
    {
      "name": "com.mulesoft.agent.handlers.internal.InternalTrackingNotificationHandler",
      "path": "/mule/agent/tracking.notification.internal.message.handler/configuration",
      "type": "class com.mulesoft.agent.domain.tracking.AgentTrackingNotification"
    }
  ],
  "serviceHandlerTypes": [
    "class com.mulesoft.agent.domain.tracking.AgentTrackingNotification"
  ]
}
```

#### [](#現在の設定の変更)現在の設定の変更

実行中に現在の設定を変更するには、変更した設定の JSON 表現を使用して要求を送信します。この表現は、現在の設定を上書きします。JSON 表現に含まれていない項目では、現在の値が保持されます。

次の例では、​`globalTrackingLevel`​ 項目と ​`trackedApplications`​ 項目の上書きを要求します。他のすべての項目は変更されません。

要求:

```json
PATCH <Runtime Manager Agent URL>/mule/agent/mule.agent.tracking.service HTTP/1.1

{
  "globalTrackingLevel": "BE",
  "trackedApplications": [
  {
    "appName": "mule-flights",
    "trackingLevel": "DEBUG",
    "trackedFlows": [
    {
      "flowName": "purchaseFlight",
      "trackingLevel": "TRACKING"
    }
    ]
  }
  ]
}
```

応答:

```json
{
  "configurableFields": [
  {
    "name": "globalTrackingLevel",
    "valueType": "com.mulesoft.agent.services.tracking.TrackingLevel",
    "value": "BE",
    "configurableType": "DYNAMIC",
    "description": ""
    },
    {
      "name": "trackedApplications",
      "valueType": "[Lcom.mulesoft.agent.services.tracking.TrackedApplication;",
      "value": [
      {
        "appName": "mule-flights",
        "trackingLevel": "DEBUG",
        "trackedFlows": [
        {
          "flowName": "purchaseFlight",
          "trackingLevel": "TRACKING"
        }
        ]
      }
      ],
      "configurableType": "DYNAMIC",
      "description": ""
    }
    ],
    "injectedHandlers": [
    {
      "name": "com.mulesoft.agent.handlers.internal.InternalTrackingNotificationHandler",
      "path": "/mule/agent/tracking.notification.internal.message.handler/configuration",
      "type": "class com.mulesoft.agent.domain.tracking.AgentTrackingNotification"
    }
    ],
    "serviceHandlerTypes": [
    "class com.mulesoft.agent.domain.tracking.AgentTrackingNotification"
    ]
  }
```

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">イベント追跡ログファイル (​<code>$MULE_HOME/logs/events-%d{yyyy-dd-MM}-%i.log</code>​) は自動的には削除されません。定期的に手動でログを削除する必要があります。</td></tr></tbody></table>

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

- [Runtime Manager から外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)

<!-- document id=fe61b6889ad7af35c246ec423123480ad9e3f54462ae91eca460f3d8df154924 url=/mulesoft/current/ja-jp/runtime-manager/insight.md -->

# インサイト

 [![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub](deployment-strategies#cloudhub)

インサイトは、トラブルシューティングツールであり、CloudHub またはオンプレミスサーバーにデプロイした Mule アプリケーション上のビジネストランザクションやイベントを詳細に調べることができます。インサイトは、アプリケーション内でのデータの動作をすべて追跡することで、メッセージ処理中に発生したエラーを検出して回復できるようにします。

インバウンドエンドポイントが CloudHub にデプロイされている Mule 3 のアプリケーションとフローでは、高度なエラー回復を実現するためにトランザクションの再生機能をサポートしています。 再生機能は、Mule 4 アプリケーションと無料またはトライアルユーザーアカウントではサポートされません。

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>インサイトを有効にすると、データ処理パフォーマンスが大きく低下し、メモリ消費量が増大します。
そのため、本番環境では長期間に渡ってインサイトを有効にしないでください。</p>
</div>
<div class="paragraph">
<p>Insight は、トランザクション ID または一意のテキスト文字列を検索することで特定のトランザクションをトラブルシューティングする目的でのみ使用してください。</p>
</div>
<div class="paragraph">
<p>本番環境を監視するためのツールについては、​<a href="https://docs.mulesoft.com/jp/runtime-manager/monitoring" class="xref page">「アプリケーションとサーバーの監視」</a>​を参照してください。</p>
</div>
</td>
</tr>
</tbody></table>

インサイトダッシュボードを使用すると、ビジネストランザクションを処理するフロー内で発生したイベントを表示できます。 イベントに関するデータにドリルダウンして、障害の根本的原因を分析したり、パフォーマンスのボトルネックを特定したり、会社の手順に準拠しているかをテストしたりできます。

インサイトは、統合されたアプリケーションに関する次のような質問に答えるのに役立ちます。

- 特定のトランザクションや同期に何が起きたか?
- トランザクションはいつ実行されたか? 所要時間はどれくらいだったか?
- トランザクションの結果はどうだったか?
- 処理中に障害が発生した場合、どの時点で発生したか?

インサイトを有効にすると、デフォルトで次の項目が追跡されます。

- Mule アプリケーションのエンドポイント (インバウンドおよびアウトバウンド) を通過するデータ
- フローの開始と完了
- Mule フローに埋め込んだカスタムビジネスイベント

## [](#制約と制限事項)制約と制限事項

Insight を使用する場合には以下の制限や制約が適用されます。

- Insight では、以下の制限を超えたイベントはドロップされます。
    
    - 単一のアプリケーションは毎分 50,000 イベントに制限されます。
    - 単一ビジネスグループのすべてのアプリケーションは毎分 100,000 イベントに制限されます。
- Insight では、アプリケーション定義ごとに保存できるカスタムイベント定義は 20 件までです。
- Insight では、単一のトランザクションに 10,000 件を超えるイベントが含まれている実行時間が長いプロセスはサポートされません。
    
    この理由から、Insight ではバッチ処理を可視化できない場合があります。 [「バッチ処理」](https://docs.mulesoft.com/mule-runtime/latest/batch-processing-concept)​を参照してください。
- リージョンを切り替えると、インサイトの再生データは失われます。
    
    この制限、コンプライアンス要件に違反していないことを確認してください。
- オンプレミスサーバーにデプロイされたアプリケーションのログには、イベント情報が含まれていますが、メッセージコンテンツは含まれていません。
- Insight は、正確に一致する語を検索する場合にのみ、一貫した結果を返します。
    
    Insight ではクエリに含めることのできる語数には制限があるため、パターンを検索する場合にはすべての一致結果が返されないことがあります。
    
    この制限を回避するには、次のいずれかを行ってください。
    
    - 正確なトランザクション ID を検索する。
    - トランザクションにカスタムビジネスイベントでタグを付けてから、カスタムビジネスイベントでトランザクションを検索する。「​[ビジネスイベントのセットアップ](#ビジネスイベントのセットアップ)​」を参照してください。

### [](#データの永続性)データの永続性

インサイトではトランザクションのサイズに制限はありません。インサイトは、30 日分のアプリケーションのトランザクションをすべて表示し、2 日分のイベントを保存します。

2017 年 10 月 7 日より前に作成された Mule 3 アプリケーションの再生データは、デフォルトリージョンの us-east-1 に保存されます。 2017 年 10 月 7 日以降に最初にデプロイされた、または別のリージョンに移動した Mule 3 アプリケーションのデータは、アプリケーションが現在デプロイされているリージョンに保存されます。

### [](#ペイロードの変換)ペイロードの変換

次の MIME タイプは常に文字列としてマッピングされます。

```linenums
application/javascript
application/json
application/csv
application/rtf
application/vnd.mozilla.xul+xml
application/x-csh
application/x-sh
application/xml
application/xml+html
images/svg+xml
text/calendar
text/css
text/csv
text/html
text/plain
text/xml
```

他のすべてのタイプについて、Mule エージェントは、Mule Runtime Engine が Mule エージェントに公開したストリーム種別に基づいて、ペイロードを別の形式に変換しようと試みます。 たとえば、Mule エージェントは ​`CURSOR_STREAM_PROVIDER`​ ペイロードをバイト配列に変換します。

デフォルトで文字列にマッピングされないストリームは、すべてログに表示されます。

## [](#インサイトを有効化または無効化する)インサイトを有効化または無効化する

インサイトを有効にして Mule サーバーで生成されるイベントを追跡する手順は、次のとおりです。

1. Anypoint Platform アカウントにサインインします。
2. **\[Runtime Manager\]**​ をクリックします。
3. 左側のメニューで ​**\[Applications (アプリケーション)\]**​ をクリックし、​**\[File (ファイル)\]**​ 列でアプリケーションを選択してページの右側にある管理パネルで開きます。
4. 管理パネルで ​**\[Insight (インサイト)\]**​ をクリックします。
5. 左側のメニューで ​**\[Settings (設定)\]**​ をクリックして、​**\[Insight (インサイト)\]**​ タブをクリックします。
    
    ![「Settings (設定)」 ページの 「Insight (インサイト)」 タブ](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-tab.png)
    
    Figure 1. **\[Servers (サーバー)\]**​ ページの ​**\[Insight (インサイト)\]**​ タブを示す矢印。
6. 次の追跡オプションのいずれかを選択します。
    
    - **\[Disabled (無効化)\]**​: インサイトを無効化します。
    - **Metadata (メタデータ)**​: イベントのみを追跡します。
    - **Metadata and Replay (メタデータと再生)**​: イベントを追跡し、コンソールからすぐにトランザクションを再生する機能を有効にします。
        
        **\[Metadata and Replay (メタデータと再生)\]**​ オプションは、インバウンドエンドポイントが設定されたフローを持つ、CloudHub にデプロイされている Mule 3 アプリケーションで使用できます。 このオプションは、Mule 4 アプリケーションと無料またはトライアルユーザーアカウントでは使用できません。
        
        詳細は、「​[問題の診断とトランザクションの再生](#問題の診断とトランザクションの再生)​」を参照してください。
7. インサイトを有効にすることを確認するためのチェックボックスをオンにして ​**Apply Changes (変更を適用)**​ をクリックします。
8. **\[Apply Changes (変更を適用)\]**​ をクリックしてアプリケーション設定を保存します。

## [](#トランザクションとイベントの検索と絞り込み)トランザクションとイベントの検索と絞り込み

インサイトダッシュボードには、情報が 3 つの追跡レベルで表示されます。

- **トランザクション**
    
    関連するイベントの論理的なグループ化で、通常はシステムのビジネス面での視点に対応しています。
- **イベント**
    
    トランザクションの低レベルの詳細を追跡します。
    
    イベントは、メッセージプロセッサーとエンドポイントにマップされ、例外や設定したカスタムビジネスイベントについての情報が明らかになります。
- **メタデータ**
    
    アプリケーションのカスタムイベントの一環としてカスタマイズしたキー - 値ペアを追跡します。
    
    このレベルでインサイトが追跡する詳細によって、概要レベルのビジネスイベントに関する情報が明らかになります。

次の図は、インサイトダッシュボードのどこにトランザクション、イベント、メタデータがあるかを示しています。

![インサイトダッシュボードの追跡レベル](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-dashboard.png)

Figure 2. このスクリーンショットは、インサイトダッシュボードの (​**1**​) トランザクションレベル、(​**2**​) イベントレベル、(​**3**​) メタデータレベルを示しています。

ビジネスデータが設定されている場合は、ダッシュボードのメタデータエリア (​**3**​) に表示されます。「​[ビジネスイベントのセットアップ](#ビジネスイベントのセットアップ)​」を参照してください。

### [](#トランザクションの検索と絞り込み)トランザクションの検索と絞り込み

**\[Insight (インサイト)\]**​ ページでは、データを検索したり検索条件を使用したりすることで、表示される結果を絞り込むことができます。以下を検索できます。

- トランザクション ID による特定のトランザクション
- 特定の日付範囲内のトランザクション
- 正確なフロー名、正確な例外メッセージ、処理時間、カスタムビジネスデータによるトランザクション
    
    **\[Business Data (ビジネスデータ)\]**​ 項目を有効にするには、アプリケーションでビジネスイベントが設定されている必要があります。「​[ビジネスイベントのセットアップ](#ビジネスイベントのセットアップ)​」を参照してください。

トランザクションを検索または絞り込む手順は次のとおりです。

1. 左側のメニューで ​**\[Insight (インサイト)\]**​ をクリックします。
2. **\[Search (検索)\]**​ 項目に検索条件を入力します。
3. **\[Search (検索)\]**​ 項目の横にある ​**\[Advanced (詳細)\]**​ をクリックします。
4. 検索条件オプションを指定します。
    
    ![インサイトダッシュボードの詳細な検索条件項目](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-search-filter.png)
    
    Figure 3. インサイトダッシュボードの詳細な検索条件項目が表示されたスクリーンショット。
    
    - 失敗または完了したトランザクションのみを表示するには、​**\[Transaction ID (トランザクション ID)\]**​ 項目のメニューから ​**\[Failed (失敗)\]**​ または ​**\[Completed (完了)\]**​ を選択します。
        
        ![インサイトダッシュボードの詳細な検索条件項目](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-filter-transactions.png)
        
        Figure 4. **\[Transaction (トランザクション)\]**​ 項目のメニューを示す矢印。
    - 特定の日付範囲内のトランザクションを表示するには、​**\[Date & Time (日時)\]**​ 項目で日付または日付の範囲を指定します。
        
        その代わりに、グラフ内をクリックしてドラッグすることで、特定の日付範囲を選択できます。
        
        ![インサイトダッシュボードで選択されたトランザクション範囲](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-filter-selected.png)
        
        Figure 5. インサイトダッシュボードで選択されたトランザクション範囲を示す矢印。
5. **\[Advanced (詳細)\]**​ ペインで ​**\[Apply (適用)\]**​ をクリックして検索条件を適用します。
6. 検索を保存するには、​**\[Save search (検索を保存)\]**​ をクリックします。
    
    ![インサイトダッシュボードの検索を保存アイコン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-save-search.png)
    
    Figure 6. インサイドダッシュボードの ​**\[Save search (検索を保存)\]**​ アイコンを示す矢印。
    
    Runtime Manager は、指定された名前で検索を保存します。

検索の保存後は以下を行うことができます。

- 検索名をクリックして保存済みを実行する。
- 検索名にマウスポインターを置いて ​**\[Edit (編集)\]**​ リンクをクリックして保存済み検索を編集する。
    
    ![編集中の保存済み検索](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-edit-search.png)
    
    Figure 7. 編集中の保存済み検索を示す矢印。
    
    **\[Done (完了)\]**​ をクリックして変更内容を保存します。
- **\[Edit (編集)\]**​ リンクをクリックしてから、検索名の右にある削除 (ごみ箱) アイコンをクリックして、保存済み検索を削除する。

### [](#イベントの絞り込み)イベントの絞り込み

インサイトで各トランザクションに表示されるイベントの種別を絞り込むことができます。

デバッグを行っている場合は、すべてのイベントを表示して、フローの詳細なステップにドリルダウンできるようにすることが役に立つことがあります。概要レベルでのビジネス情報を分析する場合は、検索条件を適用してカスタムビジネスイベントのみを表示することができます。

絞り込みオプションを表示するには、トランザクションの ​**\[Transaction details (トランザクションの詳細)\]**​ メニューをクリックします。

![「Transaction details (トランザクションの詳細)」 メニュー](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-trans-details.png)

Figure 8. **\[Transaction details (トランザクションの詳細)\]**​ メニューを示す矢印。

イベント検索条件のデフォルト設定は、ユーザーロールによって異なります。

- **Support (サポート)**
    
    デフォルトのイベント検索条件設定では、カスタムイベントのみが表示されます。
- **Admin (管理者)**​ または ​**Developer (開発者)**
    
    デフォルトのイベント検索条件設定では、カスタムイベント、エンドポイントイベント、メッセージプロセッサーイベントが表示されますが、フローイベントは表示されません。

## [](#問題の診断とトランザクションの再生)問題の診断とトランザクションの再生

インサイトがトランザクションの失敗を報告した場合は、根本原因を診断して修復できます。

インバウンドエンドポイントが設定されているフローを持つ Mule 3 アプリケーションでは、インサイトのメッセージ再生機能を使用して、失敗したトランザクションを再生できます。

### [](#トランザクションの失敗状況)トランザクションの失敗状況

たとえば、アプリケーションで Salesforce アカウントの API コール制限数を超えてトランザクションが失敗すると、インサイトはトランザクションの状況を ​`Failed`​ として表示します。

トランザクションをクリックして展開し、トランザクション内の個々のイベントを調べます。失敗したイベントの横に例外とエラーメッセージがリストされ、既存のスタック追跡も表示されます。

![CHExcMsg](/mulesoft/current/ja-jp/runtime-manager/_images/chexcmsg.png)

### [](#トランザクションの再生)トランザクションの再生

[![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-disabled.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-disabled.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

ログを調査し、トランザクションの失敗の原因となった問題を解決 (API 利用可能数を追加購入するなど) した後に、トランザクションを再生できます。

再生は、インバウンドエンドポイントが設定されているフローを持つ Mule 3 アプリケーションでのみサポートされています。 Mule 4 アプリケーションと無料またはトライアルユーザーアカウントでは使用できません。

1. 失敗したトランザクションの最初のイベントの右にある再生アイコン ​![2.5%](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-replay-icon.png)​ をクリックして再生します。
    
    ![再生アイコンと 「Purge Replay Data (再生データを消去)」 ボタン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-insight-replay-purge.png)
    
    Figure 9. (​**1**​) トランザクション再生アイコンと (​**2**​) ​**\[Purge Replay Data (再生データを消去)\]**​ ボタンを示すスクリーンショット。
2. 確認ダイアログで ​**\[Replay Transaction (トランザクションを再生)\]**​ をクリックして確認します。
    
    トランザクションが再生されたことを示す情報ポップアップが表示され、再生されたトランザクションがインサイトのダッシュボードと ​**\[Logs (ログ)\]**​ タブに直ちに表示されます。

### [](#再生データの消去)再生データの消去

[![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-disabled.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-disabled.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf disabled](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-disabled.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)

アプリケーションの既存の再生データをすべて削除するには、​**\[Purge Replay Data (再生データを消去)\]**​ ボタンをクリックします。

<table><tbody><tr><td class="icon"><i class="fa icon-warning" title="Warning"></i></td><td class="content">消去した再生データを復元することはできません。</td></tr></tbody></table>

## [](#インサイトの状況一覧)インサイトの状況一覧

インサイトが報告する状況の一覧を下表に示します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 25%;">
<col style="width: 75%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">状況</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FAILED</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>イベントが処理中に失敗し、関連する例外を返しました。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>COMPLETED</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>イベントが完全かつ正常に処理されました。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>IN_PROGRESS</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>イベントが開始されましたが、まだ完了していません。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>STALLED</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションあたりの最大イベント処理数 (10000) を超えたため、イベントの処理が保留されています。この数を超えたイベントは保留となり、処理するイベント数が上限を下回ってから処理されます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>UNCOMPLETED</code></p></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>トランザクションが 24 時間以内に完了できない場合、​<code>IN_PROGRESS</code>​ 状況のイベントは ​<code>UNCOMPLETED</code>​ に変わります。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#ビジネスイベントのセットアップ)ビジネスイベントのセットアップ

フローにカスタムビジネスイベントを埋め込むか、フローのメッセージプロセッサー内で詳細なイベント追跡を有効にすることによって、Mule アプリケーション内のビジネスイベントを設定できます。

- **カスタムビジネスイベント**
    
    アプリケーションのフロー内の関連する位置にカスタムビジネスイベント要素を含めて、追跡するビジネスに関連性の高い処理情報を表示します。
- **イベント追跡**
    
    フロー全体またはフロー内の特定のメッセージプロセッサーやエンドポイントに対してデフォルトイベント追跡を有効にすることで、さらに詳細なイベントを追跡します。アプリケーション内のフローを設定するときに、デフォルトイベント追跡の範囲を明示的に設定できます。​[「デフォルトイベント追跡の設定」](https://docs.mulesoft.com/mule-runtime/latest/business-events-in-components)​を参照してください。

## [](#トランザクション-id-のカスタマイズ)トランザクション ID のカスタマイズ

トランザクションレベルのイベントの場合、\[ID\] 列に Long 型の数値が表示されることがあります。トランザクション ID をカスタマイズすることで、ビジネス要件に関連した、より直観的な値を表示できます。

これを行うには、Mule 式を使用して、Mule アプリケーションがトランザクションに関する有意義な情報 (注文番号、追跡番号、従業員識別番号など) を返すように設定します。​[「トランザクション ID のカスタマイズ」](https://docs.mulesoft.com/mule-runtime/latest/business-events-in-components#customize-the-transaction-id)​を参照してください。

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

- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [CloudHub のアプリケーションの開発](https://docs.mulesoft.com/cloudhub/developing-applications-for-cloudhub)
- [CloudHub へのデプロイ](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [CloudHub でのアプリケーションの管理](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)
- [MuleSoft ブログの CloudHub インサイト](https://blogs.mulesoft.com/dev/anypoint-platform-dev/announcing-cloudhub-insight-real-time-visibility-message-replay-and-root-cause-analysis/)
- [ビジネスイベント](https://docs.mulesoft.com/mule-runtime/latest/business-events)

<!-- document id=02a56db1c0e243b8b6395877f08874a1e00cebae8c5db8362fa60978c378a96e url=/mulesoft/current/ja-jp/runtime-manager/hybrid-manage-props.md -->

# オンプレミスのアプリケーションのプロパティ管理

オンプレミス (ハイブリッドまたは Anypoint Platform PCE) デプロイメントでは、プロパティファイルまたは Anypoint Runtime Manager を使用してアプリケーションにプロパティを追加できます。

たとえば、プロパティファイルでアプリケーション固有のプロパティを定義し、後でデプロイ時に Runtime Manager から環境固有のプロパティを追加することができます。

Runtime Manager でプロパティを指定することにより、複数の環境の複数のファイルではなく、1 か所でアプリケーションのプロパティを定義できます。

アプリケーションのデプロイ後、​**\[Application Settings (アプリケーションの設定)\]**​ ページから、アプリケーションのプロファイルを変更または新規作成できます。 アプリケーションがデプロイされた後にプロパティを変更した場合は、アプリケーションと、アプリケーションがデプロイされたサーバーグループまたはクラスターを再起動する必要があります。

**\[Settings (設定)\]**​ タブで定義されるプロパティの値は、プロパティファイルで定義されるアプリケーションプロパティやその他の Mule プロパティを上書きします。

プロパティには、セキュリティに関する次の考慮事項が適用されます。

- Runtime Manager と Mule Runtime Engine の間で送信される値は、HTTPS を介して暗号化されます。
- Runtime Manager の内部データベースに保存される値は暗号化されます。
- Runtime Manager では、​**\[Settings (設定)\]**​ ページにのみプロパティの値が表示されます。

## [](#プロパティファイルを使用したアプリケーションプロパティの追加)プロパティファイルを使用したアプリケーションプロパティの追加

デプロイ可能なアプリケーションのアーカイブファイルにファイルをインクルードすることで、アプリケーションにプロパティを追加できます。

- プロパティプレースホルダー YAML ファイル (Mule 4)
    
    [「プロパティの設定」](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)​を参照してください。
- `mule-app.properties`​ (Mule 3)
    
    [「プロパティの設定」](#3.9@mule-runtime::configuring-properties.adoc)​を参照してください。

これらのプロパティは、アプリケーションの起動時に Mule Runtime Engine によってアプリケーションに読み込まれます。

## [](#runtime-manager-でアプリケーションのプロパティを追加する)Runtime Manager でアプリケーションのプロパティを追加する

アプリケーションにバンドルされたプロパティファイルで指定されているプロパティは、Runtime Manager で上書きできます。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Applications (アプリケーション)\]**​ タブをクリックします。
3. **\[Status (状況)\]**​ 列をクリックして詳細ペインを表示します。
4. **\[Manage Application (アプリケーションを管理)\]**​ をクリックします。
5. **\[Settings (設定)\]**​ ページで ​**\[Properties (プロパティ)\]**​ タブで以下を行います。
    
    ![\*\*\[Settings (設定)\]\* ページの \*\[Properties (プロパティ)\]\* タブ、\*\[Key (キー)\]\* 項目と \*\[Value (値)\]\* 項目、\*\[…​\]\* メニュー](_images/rtm-manage-props.png)
    
    Figure 1. このスクリーンショットは、アプリケーションの ​**\[Settings (設定)\]**​ ページの (​**1**​) ​**\[Properties (プロパティ)\]**​ タブ、(​**2**​) ​**\[Key (キー)\]**​ 項目と ​**\[Value (値)\]**​ 項目、(​**3**​) ​**\[…​\]**​ メニューを示しています。
6. **\[Key (キー)\]**​ 項目にプロパティ名を入力します。
7. **\[Value (値)\]**​ 項目にプロパティ値を入力します。
8. **\[Save (保存)\]**​ > ​**\[Redeploy Application (アプリケーションを再デプロイ)\]**​ をクリックします。

**\[…​\]**​ メニューのオプションを使用してプロパティを編集または削除できます。

## [](#アプリケーションプロパティを上書きするための他の方法)アプリケーションプロパティを上書きするための他の方法

アプリケーションプロパティを上書きするための他の方法は、以下の通りです。

- 外部の場所を設定して、プロパティプレースホルダーまたはセキュアプロパティプレースホルダーファイルを追加し、プロパティを上書きします。
- デプロイ時に Java システム環境変数を設定して、プロパティを上書きします。
    
    これを行うには、次のコマンドを使用してアプリケーションをデプロイします。
    
    mule -M-Dsecret.key=toSecretPassword -M-Denv=prod -M-Ddb.password=secretPassword -app myApp.zip
    
    この場合、コマンドで入力したすべての値はメモリにのみ保存されるため、毎回指定する必要があります。これらの値は、どのファイルにも保存されません。

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

- [「プロパティの設定」](https://docs.mulesoft.com/mule-runtime/latest/configuring-properties)​ (Mule 4)
- [「プロパティの設定」](#3.9@mule-runtime::configuring-properties.adoc)​ (Mule 3)
- [環境プロパティの設定](https://docs.mulesoft.com/mule-runtime/latest/deploying-to-multiple-environments)
- [オンプレミスでの Mule の開始時に特定の環境を設定](https://docs.mulesoft.com/mule-runtime/latest/deploying-to-multiple-environments#setting-a-specific-environment-when-starting-mule-on-premises)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [アプリケーションプロパティを安全に隠す](https://docs.mulesoft.com/cloudhub/secure-application-properties)

<!-- document id=7e205909ae38e42012e03e507b415edc893ee82278cb7a505d7912aa3b80b9f5 url=/mulesoft/current/ja-jp/runtime-manager/servers-properties-create.md -->

# カスタムサーバープロパティの作成 (ハイブリッド)

Runtime Manager では、サーバーのプロパティを定義および設定することがきます。 これらのプロパティはキー/値ペアとして定義され、サーバーが実行されている JVM によって使用されます。 たとえば、サーバーの環境を指定できる ​`ENV=qa`​ というプロパティを設定できます。

サーバーのプロパティは、Mule がインストールされているシステムの ​`$MULE_HOME/conf/wrapper.conf`​ ファイルに保存されます。

`mule-app.properties`​ ファイルで定義されているアプリケーションプロパティは、Runtime Manager で指定されているサーバープロパティよりも優先されます。 Runtime Manager で定義されているアプリケーションプロパティは、​`mule-app.properties`​ のアプリケーションプロパティよりも優先されます。

サーバープロパティを設定する方法:

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. **\[Type (種別)\]**​ 列をクリックして詳細ペインを表示します。
4. **\[Manage Server (サーバーを管理)\]**​、​**\[Manage Group (グループを管理)\]**​、または ​**\[Manage Cluster (クラスターを管理)\]**​ をクリックします。
5. **\[Settings (設定)\]**​ ページで ​**\[Properties (プロパティ)\]**​ タブで以下を行います。
    
    ![\*\[Properties (プロパティ)\]\* タブ](_images/rtm-server-properties-tab.png)
    
    Figure 1. **\[Servers (サーバー)\]**​ ページの ​**\[Properties (プロパティ)\]**​ タブを示す矢印。
6. **\[Key (キー)\]**​ 項目にプロパティの名前を入力します。
7. **\[Value (値)\]**​ 項目にプロパティの値を入力します。
8. **\[Save (保存)\]**​ をクリックします。

カスタムプロパティを作成したら、新しいプロパティを Mule 設定に適用するためにサーバーを再起動します。

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

- [オンプレミスのアプリケーションのプロパティ管理](https://docs.mulesoft.com/jp/runtime-manager/hybrid-manage-props)
- [サーバープロパティの表示](https://docs.mulesoft.com/jp/runtime-manager/servers-properties-view)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)

<!-- document id=23312ae0214c6a8f9c2e16c3743997f109b808accde647436c5c941ea79cdcb6 url=/mulesoft/current/ja-jp/runtime-manager/cluster-about.md -->

# クラスター

クラスターは、最大 8 台のサーバーから構成され、1 つのデプロイメント対象として、さらには高可用性の処理単位として機能します。サーバーグループとは異なり、クラスター内のアプリケーションインスタンスは相互を認識し、共通の情報を共有して、状況を同期させます。1 台のサーバーが故障した場合は、別のサーバーがアプリケーションの処理を引き継ぎます。1 つのクラスターは複数のアプリケーションを実行できます。

クラスターを作成する前に、Mule Runtime Engine インスタンスを作成して、Mule サーバーを Anypoint Runtime Manager に追加する必要があります。

## [](#マルチキャストクラスターとユニキャストクラスターの比較)マルチキャストクラスターとユニキャストクラスターの比較

クラスターを構成するときに、クラスター内のノードを識別するためのユニキャストオプションまたはマルチキャストオプションのいずれかを指定します。

- **Unicast (ユニキャスト)**​:
    
    ユニキャストクラスターでは、クラスター内のノードの IP アドレスを設定する必要があります。サーバーに複数のインターフェースがある場合は、ノードが他のノードと直接通信できる内部 IP アドレスを使用してください。異なる可用性ゾーンまたはリージョン間でクラスタリングを行うと、高速接続が必要であるため、クラスターのパフォーマンスの問題が発生する可能性があります。すべてのクラスターノードを 1 つのサブネットまたは同じ可用性ゾーンに配置することで、パフォーマンスリスクが低減されます。
    
    Mule はサーバーを識別するために IP アドレスを使用するため、ユニキャストクラスター上のサーバーでは、DHCP を使用して IP アドレスを動的に割り当てることはできません。サーバーが再起動され、DHCP を使用して新しい IP アドレスを取得した場合は、新しい IP アドレスを使用してサーバーをクラスターに追加する必要があります。
    
    ユニキャストクラスターにサーバーを追加するには、サーバーの状況が \[Running (実行中)\] になっている必要があります。
- **Multicast (マルチキャスト)**​:
    
    マルチキャストクラスターは、互いに自動検出されたサーバーで構成されます。マルチキャストクラスターに含まれる各サーバーは、同じネットワークセグメント上に存在する必要があります。
    
    マルチキャストクラスターを使用する 1 つの利点は、クラスター内のノードとして設定するサーバーの状況が \[Running (実行中)\] になっている必要はないということです。もう 1 つの利点は、クラスターを再起動することなくノードをクラスターに動的に追加できることです。
    
    多くのネットワークでマルチキャスト機能がブロックされています。そのため、ネットワーク内でマルチキャストを許可するかどうかは、ネットワーク管理者に確認して判断してください。

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

- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [Mule 高可用性クラスター](https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters)

<!-- document id=ec4132ea080ed7d24be48abc0b5b218cb8a42cea8d6041db2968441932a4395a url=/mulesoft/current/ja-jp/runtime-manager/cluster-del-srv.md -->

# クラスターからのサーバーの削除

サーバーやクラスターを変更せずにクラスターからサーバーを削除できます。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">ユニキャストクラスターからサーバーを削除すると、クラスター内のすべての既存のサーバーが再起動されます。</td></tr></tbody></table>

クラスターからサーバーを削除するには、次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Cluster (クラスター)\]**​ をクリックして詳細ペインを表示します。
4. サーバーの右側にある ​**\[X\]**​ アイコンをクリックして、クラスターからサーバーを削除します。
    
    ![「X」 アイコン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-remove-server-from-cluster.png)
    
    Figure 1. 詳細ペインの ​**\[X\]**​ アイコンを示す矢印。
5. **\[Remove (削除)\]**​ 確認ウィンドウで、クラスターからのサーバーの削除を確認するためのチェックボックスをオンにして ​**\[Remove (削除)\]**​ ボタンをクリックします。

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

- [マルチキャストクラスターとユニキャストクラスターの比較](https://docs.mulesoft.com/jp/runtime-manager/cluster-about#multicast-vs-unicast-clusters)

<!-- document id=3a7f9baabaf29b7039a762cee9058d4f38b09c0f72f89e9d76fae7f7099795f7 url=/mulesoft/current/ja-jp/runtime-manager/cluster-delete.md -->

# クラスターの削除

クラスターを削除するときには、次の点に注意してください。

- クラスターのアラートの定義と履歴が削除されます。
- クラスターに割り当てられたサーバーは削除されません。
- クラスターに割り当てられたサーバーは再起動されます。
- クラスター内のサーバーにデプロイされたアプリケーションは削除されます。

クラスターを削除する手順は、次のとおりです。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Cluster (クラスター)\]**​ をクリックして詳細ペインを表示します。
4. クラスター状況をクリックして、メニューから ​**\[Delete (削除)\]**​ を選択します。
    
    ![「Delete (削除)」 オプション](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-cluster-delete.png)
    
    Figure 1. 詳細ペインの ​**\[Delete (削除)\]**​ オプションを示す矢印。
5. 確認ウィンドウで、クラスターの削除を確認するためのチェックボックスをオンにしてから ​**\[Delete Cluster (クラスターを削除)\]**​ ボタンをクリックします。

クラスターを削除すると、そのクラスターに属していた各サーバーが再起動されます。

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

- [マルチキャストクラスターとユニキャストクラスターの比較](https://docs.mulesoft.com/jp/runtime-manager/cluster-about#multicast-vs-unicast-clusters)
- [クラスターからのサーバーの削除](https://docs.mulesoft.com/jp/runtime-manager/cluster-del-srv)

<!-- document id=afa99c68e72df599485d63843c4286babeaa13f9a451069b12f7702eff9a34ee url=/mulesoft/current/ja-jp/runtime-manager/cluster-add-srv.md -->

# クラスターへのサーバーの追加

クラスター内に追加するすべてのサーバーで同じバージョンの Mule と Runtime Manager エージェントが動作している必要があります。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">ユニキャストクラスターにサーバーを追加すると、クラスター内のすべての既存のサーバーが再起動されます。</td></tr></tbody></table>

## [](#前提条件)前提条件

- 最低 1 台のサーバーが設定されていること。
- クラスターが作成されていること。

## [](#クラスターへのサーバーの追加)クラスターへのサーバーの追加

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Cluster (クラスター)\]**​ をクリックして詳細ペインを表示します。
    
    ![「Add Server (サーバーを追加)」 ボタン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-cluster-add-server-to-cluster.png)
    
    Figure 1. 詳細ペインの ​**\[Add Server (サーバーを追加)\]**​ ボタンを示す矢印。
4. **\[Add Server (サーバーを追加)\]**​ をクリックします。
    
    すでにサーバーグループやクラスターに属しているサーバーは、使用可能なサーバーのリストには表示されません。
5. リストで、クラスターに追加するサーバーを選択して、​**\[Add Servers (サーバーを追加)\]**​ をクリックします。

サーバーが ​**\[Servers (サーバー)\]**​ リストから消えます。クラスター内のサーバーのリストを表示するには、クラスター名をクリックします。

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

- [マルチキャストクラスターとユニキャストクラスターの比較](https://docs.mulesoft.com/jp/runtime-manager/cluster-about#multicast-vs-unicast-clusters)
- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)

<!-- document id=138d50c469446fc536991ab4b1955ec9e12c58afda67e2ef81ecaf976d298330 url=/mulesoft/current/ja-jp/runtime-manager/servers-about.md -->

# サーバー

Anypoint Runtime Manager には、オンプレミスの Mule Runtime Engine インスタンス (サーバー) を管理するためのインターフェースがあります。個別のサーバーや、サーバーグループやクラスターのサーバーを管理できます。

サーバーは、Runtime Manager エージェントを使用して Runtime Manager と通信します。サーバーを追加したら、Runtime Manager を使用して Mule インスタンスにアプリケーションをデプロイします。Mule をインストールした環境の情報を表示することもできます。

管理したい Mule インスタンスごとに、サーバーを Runtime Manager に追加してください。複数の Mule インスタンスが存在する環境では、サーバーグループやクラスターを使用して、冗長性や高可用性を実現し、管理を容易にすることができます。

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

- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [サーバーグループ](https://docs.mulesoft.com/jp/runtime-manager/server-group-about)
- [クラスター](https://docs.mulesoft.com/jp/runtime-manager/cluster-about)

<!-- document id=85718bc84bccdfe6dbed9d425c2dda668555c1dc5d50f05c980bdf63e8589523 url=/mulesoft/current/ja-jp/runtime-manager/managing-servers.md -->

# サーバー、サーバーグループ、クラスター

Runtime Manager を使用して、オンプレミスのサーバー、サーバーグループ、クラスターのプロパティを登録しセットアップします。サーバーは、セットアップ後にサーバーグループまたはクラスターに追加できます。その後、サーバー、サーバーグループ、またはクラスターをアプリケーションのデプロイメント対象として選択できます。

## [](#サーバーグループの状況の状態)サーバーグループの状況の状態

サーバーグループとクラスターでは、両方とも複数の分散ノードでアプリケーションが実行されます。サーバーグループを使用する場合、アプリケーションの各インスタンスは完全に相互分離しています。クラスター設定では、ノードは相互に認識され、共通情報を共有し、状態が同期されます。

サーバーグループまたはクラスター内のすべてのサーバーが同じ Mule Runtime Engine バージョンと Runtime Manager エージェントバージョンを実行している必要があります。

## [](#アラート)アラート

サーバーが切断されたり、クラスターから削除されるなど、サーバーにイベントが発生した場合に通知されるメールアラートをセットアップできます。アラートは、特定のサーバーまたはサーバーグループやクラスター内のすべてのサーバーにリンクできます。

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

- [サーバー](https://docs.mulesoft.com/jp/runtime-manager/servers-about)
- [サーバーグループ](https://docs.mulesoft.com/jp/runtime-manager/server-group-about)
- [クラスター](https://docs.mulesoft.com/jp/runtime-manager/cluster-about)
- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [自分のサーバーへのアプリケーションのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [デプロイメントとサーバーの拡張](https://docs.mulesoft.com/jp/runtime-manager/runtime-dep-serv-limits)
- [Mule 高可用性クラスター](https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters)
- [Anypoint Platform の REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=d26c7e76f0dd818944e4a11fea1ea2b50446bb28db584f739f6a52cf9f2c11e4 url=/mulesoft/current/ja-jp/runtime-manager/server-group-about.md -->

# サーバーグループ

サーバーグループとは、単一のデプロイメント対象として機能する一連のサーバーを指し、各サーバーに個別にアプリケーションをデプロイしなくて済みます。

サーバーグループのサーバーにアプリケーションをデプロイすることで冗長性が生まれ、アプリケーションをよりシームレスに、短いダウンタイムですばやく復元できるようになります。

クラスターとは異なり、サーバーグループのアプリケーションインスタンスは、グループ内の他のサーバーで動作しているアプリケーションインスタンスとは隔離されて実行されます。サーバーグループで同時実行の問題がある場合は、クラスターを使用したサーバーのグループ化を検討してください。

## [](#要件と制限事項)要件と制限事項

- サーバーグループでは、すべてのサーバーが同じ Mule Runtime Engine バージョンと Runtime Manager エージェントバージョンを実行している必要があります。
- サーバーグループは、状況が \[Running (実行中)\] または \[Disconnected (切断済み)\] のサーバーで構成することができますが、状況が \[Created (作成済み)\] のサーバーと同じグループに混在させることはできません。
- すべてのサーバーの状況が \[Created (作成済み)\] であれば、それらのサーバーでサーバーグループを構成できます。
- 既存のアプリケーションが実行中であるサーバーをサーバーグループに追加するには、先にアプリケーションを停止してサーバーから削除してください。

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

- [サーバーの状況の状態](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#server_status_states)
- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [サーバーグループの作成](https://docs.mulesoft.com/jp/runtime-manager/server-group-create)
- [サーバーグループへのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/server-group-add)
- [高可用性および障害回復](https://docs.mulesoft.com/hosting-home/hadr-guide)
- [クラスタリングの利点](https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters#the-benefits-of-clustering)
- [クラスターによって解決される同時実行の問題](https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters#concurrency-issues-solved-by-clusters)

<!-- document id=808563021e981ff9c47d53232054f58e24e93aefb323288ed1ec99f57f51a951 url=/mulesoft/current/ja-jp/runtime-manager/server-group-remove.md -->

# サーバーグループからのサーバーの削除

グループを組織内で整理するなどの目的で、あるサーバーグループからサーバーを削除して別のグループに追加したい場合があります。

グループからサーバーを削除するには、次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Group (グループ)\]**​ をクリックして詳細ペインを表示します。
4. サーバーの右側にある ​**\[X\]**​ アイコンをクリックして、サーバーグループからサーバーを削除します。
    
    ![「X」 アイコン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-remove-server-from-group.png)
    
    Figure 1. 詳細ペインの ​**\[X\]**​ アイコンを示す矢印。
5. **\[Remove (削除)\]**​ 確認ウィンドウで、グループからのサーバーの削除を確認するためのチェックボックスをオンにして ​**\[Remove (削除)\]**​ ボタンをクリックします。

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

- [サーバーグループ](https://docs.mulesoft.com/jp/runtime-manager/server-group-about)
- [サーバーグループの削除](https://docs.mulesoft.com/jp/runtime-manager/server-group-delete)

<!-- document id=aeed3873658d7ca9db86ca8ae64607cceb548e64122dcfc8c7977835da57655a url=/mulesoft/current/ja-jp/runtime-manager/server-group-create.md -->

# サーバーグループの作成

アプリケーションをサーバーグループにデプロイするには、最初に Runtime Manager にサーバーを追加してからサーバーグループを作成するか、または先にグループを作成してからサーバーを追加できます。

サーバーグループを作成するには、次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Create Group (グループを作成)\]**​ ボタンをクリックします。
4. **\[Create Server Group (サーバーグループを作成)\]**​ ページで、サーバーグループの名前を指定します。
    
    グループ名では、3 ～ 40 文字の英数字 (a-z、A-Z、0-9) とハイフン (-) を使用できます。先頭や末尾をハイフンにしたり、スペースや他の文字を含めたりすることはできません。
5. 新しいサーバーグループに含めるサーバーを選択します。
6. **\[Create Group (グループを作成)\]**​ ボタンをクリックします。

新しいサーバーグループが ​**\[Servers (サーバー)\]**​ リストに表示されます。サーバーが ​**\[Servers (サーバー)\]**​ リストから消えます。サーバーグループ内のサーバーのリストを表示するには、グループ名をクリックします。

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

- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [サーバーグループへのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/server-group-add)

<!-- document id=0f918b413794492a21250a63c26159a55d0d6cd81b0fd882bd8bef45bbae9922 url=/mulesoft/current/ja-jp/runtime-manager/server-group-delete.md -->

# サーバーグループの削除

サーバーグループを削除すると、以下のアクションが実行されます。

- サーバーグループのアラート定義と履歴は削除されます。
- サーバーグループ内の各サーバーにデプロイされたアプリケーションは各サーバーでコピーされます。

削除されたサーバーグループに割り当てられているサーバーは、削除、再起動、またはシャットダウンされません。削除されたグループに属するサーバーは ​**\[Servers (サーバー)\]**​ ページに表示されます。これらのサーバーにアプリケーションを個別にデプロイしたり、他のサーバーグループやクラスターにアプリケーションをデプロイしたりできます。

## [](#サーバーグループの削除)サーバーグループの削除

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Group (グループ)\]**​ をクリックして詳細ペインを表示します。
4. サーバー状況をクリックして、メニューから ​**\[Delete (削除)\]**​ を選択します。
    
    ![「Delete (削除)」 オプション](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-group-delete.png)
    
    Figure 1. 詳細ペインの ​**\[Delete (削除)\]**​ オプションを示す矢印。
5. **\[Delete (削除)\]**​ 確認ウィンドウで、サーバーグループの削除を確認するためのチェックボックスをオンにしてから ​**\[Delete Server Group (サーバーグループを削除)\]**​ ボタンをクリックします。

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

- [サーバーグループ](https://docs.mulesoft.com/jp/runtime-manager/server-group-about)
- [サーバーグループからのサーバーの削除](https://docs.mulesoft.com/jp/runtime-manager/server-group-remove)

<!-- document id=5032caa42d5fba1855e7d820329524326a10eaed07f32465560f1bb416f194e1 url=/mulesoft/current/ja-jp/runtime-manager/server-group-add.md -->

# サーバーグループへのサーバーの追加

## [](#前提条件)前提条件

- 最低 1 台のサーバーが設定されていること。
- サーバーグループが作成されていること。
- サーバーグループに追加するサーバーにはアプリケーションがデプロイされていないこと。

## [](#サーバーをグループに追加する)サーバーをグループに追加する

サーバーグループの作成後にサーバーグループにサーバーを追加するには、次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. **\[Type (種別)\]**​ 列で ​**\[Group (グループ)\]**​ をクリックして詳細ペインを表示します。
4. **\[Add Server (サーバーを追加)\]**​ ボタンをクリックします。
    
    ![「Add Server (サーバーを追加)」 ボタン](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-group-add-server-to-group.png)
    
    Figure 1. 詳細ペインの ​**\[Add Server (サーバーを追加)\]**​ ボタンを示す矢印。
    
    使用できるサーバーのリストが表示されます。
5. グループに追加するサーバーを選択して、​**\[Add Servers (サーバーを追加)\]**​ ボタンをクリックします。

サーバーが ​**\[Servers (サーバー)\]**​ リストから消えます。グループ内のサーバーのリストを表示するには、グループ名をクリックします。

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

- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [サーバーグループの作成](https://docs.mulesoft.com/jp/runtime-manager/server-group-create)
- [サーバーグループ](https://docs.mulesoft.com/jp/runtime-manager/server-group-about)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)
- [デプロイメントとサーバーの拡張](https://docs.mulesoft.com/jp/runtime-manager/runtime-dep-serv-limits)

<!-- document id=74d4a6ef90518c28438b6cea348f834c7662edad2bc0f2c04e83ddbc34c6cdbd url=/mulesoft/current/ja-jp/runtime-manager/servers-actions.md -->

# サーバーのシャットダウン、再起動、削除

サーバーを作成したら、Runtime Manager から管理できます。実行できるアクションには、シャットダウン、再起動、削除があります。

サーバーをシャットダウンした後に Runtime Manager から再起動することはできません。Mule Runtime Engine がインストールされているマシンで、サーバーを手動で起動する必要があります。

サーバーのシャットダウンまたは再起動中にエラーが発生した場合は、エラーによっては、Mule がインストールされているマシンでのサーバーの手動による起動または停止が必要な場合があります。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. 左側のメニューで ​**\[Servers (サーバー)\]**​ を選択します。
3. サーバー名をクリックします。
4. **\[Settings (設定)\]**​ をクリックします。
    
    ![\*\[Actions (アクション)\]\* メニュー](_images/rtm-servers-actions-menu.png)
    
    Figure 1. **\[Servers (サーバー)\]**​ ページの ​**\[Actions (アクション)\]**​ メニューを示す矢印。
5. **\[Actions (アクション)\]**​ メニューから以下を選択します。
    
    - **Delete (削除)**
    - **Restart (再起動)**
    - **Shutdown (シャットダウン)**
    - **Renew Certificate (証明書を更新)**
6. 確認ウィンドウで、選択したアクションのチェックボックスをオンにします。

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

- [Mule の開始と停止](https://docs.mulesoft.com/on-premises/latest/starting-and-stopping-mule-esb)
- [サーバー証明書の更新](https://docs.mulesoft.com/jp/runtime-manager/servers-cert-renewal)

<!-- document id=e48a1f9d92a14103ab874e782b36368e197e3fb5490d26b2d10397e785ef57b6 url=/mulesoft/current/ja-jp/runtime-manager/servers-properties-view.md -->

# サーバープロパティの設定

Runtime Manager では、Mule 環境のプロパティを表示および設定することができます。Runtime Manager には、カスタムプロパティと検出されたプロパティが表示されます。

## [](#カスタムプロパティ)カスタムプロパティ

カスタムプロパティを使用して、Mule インスタンスの JVM コンテナによって使用されるプロパティを定義できます。カスタムプロパティはキー/値ペアとして定義されます。

## [](#検出されたプロパティ)検出されたプロパティ

検出されたプロパティは、Mule インスタンスのリモート環境によって定義されるプロパティです。これらのプロパティは次のとおりです。

- JVM 引数
- 環境プロパティ
- システムプロパティ

Runtime Manager では、リモートサーバーの ​`System`​ Java クラスを照会する Runtime Manager エージェントからこれらのプロパティの値を取得します。

リモートサーバープロパティの自動検出はデフォルトで無効になっています。この機能を使用するには、​**\[Enable Auto-Discovery (自動検出を有効化)\]**​ をクリックします。この機能を有効にした後、Runtime Manager ではこれらのプロパティの暗号化されたものが内部データベースに保存されます。

この機能を完全に無効化することで、Runtime Manager が検出したプロパティを保存することを禁止できます。MuleSoft カスタマーサクセス担当者にお問い合わせください。

## [](#サーバープロパティの表示)サーバープロパティの表示

検出されたプロパティを表示する手順は、次のとおりです。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. **\[Type (種別)\]**​ 列をクリックして詳細ペインを表示します。
4. **\[Manage Server (サーバーを管理)\]**​、​**\[Manage Group (グループを管理)\]**​、または ​**\[Manage Cluster (クラスターを管理)\]**​ をクリックします。
5. **\[Settings (設定)\]**​ ページで ​**\[Properties (プロパティ)\]**​ タブをクリックします。
6. **\[Custom Properties (カスタムプロパティ)\]**​ または ​**\[Discovered Properties (検出されたプロパティ)\]**​ をクリックします。
    
    検出されたプロパティが表示されるようにするには、​**\[Discovered Properties (検出されたプロパティ)\]**​ を選択してから ​**\[Enable Auto-Discovery (自動検出を有効化)\]**​ をクリックします。
    
    ![\*\[Discovered Properties (検出されたプロパティ)\] ボタンと \[Enable Auto-Discovery (自動検出を有効化)\] ボタン](_images/rtm-server-enable-autodiscovery.png)
    
    Figure 1. **\[Properties (プロパティ)\]**​ タブの ​**\[Discovered Properties (検出されたプロパティ)\]**​ ボタンと ​**\[Enable Auto-Discovery (自動検出を有効化)\]**​ ボタンが表示された画面。
    
    サーバーのプロパティを自動検出するには、サーバーの状況が \[Running (実行中)\] になっている必要があります。
    
    **\[Properties (プロパティ)\]**​ タブでは以下を行うことができます。
    
    - プロパティを検索する。
    - 新しいプロパティを作成する。
    - 既存のプロパティを編集する。

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

- [サーバー設定へのアクセス](https://docs.mulesoft.com/jp/runtime-manager/servers-settings)
- [カスタムプロパティの作成](https://docs.mulesoft.com/jp/runtime-manager/servers-properties-create)

<!-- document id=c1cd436e1a8e9089a0e20290bb5900eecd6d384637f6ee2acc1abbe83acc99d9 url=/mulesoft/current/ja-jp/runtime-manager/servers-view-info.md -->

# サーバー情報の表示 (ハイブリッド)

Runtime Manager の ​**\[Servers (サーバー)\]**​ タブでは、環境にあるサーバー、サーバーグループ、クラスター、API ゲートウェイのリストを参照できます。このタブから、これらのコンポーネントに対してアクションを実行することもできます。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
    
    Runtime Manager には次の情報を含むサーバーのリストが表示されます。
    
    **Name (名前)**
    
    サーバー、API ゲートウェイ、サーバーグループ、またはクラスターの名前を表示します。
    
    **Status (状況)**
    
    現在の状況を表示します。
    
    **Type (種別)**
    
    コンポーネントが Mule サーバー、API ゲートウェイ、サーバーグループ、またはクラスターのいずれであるかを示します。
    
    **Version (バージョン)**
    
    API ゲートウェイまたは Mule のバージョンを表示します。
3. **\[Type (種別)\]**​ 列をクリックすると、追加のプロパティとアクションが詳細ペインに表示されます。
4. コンポーネントの名前をクリックしてそのダッシュボードを表示します。

## [](#詳細ペイン)詳細ペイン

詳細ペインには以下の情報が表示されます。

- コンポーネントの状況
- Mule または API ゲートウェイのバージョン
- Runtime Manager エージェントのバージョン
- **\[Settings (設定)\] (設定)**​ ページに移動するための ​**\[Manage Server (サーバーを管理)\]**​、​**\[Manage Group (グループを管理)\]**​、または ​**\[Manage Cluster (クラスターを管理)\]**​ ボタン
- サーバーのダッシュボードページに移動するための ​**\[View Dashboard (ダッシュボードを表示)\]**​ ボタン
    
    サーバーグループまたはクラスター内のサーバーのダッシュボードを表示するには、詳細ペインでサーバー名をクリックします。
- クラスターの場合は種別 (ユニキャストまたはマルチキャスト)

下部のタブでは、次の詳細を参照できます。

- クラスターとサーバーグループでは、サーバーのリストと各サーバーの状況
- 実行中のアプリケーションとそれぞれの状況
- プラグイン (Splunk、ELK など)

![\*\[Applications (アプリケーション)\]\* タブ、サーバーリスト、\*\[Plugins (プラグイン)\]\* タブ](_images/rtm-cluster-details-pane.png)

Figure 1. **\[Applications (アプリケーション)\]**​ タブ、サーバーリスト、​**\[Plugins (プラグイン)\]**​ タブが表示された画面。

## [](#サーバーダッシュボード)サーバーダッシュボード

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](deployment-strategies#hybrid-deployments)

サーバーダッシュボードには、ヒープメモリや CPU パフォーマンスなど、詳細なパフォーマンスメトリクスが表示されます。

![\*\[Heap Memory (ヒープメモリ)\]\* グラフ、アプリケーションリスト、\*\[CPU\]\* グラフ](_images/rtm-server-dashboards-page.png)

Figure 2. **\[Heap Memory (ヒープメモリ)\]**​ グラフ、アプリケーションリスト、​**\[CPU\]**​ グラフが表示された画面。

ダッシュボードには次の情報も表示されます。

- サーバーにデプロイされたアプリケーションのリスト
- 各アプリケーションの状況
- 各アプリケーションの Mule メッセージ
- 各アプリケーションのエラーメッセージ

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

- [サーバーの状況の状態](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#server_status_states)
- [サーバーグループの状況の状態](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#server_groups_status_states)
- [クラスターの状況の状態](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications#cluster_status_states)
- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [Runtime Manager の監視ダッシュボード](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)

<!-- document id=caf524f84aadb5eda20bd3543d60eed0622374ad498ad4a663782513c768aee0 url=/mulesoft/current/ja-jp/runtime-manager/servers-settings.md -->

# サーバー設定へのアクセス

**\[Settings (設定)\]**​ ページでは、サーバーのプロパティを設定してアラートを表示できます。このページでは、他のアクション (例: サーバーグループの削除) も実行できます。

**\[Settings (設定)\]**​ ページにアクセスするには、次の手順を実行します。

1. Anypoint Platform から ​**\[Runtime Manager\]**​ を選択します。
2. ナビゲーションメニューで ​**\[Servers (サーバー)\]**​ をクリックします。
3. 次のいずれかを行います。
    
    - **\[Type (種別)\]**​ 列をクリックして詳細ペインを表示して、​**\[Manage Server (サーバーを管理)\]**​、​**\[Manage Group (グループを管理)\]**​、または ​**\[Manage Cluster (クラスターを管理)\]**​ をクリックします。
        
        ![\*\[Manage Server (サーバーを管理)\]\* ボタン](_images/rtm-view-server-settings.png)
        
        Figure 1. 詳細ペインの ​**\[Manage Server (サーバーを管理)\]**​ ボタンを示す矢印。
    - **\[Servers (サーバー)\]**​ ページでサーバー、サーバーグループ、またはクラスターの名前をクリックしてから ​**\[Settings (設定)\]**​ をクリックします。
        
        ![\*\[Settings (設定)\]\* ページ](_images/rtm-server-settings-page.png)
        
        Figure 2. **\[Settings (設定)\]**​ ページのナビゲーションオプションを示す矢印。

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

- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [サーバープロパティの設定](https://docs.mulesoft.com/jp/runtime-manager/servers-properties-view)
- [カスタムプロパティの作成](https://docs.mulesoft.com/jp/runtime-manager/servers-properties-create)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)

<!-- document id=746f23c4779c3ad18d2e5756ac2c28cdfb727945c7e49b9257d1ffe595fa2655 url=/mulesoft/current/ja-jp/runtime-manager/servers-cert-renewal.md -->

# サーバー証明書の更新

Mule サーバーを Anypoint Runtime Manager に登録するためには、Runtime Manager によってプロビジョニングされて署名されたアクティブな証明書が必要です。 証明書は、Runtime Manager と Runtime Manager エージェント間のセキュアな通信を保証します。

サーバー証明書の期限が切れると、​**\[Servers (サーバー)\]**​ ページのサーバーの ​**\[Status (状況)\]**​ 列に ​`Disconnected`​ と表示されます。 `mule_agent.log`​ ファイルには次のようなメッセージが出力されます。

com.mulesoft.agent.transport.WSConnection: Failed attempt to connect nro. 1 to the web socket client at runtime-manager.anypoint.mulesoft.com: Connection refused.

サーバーにデプロイされたアプリケーションの場合は、​**\[Applications (アプリケーション)\]**​ ページの ​**\[Status (状況)\]**​ 列に ​`Unknown`​ と表示されます。

## [](#証明書の有効期限を表示する)証明書の有効期限を表示する

サーバーの有効期限を表示するには、次の手順を実行します。

1. Anypoint Platform の ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. サーバー名をクリックします。
    
    サーバーグループやクラスターのサーバーの場合は、サーバーグループまたはクラスターの名前をクリックしてから、サーバー名をクリックします。
    
    サーバーダッシュボードに証明書の有効期限が表示されます。
    
    ![「Dashboard (ダッシュボード)」 ページの 「Certificate expiration date (証明書有効期限(日))」](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-certificate.png)
    
    Figure 1. **\[Dashboard (ダッシュボード)\]**​ ページの ​**\[Certificate expiration date (証明書有効期限(日))\]**​ を示す矢印。

## [](#runtime-manager-から証明書を更新する)Runtime Manager から証明書を更新する

証明書の有効期限が切れる前に、Runtime Manager から直接更新することができます。

証明書は、特定のサーバーまたはクラスターやグループ内の複数のサーバーに対して更新できます。

証明書を更新するためには、サーバーの状況が ​`Running`​ である必要があります。

スタンドアロンサーバーの証明書を更新する手順は、次のとおりです。

1. Anypoint Platform の ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. サーバーの状況が ​`Running`​ であることを確認します。
4. サーバー名をクリックします。
    
    ![サーバーの選択](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-standalone-name.png)
5. **\[Settings (設定)\]**​ をクリックします。
6. **\[Actions (アクション)\]**​ メニューから ​**\[Renew Certificate (証明書を更新)\]**​ を選択します。
    
    ![「Settings (設定)」 タブ](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-standalone-settings.png)
7. 確認するチェックボックスをクリックしてから ​**\[Renew (更新)\]**​ を選択します。
    
    ![更新の確定](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-standalone-renew.png)
8. **証明書の有効期限**​をチェックして証明書が正常に更新されたことを確認し、新しい証明書が使用されるように Mule Runtime を再起動します。

クラスターまたはグループのサーバーの証明書を更新する手順は、次のとおりです。

1. Anypoint Platform の ​**\[Runtime Manager\]**​ を選択します。
2. **\[Servers (サーバー)\]**​ タブをクリックします。
3. サーバーの状況が ​`Running`​ であることを確認します。
4. グループまたはクラスター名をクリックします。
    
    ![グループまたはクラスターの選択](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-certificate-group-name.png)
5. ラジオボタンをオンにして、更新するサーバーを選択します。
6. **\[Actions (アクション)\]**​ メニューから ​**\[Renew Certificate (証明書を更新)\]**​ を選択します。
    
    ![サーバーの選択](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-certificate-group-select-server.png)
7. 確認するチェックボックスをクリックしてから ​**\[Renew (更新)\]**​ を選択します。
    
    ![更新の確定](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-certificate-group-renew.png)
8. **\[Certificate expiration date (証明書有効期限 (日))\]**​ を見て、証明書が正しく更新されたことを確認します。

前のステップの実行後に ​**\[Actions (アクション)\]**​ プルダウンメニューの ​**\[Renew Certificate (証明書を更新)\]**​ オプションが使用できない場合、​[**Agent**​ バージョンを更新](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#update-the-agent.adoc)​する必要がある場合があります。 Runtime Manager から直接サーバー証明書を更新できる ​**\[Server certificate renewal (サーバー証明書の更新)\]**​ 機能は、Runtime Manager 2.8.4 によって導入されました。この機能には、Runtime Manager Agent 1.10.0 以降が必要です。 **\[Actions (アクション)\]**​ プルダウンメニューの ​**\[Renew Certificate (証明書を更新)\]**​ オプションにマウスポインターを置くと、UI のツールチップで最小必要 Runtime Agent バージョンが示されます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">サーバー証明書を更新するには、手動でランタイムを再起動して新しい証明書の使用を開始する必要があります。</td></tr></tbody></table>

Runtime Manager を使用した期限切れになる前の証明書の更新に失敗した場合は、​[コマンドラインを使用して証明書を更新する](#コマンドラインを使用して証明書を更新する)​の手順に従ってください。

## [](#コマンドラインを使用して証明書を更新する)コマンドラインを使用して証明書を更新する

このメソッドを使用して、期限が切れた後であっても証明書を更新できます。

エージェントは相互 SSL 認証を使用して Runtime Manager に接続し、キーペアを ​`$MULE_HOME/conf/mule-agent.jks`​ ファイルに保存します。 キーペアの有効期限は 2 年間で、その後、証明書の有効期限が切れて Runtime Manager から切断されます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">これらの手順を実行する前に、MFA を無効にしていることを確認してください。</td></tr></tbody></table>

エージェントのキーペアを更新するには、次の手順を実行します。

1. [キーペアの有効期限が切れたために Anypoint Runtime Manager で ​`unknown`​ または ​`disconnected`​ と表示されているアプリケーションとサーバー](https://help.mulesoft.com/s/article/Applications-and-Servers-showing-as-Unknown-and-Disconnected-state-in-Anypoint-Runtime-Manager-due-to-expired-key-pair)​から、使用している Mule バージョンに対応した ​`agent-certificate-renewer-{version}.jar`​ ファイルをダウンロードします。
2. JAR ファイルを ​`$MULE_HOME/bin`​ に移動して、実行権限を持っていることを確認します。
    
    たとえば、Linux では​`「chmod +xx agent-certificate-renewer-{version}.jar」`​と入力します。
3. Mule を停止します。
4. `$MULE_HOME/conf`​ ディレクトリのバックアップコピーを作成します。
5. Anypoint Platform での認証方法に応じて、次のいずれかのコマンドを ​`$MULE_HOME/bin`​ から実行します。
    
    - 非統合
        
        コマンドラインで Anypoint Platform のログイン情報を使用します。
        
        `java -jar ./agent-certificate-renewer-{version}.jar -u <username> -p <password>`
    - 外部 ID
        
        サーバーの登録トークンを ​**\[Runtime Manager\] > \[Servers (サーバー)\] > \[Add Server (サーバーを追加)\]**​ ポップアップ画面からコピーして、コマンドラインに含めます。
        
        ![登録トークンの追加](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-server-certificate-external-identity.png)
        
        また、次のコマンドを実行します。
        
        `java -jar ./agent-certificate-renewer-{version}.jar -H <ServerToken>`
    - プロキシ接続
        
        コマンドラインで Anypoint Platform とプロキシサーバーのログイン情報を使用します。
        
        `java -jar agent-certificate-renewer-{version}.jar -u <username> -p <password> -P <host> <port> <username> <password>`
    - 米国 MuleSoft Government Cloud コントロールプレーン
        
        次の -r フラグを使用します。
        
        `java -jar ./agent-certificate-renewer-{version}.jar -H <ServerToken> -r us_gov`
    - EU コントロールプレーン
        
        次の -r フラグを使用します。
        
        `java -jar ./agent-certificate-renewer-{version}.jar -u <username> -p <password> -r eu1`
    
    コマンドから次のメッセージが返されます。
    
    INFO: Connecting to Core Services to extract authentication token.
    INFO: Connecting to Runtime Manager to request a new certificate.
    INFO: Backing up current agent keystore.
    INFO: Generating and saving new keystore.

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

- [サーバー](https://docs.mulesoft.com/jp/runtime-manager/servers-about)
- [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)
- [サーバーのシャットダウン、再起動、削除](https://docs.mulesoft.com/jp/runtime-manager/servers-actions)
- [Runtime Manager の監視ダッシュボード](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)

<!-- document id=5bca03444479e86d225caf2037c240271e90e73031b1c756fbebad8c808a1c64 url=/mulesoft/current/ja-jp/runtime-manager/support-center-access.md -->

# サポートセンターへのアクセス

![サポート](/mulesoft/current/ja-jp/runtime-manager/_images/support-logo.png)

このページは、使用しているアカウントで MuleSoft サポートセンターにアクセスできないために表示されます。アカウントが無料アカウントまたはトライアルであるか、注文どおりに完全にセットアップされていない可能性があります。

サインインに正しいログイン情報を使用していることを確認してください。

- Anypoint Platform ユーザーは、Anypoint Platform ユーザー名とパスワードを使用してログインします。
- オンプレミスユーザーは、MuleSoft カスタマーサクセスマネージャーから提供されたログイン情報を使用します。

MuleSoft と既存の商業的関係があり、Anypoint Platform アカウントへのアクセスで問題が発生している場合は、 [MuleSoft サポートポータル](https://help.mulesoft.com/s/support)​からケースを登録することができます。サポートポータルにアクセスできない場合は、カスタマーサクセスマネージャーまたは MuleSoft アカウント管理チームにお問い合わせください。

公開情報は [MuleSoft ヘルプセンター](https://help.mulesoft.com/s/)​で参照できます。

## [](#コミュニティサポート)コミュニティサポート

現在 MuleSoft のお客様でない場合でも、 [MuleSoft ヘルプセンター](https://help.mulesoft.com/s/)​で公開されているリソースにアクセスしたり、 [MuleSoft コミュニティフォーラム](https://help.mulesoft.com/s/forum)​で他の開発者から回答を得ることができます。

<!-- document id=7237097d2bfe26c4a2e98f099e61a249945fcfe8be761f59d9ac294ba9f11565 url=/mulesoft/current/ja-jp/runtime-manager/hybrid-schedule-mgmt.md -->

# スケジューラーの管理

Runtime Manager を使用して、デプロイされたアプリケーションのフロー内の Scheduler コンポーネントの表示と制御を行うことができます。 ナビゲーションメニューにある ​**\[Schedulers (スケジューラー)\]**​ タブを使用して、実行中のアプリケーションを変更することなく、Scheduler 要素を有効化または無効化するか、頻度を変更するか、スケジュール済みジョブを直ちに実行します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">スケジュール管理は、Mule バージョン 3.9 以降のみを使用するハイブリッドデプロイメント環境のサーバーでサポートされています。</td></tr></tbody></table>

**\[Schedulers (スケジューラー)\]**​ タブでは以下を行うことができます。

- スケジューラーを有効または無効にする
- 頻度を変更する
- スケジューラーの実行開始時間を指定する
- Cron スケジューラーのタイムゾーンを指定する

Runtime Manager では、各スケジューラーコンポーネント名が ​`polling://{flow_name}`​ としてリストされます。

## [](#ユースケース)ユースケース

スケジュール管理は、次のような状況で役立ちます。

- 再デプロイせずに実行時にアプリケーションでスケジューラーを変更したい。
- 接続しているアプリケーションのうちの 1 つがメンテナンス中である間に、スケジュールされたジョブを無効にしたい場合。
- アプリケーション内のスケジューラーを実行時に可視化したい場合。

## [](#考慮事項と制限事項)考慮事項と制限事項

**\[Schedulers (スケジューラー)\]**​ タブを使用するときには、次の点を考慮してください。

- アプリケーションが実行されていないためにスケジュールされたジョブがトリガーされない場合は、アプリケーションが再起動すると、Runtime Manager はすぐにジョブをトリガーします。
- スケジューラーは、毎回の実行時にジョブ設定を読み取ります。
    
    変更を直ちに適用するには、スケジュールの更新後にジョブを手動で実行します。

## [](#runtime-manager-でアプリケーションのスケジューラーを表示して管理する)Runtime Manager でアプリケーションのスケジューラーを表示して管理する

Runtime Manager のスケジュール機能を使用するには、1 つ以上の Scheduler 要素を含むアプリケーションをデプロイします。

![Anypoint Studio キャンバスの Scheduler コンポーネント](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-scheduler-studio.png)

Figure 1. 矢印は、Anypoint Studio キャンバスの ​**Scheduler**​ コンポーネントを示しています。

アプリケーションをデプロイしたら、Runtime Manager で Scheduler 要素を表示して管理します。

1. 左ペインで ​**\[Applications (アプリケーション)\]**​ をクリックし、アプリケーション名をクリックしてから ​**\[Schedulers (スケジューラー)\]**​ をクリックします。
    
    ![「Schedulers (スケジューラー)」 ページの 「Schedulers (スケジューラー)」 オプションとチェックボックス](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-scheduler-rtm.png)
    
    Figure 2. このスクリーンショットは (​**1**​) ​**\[Schedulers (スケジューラー)\]**​ オプションと (​**2**​) ​**\[Schedulers (スケジューラー)\]**​ ページのチェックボックスを示しています。
    
    **\[Name (名前)\]**​ 列には、Scheduler 要素を含むフローの名前が表示されます。
    
    Runtime Manager では、Scheduler 要素がアプリケーションに表示される順序でリストされます。
    
    ![詳細ペインのチェックボックス、「Disable (無効化)」 ボタン、スケジュール](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-scheduler-rtm-detail.png)
    
    Figure 3. このスクリーンショットは、詳細ペインの (​**1**​) チェックボックス、(​**2**​) ​**\[Disable (無効化)\]**​ ボタン、(​**3**​) スケジュールを示しています。
2. チェックボックスをオンにして ​**\[Enable (有効化)\]**​ をクリックすることで、1 つ以上のスケジューラーを有効化します。
3. Cron スケジューラーを更新するには、詳細ペインでチェックボックスを 1 つオンにして、スケジュール設定を更新します。
    
    ![詳細ペインのスケジュール設定](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-scheduler-cron.png)
    
    Figure 4. 矢印は、詳細ペインの Cron スケジュール設定を示しています。
4. 一定間隔スケジューラーを更新するには、詳細ペインでチェックボックスを 1 つオンにして、スケジュール設定を更新します。
    
    ![詳細ペインのスケジュール設定](/mulesoft/current/ja-jp/runtime-manager/_images/hybrid-scheduler-fixed-frequency.png)
    
    Figure 5. 矢印は、詳細ペインの一定間隔スケジュール設定を示しています。
5. チェックボックスをオンにして ​**\[Disable (無効化)\]**​ をクリックすることで、1 つ以上のスケジューラーを無効化します。
6. **\[Update (更新)\]**​ をクリックして、変更した設定を保存します。

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

- [スケジューラーエンドポイント (トリガー)](https://docs.mulesoft.com/mule-runtime/latest/scheduler-concept)
- [Poll コンポーネントの移行](https://docs.mulesoft.com/mule-runtime/latest/scheduler-concept)

<!-- document id=638d204efa686d24b9f2c59f11056d9846454c7a7840039f30476eb02d1bf0ef url=/mulesoft/current/ja-jp/runtime-manager/managing-deployed-applications.md -->

# デプロイされたアプリケーションの管理

アプリケーションをデプロイした後は、Runtime Manager コンソールを使用して実行中のアプリケーションを監視および管理できます。使用できる管理機能は、使用している​[デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)​によって異なります。

Runtime Manager コンソールの基本管理ツールにより、以下の作業を行うことができます。

- [アプリケーションの起動、停止、削除](#start_stop_delete_app)
- [アプリケーションの状況の状態の表示](#status_states)
- [アプリケーションの更新](#update_application)
- [アプリケーションの監視とトラブルシューティング](https://docs.mulesoft.com/jp/runtime-manager/monitoring)

[独自のサーバー](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)​にデプロイされたアプリケーションでは、次も可能です。

- [サーバーの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [クラスターとサーバーグループの作成](https://docs.mulesoft.com/jp/runtime-manager/server-group-create)
- [Runtime Manager から外部の分析ソフトウェアへのデータの送信](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [個々のフローの管理](https://docs.mulesoft.com/jp/runtime-manager/flow-management)

[CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/ch2-manage-apps)​ にデプロイされたアプリケーションでは、次も可能です。

- [アプリケーションアラートの設定](https://docs.mulesoft.com/cloudhub-2/ch2-config-app-alerts)
- [アプリケーションスケジュールの管理](https://docs.mulesoft.com/cloudhub-2/ch2-manage-schedules)
- [アプリケーションプロパティの追加](https://docs.mulesoft.com/cloudhub-2/ch2-manage-props)
- [デプロイ済みアプリケーションのログデータの表示](https://docs.mulesoft.com/cloudhub-2/ch2-view-logs)
- [デプロイ済みアプリケーションの診断データの表示](https://docs.mulesoft.com/cloudhub-2/ch2-view-diag)
- [Object Store v2 の使用](https://docs.mulesoft.com/cloudhub-2/ch2-clustering#cloudhub-2-0-clustering-and-object-store-v2)

[CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)​ にデプロイされたアプリケーションでは、次も可能です。

- [通知の管理](https://docs.mulesoft.com/cloudhub/notifications-on-runtime-manager)
- [インサイトを使用した Mule アプリケーションでのビジネストランザクションとイベントのトラブルシューティング](https://docs.mulesoft.com/jp/runtime-manager/insight)
- [キューの管理](https://docs.mulesoft.com/cloudhub/managing-queues)
- [スケジュールの管理](https://docs.mulesoft.com/cloudhub/managing-schedules)
- [アプリケーションプロパティを安全に隠す](https://docs.mulesoft.com/cloudhub/secure-application-properties)
- [アプリケーションログデータの表示](https://docs.mulesoft.com/cloudhub/viewing-log-data)
- [CloudHub ワーカーの監視](https://docs.mulesoft.com/cloudhub/worker-monitoring)
- [オブジェクトストアを使用したアプリケーションデータの管理](https://docs.mulesoft.com/cloudhub/managing-application-data-with-object-stores)

[Anypoint Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/)​ にデプロイされたアプリケーションでは、次も可能です。

- [アプリケーションスケジュールの管理](https://docs.mulesoft.com/runtime-fabric/latest/manage-schedules)
- [アプリケーションプロパティ値の保護](https://docs.mulesoft.com/runtime-fabric/latest/protect-app-properties)
- [アプリケーションのバージョン管理の確認](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)

## [](#applications-アプリケーション-タブ)\[Applications (アプリケーション)\] タブ

Runtime Manager では、「アプリケーション」とは Mule Runtime Engine (Mule) または API ゲートウェイランタイムインスタンスで実行中の Mule アプリケーションを指します。インスタンスは CloudHub、組織のオンプレミスサーバー、サーバーのグループ、またはサーバークラスターで実行されている場合があります。

**\[Applications (アプリケーション)\]**​ メニューでは、アカウントにある現在デプロイ済みで実行中のアプリケーションをすばやく参照できます。エントリをクリックして追加情報を表示するか (下記参照)、​**\[Manage Application (アプリケーションを管理)\]**​ をクリックしてアプリケーションの​[ダッシュボード](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)​および設定ページを参照します。

![AMC\_ManageApplication](/mulesoft/current/ja-jp/runtime-manager/_images/amc-manageapplication.png)

アプリケーションを少なくとも 1 つ作成した後、ここにアプリケーションがリストされます。

サーバーグループにデプロイされたアプリケーションはグループ内のすべてのサーバーで実行されます。

## [](#servers-サーバー-タブ)\[Servers (サーバー)\] タブ

このタブは、オンプレミスサーバーにアプリケーションをデプロイする場合にのみ使用します。CloudHub ワーカーはここに表示されません。

Runtime Manager では、サーバーとは CloudHub (オンプレミスまたは別のクラウドサーバー) 以外の場所にある Mule または API ゲートウェイインスタンスを指し、最初に Runtime Manager コンソールで登録する必要があります。サーバーを登録して設定したら、​**\[Applications (アプリケーション)\]**​ タブでアプリケーションをサーバーにデプロイできます。

![AMC\_Servers](/mulesoft/current/ja-jp/runtime-manager/_images/amc-servers2.png)

**\[Servers (サーバー)\]**​ タブから、次のオプションのいずれかを選択し、これらのタスクを実行します。

- Add a Server (サーバーを追加) (Runtime Manager コンソールでサーバーを登録する)
- Start Mule or API gateway (Mule または API ゲートウェイを開始)
- Create a server group (サーバーグループを作成)
- Create a cluster (クラスターを作成)
- Add and remove servers from a server group (サーバーをサーバーグループに追加および削除)
- Add and remove servers from a cluster (サーバーをクラスターに追加および削除)
- Stop an application on a server (サーバー上のアプリケーションを停止)
- Delete a server, server group or cluster (サーバー、サーバーグループ、またはクラスターを削除)

このタブのオプションについての詳細は、​[「サーバー、サーバーグループ、クラスター」](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)​を参照してください。

## [](#環境の切り替え)環境の切り替え

組織に複数の環境がある場合、環境を切り替えることができます。

1. Runtime Manager の任意の画面で、画面の左上隅に表示される現在の環境をクリックします。
2. 切り替え先の環境を選択します。
3. **\[Switch (切り替え)\]**​ をクリックします。

![managing deployed applications 0e10f](/mulesoft/current/ja-jp/runtime-manager/_images/managing-deployed-applications-0e10f.png)

## [](#start_stop_delete_app)アプリケーションの開始、再起動、停止、削除

1. **\[Applications (アプリケーション)\]**​ で、アプリケーション名をクリックして画面右側の管理パネルで開きます。
2. \[status (状況)\] の隣にある下矢印をクリックします (メニューはアプリケーションの現在の状態によって異なります)。
    
    ![AMC\_StopStartDeleteApp](/mulesoft/current/ja-jp/runtime-manager/_images/amc-restartapp.png)
3. 実行するアクションをクリックします。  
    
    - **Start (開始)**
        
        停止中のアプリケーションを開始します。
    - **Restart (再起動)**
        
        すでに開始されているアプリケーションをリセットします。アプリケーションがデプロイされていない場合は、アプリケーションの ZIP ファイルがサーバーに送られて、サーバー上でアプリケーションが開始されます。
    - **Stop (停止)**
        
        実行中のアプリケーションを停止します。
    - **Delete (削除)**
        
        アプリケーションを削除します。

アプリケーションをオンプレミスのクラスターにデプロイすると、Runtime Manager は各サーバーでアプリケーションを同時に開始/終了/削除します。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">CloudHub では、アプリケーションを削除すると、コンソールからログデータにアクセスできなくなります。CloudHub では、古いログデータはパージされる前に一定期間アーカイブされます。そのため、必要に応じてデータを復元できます。詳細は、 <a href="https://help.mulesoft.com">MuleSoft ヘルプセンター</a>​でサポートケースを開いてください。</td></tr></tbody></table>

## [](#status_states)状況の状態

**\[Status (状況)\]**​ 列の情報は、コンテキストによって異なります。

- [アプリケーションの状況の状態](#application_status_states)
- [アプリケーションのデプロイメントの状態](#application_deploy_states)
- [レプリカの状況の状態](#replica_status_states)
- [サーバーの状況の状態](#server_status_states)
- [サーバーグループの状況の状態](#server_groups_status_states)
- [クラスターの状況の状態](#cluster_status_states)

### [](#application_status_states)アプリケーションの状況の状態

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 30%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アイコン</th>
<th class="tableblock halign-left valign-top">State (状態)</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><strong>Stopped (停止)</strong>​</p>
</li>
<li>
<p><strong>Not Running (非実行中)</strong>​</p>
</li>
<li>
<p><strong>Undeployed (アンデプロイ済み)</strong>​</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションは実行されていません。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-515a4.png" alt="managing deployed applications 515a4">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><strong>Starting (開始中)</strong>​</p>
</li>
<li>
<p><strong>Stopping (停止中)</strong>​</p>
</li>
<li>
<p><strong>Undeploying (アンデプロイ中)</strong></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションは他の状態へ移行中です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/console-overview-green-circle.png" alt="console_overview_green_circle"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><strong>Started (開始済み)</strong>​</p>
</li>
<li>
<p><strong>Running (実行中)</strong>​</p>
</li>
<li>
<p><strong>Updated (更新済み)</strong></p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションは正常に動作しているか、または更新されました。</p>
</div>
<div class="paragraph">
<p>アプリケーションは少なくとも 1 つのクラスターノードで実行されている場合に [Started (開始済み)] と表示します。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/console-overview-red-circle.png" alt="console_overview_red_circle"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="ulist">
<ul>
<li>
<p><strong>Deployment Failed (デプロイ失敗)</strong>​</p>
</li>
</ul>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションのデプロイメントが失敗しました。</p>
</div>
<div class="paragraph">
<p>障害の原因がコンソールに表示されます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-ab70d.png" alt="managing deployed applications ab70d">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションの更新が失敗しました。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#application_deploy_states)アプリケーションのデプロイメントの状態

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 30%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アイコン</th>
<th class="tableblock halign-left valign-top">State (状態)</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Deleted (削除済み)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションが削除されています。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-515a4.png" alt="managing deployed applications 515a4">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Applying (適用中)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションは他の状態へ移行中です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/console-overview-green-circle.png" alt="console_overview_green_circle"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Applied (適用済み)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションは正常に動作しているか、または更新されました。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/console-overview-red-circle.png" alt="console_overview_red_circle"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Failed (失敗)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>アプリケーションのデプロイメントが失敗しました。</p>
</div>
<div class="paragraph">
<p>障害の原因がコンソールに表示されます。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-de1b7.png" alt="managing deployed applications de1b7">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>Unknown (不明)</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバーがプラットフォームに応答しないので、アプリケーションの状況は不明です (オンプレミスデプロイメントの場合のみ)。</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#replica_status_states)レプリカの状況の状態

\[Replica (レプリカ)\] の状況は、Runtime Fabric にデプロイされたアプリケーションにのみ適用されます。これらの状況は、新規設定または変更した設定をデプロイ済みのアプリケーションに適用する場合に表示されます。​[「アプリケーションデプロイメントのバージョン設定」](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)​を参照してください。

\[Replica (レプリカ)\] の状況は次のとおりです。

- **Started (開始済み)**​ (緑)
    
    レプリカはトラフィックを受信しています。
- **Pending (保留中)**
    
    レプリカは開始を待機中です。
- **Starting (開始中)**
    
    レプリカでプロセスを開始中です。
- **Deleting (削除中)**
    
    レプリカの削除が進行中です。
- **Deleted (削除済み)**
    
    レプリカが削除されました。
- **Stopping (停止中)**
    
    レプリカが停止中です。
- **Stopped (停止)**
    
    レプリカは停止しています (トラフィックを受信していません)。
- **Failed (失敗)**​ (赤)
    
    設定のデプロイに失敗しました。
- **Recovering (回復中)**​ (赤)
    
    レプリカは終了後に再起動しようとしています。

### [](#server_status_states)サーバーの状況の状態

- **Connected (接続済み)**
    
    サーバーを使用できます。
- **Created (作成済み)**
    
    サーバーは最近システムに登録され、一度も接続されていません。
- **Running (実行中)**
    
    サーバーは稼働中で、要求を受け入れています。
- **Disconnected (切断済み)**
    
    サーバーは現在使用できませんが、登録済みで接続可能です。

### [](#server_groups_status_states)サーバーグループの状況の状態

- **Connected (接続済み)**
    
    サーバーグループ内のすべてのサーバーが接続済みです。
- **Created (作成済み)**
    
    サーバーグループが作成されました。
    
    この状態は、グループを作成してから \[Empty (空)\] 状態になるまで一時的に発生します。
- **Disconnected (切断済み)**
    
    サーバーグループ内のすべてのサーバーが使用不可です。この状態は、ネットワークがダウンするか、グループ内の 1 つ以上のサーバーに障害がある場合に発生します。
- **Empty (空)**
    
    現在このグループに割り当てらているサーバーはありません。
- **Partial (一部)**
    
    グループ内の 1 つ以上のサーバーの状態が異なります。
- **Running (実行中)**
    
    サーバーグループ内のすべてのサーバーが実行中です。

### [](#cluster_status_states)クラスターの状況の状態

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 30%;">
<col style="width: 60%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">アイコン</th>
<th class="tableblock halign-left valign-top">State (状態)</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/status-green.png" alt="緑"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行中</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>すべてのノードが実行中です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/status-yellow.png" alt="黄色"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>実行中</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>少なくとも 1 つのクラスターノードが実行中です。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/status-yellow.png" alt="黄色"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>通信に関する問題ありで実行中</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>すべてのノードが実行中ですが、ノード間に通信の問題があります。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="imageblock">
<div class="content">
<img src="https://docs.mulesoft.com/jp/runtime-manager/_images/managing-deployed-applications-a665b.png" alt="managing deployed applications a665b">
</div>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Disconnected (切断済み)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>すべてのノードが切断済みです。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><span class="image"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/status-black.png" alt="黒"></span></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>作成済み</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サーバー/ノードはプラットフォームに登録されていますが、開始されていません。</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#アプリケーション管理パネル)アプリケーション管理パネル

**\[Applications (アプリケーション)\]**​ タブで任意のアプリケーションを選択すると、右側にパネルが開きます。ここにアプリケーションに関する追加情報が表示され、アプリケーションの設定にアクセスできます。

![ダッシュボード](/mulesoft/current/ja-jp/runtime-manager/_images/dashboard-ch.png)

管理パネルに表示される内容は、アプリケーションが ​[CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)​ と​[自分のサーバー](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)​のどちらにデプロイされているかによって異なります。

- CloudHub にあるアプリケーションには、アプリケーションが実行されている CloudHub ワーカーに関する情報が表示されます。
- クラスターおよびサーバーグループにデプロイされているアプリケーションには、サーバーのリストとそれぞれの状況が表示されます。

状況、最終変更日時、デプロイされたアプリケーション ZIP ファイルが常に表示されます。​**\[Choose File (ファイルを選択)\]**​ ボタンを使用すると、アプリケーション ZIP ファイルを変更できます。

**\[Manage Application (アプリケーションを管理)\]**​ ボタンを使用すると、さらに詳細なアプリケーション設定を表示して管理できます。

![managing deployed applications 38b94](/mulesoft/current/ja-jp/runtime-manager/_images/managing-deployed-applications-38b94.png)

アプリケーションの設定ページでは、​**\[Dashboard (ダッシュボード)\]**​ ボタンを使用して、アプリケーションの完全な詳細ダッシュボードを表示できます。​[「ダッシュボードの監視」](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards)​を参照してください。

![managing deployed applications 107ad](/mulesoft/current/ja-jp/runtime-manager/_images/managing-deployed-applications-107ad.png)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><strong>[Dashboard (ダッシュボード)]</strong>​ オプションは Titanium サブスクリプションでのみ利用できます。</td></tr></tbody></table>

**\[Insight (インサイト)\]**​ ボタンを使用すると、トランザクションレベルのデータが表示できます。​[「インサイト」](https://docs.mulesoft.com/jp/runtime-manager/insight)​を参照してください。

![managing deployed applications 76124](/mulesoft/current/ja-jp/runtime-manager/_images/managing-deployed-applications-76124.png)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ダッシュボードとインサイトは、Anypoint Platform Private Cloud Edition では現在使用できない機能です。​<a href="https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies" class="xref page">「デプロイメントオプション」</a>​を参照してください。</td></tr></tbody></table>

## [](#アプリケーションの監視)アプリケーションの監視

アプリケーションのイベントやサーバーまたは仮想サーバーのパフォーマンスを監視するためのツールは、​[デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)​によって異なります。​[「アプリケーションの監視」](https://docs.mulesoft.com/jp/runtime-manager/monitoring)​を参照してください。

## [](#update_application)アプリケーションの更新

アプリケーションに変更を加えた場合、新しいバージョンをデプロイする手順は、次のとおりです。

1. \[Deployment (デプロイメント)\] 画面で ​**\[Choose file (ファイルを選択)\]**​ をクリックします。
2. **\[Import file from Exchange (Exchange からファイルをインポート)\]**​ または ​**\[Upload file (ファイルをアップロード)\]**​ を選択します。
3. **\[Apply changes (変更を適用)\]**​ をクリックします。  
    数秒以内にアプリケーションが再デプロイされます。再デプロイ中はアプリケーションの状況インジケーターが青に変わり、デプロイメントが完了すると緑に変わります。
4. CloudHub にデプロイされたアプリケーションの場合は、​**\[Logs (ログ)\]**​ をクリックするとアプリケーションの再デプロイメントをライブで確認できます。

アプリケーションをオンプレミスのクラスターにデプロイすると、Runtime Manager は各サーバーに新しいアプリケーションバージョンを同時にインストールします。

Runtime Fabric にデプロイされたアプリケーションを更新する場合は、​[「Runtime Fabric でのアプリケーションのバージョン管理」](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)​を参照してください。

### [](#猶予期間)猶予期間

アプリケーションを停止、再起動、更新、再デプロイ、終了すると、CloudHub はアプリケーションを Mule から削除しようとしますが、処理中のメッセージが配信されるの待つためのタイムアウト期間が 2 分間あります。その期間の後、CloudHub はインスタンス全体をシャットダウンします。

## [](#アラート)アラート

デプロイメントの失敗やアプリケーションの削除など、アプリケーションに特定のイベントが発生した場合に送信されるメールアラートをセットアップできます。これらのアラートは、特定のアプリケーションまたはすべてのアプリケーションにリンクすることができます。詳細については​[「アラート」](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)​を参照してください。

アラートを作成する権限がない場合でも、メールアラートを受信するかどうかを指定できます。

このビューからアラートをオフに切り替えると、現在 (サインイン済み) のユーザーに対してのみオフに切り替わります。他のユーザーのアラートはアクティブのままです。

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

- [CloudHub でのアプリケーションの管理](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [Runtime Manager から外部の分析ソフトウェアへのデータの送信](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [デプロイメントオプション](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies)
- [アプリケーションとサーバーの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [クラスタリング](https://docs.mulesoft.com/cloudhub/cloudhub-fabric)
- [キューの管理](https://docs.mulesoft.com/cloudhub/managing-queues)
- [スケジュールの管理](https://docs.mulesoft.com/cloudhub/managing-schedules)
- [オブジェクトストアを使用したアプリケーションデータストレージの管理](https://docs.mulesoft.com/cloudhub/managing-application-data-with-object-stores)
- [アプリケーションプロパティを安全に隠す](https://docs.mulesoft.com/cloudhub/secure-application-properties)
- [Virtual Private Cloud](https://docs.mulesoft.com/cloudhub/virtual-private-cloud)
- [侵入テストポリシー](https://docs.mulesoft.com/cloudhub/penetration-testing-policies)
- [Runtime Fabric でのアプリケーションのバージョン管理](https://docs.mulesoft.com/runtime-fabric/latest/app-versioning)

<!-- document id=ad32551d39950b08798deebe7d903c75695b46490055200f9d8feab5d29f516e url=/mulesoft/current/ja-jp/runtime-manager/deployment-strategies.md -->

# デプロイメントオプション

Anypoint Studio でアプリケーションを実行すると、Studio の埋め込みテストサーバーにアプリケーションがデプロイされます。このサーバーは本番デプロイメント用ではなく、アップタイム制限が適用されるため、Anypoint Runtime Manager でサポートされているいずれかのデプロイメントオプションを使用して Mule アプリケーションをデプロイしてください。

## [](#cloudhub-2-0)CloudHub 2.0

CloudHub 2.0 は、完全に管理されコンテナ化されたサービスとしてのインテグレーションプラットフォーム (iPaaS) であり、API とインテグレーションを軽量コンテナとしてクラウドにデプロイできます。

[Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールからアプリケーションをデプロイして、​[CloudHub](https://docs.mulesoft.com/cloudhub-2/)​ でホストできます。CloudHub 2.0 へのアプリケーションのデプロイ方法については、[Deploying Apps to CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/ch2-deploy)を参照してください。

## [](#cloudhub)CloudHub

CloudHub は完全なサービスとしてのインテグレーションプラットフォーム (iPaaS) であり、ホスト環境を設定せずにアプリケーションをデプロイするためのサーバー機能を提供します。アプリケーションに割り当てるリソース数は、コントラクトによって制限されます。

[Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールからアプリケーションをデプロイして、​[CloudHub](https://docs.mulesoft.com/cloudhub/)​ でホストできます。CloudHub へのアプリケーションのデプロイ方法については、[Deploy to CloudHub](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)を参照してください。

## [](#ハイブリッドデプロイメント)ハイブリッドデプロイメント

ハイブリッドデプロイメントオプションを使用すると、Runtime Manager のクラウドコンソールから Mule サーバーにアプリケーションをデプロイして、Runtime Manager を使用してアプリケーションを管理できます。このオプションにより、オンプレミスのセキュリティを柔軟に制御できますが、ホストインフラストラクチャを自分で用意する必要があります。

ハイブリッドオプションを使用するには、最初に Mule サーバーを Runtime Manager エージェントに登録します。その後、必要に応じて Runtime Manager からこれらのサーバーをサーバーグループやクラスターに追加することで、可用性を高めることができます。最後に、アプリケーションを Runtime Manager からサーバー、サーバーグループ、またはクラスターにデプロイします。

Mule サーバーにアプリケーションをデプロイする方法については、[自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)を参照してください。

## [](#anypoint-platform-private-cloud-edition)Anypoint Platform Private Cloud Edition

[Anypoint Platform Private Cloud Edition](https://docs.mulesoft.com/private-cloud/latest/)​ は、Anypoint Platform の管理機能とエンゲージメント機能をコンテナ化した配布であり、オンプレミスまたは組織のプライベートクラウド環境でホストします。

自分の組織では厳格な規制やコンプライアンス要件によってクラウドソリューションの使用が制限されている場合は、Anypoint Platform PCE を使用してアプリケーションをオンプレミスでデプロイしてホストできます。

アプリケーションを Anypoint Platform Private Cloud Edition にデプロイする方法の詳細については、[自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)を参照してください。

## [](#anypoint-runtime-fabric-デプロイメント)Anypoint Runtime Fabric デプロイメント

Anypoint Runtime Fabric は、Mule アプリケーションや API ゲートウェイのデプロイメントおよびオーケストレーションを自動化するコンテナサービスです。Runtime Fabric は AWS、Azure、仮想マシン (VM)、またはベアメタルサーバーの顧客の管理対象インフラストラクチャ内で実行されます。

Runtime Fabric には、必要なすべてのコンポーネントが含まれています。これらのコンポーネント (Docker や Kubernetes など) は、Mule Runtime や他の MuleSoft サービスと効率的に連携するように最適化されています。

Runtime Fabric オプションを使用するには、最初に Runtime Manager を使用して Runtime Fabric を作成する必要があります。その後、Runtime Fabric をインフラストラクチャにインストールします。最後に、Runtime Manager のクラウドコンソールから、作成した Runtime Fabric にアプリケーションをデプロイします。

[Anypoint Platform](https://anypoint.mulesoft.com)​ Runtime Manager のクラウドコンソールからアプリケーションをデプロイして、​[Anypoint Runtime Fabric](https://docs.mulesoft.com/runtime-fabric/latest/)​ でホストできます。Runtime Fabric へのアプリケーションのデプロイ方法の詳細については、[Deploying Mule Apps to Runtime Fabric Using Runtime Manager](https://docs.mulesoft.com/runtime-fabric/latest/deploy-to-runtime-fabric)を参照してください。

## [](#デプロイメントオプションのアイコン)デプロイメントオプションのアイコン

Runtime Manager ドキュメントの各ページの先頭には、そのページのコンテンツが適用されるデプロイメントオプションを示すアイコンが表示されます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 66.6666%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">アイコン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="image"><a class="image" href="#cloudhub-2-deployments"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/logo-cloud2-active.png" alt="logo cloud2 active" title="CloudHub 2.0"></a></span></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="image"><a class="image" href="#cloudhub-deployments"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/logo-cloud-active.png" alt="logo cloud active" title="CloudHub"></a></span></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="image"><a class="image" href="#hybrid-deployments"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/logo-hybrid-active.png" alt="logo hybrid active" title="Hybrid"></a></span></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="image"><a class="image" href="#anypoint-platform-pce-deployments"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/logo-server-active.png" alt="logo server active" title="Anypoint Platform PCE"></a></span></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><span class="image"><a class="image" href="#anypoint-runtime-fabric-deployments"><img src="https://docs.mulesoft.com/jp/runtime-manager/_images/logo-rtf-active.png" alt="logo rtf active" title="Runtime Fabric"></a></span></p></td>
</tr>
</tbody>
</table>

## [](#runtime-manager-の機能)Runtime Manager の機能

各デプロイメントオプションで使用できる Runtime Manager の機能については、以下を参照してください。

- [高可用性](#高可用性)
- [\[JDK のバージョン\]](<#JDK のバージョン>)
- [負荷分散](#負荷分散)
- [ログ](#ログ)
- [監視](#監視)
- [\[Object Store\]](<#Object Store>)
- [スケジュール](#スケジュール)
- [セキュリティの更新](#セキュリティの更新)
- [共有リソースのサポート](#共有リソースのサポート)
- [トラブルシューティング](#トラブルシューティング)

### [](#高可用性)高可用性

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 17.647%;">
<col style="width: 52.9411%;">
<col style="width: 29.4119%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2 つ以上のレプリカと Anypoint VPN によるクラスタリング経由。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-clustering#replica-scale-out" class="xref page">クラスタリング</a>​<br>
  ​<a href="https://docs.mulesoft.com/cloudhub-2/ps-vpn-about#vpn-ha" class="xref page">VPN 高可用性</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">2 つ以上のワーカーと Anypoint VPN によるクラスタリング経由。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub/cloudhub-fabric" class="xref page">CloudHub High Availability Features</a><br>
  <a href="https://docs.mulesoft.com/cloudhub/vpn-high-availability" class="xref page">Anypoint VPN High Availability</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバーグループまたはクラスター経由。クラスター化された Mule インスタンスには、永続的な VM キュー、トランザクション、クラスター全体のデータストレージを提供する分散共有メモリがあります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/server-group-about" class="xref page">サーバーグループ</a><br>
  <a href="https://docs.mulesoft.com/jp/runtime-manager/cluster-about" class="xref page">クラスター</a><br>
  <a href="https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters" class="xref page">On-Premises Mule Runtime High Availability Cluster Overview</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバーグループまたはクラスター経由。クラスター化された Mule インスタンスには、永続的な VM キュー、トランザクション、クラスター全体のデータストレージを提供する分散共有メモリがあります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/server-group-about" class="xref page">サーバーグループ</a><br>
  <a href="https://docs.mulesoft.com/jp/runtime-manager/cluster-about" class="xref page">クラスター</a><br>
  <a href="https://docs.mulesoft.com/on-premises/latest/mule-high-availability-ha-clusters" class="xref page">On-Premises Mule Runtime High Availability Cluster Overview</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">自動アプリケーションフェールオーバー経由。アプリケーションごとに 2 つ以上のレプリカをデプロイすることにより、高可用性を実現できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/runtime-fabric/latest/deploy-to-runtime-fabric" class="xref page">Deploying Mule Apps to Runtime Fabric Using Runtime Manager</a></p></td>
</tr>
</tbody>
</table>

### [](#jdk-バージョン)JDK バージョン

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 40%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">バージョン</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JDK 8</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/release-notes/cloudhub-2/cloudhub-2-runtimes-release-notes" class="xref page">CloudHub 2.0 Runtime and Infrastructure Patch Update Release Notes</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JDK 8</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/release-notes/cloudhub/cloudhub-runtimes-release-notes" class="xref page">CloudHub Runtime and Operating System Patch Update Release Notes</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サポートされる JDK の最小バージョンについては、Mule Runtime Engine のリリースノートを参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/release-notes/mule-runtime/mule-esb" class="xref page">Mule Runtime Release Notes</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サポートされる JDK の最小バージョンについては、Mule Runtime Engine のリリースノートを参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/release-notes/mule-runtime/mule-esb" class="xref page">Mule Runtime Release Notes</a></p></td>
</tr>
</tbody>
</table>

### [](#負荷分散)負荷分散

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 19.0476%;">
<col style="width: 38.0952%;">
<col style="width: 42.8572%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">サポートされる負荷分散</th>
<th class="tableblock halign-left valign-top">Alternative/Workaround</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションを 2 つ以上のレプリカにデプロイすると、CloudHub HTTP 負荷分散サービスはこれらのレプリカで要求を分散します。​<a href="https://docs.mulesoft.com/cloudhub-2/ch2-architecture#scale-out-and-data-center-redundancy" class="xref page">「スケールアウトとデータセンターの冗長性」</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションが複数のワーカーで動作している場合、CloudHub の共有ロードバランサーが自動的に受信トラフィックを分散します。​<a href="https://docs.mulesoft.com/cloudhub/cloudhub-dedicated-load-balancer" class="xref page">「専用ロードバランサー」</a>​を参照してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">必要に応じて専用ロードバランサー (DLB) コンポーネントを使用することで、Anypoint Virtual Private Cloud (VPC) 内の CloudHub ワーカーにデプロイされている複数の Mule アプリケーションに外部トラフィックを転送できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サポートされていません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">負荷分散は、オンプレミスリソースに接続されているツールで管理できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">サポートされていません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">負荷分散は、オンプレミスリソースに接続されているツールで管理できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">基本的な負荷分散を行うための内部ロードバランサー。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">また、Runtime Fabric から rsyslog サーバーにログを転送できます。</p></td>
</tr>
</tbody>
</table>

### [](#ログ)ログ

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 18.1818%;">
<col style="width: 31.8181%;">
<col style="width: 31.8181%;">
<col style="width: 18.182%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">Alternative/Workaround</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 により、各レプリカのデプロイメントのメッセージとイベントおよび Mule Runtime Engine ログを含むログデータへのアクセスが可能になります。</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-view-logs" class="xref page">Viewing Log Data for Deployed Apps</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub は、ログレベルのカスタマイズ、ログの検索、ログのダウンロードを行うためのログサービスを提供しています。</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub/viewing-log-data" class="xref page">View Log Data</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager のログ機能は、ハイブリッドデプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オンプレミスアプリケーションを設定することで、Splunk や ELK などの外部分析ソフトウェアにデータを送信できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software" class="xref page">Runtime Manager から外部分析ツールへのデータのエクスポート</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager のログ機能は、ハイブリッドデプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager のログ機能は、ハイブリッドデプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software" class="xref page">Runtime Manager から外部分析ツールへのデータのエクスポート</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric は、Anypoint Monitoring の Titanium ログをサポートしています。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">また、Runtime Fabric から rsyslog サーバーにログを転送できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/runtime-fabric/latest/manage-monitor-applications#logs" class="xref page">ログ</a></p></td>
</tr>
</tbody>
</table>

### [](#監視)監視

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 29.1666%;">
<col style="width: 37.5%;">
<col style="width: 16.6668%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">機能</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 にデプロイされているアプリケーション用に、​<a href="https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager" class="xref page">Runtime Manager</a>​ でアラートを作成できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">スレッドダンプを実行します。アプリケーションアラートを設定します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-monitor-apps" class="xref page">CloudHub 2.0 にデプロイされたアプリケーションの監視</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager のダッシュボードは、デプロイされているすべてのアプリケーションのパフォーマンスメトリクスを表示します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">デプロイされたアプリケーションのアラート条件に基づくアラート。アプリケーションでイベントが発生したときに通知する標準的な通知。CloudHub Connector をアプリケーションのフローに追加し、任意のイベントによってトリガーされるカスタムアラートと通知を設定します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/monitoring" class="xref page">アプリケーションとサーバーの監視</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager のダッシュボードは、デプロイされているすべてのアプリケーションのパフォーマンスメトリクスを表示します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">デプロイされたアプリケーションのアラート条件に基づくアラート。アプリケーションでイベントが発生したときに通知する標準的な通知。アラートが実行されているサーバーに関連するイベントによってトリガーされます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/monitoring" class="xref page">アプリケーションとサーバーの監視</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform PCE は、Runtime Manager ダッシュボードをサポートしていません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">デプロイされたアプリケーションのアラート条件に基づくアラート。アプリケーションでイベントが発生したときに通知する標準的な通知。アラートが実行されているサーバーに関連するイベントによってトリガーされます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/monitoring" class="xref page">アプリケーションとサーバーの監視</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric エージェントでは、​<code>rtf.mulesoft.com/id</code>​ という表示ラベルの付いた Kubernetes デプロイメントを監視します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Kubernetes によってデプロイメントの状態が更新されると、エージェントによってその更新がコントロールプレーンに送信されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/runtime-fabric/latest/#monitoring-application-deployments" class="xref page">アプリケーションデプロイメントの監視</a>​<br>
   ​<a href="https://docs.mulesoft.com/runtime-fabric/latest/manage-monitor-applications#logs" class="xref page">ログ</a></p></td>
</tr>
</tbody>
</table>

### [](#オブジェクトストア)オブジェクトストア

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 16.6666%;">
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 16.6668%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">注記</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 でオブジェクトストアを使用するようにアプリケーションを設定する必要はありません。さらに、Mule 4 アプリケーションでは、Anypoint Runtime Manager コンソールから有効化できる Object Store v2 がサポートされています。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 で Object Store v2 を有効にする場合、レート制限がある点に注意してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/object-store/" class="xref page">Object Store v2 の概要</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub には、独自の事前設定されたデフォルトのオブジェクトストアがあり、オブジェクトストア用 Anypoint Connector を使用して参照できます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Idempotent ルーターはメモリ内ストアでのみ動作します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub/managing-application-data-with-object-stores" class="xref page">オブジェクトストアを使用したアプリケーションデータストレージの管理</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッドデプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトストアを使用するには、データを保存するためのデータベースを設定する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/object-store-connector/latest/" class="xref page">Object Store Connector</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform PCE デプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトストアを使用するには、データを保存するためのデータベースを設定する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/object-store-connector/latest/" class="xref page">Object Store Connector</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric デプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オブジェクトストアを使用するには、データを保存するためのデータベースを設定する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/object-store-connector/latest/" class="xref page">Object Store Connector</a></p></td>
</tr>
</tbody>
</table>

### [](#スケジュール)スケジュール

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 19.0476%;">
<col style="width: 28.5714%;">
<col style="width: 28.5714%;">
<col style="width: 23.8096%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">注記</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager を使用して、実行中のアプリケーションを変更することなく、デプロイされたアプリケーションのフロー内の Scheduler コンポーネントの表示と制御を行うことができます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションスケジュールを表示するには、「Read Applications (アプリケーションの読み取り)」権限に加えて「Exchange Viewer (Exchange 閲覧者)」権限が必要です。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-manage-schedules" class="xref page">Managing App Schedules</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Manager を使用して、デプロイされたアプリケーションのフロー内の Scheduler コンポーネントの表示と制御を行うことができます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">スクリプトを使用して CloudHub のスケジュールを管理することはできません。CloudHub のスケジュールを管理するには、​<strong>[Schedules (スケジュール)]</strong>​ タブまたは CloudHub API を使用してください。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub/managing-schedules" class="xref page">Manage Schedules</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッドデプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">タスクをスケジュールするには、フロー内で [Scheduler endpoint (Scheduler エンドポイント)] 要素を使用する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/mule-runtime/latest/scheduler-concept" class="xref page">Scheduler エンドポイント</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform PCE デプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">タスクをスケジュールするには、フロー内で [Scheduler endpoint (Scheduler エンドポイント)] 要素を使用する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/mule-runtime/latest/scheduler-concept" class="xref page">Scheduler エンドポイント</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric デプロイメントでは使用できません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">タスクをスケジュールするには、フロー内で [Scheduler endpoint (Scheduler エンドポイント)] 要素を使用する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/mule-runtime/latest/scheduler-concept" class="xref page">Scheduler エンドポイント</a></p></td>
</tr>
</tbody>
</table>

### [](#セキュリティの更新)セキュリティの更新

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 18.75%;">
<col style="width: 56.25%;">
<col style="width: 25%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 によって必要に応じてセキュリティパッチが定期的に適用されるため、アプリケーションが保護されます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-patch-updates" class="xref page">CloudHub 2.0 オペレーティングシステムのパッチ更新</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub によって必要に応じてセキュリティパッチが適用されるため、アプリケーションは保護され、月に 1 回 Mule が更新されてアプリケーションの安定性が保たれます。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub/cloudhub-app-runtime-version-updates" class="xref page">CloudHub Runtime の継続的な更新</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションをデプロイメントして実行を開始したら、選択したランタイムバージョンのセキュリティの更新を手動で適用する必要があります。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#ハイブリッドデプロイメントのセキュリティ">ハイブリッドデプロイメントのセキュリティ</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションをデプロイメントして実行を開始したら、選択したランタイムバージョンのセキュリティの更新を手動で適用する必要があります。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションのランタイムバージョンでセキュリティの更新が利用できる場合は、Runtime Manager で更新を表示して適用できます。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
</table>

### [](#共有リソースのサポート)共有リソースのサポート

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 17.647%;">
<col style="width: 58.8235%;">
<col style="width: 23.5295%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
<th class="tableblock halign-left valign-top">詳細情報</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">共有スペースは、マルチテナント環境で実行される Mule インスタンスを含むリソースの拡張性の高いクラウドです。CloudHub 2.0 は、サポートされているリージョンごとに 1 つの共有スペースを提供し、そこにインテグレーションアプリケーションをデプロイします。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/cloudhub-2/ch2-shared-space-about" class="xref page">Shared Spaces</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub にデプロイされた各アプリケーションは個別の仮想サーバーで実行されます。ドメインを使用してアプリケーション間のポートやその他のリソースの共有する必要はありません。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オンプレミスにデプロイする場合は、​<code>Domain</code>​ Mule プロジェクトを作成することができます。このプロジェクトでは、フローを定義せずに、同じサーバー上にデプロイされる他のアプリケーションとの間で共有するグローバル設定要素のセットを定義します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#オンプレミスアプリケーションデプロイメントでの共有リソースのサポート">オンプレミスアプリケーションデプロイメントでの共有リソースのサポート</a></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">オンプレミスにデプロイする場合は、​<code>Domain</code>​ Mule プロジェクトを作成することができます。このプロジェクトでは、フローを定義せずに、同じサーバー上にデプロイされる他のアプリケーションとの間で共有するグローバル設定要素のセットを定義します。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="#オンプレミスアプリケーションデプロイメントでの共有リソースのサポート">オンプレミスアプリケーションデプロイメントでの共有リソースのサポート</a></p></td>
</tr>
</tbody>
</table>

### [](#トラブルシューティング)トラブルシューティング

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">デプロイメントオプション</th>
<th class="tableblock halign-left valign-top">実装</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 は​<a href="https://docs.mulesoft.com/jp/runtime-manager/insight" class="xref page">インサイト</a>​トラブルシューティングツールをサポートしていません。代わりに ​<a href="https://docs.mulesoft.com/jp/monitoring/" class="xref page">Anypoint Monitoring</a>​ を使用します。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/insight" class="xref page">インサイト</a>​というトラブルシューティングツールを使用すると、Runtime Manager を使用してデプロイした Mule アプリケーション上のビジネストランザクションやイベントを詳細に調べることができます。[Insight (インサイト)] タブではインサイト分析機能を有効にしてメタデータオプションを指定できます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://docs.mulesoft.com/jp/runtime-manager/insight" class="xref page">インサイト</a>​というトラブルシューティングツールを使用すると、Runtime Manager を使用してデプロイした Mule アプリケーション上のビジネストランザクションやイベントを詳細に調べることができます。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Private Cloud Edition</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Platform PCE には、​<a href="https://docs.mulesoft.com/jp/runtime-manager/insight" class="xref page">インサイト</a>​トラブルシューティングツールはありません。</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">Runtime Fabric</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Anypoint Monitoring を使用して、Runtime Fabric にデプロイされたアプリケーションの情報を表示します。クラスターとコンポーネントの健全性状況を取得するには、Runtime Fabric コマンドラインツールを使用します。​<a href="https://docs.mulesoft.com/runtime-fabric/latest/manage-monitor-applications" class="xref page">「Runtime Fabric にデプロイされたアプリケーションの監視」</a>​を参照してください。</p></td>
</tr>
</tbody>
</table>

## [](#ハイブリッドデプロイメントのセキュリティ)ハイブリッドデプロイメントのセキュリティ

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](#hybrid-deployments)

デフォルトでは、各 Mule Runtime Engine で Runtime Manager エージェントによってプッシュされたメタデータのみがクラウドに転送されます。アプリケーションデータは公開されません。

エージェントは Mule の監視と制御を行い、データをコントロールプレーンにパブリッシュします。Runtime Manager エージェント API をコールして、外部システムから Mule を制御できます。また、Mule が外部システムにデータを公開するように指定することもできます。

ID や最終平均値など、アプリケーションの監視や制御に有用なデータをエージェントが転送するようにデフォルトの動作を変更できます。 [「Runtime Manager エージェント」](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent)​を参照してください。

また、機密データをトークナイズすることもできます。​[「トークナイゼーションをサービスとして Mule アプリケーションに直接公開」](https://docs.mulesoft.com/jp/anypoint-security/tokenization-from-a-mule)​を参照してください。

## [](#オンプレミスアプリケーションデプロイメントでの共有リソースのサポート)オンプレミスアプリケーションデプロイメントでの共有リソースのサポート

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](#anypoint-platform-pce-deployments)

オンプレミスにデプロイする場合は、​`Domain`​ Mule プロジェクトを作成することができます。このプロジェクトでは、フローを定義せずに、同じサーバー上にデプロイされる他のアプリケーションとの間で共有するグローバル設定要素のセットを定義します。

この方法により、各アプリケーションで同じ設定やログイン情報を繰り返し定義する手間を省くことができます。 また、同じ HTTP ホストおよびポート、あるいは他の排他的なリソースでリスンするように複数のアプリケーションを設定することもできます。

[「共有リソースの定義」](https://docs.mulesoft.com/mule-runtime/latest/shared-resources)​を参照してください。

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

- [ホスティングオプション](https://docs.mulesoft.com/hosting-home/)
- [Anypoint Studio](https://docs.mulesoft.com/studio/)
- [CloudHub のアプリケーションの開発](https://docs.mulesoft.com/cloudhub/developing-applications-for-cloudhub)
- [CloudHub へのデプロイ](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)
- [CloudHub 2.0 へのアプリケーションのデプロイ](https://docs.mulesoft.com/cloudhub-2/ch2-deploy)
- [CloudHub 2.0 の機能](https://docs.mulesoft.com/cloudhub-2/ch2-features)
- [自分のサーバーへのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [Runtime Fabric へのアプリケーションおよび API プロキシのデプロイ](https://docs.mulesoft.com/runtime-fabric/latest/deploy-index)

<!-- document id=5104026c100c600fd1ba9e0dbf3a877420274bc4bea5b42c3dfff2974e590ef4 url=/mulesoft/current/ja-jp/runtime-manager/runtime-dep-serv-limits.md -->

# デプロイメントとサーバーの拡張

プラットフォームの安定性とパフォーマンスを確保するために、Anypoint Platform にはハイブリッドデプロイメントシナリオでのデプロイメント数、対象数、サーバー数に、次の推奨される制限とハード制限があります。これらの制限は、ビジネスグループ内の環境に固有です。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content"><em>対象</em>​は、Mule アプリケーションの宛先 (サーバーグループ、クラスター、オンプレミス Mule インスタンスなど) です。 たとえば、8 個のサーバー (Mule インスタンス) で構成されるサーバーグループで 1 つの対象が構成されます。</td></tr></tbody></table>

これらの制限を超えて追加のデプロイメントまたはサーバーを作成するには、別のアカウント、環境、またはビジネスグループを使用できます。同じ環境内でこれらの制限を超えるには、カスタマーサクセス担当者にお問い合わせください。

ハイブリッドデプロイメントシナリオでのデプロイメント数のテスト済みの推奨される制限は次のとおりです。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コンポーネント</th>
<th class="tableblock halign-left valign-top">テスト済み/推奨される制限</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">環境ごとの最大デプロイメント数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">1000</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">ハイブリッド対象ごとの最大デプロイメント数 (Runtime Fabric 以外)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">200</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">アプリケーションごとの最大プロパティ数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">300</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub とスタンドアロンの最大デプロイメントサイズ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">200 MB</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">CloudHub 2.0 と Runtime Fabric の最大デプロイメントサイズ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">350 MB</p></td>
</tr>
</tbody>
</table>

ハイブリッドデプロイメントシナリオでのサーバー数のハード制限は次のとおりです。

<table class="tableblock frame-all grid-all fit-content spread">
<colgroup>
<col>
<col>
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">コンポーネント</th>
<th class="tableblock halign-left valign-top">ハード制限</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">最大サーバー数 (Runtime Fabric 以外)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">500</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">サーバーグループごとの最大サーバー数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">20</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">クラスターごとの最大サーバー数</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">8</p></td>
</tr>
</tbody>
</table>

任意の数のクラスターまたはサーバーグループで組み合わせることができるサーバーの最大数は 500 です。サーバーグループとクラスターの組み合わせの最大数も 500 です。

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

- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)

<!-- document id=9e57793f44fd4d5aeb2dc9648520a47c8f94a9154a49f12a37af139958345566 url=/mulesoft/current/ja-jp/runtime-manager/troubleshooting.md -->

# トラブルシューティング

 [![logo cloudhub 2.0 active](/mulesoft/current/ja-jp/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)[ ![logo rtf active](/mulesoft/current/ja-jp/_/img/icons/cloud-gear.svg "Runtime Fabric")Runtime Fabric](deployment-strategies#anypoint-runtime-fabric-deployments)

デプロイされたアプリケーションで問題が発生した場合、Runtime Manager には、その原因を突き止めるのに役立つツールがいくつか用意されています。

使用できるトラブルシューティングリソースは、デプロイ戦略によって異なります。

## [](#アプリケーションのトラブルシューティング)アプリケーションのトラブルシューティング

アプリケーションをトラブルシューティングするための情報にアクセスするには、次のツールを使用します。

- [インサイト](https://docs.mulesoft.com/jp/runtime-manager/insight) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments)
    
    重要なメトリクスを表示するダッシュボードにアクセスして、個々のトランザクションレベルでイベントの詳細を参照できます。
- [API 機能監視](https://docs.mulesoft.com/jp/api-functional-monitoring/) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments) [![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "ハイブリッド")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments) [![logo rtf active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-rtf-active.png "Runtime Fabric")](deployment-strategies#anypoint-runtime-fabric-deployments)
    
    API 機能監視を使用すると、テストを自動化してレポートを生成し、API 機能を検証して API が生成する結果を確認できます。ソフトウェア開発ライフサイクルの各フェーズと本番環境で API を監視できます。
- アプリケーションログデータの表示 [![logo cloud2 active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud2-active.png "CloudHub 2.0")](deployment-strategies#cloudhub-2-0) [![logo cloud active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-cloud-active.png "CloudHub")](deployment-strategies#cloudhub-deployments)
    
    [CloudHub](https://docs.mulesoft.com/cloudhub/viewing-log-data)​ と ​[CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/ch2-view-logs)​ にデプロイしたアプリケーションでは、各ワーカーとレプリカのデプロイメントのメッセージとイベントを含むログデータと Mule Runtime Engine ログへのアクセスが可能になります。
    
    独自のサーバーにデプロイされたアプリケーションの場合は、サードパーティソフトウェアにログデータをエクスポートして参照できます。

## [](#サーバーのトラブルシューティング)サーバーのトラブルシューティング

[![logo hybrid active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-hybrid-active.png "Hybrid")](deployment-strategies#hybrid-deployments) [![logo server active](/mulesoft/current/ja-jp/runtime-manager/_images/logo-server-active.png "Anypoint Platform PCE")](deployment-strategies#anypoint-platform-pce-deployments)

独自のサーバーにデプロイされたアプリケーションでは、次のツールを使用してトラブルシューティングに役立つ情報にアクセスできます。

- [サーバーの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring#monitoring-servers)
    
    アラートとダッシュボードを使用して、サーバーに関する情報を取得します。
- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
    
    Splunk や ELK などの外部ツールにデータを送信します。

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

- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [CloudHub へのデプロイ](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)
- [Deploying Apps to CloudHub 2.0](https://docs.mulesoft.com/cloudhub-2/ch2-deploy)
- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)

<!-- document id=f735d6a97564c0302a537d4feda89ca07b98baec54cf1a59f694ed3f5d5a6ecc url=/mulesoft/current/ja-jp/runtime-manager/extending-the-runtime-manager-agent.md -->

# ハイブリッドのための Runtime Manager エージェントの拡張

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

文字列を元に戻すメソッドを使用して、完全なサービス、外部メッセージハンドラー、内部メッセージハンドラーの実装など、Anypoint Runtime Manager エージェントを拡張できます。

## [](#runtime-manager-エージェントの拡張可能なコンポーネント)Runtime Manager エージェントの拡張可能なコンポーネント

Runtime Manager エージェントには、次の拡張可能なコンポーネントが含まれています。

- サービス
- 外部メッセージハンドラー
- 内部メッセージハンドラー

## [](#runtime-manager-エージェントのカスタムコンポーネントの構造)Runtime Manager エージェントのカスタムコンポーネントの構造

Runtime Manager エージェントのカスタムコンポーネントは、次の構造に従う必要があります。

- `/lib`​ にはコンポーネントの連動関係を含めます。
- `/classes`​ にはコンパイルされたクラスを含めます。

カスタムコンポーネントも Java 1.7 でコンパイルする必要があります。それよりも新しいバージョンでコンパイルされたコンポーネントはエージェントによって読み込まれません。

この例では、エージェントを拡張するために必要なライブラリを取得するために、​`pom.xml`​ に次の連動関係を追加します。

```xml
<properties>
    <maven.compiler.source>1.7</maven.compiler.source>
    <maven.compiler.target>1.7</maven.compiler.target>
    <mule.agent.version>1.6.4-mule-3.x</mule.agent.version>
    <jersey.core.version>2.11</jersey.core.version>
    <commons.lang.version>2.4</commons.lang.version>
</properties>

<dependencies>
        <dependency>
            <groupId>com.mulesoft.agent</groupId>
            <artifactId>mule-agent-api</artifactId>
            <version>${mule.agent.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.glassfish.jersey.core</groupId>
            <artifactId>jersey-client</artifactId>
            <version>${jersey.core.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>commons-lang</groupId>
            <artifactId>commons-lang</artifactId>
            <scope>provided</scope>
            <version>${commons.lang.version}</version>
        </dependency>
</dependencies>

<repositories>
    <repository>
        <id>mulesoft-ci-releases</id>
        <name>ci releases</name>
        <url>https://repository-master.mulesoft.org/nexus/content/repositories/releases-ee/<url>
    </repository>
</repositories>

<build>
    <plugins>
        <plugin>
            <artifactId>maven-assembly-plugin</artifactId>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <descriptorRefs>
                    <descriptorRef>jar-with-dependencies</descriptorRef>
                </descriptorRefs>
            </configuration>
        </plugin>
    </plugins>
</build>
```

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>このリポジトリへのアクセスについては、MuleSoft サポートにお問い合わせください。</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml">https://repository-master.mulesoft.org/nexus/content/repositories/releases-ee/</code></pre>
</div>
</div>
</td>
</tr>
</tbody></table>

対応する JAR は、Mule インスタンスの ​`plugins`​ フォルダーにある ​`mule-agent`​ プラグイン内の ​`lib`​ フォルダーに追加します。例: `$MULE_HOME/plugins/mule-agent/lib/<component name>.jar`​。

## [](#addservice)新しいサービスの追加

新しいサービスを追加するには、​`MuleAgentService`​ インターフェースを実装します。

カスタムサービスに関する考慮事項

- サービスは、​`@Inject`​ アノテーションを使用することによって、Runtime Manager エージェント環境に登録されている任意の内部ハンドラーを実行できます。
- 新しいサービスを作成するために Runtime Manager エージェントアーキテクチャに従う必要はありません。

### [](#サービスの記述)サービスの記述

#### [](#muleagentservice-の実装)MuleAgentService の実装

```java
@Named("my.company.service")
@Singleton
public class MyService implements MuleAgentService
{

    @Inject
    private Map<String, InternalMessageHandler<List<T>>> handlers;

    @Override
    public java.util.List<com.mulesoft.agent.handlers.InternalMessageHandler> getInternalHandlers()
    {
        // TODO: return List of Internal Handlers
    }

    @Override
    public void enable(boolean state) throws AgentEnableOperationException {
        // TODO: enable the Service
    }

    @Override
    public boolean isEnabled() {
        // TODO: return Service status
    }
}
```

新しいサービスを追加するには、クラスを含む JAR を ​`mule-agent`​ プラグインフォルダー内の ​`lib`​ フォルダー (​`$MULE_HOME/mule-agent/lib`​ など) に置きます。

### [](#文字列復元サービスの例)文字列復元サービスの例

上で説明したように、このドキュメントでは簡単な例を使用して、文字列を元に戻すための完全な拡張を記述する方法を説明します。最初のステップは、この目的のためのサービスを追加することです。

```java
@Named("com.company.service.reverse")
@Singleton
public class ReverseService implements MuleAgentService
{

    @Inject
    List<InternalMessageHandler<String>> messageHandlerList;

    @Override
    public List<InternalMessageHandler> getInternalHandlers()
    {
        return new ArrayList<InternalMessageHandler>(messageHandlerList);
    }

    @Override
    public void enable(boolean b) throws AgentEnableOperationException
    {

    }

    @Override
    public boolean isEnabled()
    {
        return true;
    }

    public String getConvertedString(String origString)
    {
        String reverted = StringUtils.reverse(origString);
        for (InternalMessageHandler<String> internalMessageHandler : messageHandlerList)
        {
            internalMessageHandler.handle(reverted);
        }

        return reverted;
    }
}
```

## [](#extmh)新しい外部メッセージハンドラーの追加

新しい外部メッセージハンドラーを追加するには、Runtime Manager エージェントの​[文字列復元の外部メッセージハンドラー](#文字列復元の外部メッセージハンドラー)​インターフェースを実装する必要があります。

カスタム外部メッセージハンドラーに関する考慮事項

- 外部メッセージハンドラーは、トランスポートに挿入されます。
- 外部メッセージハンドラーは、スレッドセーフである必要があります。
- 外部メッセージハンドラーは、トランスポートによって実行され、Mule とやりとりすることはできません。 **サービスのみが Mule とやりとりできます。**

### [](#外部メッセージハンドラーの記述)外部メッセージハンドラーの記述

#### [](#rest)REST

```java
@Named("my.external.handler")
@Path("somePath")
@Singleton
public class MyRequestHandler implements ExternalMessageHandler
{
    @Inject
    private MuleService muleServiceInTheAPIModule;

    @Override
    public void enable(boolean state) throws AgentEnableOperationException {
        // TODO: enable the Handler
    }

    @Override
    public boolean isEnabled() {
        // TODO: return Handler status
    }

    @GET
    @Produces(MediaType.APPLICATION_JSON)
    public List<Component> someRequest()
    {

    }
}
```

#### [](#websockets)WebSockets

```java
@Named("TYPE_OF_MESSAGE_THAT_MUST_DISPATCH")
@Singleton
public class MyRequestHandler implements ExternalMessageHandler
{
    @Inject
    private MuleService muleServiceInTheAPIModule;

    @Override
    public void enable(boolean state) throws AgentEnableOperationException {
        // TODO: enable the Handler
    }

    @Override
    public boolean isEnabled() {
        // TODO: return Handler status
    }

}
```

新しい外部メッセージハンドラーを追加するには、クラスを含む JAR を ​`mule-agent`​ プラグインフォルダー内の ​`lib`​ フォルダー (​`$MULE_HOME/mule-agent/lib`​ など) に置きます。

### [](#文字列復元の外部メッセージハンドラー)文字列復元の外部メッセージハンドラー

文字列復元の例に従った外部ハンドラーの例を次に示します。

```java
@Named("com.company.externalhandler.reverse")
@Path("revert")
@Singleton
public class ReverseExternalHandler implements ExternalMessageHandler
{

    @Inject
    private ReverseService reverseService;

    @Override
    public void enable(boolean b) throws AgentEnableOperationException
    {

    }

    @Override
    public boolean isEnabled()
    {
        return true;
    }

    @GET
    public String getReversedString(@QueryParam("string") String string)
    {
        return reverseService.getConvertedString(string);
    }
}
```

上記のコードは、​`<your REST transport host>/mule/revert`​ でリソースを公開します。

## [](#intmh)新しい内部メッセージハンドラーの追加

新しい内部メッセージハンドラーを追加するには、​[内部メッセージハンドラー](#内部メッセージハンドラー)​インターフェースを実装する必要があります。

カスタム内部メッセージハンドラーに関する考慮事項

- 内部メッセージハンドラーは、処理するメッセージ種別に基づいてサービスに挿入されます。
- 内部メッセージハンドラーは、スレッドセーフである必要があります。
- 内部メッセージハンドラーは、サービスによって実行され、Mule とやりとりすることはできません。 **サービスのみが Mule とやりとりできます。**

### [](#内部メッセージハンドラーの記述)内部メッセージハンドラーの記述

```java
@Named("my.company.internal.handler")
@Singleton
public class MyInternalMessageHandler<T> implements InternalMessageHandler<T>{

    boolean handle(T t){
          // TODO handle message
    }

    @Override
    public void enable(boolean state) throws AgentEnableOperationException {
        // TODO: enable the Handler
    }

    @Override
    public boolean isEnabled() {
        // TODO: return Handler status
    }
}
```

新しい内部メッセージハンドラーを追加するには、クラスを含む JAR を ​`mule-agent`​ プラグインフォルダー内の ​`lib`​ フォルダー (​`$MULE_HOME/mule-agent/lib`​ など) に置きます。

#### [](#文字列復元の内部メッセージハンドラー)文字列復元の内部メッセージハンドラー

次のコードは、文字列復元の例の内部メッセージハンドラーを示しています。

```java
@Named("com.mulesoft.agent.test.extension.internalHandler")
@Singleton
public class ReverseInternalHandler extends BufferedHandler<String>
{

    @Configurable("true")
    protected boolean enabled;

    @Configurable
    public String host;

    @Configurable
    public String port;

    @Inject
    public ReverseInternalHandler()
    {
        super();
    }

    @Override
    protected boolean canHandle(String t)
    {
        return true;
    }

    @Override
protected boolean flush(Collection<String> ts)
    {
        String tempDir = System.getProperty("java.io.tmpdir");
        File revertedStringFile = new File(tempDir, "revertedString.txt");

        FileOutputStream fos = null;

        BufferedWriter bw = null;

        try
        {
            fos = new FileOutputStream(revertedStringFile);

            bw = new BufferedWriter(new OutputStreamWriter(fos));

            for (String string : ts)
            {
                bw.write(string);
                bw.newLine();
            }
        }
        catch (IOException e)
        {
            System.out.println("Error writing reversed string");
            return false;
        } finally {
          if (bw != null){
            try {
                bw.close();
            } catch(IOException x) {

            }
          }
          if (fos != null){
            try{
                fos.close();
            } catch(IOException x) {

            }
          }
        }
        return true;
    }
    @PostConfigure
    public void postConfigure()
    {
    }

    @Override
    public void enable(boolean b) throws AgentEnableOperationException
    {
      enabled = b;
    }

    @Override
    public boolean isEnabled()
    {
        return enabled;
    }
}
```

内部メッセージハンドラーは、サービスによって処理されたメッセージを ​`revertedString.txt`​ というファイルに書き込みます。

## [](#runtime-manager-エージェント-api-インターフェース)Runtime Manager エージェント API インターフェース

### [](#mule-サービス)Mule サービス

```java
**
 * <p>
 * Implementations of this interface provides new functionality to the Runtime Manager agent. These services handle data from
 * Mule and interact with Mule.
 * </p>
 *
 * @see com.mulesoft.agent.handlers.ExternalMessageHandler , InternalMessageHandler
 * @since 1.0
 */
public interface MuleAgentService extends Switcher
{

    public List<InternalMessageHandler> getInternalHandlers();

}
```

### [](#外部メッセージハンドラー)外部メッセージハンドラー

```java
/**
 * <p>
 * Gets  messages coming from an external system and executes {@link com.mulesoft.agent.services.MuleAgentService} based
 * the request.
 * </p>
 * <p>
 * This is just a marker interface for the communication layer to recognize the interface as a External message receiver
 * </p>
 *
 * @since 1.0
 */
public interface ExternalMessageHandler extends Switcher
{

}
```

### [](#内部メッセージハンドラー)内部メッセージハンドラー

```java
/**
 * <p>
 * Internal messages come generally from mule side. {@link InternalMessageHandler} are use to handle those messages depending on,
 * for example, the transport.
 * </p>
 *
 * @param <Rq> is the type of the message it must handle
 * @since 1.0
 */
public interface InternalMessageHandler<Rq> extends Switcher
{

    /**
     * <p>
     * Process an internal message
     * </p>
     *
     * @param message The message to be processed
     * @return true if the message could be processed
     */
    boolean handle(@NotNull Rq message);

}
```

### [](#スイッチャー)スイッチャー

```java
/**
 * <p>
 * All the classes implementing this interface will be able to enable/disable themselves
 * </p>
 *
 * @since 1.0
 */
public interface Switcher
{
    /**
     * <p>
     * Turn the feature on, the class will be behave as expected
     * <br/>
     * If the feature is being disabled, any resources it has allocated should be freed and taken again when it is reenabled
     * </p>
     * @param state true if enabled, false otherwise
     * @throws AgentEnableOperationException if the end state is not the requested one
     */
    void enable(boolean state) throws AgentEnableOperationException;

    /**
     * <p>
     * Check the state of the class
     * </p>
     *
     * @return true if it is on, false otherwise
     */
    boolean isEnabled();

}
```

<!-- document id=eed2dec68774b068eaa8cd88dbfb123c8d3bac402218e9db149a545bceeb0c2b url=/mulesoft/current/ja-jp/runtime-manager/flow-metrics.md -->

# フローメトリクス

 [![logo cloudhub 2.0 active](/mulesoft/current/ja-jp/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">MuleSoft は、2019 年 12 月 9 日にフローメトリクス機能を非推奨としました。アプリケーションと API の監視には、​<a href="https://docs.mulesoft.com/jp/monitoring/" class="xref page">Anypoint Monitoring</a>​ の使用をお勧めします。</td></tr></tbody></table>

オンプレミスのサーバーにデプロイされたアプリケーション (ハイブリッドまたは Anypoint Platform Private Cloud Edition) の個々のフローのパフォーマンスメトリクスの推移を表示できます。

## [](#ハイブリッドでのフローメトリクスの有効化)ハイブリッドでのフローメトリクスの有効化

ハイブリッドデプロイメント環境に新しいアプリケーションをデプロイすると、デフォルトではフローメトリクス機能は有効になっていません。フローメトリクスを有効にするには、アカウントに次のいずれかの権限が付与されている必要があります。

- **Manage Application Data (アプリケーションデータの管理)**
- **Create Applications (アプリケーションの作成)**
- **Manage Settings (設定の管理)**

フローメトリクスを有効にする手順は、次のとおりです。

1. Runtime Manager から、​**\[Applications (アプリケーション)\]**​ をクリックします。
2. フローメトリクスを有効にするアプリケーションを選択し、​**\[Manage Application (アプリケーションを管理)\]**​ をクリックします。
3. **\[Settings (設定)\]**​ をクリックし、​**\[Flow Monitoring (フローの監視)\]**​ タブを選択します。
    
    ![flow metrics enable](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-enable.png)
4. **\[Enabled (有効)\]**​ を選択します。
5. **\[Apply Changes (変更を適用)\]**​ をクリックします。

## [](#フローメトリクスへのアクセス)フローメトリクスへのアクセス

フローメトリクスを表示するには、目的のアプリケーションに対する「Read Application (アプリケーションの参照)」権限が必要です。

1. Runtime Manager で、​**\[Applications (アプリケーション)\]**​ タブを選択します。
2. 実行中のアプリケーションの設定を入力 (サイドパネルで ​**\[Manage Application (アプリケーションを管理)\]**​ ボタンをクリックするか、テーブル内のアプリケーション名自体をクリック) します。
3. 左のサイドバーで ​**\[Flows (フロー)\]**​ タブを選択します。
4. 1 つ以上のフローを選択します。
    
    ![flow metrics c8f9d](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-c8f9d.png)

## [](#サーバー状況の確認)サーバー状況の確認

アプリケーションがクラスターまたはサーバーグループにデプロイされている場合、アプリケーションが実行されている各サーバーでのフローの状況を表示できます。

![flow metrics 86a1a](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-86a1a.png)

この情報を使用して、サーバー間での状態の不整合につながる通信の問題がないことを確認できます。

## [](#フローメトリクスの表示)フローメトリクスの表示

1 つ以上のフローを選択したら、​**\[Metrics (メトリクス)\]**​ タブを表示できます。

![flow metrics e26c4](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-e26c4.png)

このタブには、次の 3 つのメトリクスのグラフが含まれています。

- Mule messages (Mule メッセージ)
- Errors (エラー)
- Flow response time (フローの応答時間)

すべてのメトリクスは、選択した時間単位に対して相対的な平均として表示されます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">フローメトリクスの保持期間は 2 週間です。</td></tr></tbody></table>

## [](#メトリクスの操作)メトリクスの操作

すべてのグラフは、右上隅にある目的の期間を選択することで、異なる時間単位で表示できます。

![flow metrics 801cc](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-801cc.png)

アプリケーションがクラスターまたはサーバーグループで実行されている場合、サーバーセット全体の集計メトリクスが 1 本の折れ線として表示されます。

グラフの任意の点にマウスポインターを置くことで、その時点のアクティビティに関する数値の詳細がフロート表示されます。

![flow metrics c2b16](/mulesoft/current/ja-jp/runtime-manager/_images/flow-metrics-c2b16.png)

いずれかのメトリクスが長時間にわたって重大値に達した場合に自動的に通知されるようにアラートをセットアップできます。

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

- [Anypoint Monitoring](https://docs.mulesoft.com/jp/monitoring/)
- [アラート](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)
- [インサイト](https://docs.mulesoft.com/jp/runtime-manager/insight)
- [フロー管理](https://docs.mulesoft.com/jp/runtime-manager/flow-management)
- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)

<!-- document id=e11ffb963653dc98b76abccd52241768276f038533a8c308cd65f68ed82b9c8f url=/mulesoft/current/ja-jp/runtime-manager/flow-management.md -->

# フロー管理

 [![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)

Runtime Manager UI を使用して、デプロイされたアプリケーション内の特定のフローを個別に開始または停止できます。 すべてのフローはデフォルトでアクティブです。

フロー管理機能は、CloudHub および Anypoint Runtime Fabric にデプロイされているアプリケーションでは使用できません。

フローに対してアクションを実行するには、目的のアプリケーションで​**「Manage Applications (アプリケーションの管理)」**​権限が必要です。

## [](#フローの開始と停止)フローの開始と停止

個々のフローは、​**\[Start (開始)\]**​ ボタンと ​**\[Stop (停止)\]**​ ボタンを使用してアクティブまたは非アクティブに設定できます。

アプリケーション内の 1 つ以上のフローを選択し、​**\[Start (開始)\]**​ ボタンまたは ​**\[Stop (停止)\]**​ ボタンをクリックします。

![flow management 983fd](/mulesoft/current/ja-jp/runtime-manager/_images/flow-management-983fd.png)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">フローを開始しても、エンドポイントをトリガーしたことにはなりません。それ以前に非アクティブに設定されていた場合に、アクティブになるだけです。</td></tr></tbody></table>

## [](#フローを未管理に設定)フローを未管理に設定

一部のケースでは、目的の条件に従って、フローを自動的に開始および停止するようにアプリケーションを明示的にセットアップできます。このような場合には、この動作は Mule Runtime 自体の内部で実行されるアプリケーションのロジックによって実行され、Runtime Manager はこれらの変更の基となるロジックを認識しません。

各アプリケーションのデフォルトのフロー状況は \[unmanaged (未管理)\] になります。つまり、Mule Runtime 内で実行されるアプリケーションのロジックでセットアップされた動作に従ってフローでアクティブと非アクティブの状態を自由に切り替えることができます。

**\[Flow Management (フロー管理)\]**​ タブでフローの ​**\[Start (開始)\]**​ または ​**\[Stop (停止)\]**​ をクリックして、\[unmanaged (未管理)\] 状況を上書きできます。この場合、Mule Runtime が実行しようとする変更に関係なく、Runtime Manager は引き続き、フローのアクティブまたは非アクティブの状態を適用します。​**\[Unmanage (未管理)\]**​ をクリックすれば、いつでもフロー状況を \[unmanaged (未管理)\] リセットできます。

![flow management unmanage](/mulesoft/current/ja-jp/runtime-manager/_images/flow-management-unmanage.png)

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

- [フローメトリクス](https://docs.mulesoft.com/jp/runtime-manager/flow-metrics)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)

<!-- document id=4a6f0b5252a27e5779c8f6f6dab756a6c167865b7ef7f0b18f6b1f099c0f645a url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-proxy-config.md -->

# プロキシサーバー経由のエージェントへの接続

 [![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)

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-note" title="Note"></i>
</td>
<td class="content">
<div class="paragraph">
<p>可能な場合は、Equality の会社の値に一致するように、含めない用語を変更しました。顧客の実装に対する影響を回避するために、一部の用語は変更されていません。</p>
</div>
</td>
</tr>
</tbody></table>

プロキシサーバーを介して外部通信が制限されるファイアウォールの内側で Mule Runtime Engine を実行する場合は、Runtime Manager エージェントがトラフィックをプロキシサーバー経由で Runtime Manager に転送するように設定できます。

Runtime Manager エージェントは、プロキシを使用した通信で、基本アクセスと Kerberos v5 (SPNEGO 経由) 認証スキームをサポートします。

## [](#プロキシサーバー経由で接続するためのエージェントの設定)プロキシサーバー経由で接続するためのエージェントの設定

プロキシサーバー経由で接続するようにエージェントを設定するには、次の作業を行う必要があります。

- `amc_setup`​ コマンドを実行して、​`$MULE_HOME/conf/mule-agent.yml`​ ファイルを作成する。
- `$MULE_HOME/conf/wrapper.conf`​ ファイルでプロキシサーバー設定をセットアップする。

### [](#mule-agent-yml-を作成するための-amc_setup-の実行)mule-agent.yml を作成するための amc\_setup の実行

Runtime Manager エージェントをすでにインストール済みで、プロキシを使用するように設定を変更するには、​`mule-agent.yml`​ ファイルにプロキシ設定を追加します。

プロキシサーバー接続を設定する手順は、次のとおりです。

1. `mule-agent.yml`​ ファイルでパスワードを暗号化する場合、​`AGENT_VAR_master_password`​ 環境変数をメインパスワードに設定します。
    
    `export AGENT_VAR_master_password=myPassword`
2. 次のコマンドを実行します。
    
    基本認証では、-P パラメーターによって認証済みプロキシを設定します。
    
    ```console
    $MULE_HOME/bin/amc_setup -H token server-name -P proxy-host proxy-port proxy-user proxy-password
    ```
    
    Kerberos 認証では、新しいパラメーターを使用して、このプロトコルを設定ファイルパスと共に使用することを指定します。
    
    ```console
    $MULE_HOME/bin/amc_setup -H token server-name -P proxy-host proxy-port proxy-user proxy-password --use-kerberos-proxy krb5-configuration-path jaas-configuration-path
    ```

プロキシサーバーで認証が必要ない場合は、​_proxy-user_​ と ​_proxy-password_​ は不要です。これらのオプションは、​_\--use-kerberos-proxy_​ で Kerberos 認証を使用する場合には必須です。

- **amc\_setup -P パラメーター:**
    
    _proxy-host_​
    
    希望するプロキシサーバーのホスト名を指定します (例: `proxy.acme.com`​)。 ホスト名には ​`http://`​ や ​`https://`​ を含めないでください。
    
    _proxy-port_​
    
    希望するプロキシサーバーのポートを指定します。
    
    _proxy-user_​
    
    必要であれば、プロキシでのユーザー認証情報を指定します。
    
    _proxy-password_​
    
    必要であれば、​_proxy-user_​ の認証情報で使用するパスワードを指定します。
- **amc\_setup --use-kerberos-proxy パラメーター:**
    
    _krb5-configuration-path_​
    
    Kerberos KDC との通信で必要な ​`krb5.conf`​ ファイルへのパスを指定します。
    
    これは Kerberos の種類によって異なります。ほとんどの UNIX システムと Windows システムの標準である MIT 実装のリファレンスは、 [MIT Kerceros ドキュメント](https://web.mit.edu/kerberos/krb5-1.12/doc/admin/conf_files/krb5_conf.html)​を参照してください。
    
    _jaas-configuration-path_​
    
    Kerberos KDC へのログインで必要な JAAS ログイン設定ファイルへのパスを指定します。
    
    このファイル形式のリファレンスは、 [「JAAS ログイン設定ファイル^」](https://docs.oracle.com/javase/8/docs/technotes/guides/security/jgss/tutorials/LoginConfigFile.html)​を参照してください。

次の例では、プロキシサーバー (​`acme.proxy.com`​) と連携して動作するようにエージェントを設定し、Runtime Manager トークンを設定しています。

```console
amc_setup -H myToken myMuleServer -P acme.proxy.com 443
```

次の例では、エージェントが認証が必要なプロキシサーバーと連携するようにエージェントを設定しています。

```console
amc_setup -H myToken myMuleServer -P acme.proxy.com 443 internalAdmin Ins1d3V0icePassword
```

### [](#wrapper-conf-ファイルでのプロキシサーバー設定のセットアップ)wrapper.conf ファイルでのプロキシサーバー設定のセットアップ

`$MULE_HOME/conf/wrapper.conf`​ ファイルでプロキシサーバー設定を指定するには、次のプロパティにプロキシサーバー情報を追加します。

- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_host={hostname}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_port={port}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_username={username}`
- `wrapper.java.additional.<n>=-Danypoint.platform.proxy_password={password}`

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">これらは、Java の起動時に渡す追加パラメーターです。&lt;n&gt; 要素は、設定の追加パラメーターの数を指します。​<code>1</code>​ からの整数として示され、隙間なく連続している必要があります。</td></tr></tbody></table>

## [](#プロキシサーバーが-runtime-manager-証明書を変更しないことの確認)プロキシサーバーが Runtime Manager 証明書を変更しないことの確認

ファイアウォールやプロキシが Runtime Manager 証明書を遮断したり変更したりしないことを確認するため、Runtime Manager エージェントのバージョンに応じて次のいずれかのコマンドを実行します。

これらのコマンドは、プローブを実行して、ファイアウォールやプロキシが証明書を改ざんしているかどうかを判断します。

- バージョン 1.12.0 以降と 2.2.0 以降のエージェント:
    
    ```console
    echo -e "GET / HTTP/1.0\r\n" | openssl s_client -connect runtime-manager.anypoint.mulesoft.com:443 -ign_eof
    ```
    
    このコマンドの出力には次の情報が含まれています。
    
    ```console
    -----END CERTIFICATE-----
    subject=/C=US/ST=California/L=San Francisco/O=salesforce.com, inc./CN=runtime-manager.anypoint.mulesoft.com issuer=/C=US/O=DigiCert Inc/CN=DigiCert TLS RSA SHA256 2020 CA1
    ```

想定される情報が出力に含まれていない場合は、​`openssl`​ コマンドの出力をネットワークチームに送信してください。

## [](#既知の問題)既知の問題

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15%;">
<col style="width: 85%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">問題</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>SE-8011</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>エージェントのセットアップが、セットアップ中にプロキシ情報を渡すときに ​<code>407 Proxy Authentication Required</code>​ を返す。</p>
</div></div></td>
</tr>
</tbody>
</table>

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

- [既存の mule-agent.yml ファイルでのパスワードの暗号化](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent#encrypt_password)​。
- [How to troubleshoot communication issues between the Mule Runtime Agent and the OnPrem server (Mule Runtime Engine とオンプレミスサーバーの通信に関する問題のトラブルシューティング方法)](https://help.mulesoft.com/s/article/How-to-troubleshoot-communication-issues-between-the-Mule-Runtime-Agent-and-the-OnPrem-server)​。

<!-- document id=ed8c0684a818367fed7c5935d9deca3818ea2bfae559dfd8e23a46b1acd3344e url=/mulesoft/current/ja-jp/runtime-manager/about-logging-of-payload-formats.md -->

# ペイロード形式とログ記録

 [![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)

メッセージペイロードデータを外部分析ソフトウェアに送信するには、Runtime Manager エージェントはまずデータをシリアル化してテキストに変換する必要があります。

一部のペイロード形式はプレーンテキストに変換できないため、Runtime Manager エージェントは機能すると考えられる形式のみを変換します。 変換できないペイロード形式の場合、エージェントはペイロードメッセージコンテンツではなく、ペイロードクラス種別の完全修飾名のみを渡します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">Runtime Manager エージェントバージョン 1.6.2 以前では、すべてのペイロード形式を変換しようとするため、一部の形式でエラーが発生します。</td></tr></tbody></table>

## [](#デフォルトの変換動作)デフォルトの変換動作

次の表はペイロード形式を示しており、Runtime Manager エージェントが文字列型に変換してペイロードメッセージを渡すかどうかを示しています。 **「文字列への変換」**​列が「FALSE」の場合、Runtime Manager エージェントはペイロードクラス種別のみを渡します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15.7894%;">
<col style="width: 36.8421%;">
<col style="width: 26.3157%;">
<col style="width: 21.0528%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">拡張子</th>
<th class="tableblock halign-left valign-top">ドキュメントの種類</th>
<th class="tableblock halign-left valign-top">MIME タイプ</th>
<th class="tableblock halign-left valign-top">文字列への変換</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.epub</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">電子出版物 (EPUB)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/epub+zip</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.jar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Java アーカイブ (JAR)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/java-archive</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.js</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JavaScript (ECMAScript)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/javascript</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.json</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JSON 形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/json</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.doc</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Microsoft Word</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/msword</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.arc</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アーカイブドキュメント (複数のファイルが埋め込まれている)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/octet-stream</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.bin</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">任意の種類のバイナリデータ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/octet-stream</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ogx</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OGG</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/ogg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.pdf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Adobe ポータブルドキュメント形式 (PDF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/pdf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.rtf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">リッチテキスト形式 (RTF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/rtf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.azw</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Amazon Kindle eBook 形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.amazon.ebook</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.mpkg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Apple インストーラーパッケージ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.apple.installer+xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.xul</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">XUL</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.mozilla.xul+xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.xls</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Microsoft Excel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.ms-excel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ppt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Microsoft PowerPoint</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.ms-powerpoint</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.odp</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OpenDocument プレゼンテーションドキュメント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.oasis.opendocument.presentation</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ods</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OpenDocument スプレッドシートドキュメント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.oasis.opendocument.spreadsheet</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.odt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OpenDocument テキストドキュメント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.oasis.opendocument.text</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.vsd</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Microsoft Visio</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/vnd.visio</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.7z</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">7-zip アーカイブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-7z-compressed</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.abw</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AbiWord ドキュメント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-abiword</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.bz</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">BZip アーカイブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-bzip</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.bz2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">BZip2 アーカイブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-bzip2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.csh</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">C シェルスクリプト</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-csh</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.rar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">RAR アーカイブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-rar-compressed</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.sh</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Bourne シェルスクリプト</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-sh</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.swf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Small web format (SWF) または Adobe Flash ドキュメント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-shockwave-flash</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.tar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">テープアーカイブ (TAR)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/x-tar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.xhtml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">XHTML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/xhtml+xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">XML</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.zip</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">ZIP アーカイブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">application/zip</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.aac</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AAC オーディオファイル</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">audio/aac</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.mid .midi</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">電子楽器デジタルインターフェース (MIDI)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">audio/midi</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.oga</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OGG オーディオ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">audio/ogg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.weba</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">WEBM オーディオ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">audio/webm</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Waveform オーディオ形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">audio/x-wav</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ttf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">TrueType フォント</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">font/ttf</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.woff</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Web オープンフォント形式 (WOFF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">font/woff</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.woff2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Web オープンフォント形式 (WOFF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">font/woff2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.gif</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">グラフィックスインターチェンジ形式 (GIF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/gif</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.jpeg .jpg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">JPEG 画像</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/jpeg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.svg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">スケーラブルベクターグラフィックス (SVG)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/svg+xml</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.tif</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.tiff	タグ付き画像ファイル形式 (TIFF)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/tiff</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.webp</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">WEBP 画像</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/webp</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ico</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">アイコン形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">image/x-icon</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ics</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">iCalendar 形式</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">text/calendar</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.css</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">カスケードスタイルシート (CSS)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">text/css</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.csv</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">カンマ区切り値 (CSV)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">text/csv</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.htm</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">.html	ハイパーテキストマークアップ言語 (HTML)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">text/html</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.txt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">プレーンテキスト</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">text/plain</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">はい</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.3gp</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3GPP オーディオ/ビデオコンテナ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/3gpp audio/3gpp (ビデオが含まれていない場合)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.3g2</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">3GPP2 オーディオ/ビデオコンテナ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/3gpp2 audio/3gpp2 (ビデオが含まれていない場合)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.mpeg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">MPEG ビデオ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/mpeg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.ogv</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">OGG ビデオ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/ogg</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.webm</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">WEBM ビデオ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/webm</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">.avi</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">AVI: オーディオビデオインターリーブ</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">video/x-msvideo</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Multipart</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">multipart/mixed、multipart/alternative、multipart/digest、multipart/parallel</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">いいえ</p></td>
</tr>
</tbody>
</table>

## [](#変換動作のカスタマイズ)変換動作のカスタマイズ

`conf/mule-agent.yml`​ ファイルにプロパティを追加すれば、デフォルトの動作を上書きして、すべてのペイロード形式を転送するか、どのペイロード形式も転送しないようにエージェントを設定できます。

たとえば、組織が特定の型のデータを共有することの安全性について懸念を抱いている場合、一部の形式を外部ログから除外する必要がある場合もあります。

### [](#ペイロードを除外する)ペイロードを除外する

特定のアプリケーションのすべてのペイロードを除外するには、次のようにします。

```yaml
    mule.agent.tracking.service:
        globalTrackingLevel: DEBUG
        enabled: true
        trackedApplications:
            - appName: someApp
              trackingLevel: DEBUG
              payloadExcluded: true
```

すべてのアプリケーションのすべてのペイロードを除外するには、次のようにします。

```yaml
    mule.agent.tracking.service:
        globalTrackingLevel: DEBUG
        enabled: true
        globalPayloadExclusion: true
```

### [](#ペイロードを含める)ペイロードを含める

Runtime Manager エージェントが変換できないと考えるペイロード形式を変換して転送する必要がある場合もあります。

<table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">すべてのペイロード形式の変換を強制的に実行した場合、送信されるペイロードはペイロードメッセージコンテンツではなく、ペイロードクラス種別になる場合もあります。</td></tr></tbody></table>

特定のアプリケーションのすべてのペイロードを含めるには、次のようにします。

```yaml
    mule.agent.tracking.service:
        globalTrackingLevel: DEBUG
        enabled: true
        trackedApplications:
            - appName: someApp
              trackingLevel: DEBUG
              forcePayloadInclusion: true
```

すべてのアプリケーションのすべてのペイロードを含めるには、次のようにします。

```yaml
    mule.agent.tracking.service:
        globalTrackingLevel: DEBUG
        enabled: true
        forceGlobalPayloadInclusion: true
```

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

- [外部分析ツールへのデータのエクスポート](https://docs.mulesoft.com/jp/runtime-manager/sending-data-from-arm-to-external-analytics-software)
- [Runtime Manager API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=43ebd58e3745541f9733edfabf7d341dabebad923a0c26035ca80df3a6e7afd3 url=/mulesoft/current/ja-jp/runtime-manager/rtm-agent-allowlists.md -->

# ポート、IP アドレス、ホスト名の許可

お客様がホストする Mule Runtime Engine 内の Runtime Manager エージェントと MuleSoft が管理するオンライン Anypoint Platform の API やサービスが通信できるように、ネットワーク内で Anypoint Platform の各部のホスト名やポートを許可リストに追加する必要がある場合があります。

次の表に、エージェントと Runtime Manager コンソールとの間の通信を許可するために許可リストに追加するポートまたは IP アドレスとホスト名を示します。

次のエンドポイントは相互 TLS 認証を使用しているため、接続を確立するためには、証明書を許可するための SSL パススルーを設定する必要があります。

- runtime-manager.anypoint.mulesoft.com
- runtime-manager.eu1.anypoint.mulesoft.com
- runtime-manager.gov.anypoint.mulesoft.com
- data-authenticator.anypoint.mulesoft.com
- data-authenticator.gov.anypoint.mulesoft.com

さらに、次のエンドポイントでは WebSockets を使用しています。

- mule-manager.eu1.anypoint.mulesoft.com
- runtime-manager.anypoint.mulesoft.com
- runtime-manager.eu1.anypoint.mulesoft.com
- runtime-manager.gov.anypoint.mulesoft.com

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">アウトバウンド接続では、ポート、IP アドレス、ホスト名が必要です。ネットワークおよびサーバーへのインバウンド接続は必要ありません。顧客がホストする Mule Runtime と Anypoint Platform 間の接続は、永続的な Websocket 接続を介して確立されます。すべての接続はアウトバウンドです。</td></tr></tbody></table>

## [](#ポート)ポート

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 71.4285%;">
<col style="width: 14.2858%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">ポート</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>analytics-ingest.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>exchange-files.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>exchange2-asset-manager-kprod.s3.amazonaws.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.gov.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.gov.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>gov.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>exchange-files.gov.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>exchange2-asset-manager-kgprod.s3.us-gov-west-1.amazonaws.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>analytics-ingest.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>exchange2-asset-manager-kprod-eu.s3.eu-central-1.amazonaws.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>443</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#静的-ip-アドレス)静的 IP アドレス

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">継続的なインフラストラクチャ改善の一環として、MuleSoft は Runtime Manager に新しい静的 IP アドレスを導入し、既存の IP アドレスを増強します。サービスの中断を避けるため、ネットワークポリシーに応じて、2024 年 2 月 1 日までに次の IP アドレスまたはドメインを組織のファイアウォールで許可してください。</td></tr></tbody></table>

- `mule-manager`​ ホストにアクセスするには、​`US`​ リージョンのこれらの静的 IP を許可リストに登録します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 60%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">IP アドレス</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>52.201.174.72</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>52.201.67.218</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>44.196.243.83 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>3.223.189.76 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.210.198.109 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
</tbody>
</table>
- `runtime-manager`​ ホストにアクセスするには、​`US`​ リージョンのこれらの静的 IP を許可リストに登録します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 60%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">IP アドレス</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.214.68.14</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>35.174.151.175</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.213.137.40 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>34.232.255.44 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>44.209.29.79 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
</tbody>
</table>
- `mule-manager`​ ホストにアクセスするには、​`EU`​ リージョンのこれらの静的 IP を許可リストに登録します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 60%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">IP アドレス</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.195.19.18</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.194.245.32</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.193.248.250 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>3.76.156.245 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>mule-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>3.122.182.28 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
</tbody>
</table>
- `runtime-manager`​ ホストにアクセスするには、​`EU`​ リージョンのこれらの静的 IP を許可リストに登録します。
    
    <table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 10%;">
<col style="width: 60%;">
<col style="width: 30%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">名前</th>
<th class="tableblock halign-left valign-top">IP アドレス</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.185.141.77</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>3.123.216.217</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>3.127.253.183 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>35.158.72.97 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.eu1.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>18.198.198.255 (2024 年 2 月開始)</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#動的-ip-アドレス)動的 IP アドレス

Anypoint Platform によって使用される IP アドレスの一部は、基盤となるクラウドインフラストラクチャによって自動的に割り当てられます。これらの IP アドレスは動的であるため、Anypoint サービスに割り当てられた IP アドレスに基づいて許可リストを実装しないでください。

多くのファイアウォールデバイスでは、レイヤー 7 ファイアウォールルールを定義できるため、宛先名やアプリケーション種別によって絞り込むことができます。

次の完全修飾ホスト名をレイヤー 7 ファイアウォールルールに含めます。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 14.2857%;">
<col style="width: 85.7143%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">リージョン</th>
<th class="tableblock halign-left valign-top">ホスト名</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>analytics-ingest.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.gov.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.gov.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>US-GOV</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>gov.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>eu1.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>analytics-ingest.eu1.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><strong>EU</strong></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.eu1.anypoint.mulesoft.com</p>
</div></div></td>
</tr>
</tbody>
</table>

### [](#許可リスト)許可リスト

1.12.0 (Mule 3.x) または 2.2.0 (Mule 4.x) 以上のエージェントバージョンを使用している場合にのみ、次の URL を許可リストに登録します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 66.6667%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">URL</th>
<th class="tableblock halign-left valign-top">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>runtime-manager.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ARM 管理機能用の接続 (​<strong>公開証明書エージェント</strong>​)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>data-authenticator.anypoint.mulesoft.com</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>arm-monitoring スタックのメトリクス取り込みサービスへの接続 (​<strong>公開証明書エージェント</strong>​)</p>
</div></div></td>
</tr>
</tbody>
</table>

<!-- document id=3045833a9542dbc6253226fd914dd6aa61ec412c31260ebb5cd6129393954733 url=/mulesoft/current/ja-jp/runtime-manager/internal-handler-buffering.md -->

# 内部ハンドラーバッファ

 [![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)

Anypoint Runtime Manager エージェントでは、バッファをサポートする内部ハンドラーを簡単な方法で実装できます。このドキュメントでは、Runtime Manager エージェントの内部ハンドラーのバッファを実装し、設定する方法について説明します。

## [](#バッファ付き内部ハンドラーの実装)バッファ付き内部ハンドラーの実装

### [](#bufferedhandler-抽象クラス)BufferedHandler 抽象クラス

バッファ付き内部ハンドラーを実装するには、​`BufferedHandler<T>`​ 抽象クラスを拡張する必要があります。上書きするメソッドは次のとおりです。

- `boolean canHandle(T message)`
    
    メッセージが内部ハンドラーによって処理可能であれば true を返します。
- `boolean flush(Collection<T> collectionOfMessages)`
    
    バッファに保存されているメッセージを外部サービスに送信する実装を提供します。

### [](#例)例

```java
@Named("com.mulesoft.agent.mypublisher")
@Singleton
public class MyPublisher extends BufferedHandler<List<Metric>>
{
    @Configurable(value = "mule")
    String metricPrefix;

    @Inject
    public MyPublisher()
    {
        super();
    }

    public MyPublisher(OnOffSwitch enabledSwitch)
    {
        super();
        this.enabledSwitch = enabledSwitch;
    }

    @Override
    public boolean canHandle(@NotNull List<Metric> metrics)
    {
        // Evaluates if the message could be handled
    }

    @Override
    public boolean flush(@NotNull Collection<List<Metric>> listOfMetrics)
    {
        // Send messages to external service
    }
}
```

## [](#内部ハンドラーのバッファの設定)内部ハンドラーのバッファの設定

### [](#バッファ設定オブジェクト)バッファ設定オブジェクト

内部ハンドラーにバッファサポートが含まれる場合は、​`mule-agent.yml`​ ファイル内でバッファを設定できます。次の表は、使用可能な設定パラメーターを示しています。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 34%;">
<col style="width: 33%;">
<col style="width: 33%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">項目</th>
<th class="tableblock halign-left valign-top">説明</th>
<th class="tableblock halign-left valign-top">デフォルト値</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>type</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">バッファ種別。有効な値は、​<code>MEMORY</code>​ (メモリ) または ​<code>DISK</code>​ (ディスク) です。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>retryCount</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">フラッシュメソッドで例外が発生した後に再試行する回数。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>maximumCapacity</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">バッファに保持するイベントの最大数。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>flushFrequency</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">フラッシュメソッドを実行する頻度 (ミリ秒)。</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>filePath</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">バッファファイルへのパス。種別が ​<code>DISK</code>​ (ディスク) のバッファにのみ有効です。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>PATH/bufferFile</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>whenExhausted</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">バッファが枯渇したときに従う戦略。指定しない場合、バッファは自動的に拡張されます。有効な値は、​<code>FAIL</code>​ (失敗) と ​<code>FLUSH.</code>​ (フラッシュ) です。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">なし</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>flushThreadsNumber</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>whenExhausted</code>​ で定義した戦略が ​<code>FLUSH</code>​ (フラッシュ) (上記参照) である場合に、バッファが枯渇したときに FlushThreadExecutor によって使用されるスレッド数。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>60</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>discardMessagesOnFlushFailure</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">true の場合、フラッシュが成功しなかったときにはメッセージがバッファに返されません。</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>false</code></p></td>
</tr>
</tbody>
</table>

<table>
<tbody><tr>
<td class="icon">
<i class="fa icon-important" title="Important"></i>
</td>
<td class="content">
<div class="paragraph">
<p>バッファの最大容量は、バイト数ではなくイベント数に基づいて設定されます。イベントのサイズが大きく、​<code>maximumCapacity</code>​ を低い値に設定していない場合は、ヒープに負荷がかかり、アプリケーションのパフォーマンスに影響する可能性があります。</p>
</div>
</td>
</tr>
</tbody></table>

`DISK`​ (ディスク) バッファを設定した場合は、I/O 操作のパフォーマンスを改善するために、メモリ内バッファもインスタンス化されます。デフォルトでは、メモリバッファのイベント数は 10000 で、500 ミリ秒ごとにディスクにフラッシュし、各バッチには 10000 件のイベントが含まれます。これらの値は、それぞれシステムプロパティ ​`agent.disk.buffering.cache.size`​、​`agent.disk.buffering.cache.flush.frequency`​、​`agent.disk.buffering.max.flushing.size`​ で設定できます。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">ディスクから外部システムへの 10000 件ずつのバッチのフラッシュと、​<code>agent.disk.buffering.max.flushing.size</code>​ プロパティは、Mule エージェントプラグインの 2.1.9 および 1.11.3 以降でサポートされています。</td></tr></tbody></table>

### [](#サンプルの-mule-agent-yml-ファイル)サンプルの ​`mule-agent.yml`​ ファイル

#### [](#パブリッシャーでのバッファの設定)パブリッシャーでのバッファの設定

```yaml
---
muleInstanceUniqueId: validId
organizationId: organizationId

transports:
    websocket.transport:
        security:
            keyStorePassword: mykeystorePassword
            keyStoreAlias: agent
            keyStoreAliasPassword: agentpassword

    rest.agent.transport:
        security:
            keyStorePassword: mykeystorePassword
            keyStoreAlias: agent
            keyStoreAliasPassword: agentpassword
        port: 9997

services:
    mule.agent.application.service:
        enabled: true

    mule.agent.domain.service:
        enabled: true

    mule.agent.jmx.publisher.service:
        enabled: true
        frequency: 15
        frequencyTimeUnit: MINUTES
        beans:
            -   beanQueryPattern: java.lang:type=Runtime
                attribute: Uptime
                monitorMessage: Monitoring memory up-time
            -   beanQueryPattern: java.lang:type=MemoryPool,*
                attribute: Usage.used
                monitorMessage" : Used Memory

internalHandlers:
    domaindeploymentnotification.internal.message.handler:
        enabled: true

    applicationdeploymentnotification.internal.message.handler:
        enabled: false

    com.mulesoft.agent.test.buffering.jmx.internal.handler:
        enabled: true
        buffer:
            type: DISK
            retryCount: 1
            flushFrequency: 10000
            maximumCapacity: 30
            filePath: publisher-buffer.log

externalHandlers:
    applications.request.handler:
        enabled: true

    domains.request.handler:
        enabled: true
```

#### [](#イベント追跡でのバッファの設定)イベント追跡でのバッファの設定

```yaml
---
muleInstanceUniqueId: validId
organizationId: organizationId

transports:
    websocket.transport:
        security:
            keyStorePassword: mykeystorePassword
            keyStoreAlias: agent
            keyStoreAliasPassword: agentpassword

    rest.agent.transport:
        security:
            keyStorePassword: mykeystorePassword
            keyStoreAlias: agent
            keyStoreAliasPassword: agentpassword
        port: 9997

services:
    mule.agent.application.service:
        enabled: true

    mule.agent.domain.service:
        enabled: true

    mule.agent.jmx.publisher.service:
        enabled: true
        frequency: 15
        frequencyTimeUnit: MINUTES
        beans:
            -   beanQueryPattern: java.lang:type=Runtime
                attribute: Uptime
                monitorMessage: Monitoring memory up-time
            -   beanQueryPattern: java.lang:type=MemoryPool,*
                attribute: Usage.used
                monitorMessage" : Used Memory

internalHandlers:
    domaindeploymentnotification.internal.message.handler:
        enabled: true

    applicationdeploymentnotification.internal.message.handler:
        enabled: false

    tracking.notification.internal.message.handler:
        enabled: true
        buffer:
            type: MEMORY
            retryCount: 1
            flushFrequency: 10000
            maximumCapacity: 30

externalHandlers:
    applications.request.handler:
        enabled: true

    domains.request.handler:
        enabled: true
```

<!-- document id=a3c5abf27c9683098e9bf42bbfb00d34650c0b8048ebea04c31da47c11d30e9b url=/mulesoft/current/ja-jp/runtime-manager/continuous-deployment.md -->

# 継続的デプロイメント

 [![logo cloudhub 2.0 active](/mulesoft/current/ja-jp/_/img/icons/clouds.svg "CloudHub 2.0")CloudHub 2.0](deployment-strategies#cloudhub-2-0)[ ![logo cloudhub active](/mulesoft/current/ja-jp/_/img/icons/cloudhub.svg "CloudHub")CloudHub ](deployment-strategies#cloudhub)[ ![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)[ ![logo rtf active](/mulesoft/current/ja-jp/_/img/icons/cloud-gear.svg "Runtime Fabric")Runtime Fabric](deployment-strategies#anypoint-runtime-fabric-deployments)

Runtime Manager REST API を使用して、独自のオンプレミスサーバーまたは他のクラウドサーバー (CloudHub の外部) への継続的デプロイメントができます。Runtime Manager REST API を使用すると、Runtime Manager が提供する多くの機能にプログラムでアクセスできます。CloudHub への継続的デプロイメントを実装する場合は、​[「CloudHub REST API」](https://docs.mulesoft.com/cloudhub/cloudhub-api)​を参照してください。

ここで説明するプロセスを以下の方法で継続的デプロイメントパイプラインにタスクとして実装できます。

- シェルとして (Microsoft PowerShell、Bash など)
- スクリプトとして
- Java で記述された Jenkins/Maven プラグインとして

API を介してサポートされるすべての操作、リソース、メソッド、必須プロパティ、および予想される応答の詳細なリファレンスは、 [スタンドアロン Runtime Manager API リファレンス](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)​または [Runtime Fabric API リファレンス](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/runtime-fabric/)​を参照してください。

同じ機能を提供する Mule Maven プラグインも使用できます。したがって、ここで説明するプロセスは、​[Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/mmp-concept)​を使用できない場合や、使用することが望まれない場合の代替方法として使用してください。

デプロイおよび CI 関連のアクティビティ専用の Anypoint Platform アカウントを作成することをお勧めします。

## [](#オンプレミスサーバーのワークフロー)オンプレミスサーバーのワークフロー

以下で説明するワークフローは、好みに応じてさまざまな方法で実行できますが、ステップは同じです。ステップの概要を以下に示します。

- ユーザーを Anypoint Platform にサインインします。
- そのアカウントで登録されているサーバー、サーバーグループ、およびクラスターに関する情報が取得されます。
- アプリケーションがデプロイされます。
- アプリケーションはアクセス管理および Runtime Manager の API とやり取りします。

ワークフローは以下の入力パラメーターを受け取る必要があります。

- **Username (ユーザー名)**​ - Anypoint Platform アカウントのユーザー名
- **Password (パスワード)**​ - Anypoint Platform ユーザー名のパスワード
- **Environment (環境)**​ - デプロイ環境 (Dev (開発)、Test (テスト)、Prod (本番) など)
- **Target Name (対象名)**​ - アプリケーションのデプロイ先の対象の名前
- **Target Type (対象種別)**​ - 対象の種別 (Server (サーバー)、Cluster (クラスター)、ServerGroup (サーバーグループ)、Runtime Fabric)
- **Artifact Name (アーティファクト名)**​ - デプロイする Mule アプリケーションの名前
- **File (ファイル)**​ - デプロイする Mule アプリケーションのバイナリファイル

ワークフローは以下の API コールを順番に実行します。

![ワークフロー](/mulesoft/current/ja-jp/runtime-manager/_images/arm-api-workflow.png)

[Anypoint Platform アクセス管理](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/)​ API の使用方法

1. 有効な Anypoint Platform ユーザー名とパスワードを使用して、アクセス管理 API の ​`/login`​ をコールし、後続のすべてのコールで使用する ​`access_token`​ と ​`token_type`​ を取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">Jenkins を使用する場合、タスク内で ​<strong>[Username (ユーザー名)]</strong>​ と ​<strong>[Password (パスワード)]</strong>​ を設定する必要があります。タスクでは、​<code>token_type</code>​ と ​<code>access_token</code>​ を連結し、ワークフロープロセス全体の期間にわたってそれらを保存する必要があります。これらの項目は ​<code>token = token_type + " " + access_token</code>​ のように連結する必要があります (例: <code>"bearer 895d1a05-ba24-44f2-a9df-3675c1bde97b"</code>​)。<br>トークンはその連結された形式で、後続のすべての API コールでヘッダーとして渡す必要があります。</td></tr></tbody></table>
2. アクセス管理 API の ​`/accounts`​ をコールし、組織 ​`id`​ を取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">次に、タスクは「user.organisation.id」の場所から組織 ID を抽出し、これを後で使用する場合に備えて保存する必要があります。このステップは必須ではありません。組織 ID はその静的な性質のため、ローカルパラメーターとしてタスクに渡される可能性があるためです。</td></tr></tbody></table>
3. 前のステップで取得した組織 ​`id`​ を渡し、関連する環境名 (​`Dev`​、​`Test`​、​`Production`​ など) に基づいて正しい環境 ​`id`​ を選択して、アクセス管理 API の ​`/environments`​ をコールします。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">ステップ 2 で取得した組織 ​<code>id</code>​ は API URI の一部として渡す必要があります。環境 ​<code>id</code>​ は、パス「data[i].id」から条件「data[i].name == inputEnvironment」を使用して抽出する必要があります (「Dev」、「Test」、「Production」、または Anypoint Platform でセットアップされた有効な環境名などの値が取得される可能性があります)。</td></tr></tbody></table>

[スタンドアロン Runtime Manager](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)​ API を使用する手順は、次のとおりです。

1. サーバー、クラスター、またはサーバーグループ名と、取得した組織 ​`id`​ および環境 ​`id`​ を渡して、Runtime Manager API の ​`/servers`​、​`/clusters`​、または ​`/serverGroups`​ をコールします。 このコールでは、​`targetId`​ を含め、このサーバー、クラスター、またはサーバーグループに関するすべてのデータが返されます。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このステップでは、後でデプロイの対象として使用する対象 ​<code>id</code>​ を取得します。このタスクでは、ワークフローの開始時に入力として設定された対象名に基づいて、適切なサーバー、サーバーグループ、またはクラスター ID を選択する必要があります。サーバー ​<code>id</code>​ は、​<code>data[i].id</code>​ から条件 ​<code>data[i].name == inputTargetName</code>​ を使用して抽出する必要があります。</td></tr></tbody></table>
2. 組織の ​`id`​ と環境の ​`id`​ を渡して、Runtime Manager API の ​`/applications`​ をコールし、アプリケーションの ​`id`​ とそのデータの残りを取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このステップでは、アプリケーション ​<code>id</code>​ を取得し、次のステップが新規デプロイ (6a) または再デプロイ (6b) のどちらであるかを判別します。アプリケーション ​<code>id</code>​ は、「data[i].id」から条件「data[i].artifact.name == inputArtifactName」および「data[i].target.id == serverId」/「clusterId」/「serverGroupId」を使用して抽出する必要があります。</td></tr></tbody></table>
3. 組織の ​`id`​、環境の ​`id`​、「artifactName」、​`targetId`​ (このセクションのステップ 1 で取得)、デプロイする Mule アプリケーションの .zip ファイル、および必要に応じてアプリケーション ​`id`​ を渡して、Runtime Manager API の ​`/applications`​ を POST します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このステップでは、実際の Mule アプリケーションアーティファクトを対象環境およびサーバー/クラスター/サーバーグループに初めてデプロイします。ステップ 2 でアプリケーション ID を取得していない場合、​<strong>POST</strong>​ 要求を使用します。ステップ 2 でアプリケーション ID を取得した場合、​<strong>PATCH</strong>​ を使用して、実際の Mule アプリケーションアーティファクトを対象環境およびサーバー/クラスター/サーバーグループに再デプロイします。</td></tr></tbody></table>

## [](#オンプレミス-runtime-fabric-のワークフロー)オンプレミス Runtime Fabric のワークフロー

以下で説明するワークフローは、好みに応じてさまざまな方法で実行できますが、ステップは同じです。ステップの概要を以下に示します。

- まず、ユーザーを Anypoint Platform にログインします。
- そのアカウントで登録されている Runtime Fabric に関する情報が取得されます。
- アプリケーションがデプロイされます。
- アプリケーションは MuleSoft Anypoint Platform のアクセス管理および Runtime Manager の API とやり取りします。

ワークフローは以下の入力パラメーターを受け取る必要があります。

- **Username (ユーザー名)**​ - Anypoint Platform アカウントのユーザー名
- **Password (パスワード)**​ - Anypoint Platform ユーザー名のパスワード
- **Environment (環境)**​ - デプロイ環境 (Dev (開発)、Test (テスト)、Prod (本番) など)。
- **Target Settings (対象設定)**​ - アプリケーションのデプロイ先の対象の種別 (MC) 名、および設定
- **Exchange Reference (Exchange 参照)**​ - Exchange にデプロイする Mule アプリケーションの参照
- **Application Configuration (アプリケーション設定)**​ - デプロイのアプリケーション設定

ワークフローは以下の API コールを順番に実行します。

**Maven ツールの使用**

1. [Maven](https://docs.mulesoft.com/exchange/to-publish-assets-maven)​ を使用して、アーティファクトを Exchange アセットマネージャーにパブリッシュします。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">対象で障害が発生し、回復のためにコントロールプレーンでアーティファクトを再デプロイする必要がある場合、このステップを実行して高可用性を確保する必要があります。</td></tr></tbody></table>

[Anypoint Platform アクセス管理](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/access-management-api/)​ API の使用方法

1. 有効な Anypoint Platform ユーザー名とパスワードを使用して、アクセス管理 API の ​`/login`​ をコールし、後続のすべてのコールで使用する ​`access_token`​ と ​`token_type`​ を取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">Jenkins を使用する場合、タスク内で ​<strong>[Username (ユーザー名)]</strong>​ と ​<strong>[Password (パスワード)]</strong>​ を設定する必要があります。タスクでは、​<code>token_type</code>​ と ​<code>access_token</code>​ を連結し、ワークフロープロセス全体の期間にわたってそれらを保存する必要があります。これらの項目は ​<code>token = token_type + " " + access_token</code>​ のように連結する必要があります (例: <code>"bearer 895d1a05-ba24-44f2-a9df-3675c1bde97b"</code>​)。</td></tr></tbody></table>

トークンはその連結された形式で、後続のすべての API コールでヘッダーとして渡す必要があります。

1. アクセス管理 API の ​`/accounts`​ をコールし、組織 ​`id`​ を取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">次に、タスクは「user.organisation.id」の場所から組織 ID を抽出し、これを後で使用する場合に備えて保存する必要があります。このステップは必須ではありません。組織 ID はその静的な性質のため、ローカルパラメーターとしてタスクに渡される可能性があるためです。</td></tr></tbody></table>
2. 前のステップで取得した組織 ​`id`​ を渡し、関連する環境名 (​`Dev`​、​`Test`​、​`Production`​ など) に基づいて正しい環境 ​`id`​ を選択して、アクセス管理 API の ​`/environments`​ をコールします。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">ステップ 2 で取得した組織 ​<code>id</code>​ は API URI の一部として渡す必要があります。環境 ​<code>id</code>​ は、パス「data[i].id」から条件「data[i].name == inputEnvironment」を使用して抽出する必要があります (「Dev」、「Test」、「Production」、または Anypoint Platform でセットアップされた有効な環境名などの値が取得される可能性があります)。</td></tr></tbody></table>

\*​https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/amc-application-manager/\[Application Manager API^\]​ の使用:

1. 組織の ​`id`​ と環境の ​`id`​ を渡して、アプリケーションマネージャー API の deployments をコールし、アプリケーションの ​`id`​ とそのデータの残りを取得します。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このステップでは、アプリケーション ​<code>id</code>​ を取得し、次のステップが新規デプロイ (6a) または再デプロイ (6b) のどちらであるかを判別します。アプリケーション ​<code>id</code>​ は、​<code>data[i].id</code>​ から条件 ​<code>data[i].artifact.name == inputArtifactName' and `​data[i].target.targetId == ​`targetId`</code>​ を使用して抽出する必要があります。</td></tr></tbody></table>
2. 組織の ​`id`​、環境の ​`id`​、​`applicationName`​、​`labels`​、​`target`​ デプロイ設定 (このセクションのステップ 1 で取得した対象 ID を含む)、デプロイするパブリッシュ済み Mule アプリケーション「application」の Exchange 参照、アプリケーション ​`configuration`​、および必要に応じてアプリケーション ​`id`​ を渡して、アプリケーションマネージャー API の ​`/deployments`​ を POST します。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このステップでは、実際の Mule アプリケーションアーティファクトを対象環境および Runtime Fabric に初めてデプロイします。ステップ 2 でアプリケーション ID を取得していない場合、​<code>POST</code>​ 要求を使用します。ステップ 2 でアプリケーション ID を取得した場合、​<code>PATCH</code>​ 要求を使用して再デプロイします。</td></tr></tbody></table>

<!-- document id=b6df1c0c855f7be8f8811033e9eec713e130d0018484eb65a4752864893e7a33 url=/mulesoft/current/ja-jp/runtime-manager/managing-applications-on-your-own-servers.md -->

# 自分のサーバーでのアプリケーションの管理

 [![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)

[サーバーを追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)​して、サーバーに​[アプリケーションをデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)​したら、Runtime Manager を使用してアプリケーションの監視と管理を実行できます。

アプリケーションが ​[CloudHub](https://docs.mulesoft.com/cloudhub/deploying-to-cloudhub)​ または​[独自サーバー](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)​のどちらにデプロイされているかに応じて、デプロイ後に実行できる一連のアクションが異なります。このページでは、独自サーバーにデプロイされたアプリケーションに固有のアクションに焦点を絞ります。両方の種類のデプロイメント対象に共通する基本的な管理ツールについては、​[「デプロイ済みアプリケーションの管理」](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)​を参照してください。

独自のサーバーにデプロイされたアプリケーションでは、以下を行うことができます。

- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)​とアプリケーションが実行されるサーバーの監視
- [サーバーの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このドキュメントでは、 <a href="https://anypoint.mulesoft.com">クラウドベース</a>​の Anypoint Platform または Anypoint Platform Private Cloud Edition を使用してデプロイされたオンプレミスのデプロイメントについて説明します。このページで説明する機能の一部は、Anypoint Platform Private Cloud Edition ではまだ使用できません。明確な区別については、​<a href="https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies" class="xref page">「デプロイメントオプション」</a>​を参照してください。Anypoint Platform Private Cloud Edition をリクエストすることに関心がある場合は、営業担当にお問い合わせください。</td></tr></tbody></table>

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">MuleSoft では、Runtime Manager を使用してオンプレミスサーバーを管理している場合、手動でのアプリケーションのデプロイはサポートされません。 オンプレミスサーバーでアプリケーションを手動でデプロイすると、アプリケーションが自動検出されないため、Runtime Manager で表示したり管理したりできません。</td></tr></tbody></table>

## [](#アプリケーションダッシュボード)アプリケーションダッシュボード

\[Applications (アプリケーション)\] タブでいずれかのアプリケーションを選択すると、右側にパネルが開きます。ここでは、アプリケーションに関する追加情報を参照し、その設定にアクセスできます。

![managing applications on your own servers 26ef4](/mulesoft/current/ja-jp/runtime-manager/_images/managing-applications-on-your-own-servers-26ef4.png)

このダッシュボードに表示される内容は、アプリケーションが ​[CloudHub](https://docs.mulesoft.com/cloudhub/managing-applications-on-cloudhub)​ と Mule のどちらにデプロイされているかによって異なります。

Mule にデプロイされているアプリケーションの場合は、状況、最終変更日時、デプロイされたアプリケーション ZIP ファイルが表示されます。ZIP ファイルは、このメニューから ​**\[Choose File (ファイルを選択)\]**​ ボタンを使用して変更できます。クラスターとサーバーグループにデプロイされているアプリケーションの場合は、さらにサーバーのリストと各サーバーの状況も表示されます。

<table><tbody><tr><td class="icon"><i class="fa icon-tip" title="Tip"></i></td><td class="content">アプリケーションが実行されているサーバーについての情報を確認するには、パネルでサーバー名をクリックするか、​<strong>[Servers (サーバー)]</strong>​ タブでサーバー名を検索します。詳細は、​<a href="https://docs.mulesoft.com/jp/runtime-manager/managing-servers#servers-dashboard" class="xref page">「サーバー、サーバーグループ、クラスターについて」</a>​を参照してください。</td></tr></tbody></table>

すべてのパネルには、次の 2 つのボタンが表示されます。

- **\[Manage Application (アプリケーションを管理)\]**​ ボタン。アプリケーションの設定ページに移動します。このページには、アプリケーションとアプリケーションが実行されるサーバーに関する詳細な情報が表示されます。また、ここからアプリケーションダッシュボードにもアクセスできます。詳細は、​[「ダッシュボードの監視」](https://docs.mulesoft.com/jp/runtime-manager/monitoring-dashboards#the-dashboard-for-apps-on-servers)​を参照してください。
    
    ![managing applications on your own servers b0e6f](/mulesoft/current/ja-jp/runtime-manager/_images/managing-applications-on-your-own-servers-b0e6f.png)
- **\[Insight (インサイト)\]**​ ボタン。トランザクションレベルのデータが表示されます。表示される内容についての詳細は、​[「インサイト」](https://docs.mulesoft.com/jp/runtime-manager/insight)​を参照してください。
    
    ![managing applications on your own servers ba927](/mulesoft/current/ja-jp/runtime-manager/_images/managing-applications-on-your-own-servers-ba927.png)
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">現在、​<strong>インサイト</strong>​機能は、Anypoint Platform Private Cloud Edition では使用できません。</td></tr></tbody></table>

## [](#アプリケーション設定にアクセスする)アプリケーション設定にアクセスする

[Anypoint Platform](https://anypoint.mulesoft.com)​ にサインインし、Runtime Manager の ​**\[Applications (アプリケーション)\]**​ タブを表示します。CloudHub で実行されているアプリケーションのいずれかを選択して、右側のパネルを開きます。パネルで、​**\[Manage Application (アプリケーションを管理)\]**​ ボタンをクリックして、アプリケーションの設定を開きます。

![managing applications on your own servers 1fd39](/mulesoft/current/ja-jp/runtime-manager/_images/managing-applications-on-your-own-servers-1fd39.png)

このメニューには、パネル上に表示されるのと同じデータがすべて表示され、さらに ​**\[Alerts History (アラート履歴)\]**​ タブに、このアプリケーションでトリガーされたアラートの記録が表示されます。詳細は、​[「Runtime Manager のアラート」](https://docs.mulesoft.com/jp/runtime-manager/alerts-on-runtime-manager)​を参照してください。

## [](#フロー管理)フロー管理

UI のこのタブを使用して、デプロイされたアプリケーション内の特定のフローを個別に開始または停止できます。​[「フロー管理」](https://docs.mulesoft.com/jp/runtime-manager/flow-management)​を参照してください。

## [](#アプリケーションの監視)アプリケーションの監視

アプリケーションが独自サーバーのいずれかにデプロイされている場合は、アプリケーションで発生するイベントやアプリケーションが実行されているサーバー、サーバーグループ、クラスターのパフォーマンスを監視するためのツール群があります。詳細は、​[「アプリケーションの監視」](https://docs.mulesoft.com/jp/runtime-manager/monitoring)​を参照してください。

## [](#アプリケーションの削除)アプリケーションの削除

デプロイされたアプリケーションをサーバーから削除するには、アプリケーションの状況の横にある矢印をクリックし、​**\[Delete (削除)\]**​ を選択します。

![managing applications on your own servers 96463](/mulesoft/current/ja-jp/runtime-manager/_images/managing-applications-on-your-own-servers-96463.png)

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">このオプションが使用可能になるには、サーバーが実行中である必要があります。クラスターまたはサーバーグループの場合、少なくとも 1 つのノードが実行中である必要があります。</td></tr></tbody></table>

### [](#削除済みのハイブリッドアプリケーションの再デプロイ)削除済みのハイブリッドアプリケーションの再デプロイ

オンプレミスでデプロイされるアプリケーションの場合、Runtime Manager による特定の動作をトリガーする 2 つのシナリオが考えられます。

- Mule が実行されていないときに 1 つ以上のアプリケーションフォルダーを手動で削除し、サーバーが再同期されると、Runtime Manager で欠落しているアプリケーションが検出され、欠落しているアプリケーションをもう一度サーバーにダウンロードするよう要求され、自動的に再同期されます。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">UI から、または REST を使用して削除した場合のみ、アプリケーションが完全に削除されます。</td></tr></tbody></table>
- 新しいサーバーがクラスターまたはサーバーグループに追加されると、そのグループまたはクラスターで他のサーバーが実行されていなかったとしても、Runtime Manager によってアプリケーションがそのサーバーグループまたはクラスターに自動的にデプロイされます。

## [](#アプリケーションアーカイブのダウンロード)アプリケーションアーカイブのダウンロード

Runtime Manager では、オンプレミスサーバーにデプロイメントされているアプリケーションの ​**\[Settings (設定)\]**​ ページからアプリケーションのアーカイブ (ZIP または JAR ファイル) をダウンロードすることはできません。 ARM REST サービス API コールまたは Anypoint コマンドラインインターフェースを使用すれば、アーカイブをダウンロードできます。

詳細は、 [「How to Download an Archive of an Application Deployed in Hybrid from Anypoint Platform using API and CLI (API と CLI を使用した、Anypoint Platform からハイブリッドでデプロイされているアプリケーションのアーカイブのダウンロード方法)」](https://help.mulesoft.com/s/article/How-to-Download-an-Archive-of-an-Application-Deployed-in-Hybrid-On-Premise-from-Anypoint-Platform-using-API-and-CLI)​を参照してください。

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

- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [自分のサーバーへのアプリケーションのデプロイ](https://docs.mulesoft.com/jp/runtime-manager/deploying-to-your-own-servers)
- [デプロイされたアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-deployed-applications)
- [アプリケーションの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [Runtime Manager REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=aa16ee43967bac45222e3696f2fd25cb56d3cbd25a3dde8530b828f4acbc9715 url=/mulesoft/current/ja-jp/runtime-manager/deploying-to-your-own-servers.md -->

# 自分のサーバーへのデプロイ

 [![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 アプリケーションをローカルサーバーにデプロイするには、次のものを使用できます。

- [Anypoint Platform Runtime Manager クラウドコンソール](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies#cloudhub-deployments)
- [Anypoint Platform Private Cloud Edition Runtime Manager コンソール](https://docs.mulesoft.com/jp/runtime-manager/deployment-strategies#anypoint-platform-pce-deployments)
- [Runtime Manager API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)
- [Mule Maven プラグイン](https://docs.mulesoft.com/mule-runtime/latest/deploy-on-premises)

Runtime Manager を使用してサーバーを管理する場合は、他のデプロイメント/管理方法やツールを使用して管理することはできません。

## [](#前提条件)前提条件

ローカルサーバーにデプロイする前に、以下を行う必要があります。

1. [Mule をダウンロードしてインストールします](https://docs.mulesoft.com/on-premises/latest/runtime-installation-task)​。
2. [Runtime Manager へのサーバーの追加](https://docs.mulesoft.com/jp/runtime-manager/servers-create)​。

非本番 (Sandbox) 環境から本番環境にアプリケーションをコピーする場合は、両方の環境で権限を持っていることを確認してください。

互換性の問題を回避するには、以下の点にも注意してください。

- 両方の環境のサーバーで動作している Mule バージョンが同じか、または互換性がある。
- 両方の環境のデプロイメント対象種別 (単一サーバー、サーバーグループ、またはクラスター) が同じ。

## [](#runtime-manager-からのアプリケーションのデプロイ)Runtime Manager からのアプリケーションのデプロイ

Runtime Manager からローカルサーバーにアプリケーションをデプロイする手順は次のとおりです。

1. Anypoint Platform にサインインします。
2. **\[Runtime Manager\]**​ を選択します。
3. **\[Applications (アプリケーション)\]**​ ページで ​**\[Deploy application (アプリケーションをデプロイ)\]**​ をクリックします。
4. アプリケーションの名前を入力します。
    
    アプリケーション名は、Runtime Manager でアプリケーションを識別するものであり、すべての環境で一意である必要があります。 名前がすでに使用されている場合は、Runtime Manager から警告が表示されます。
    
    アプリケーション名では、3 ～ 42 文字の英数字 (a-z、A-Z、0-9) とハイフン (-) を使用できます。 スペースやその他の文字を含めることはできません。
    
    <table><tbody><tr><td class="icon"><i class="fa icon-important" title="Important"></i></td><td class="content">アプリケーションのデプロイ後は名前を変更することはできません。名前を変更するには、削除してから新しい名前でアプリケーションを再デプロイしてください。</td></tr></tbody></table>
5. デプロイメント対象を選択します。
    
    対象は、実行中のサーバー、サーバーグループ、またはクラスターである必要があります。
6. アプリケーションファイルを指定します。
    
    - Exchange からファイルをインポートします。
        
        1. **\[Choose file (ファイルを選択)\]**​ をクリックして、​**\[Import file from Exchange (Exchange からファイルをインポート)\]**​ を選択します。
        2. 種別には ​**\[Application (アプリケーション)\]**​ を選択します。
        3. 検索ボックスにアプリケーションの名前を入力します。
        4. デプロイするアプリケーションを選択し、​**\[Version (バージョン)\]**​ メニューからバージョンを選択して、​**\[Select (選択)\]**​ をクリックします。
    - アプリケーションの ZIP ファイルをアップロードします。
        
        1. **\[Choose file (ファイルを選択)\]**​ をクリックして、​**\[Upload file (ファイルをアップロード)\]**​ を選択します。
        2. アップロードするファイルを選択して ​**\[Open (開く)\]**​ をクリックします。
    - 非本番環境からアプリケーションをコピーします。
        
        1. **\[Get from sandbox (Sandbox から取得)\]**​ をクリックします。
            
            このボタンは、非本番環境が存在する場合にのみ使用できます。
        2. アプリケーションを取得する環境 (Sandbox など) を選択します。
        3. 必要であれば、デプロイするアプリケーションを検索します。
        4. アプリケーションを選択し、​**\[Apply (適用)\]**​ をクリックします。
            
            ローカルサーバー、サーバーグループ、またはクラスターにデプロイされているアプリケーションのみがリストに表示されます。 CloudHub にデプロイされたアプリケーションは、他の CloudHub ワーカーで実行するようにのみ昇格できます。
7. タブをクリックしてアプリケーションオプションを設定します。
    
    ![「Deploy Application (アプリケーションのデプロイ)」 ページの設定タブ](/mulesoft/current/ja-jp/runtime-manager/_images/rtm-deploy-to-own-servers.png)
    
    Figure 1. 矢印は、​**\[Deploy Application (アプリケーションのデプロイ)\]**​ ページの設定タブを示しています。
    
    **\[Deployment Target (デプロイメント対象)\]**​ タブ
    
    選択したサーバー、サーバーグループ、またはクラスターによって Mule バージョンが決定されます。
    
    この Mule バージョンがアプリケーションの開発に使用したのと同じバージョンであることを確認します。
    
    **\[Insight (インサイト)\]**​ タブ
    
    インサイト分析機能のメタデータオプションを指定します。 [「インサイト」](https://docs.mulesoft.com/jp/runtime-manager/insight)​を参照してください。
    
    **\[Properties (プロパティ)\]**​ タブ
    
    デプロイ時と実行時にアプリケーションで使用されるプロパティ (キー-値ペア) を指定します。
    
    非本番環境からアプリケーションをデプロイすると (​**\[Get from sandbox (Sandbox から取得)\]**​)、新しいアプリケーションは元のアプリケーションで定義されているすべてのプロパティを継承します。 これらのプロパティは、アプリケーションをデプロイする前に必要に応じて ​**\[Properties (プロパティ)\]**​ タブで変更できます。
    
    [「オンプレミスのアプリケーションのプロパティ管理」](https://docs.mulesoft.com/jp/runtime-manager/hybrid-manage-props)​と​[「アプリケーションプロパティを安全に隠す」](https://docs.mulesoft.com/cloudhub/secure-application-properties)​を参照してください。
    
    **\[Logging (ログ)\]**​ タブ
    
    アプリケーションのログレベルを ​`TRACE`​、​`DEBUG`​、​`INFO`​、​`WARN`​、​`ERROR`​、または ​`FATAL`​ に設定します。
    
    `log4j2.xml`​ ファイルで ​`level`​ 値を変更することでログレベルを設定することもできます。 [「カスタムログの設定」](https://docs.mulesoft.com/mule-runtime/latest/logging-in-mule#configuring-custom-logging-settings)​と [「Apache ログサービス」](https://logging.apache.org/log4j/2.x/manual/configuration.html)​を参照してください。
    
    アプリケーションをデプロイすると、2 つのタブが追加されます。
    
    **\[Flow Monitoring (フローの監視)\]**​ タブ
    
    アプリケーションの ​**\[Flows (フロー)\]**​ ページでフロー監視メタデータを使用できるようにします。
    
    **\[Alerts History (アラート履歴)\]**​ タブ
    
    アプリケーションのアラートを表示します。
8. **\[Deploy Application (アプリケーションをデプロイ)\]**​ をクリックします。

新しいアプリケーションは、\[Applications (アプリケーション)\] タブのデプロイ済みアプリケーションのリストに表示されます。

## [](#デプロイ済みアプリケーションを変更する)デプロイ済みアプリケーションを変更する

デプロイされたアプリケーションのアプリケーションファイルを変更できます。

1. **\[Applications (アプリケーション)\]**​ ページでアプリケーションを選択して、対応するパネルを開きます。
2. **\[Choose File (ファイルを選択)\]**​ をクリックし、新しいファイルをアップロードします。

新しいバージョンがサーバー、サーバーグループ、クラスターで起動されるときには、アプリケーションに若干のダウンタイムが生じることがあります。

## [](#デプロイエラー)デプロイエラー

エラーが発生し、アプリケーションをデプロイできない場合、アプリケーションの状況インジケーターは ​`Failed`​ に変わり、エラーが発生したことが状況エリアに示されます。 ログの詳細を参照し、アプリケーションのデプロイエラーがないかどうかを確認します。 エラーを修正し、アプリケーションをアップロードしてから、アプリケーションを再デプロイします。

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

- [ポート、IP アドレス、ホスト名の許可](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-allowlists)
- [自分のサーバーでのアプリケーションの管理](https://docs.mulesoft.com/jp/runtime-manager/managing-applications-on-your-own-servers)
- [サーバー、サーバーグループ、クラスター](https://docs.mulesoft.com/jp/runtime-manager/managing-servers)
- [アプリケーションとサーバーの監視](https://docs.mulesoft.com/jp/runtime-manager/monitoring)
- [Runtime Manager REST API](https://anypoint.mulesoft.com/exchange/portals/anypoint-platform/f1e97bc6-315a-4490-82a7-23abe036327a.anypoint-platform/arm-rest-services)

<!-- document id=54344ebdd9a5f7ff0ad54a6aa07dd715c079af007206ff6c16ce69fb2cb6839e url=/mulesoft/current/ja-jp/runtime-manager/advanced-usage.md -->

# 高度な用途

 [![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)

通常、Runtime Manager エージェントで必要な作業は、​[「Runtime Manager エージェントのインストールまたは更新」](https://docs.mulesoft.com/jp/runtime-manager/installing-and-configuring-runtime-manager-agent)​に従ってインストールおよび構成することだけです。

Runtime Manager エージェントの基盤となるアーキテクチャや高度な設定については、次のトピックを参照してください。

- [Runtime Manager エージェントアーキテクチャ](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-architecture)
- [エージェント API](https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-api)
- [イベント追跡](https://docs.mulesoft.com/jp/runtime-manager/event-tracking)
- [内部ハンドラーバッファ](https://docs.mulesoft.com/jp/runtime-manager/internal-handler-buffering)
- [Runtime Manager エージェントの拡張](https://docs.mulesoft.com/jp/runtime-manager/extending-the-runtime-manager-agent)
- [アプリケーションバリデーターサービス](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-app-validator)
    
    - [JAR 署名バリデーター](https://docs.mulesoft.com/jp/runtime-manager/rtm-agent-jar-signature-validator)