---
schema_version: "1"
id: d9c6422eebc27fbce69e42307bf9005dafd7a71bc83c431651c28ef794647985
title: Runtime Manager エージェント通知
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-manager/runtime-manager-agent-notifications.md
canonical_url: https://docs.mulesoft.com/jp/runtime-manager/runtime-manager-agent-notifications
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 65405e32c3da716de9818d3da1ac295f37928b0f19470fb3497995b800f4ca39
description: MuleSoft Documentation Site
latest: true
---
# Runtime Manager エージェント通知

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

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)