翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon CloudWatch を使用して Oracle GoldenGate ログを監視する
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch"></a>

*Amazon Web Services、Chithra Krishnamurthy*

## 概要
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-summary"></a>

Oracle GoldenGate は、Oracle データベース用の Amazon Relational Database Service (Amazon RDS) または Amazon Elastic Compute Cloud (Amazon EC2) でホストされている Oracle データベース間のリアルタイムレプリケーションを提供しています。一方向レプリケーションと双方向レプリケーションの両方をサポートしています。

Oracle GoldenGate をレプリケーションに使用する場合は、Oracle GoldenGate プロセスが稼働していて、ソースデータベースとターゲットデータベースが同期していることを確認してください。

このパターンでは、GoldenGate エラーログの Amazon CloudWatch モニタリングを実装する手順と、レプリケーションを迅速に再開するための適切なアクションを実行できるような、`STOP` または `ABEND` など特定のイベントの通知を送信するようにアラームを設定する方法について説明します。

## 前提条件と制限事項
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-prereqs"></a>

前提条件
+ GoldenGate は EC2 インスタンスにインストールし設定されているため、これらの EC2 インスタンスで CloudWatch モニタリングをセットアップできます。AWS リージョン全体で GoldenGate をモニタリングして双方向レプリケーションを行う場合は、GoldenGate プロセスが実行されている各 EC2 インスタンスに CloudWatch エージェントをインストールする必要があります。

制限事項
+ このパターンでは、CloudWatch を使用して GoldenGate プロセスをモニタリングする方法を説明します。CloudWatch は、レプリケーション中のレプリケーションラグやデータ同期の問題をモニタリングしません。「[GoldenGate のドキュメント](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html)」で説明されているように、レプリケーションラグやデータ関連のエラーをモニタリングするには、別の SQL クエリを実行する必要があります。

**製品バージョン**
+ このドキュメントは、Linux x86-64 上の Oracle 用 Oracle GoldenGate 19.1.0.0.4 の実装を基にしています。ただし、このソリューションは GoldenGate のすべての主要バージョンに適用できます。

## アーキテクチャ
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-architecture"></a>

**ターゲットテクノロジースタック**
+ EC2 インスタンスにインストールされた Oracle 用 GoldenGate バイナリ
+ Amazon CloudWatch
+ Amazon Simple Notification Service (Amazon SNS)

**ターゲットアーキテクチャ**

![\[AWS 上の GoldenGate ログをモニタリングするためのターゲットアーキテクチャ\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/images/pattern-img/973a71d5-b6b3-4a2b-813e-cb4d8fd51ba5/images/1781aa9b-77b3-40c4-bc54-3cb91400899c.png)


## ツール
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-tools"></a>

**AWS サービス**
+ [Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html) は、このようなパターンで GoldenGate エラーログをモニタリングするために使用されるモニタリングサービスです。
+ [Amazon SNS](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/US_SetupSNS.html) は、このようなパターンでメール通知を送信するために使用されるメッセージ通知サービスです。

その他のツール
+ 「[Oracle GoldenGate](https://docs.oracle.com/en/middleware/goldengate/core/19.1/index.html)」は、Oracle データベース用の Amazon RDS for Oracle または Amazon EC2 でホストされている Oracle データベースに使用できるデータレプリケーションツールです。

ハイレベルな実装ステップ

1. CloudWatch エージェント用に AWS Identity and Access Management (IAM) ロールを作成します。

1. GoldenGate エラーログが生成される EC2 インスタンスに IAM ロールを添付します。

1. EC2 インスタンスに CloudWatch エージェントをインストールします。

1. CloudWatch エージェント設定ファイルの `awscli.conf` と `awslogs.conf` を設定します。

1. CloudWatch エージェントを起動します。

1. ロググループにメトリックスフィルタを作成します。

1. Amazon SNS をセットアップします。

1. 次に、メトリクスフィルターのアラームを作成します。Amazon SNS は、これらのフィルタがイベントをキャプチャするとメールアラートを送信します。

詳細な手順については、次のセクションを参照してください。

## エピック
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-epics"></a>

### ステップ 1. CloudWatch エージェント用の IAM ロールを作成
<a name="step-1-create-an-iam-role-for-the-cloudwatch-agent"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| IAM ロールの作成 | AWS リソースへのアクセスには権限が必要なので、各サーバーが CloudWatch エージェントを実行するのに必要な権限を含む IAM ロールを作成します。IAM ロールを作成するには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS 全般 | 

### ステップ 2. GoldenGate EC2 インスタンスに IAM ロールを添付
<a name="step-2-attach-the-iam-role-to-the-goldengate-ec2-instance"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| GoldenGate エラーログが生成される EC2 インスタンスに IAM ロールを添付します。 | GoldenGate によって生成されたエラーログは CloudWatch に入力してモニタリングする必要があるため、ステップ 1 で作成した IAM ロールを GoldenGate が実行されている EC2 インスタンスに添付する必要があります。IAM ロールをインスタンスにアタッチするには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS 全般 | 

### ステップ 3 ～ 5。Goldengate EC2 インスタンスに CloudWatch Logs エージェントをインストールして設定します。
<a name="steps-3-5-install-and-configure-the-cloudwatch-agent-on-the-goldengate-ec2-instance"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| GoldenGate EC2 インスタンスに CloudWatch エージェントをインストールします。 | エージェントをインストールするには、以下のコマンドを実行します。<pre>sudo yum install -y awslogs</pre> | AWS 全般 | 
| エージェント設定ファイルを編集します。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | AWS 全般 | 
| CloudWatch エージェントを起動します。 | エージェントを開始するには、次のコマンドを実行します。<pre>$ sudo service awslogsd start</pre>エージェントを起動した後、CloudWatch コンソールでロググループを表示できます。ログストリームにはファイルのコンテンツが含まれています。 | AWS 全般 | 

### ステップ 6. ロググループのメトリクスフィルターの作成
<a name="step-6-create-metric-filters-for-the-log-group"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| キーワードの「ABEND」と「STOPPED」のために、メトリックスフィルターを作成します。 | ロググループのメトリックスフィルタを作成すると、エラーログでフィルタが特定されるたびに、アラームが起動し、Amazon SNS 設定に基づき、メール通知が送信されます。メトリックスフィルターを作成するには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | CloudWatch | 

### ステップ 7. Amazon SNS をセットアップする
<a name="step-7-set-up-amazon-sns"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| SNS トピックを作成します。 | このステップでは、Amazon SNS を設定して、メトリックスフィルタのアラームを作成します。SNS トピックを作成するには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html) | Amazon SNS | 
| サブスクリプションを作成します。 | トピックのサブスクリプションを作成するには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html)Amazon SNS がウェブブラウザを開き、サブスクリプション ID とともにサブスクリプションの確認を表示します。 | Amazon SNS | 

### ステップ 8. メトリックスフィルタの通知を送信するアラームを作成します。
<a name="step-8-create-an-alarm-to-send-notifications-for-the-metric-filters"></a>


| タスク | 説明 | 必要なスキル | 
| --- | --- | --- | 
| SNS トピック用のアラームを作成します。 | ロググループのメトリクスフィルターに基づいてアラームを作成するには[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/prescriptive-guidance/latest/patterns/monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch.html)これらの手順を実行すると、モニタリングしている GoldenGate エラーログファイル (`ggserr.log`) でこれらのパターンが検出されるたびに、電子メール通知が届きます。 | CloudWatch | 

## トラブルシューティング
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-troubleshooting"></a>


| 問題 | ソリューション | 
| --- | --- | 
| GoldenGate エラーログからのログストリームは CloudWatch に流れません。 | `/etc/awslogs/awslogs.conf` ファイルを確認して、ファイル名、ロググループ名、日付/時刻の形式を確認します。`ggserror.log` の日付形式と一致する日付/時刻を指定する必要があります。そうしないと、ログストリームは CloudWatch に流れません。 | 

## 関連リソース
<a name="monitor-oracle-goldengate-logs-by-using-amazon-cloudwatch-resources"></a>
+ 「[Amazon CloudWatch ドキュメント](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)」
+ 「[CloudWatch エージェントを使用したメトリクスとログの収集](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html)」
+ 「[Amazon SNS のドキュメント](https://docs.aws.amazon.com/sns/latest/dg/welcome.html)」