---
schema_version: "1"
id: 020e26f7f3012432b47c71bcc42b94393e5b91079d299d3ca374792625c6581d
title: Runtime Manager から外部データベースへのイベントデータの送信
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/runtime-manager/sending-event-data-from-arm-to-db.md
canonical_url: https://docs.mulesoft.com/jp/runtime-manager/sending-event-data-from-arm-to-db
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 7287bb04719a841e98e6fcab798a470e7d40e5327ccc8ac108a614178c807d79
description: MuleSoft Documentation Site
latest: true
---
# Runtime Manager から外部データベースへのイベントデータの送信

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

Mule アプリケーションからのイベント通知をデータベースに保存するように Runtime 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)