AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。

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

# メインフレームランタイム (Amazon EC2) Amazon CloudWatch アラームの AWS 変換を設定する
<a name="ba-cw-alarms-ec2"></a>

アプリケーションログを受信するよう CloudWatch を設定し、エラーの可能性を警告するアラームを追加できます。これにより、デプロイされたアプリケーションに例外が発生するたびに、より見やすい通知を表示できます。以下のセクションは、CloudWatch のログ記録とアラームの設定について理解し、学習するのに役立ちます。

## CloudWatch ログ記録を有効にする
<a name="ba-cw-log-deploy"></a>

CloudWatch ログ記録を有効にするには、次のセクションで提供されている設定テンプレートを使用して、設定フォルダに`logback-cloudwatch.xml`ファイルを作成します。次に、次の行のコメントを解除して、 ファイルでこの`application-main.yml`ファイルを参照します。

```
# logging:
#  config: classpath:logback-cloudwatch.xml
```

 これらの行のコメントを解除すると、CloudWatch ログ記録が有効になり、次のセクションで説明するようにさらに設定できます。

## CloudWatch のログ記録の設定
<a name="config-cw-log"></a>

次のテンプレートを使用して `logback-cloudwatch.xml` ファイルを作成します。

```
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration>
<configuration>

    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </encoder>
    </appender>

    <appender name="cloudwatch" class="com.netfective.bluage.runtime.cloudwatchlogger.CloudWatchAppender">
        <logGroup>BluAgeRuntimeOnEC2-Logs</logGroup>
        <logStream>%date{yyyy-MM-dd,UTC}.%instanceId.%uuid</logStream>
        <layout>
            <pattern>%date{yyyy-MM-dd HH:mm:ss.SSS,UTC}  %level --- [%thread{15}] %logger{40} : %msg%n%xThrowable</pattern>
        </layout>
        <appender-ref ref="console" />
    </appender>

    <root level="INFO">
        <appender-ref ref="cloudwatch" />
    </root>
</configuration>
```

<appender name="cloudwatch"/> 要素の外部は、すべて標準的なログバックの設定です。このファイルには、ログをコンソールに送信するコンソールアペンダーと、CloudWatch にログを送信する CloudWatch アペンダーの 2 つのアペンダーがあります。

`root` 要素の `level` 属性は、アプリケーション全体のログ記録レベルを指定します。

タグ <appender name="cloudwatch"/> 内の必須の値は次のとおりです。
+ <logGroup/>: CloudWatch のロググループ名を設定します。値が指定されない場合、デフォルトは `BluAgeRuntimeOnEC2-Logs` になります。ロググループが存在しない場合は、自動的に作成されます。この動作は、次で説明する設定によって変更できます。
+ <logStream/>: CloudWatch の (ロググループ内の) logStream の名前を設定します。

オプションの値: 
+ <region/>: ログストリームが書き込まれるリージョンを無効にします。デフォルトでは、ログは EC2 インスタンスと同じリージョンに送られます。
+ <layout/>: ログメッセージが使用するパターン。
+ <maxbatchsize/>: オペレーションごとに CloudWatch に送信するログメッセージの最大数。
+ <maxbatchtimemillis/>: CloudWatch ログが書き込まれるまでの時間 (ミリ秒単位)。
+ <maxqueuewaittimemillis/>: 内部ログキューにリクエストの挿入を試行する時間 (ミリ秒単位)。
+ <internalqueuesize/>: 内部キューの最大サイズ。
+ <createlogdests/>: 存在しない場合はロググループとログストリームを作成します。
+ <initialwaittimemillis/>: スタートアップ時にスレッドを休止させる時間。この最初の待機時間により、最初にログが蓄積されます。
+ <maxeventmessagesize/>: ログイベントの最大サイズ。このサイズを超えるログは送信されません。
+ <truncateeventmessages/>: 長すぎるメッセージは切り捨てられます。
+ <printrejectedevents/>: 緊急アペンダーを有効にします。

## CloudWatch の設定
<a name="cw-setup"></a>

上記の設定でログを CloudWatch に正しくプッシュするため、Amazon EC2 IAM インスタンスプロファイルロールを更新して、「BluAgeRuntimeOnEC2-Logs」ロググループとそのログストリームに対する追加のアクセス許可を付与します。
+ `logs:CreateLogStream`
+ `logs:DescribeLogStreams`
+ `logs:CreateLogGroup`
+ `logs:PutLogEvents`
+ `logs:DescribeLogGroups`

## アラーム設定
<a name="alarm-setup"></a>

CloudWatch ログにより、アプリケーションやニーズに応じてさまざまなメトリクスやアラームを設定できます。具体的には、使用状況の警告に関するプロアクティブアラームを設定して、アプリケーションが猶予期間に入る (そして最終的にはアプリケーションが動作しなくなる) ようなエラーが発生した場合に警告することができます。これを実現するには、「Error C5001」文字列に関するメトリクスをログに追加できます。これにより、メインフレーム管理システムの AWS 変換への接続のエラーが強調表示されます。その後、このメトリクスに反応するアラームを定義できます。