設定 AWS Blu Age Runtime （在 Amazon EC2 上） Amazon CloudWatch 警示 - AWS 大型主機現代化
部署 CloudWatch 記錄CloudWatch 記錄的組態CloudWatch 設定警示設定

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

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

設定 AWS Blu Age Runtime （在 Amazon EC2 上） Amazon CloudWatch 警示

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

部署 CloudWatch 記錄

根據預設， AWS Blu Age Runtime 包含名為 的記錄檔案logback-cloudwatch.yml。此檔案會在 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 日誌，您可以根據您的應用程式和需求，設定不同的指標和警示。具體而言，您可以為用量提醒設定主動警示，以便在錯誤可能導致應用程式處於寬限期時收到警告 （最後防止其完全運作）。若要達成此目的，您可以在 日誌中新增有關「錯誤 C5001」字串的指標，這會反白連線至 AWS Blu Age 控制系統的錯誤。然後，您可以定義對此指標做出反應的警示。