View a markdown version of this page

設定大型主機執行期 （在 Amazon EC2 上） Amazon CloudWatch 警示的 AWS 轉換 - AWS大型主機現代化
啟用 CloudWatch 記錄CloudWatch 記錄的組態CloudWatch 設定警示設定

在仔細考慮之後，我們決定關閉新客戶對AWS大型主機現代化自我管理體驗的存取權，自 2026 年 6 月 30 日起生效。現有客戶可以繼續照常使用 服務。AWS會繼續投資改善AWS Mainframe Modernization 自我管理體驗的安全性和可用性，但我們不打算推出新功能。如需詳細資訊，請參閱AWS大型主機現代化可用性變更。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱AWS大型主機現代化可用性變更。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定大型主機執行期 （在 Amazon EC2 上） Amazon CloudWatch 警示的 AWS 轉換

您可以設定 CloudWatch 來接收應用程式日誌，並新增警示來警告您可能發生的錯誤。這可讓您在部署的應用程式遇到例外狀況時，收到更多可見的通知。下列各節可協助您了解和了解 CloudWatch 記錄和警示設定的組態。

啟用 CloudWatch 記錄

若要啟用 CloudWatch 記錄，請使用下一節提供的組態範本，在組態資料夾中建立logback-cloudwatch.xml檔案。然後，透過取消註解以下幾行，在 檔案中參考此application-main.yml檔案：

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

取消註解這些行後，將啟用 CloudWatch 記錄，並可以進一步設定，如以下章節所述。

CloudWatch 記錄的組態

使用下列範本建立 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。

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 設定

為了讓上述組態正確將日誌推送至 CloudWatch，請更新您的 Amazon EC2 IAM 執行個體描述檔角色，以授予 `BluAgeRuntimeOnEC2-Logs` 日誌群組及其日誌串流的額外許可：

  • logs:CreateLogStream

  • logs:DescribeLogStreams

  • logs:CreateLogGroup

  • logs:PutLogEvents

  • logs:DescribeLogGroups

警示設定

由於 CloudWatch 日誌，您可以根據您的應用程式和需求，設定不同的指標和警示。具體而言，您可以為用量提醒設定主動警示，以便在發生錯誤時警告您的應用程式處於寬限期 （最後防止其完全運作）。若要達成此目的，您可以在日誌中新增有關 "Error C5001" 字串的指標，這會反白顯示與大型主機控制系統 AWS 的 Transform 連線中的錯誤。然後，您可以定義對此指標做出反應的警示。