View a markdown version of this page

Mengatur AWS Transform untuk mainframe Runtime (di Amazon EC2) alarm Amazon CloudWatch - AWS Modernisasi Mainframe
Aktifkan CloudWatch pencatatanKonfigurasi CloudWatch loggingCloudWatch penyiapanPengaturan alarm

AWS Layanan Modernisasi Mainframe (Managed Runtime Environment experience) tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Layanan Modernisasi AWS Mainframe (pengalaman Lingkungan Runtime Terkelola), jelajahi Layanan Modernisasi AWS Mainframe (Pengalaman yang Dikelola Sendiri). Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Untuk informasi selengkapnya, lihat Perubahan AWS ketersediaan Modernisasi Mainframe.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengatur AWS Transform untuk mainframe Runtime (di Amazon EC2) alarm Amazon CloudWatch

Anda dapat mengatur CloudWatch untuk menerima log aplikasi Anda dan menambahkan alarm untuk memperingatkan Anda tentang kemungkinan kesalahan. Ini memungkinkan Anda untuk memiliki notifikasi yang lebih terlihat setiap kali aplikasi yang Anda gunakan menemukan pengecualian. Bagian berikut membantu Anda memahami dan mempelajari tentang konfigurasi CloudWatch pencatatan dan pengaturan alarm.

Aktifkan CloudWatch pencatatan

Untuk mengaktifkan CloudWatch logging, buat logback-cloudwatch.xml file di folder konfigurasi menggunakan templat konfigurasi yang disediakan di bagian berikut. Kemudian, rujuk file ini dalam application-main.yml file dengan menghapus komentar baris berikut:

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

Setelah menghapus komentar baris ini, CloudWatch logging akan diaktifkan dan dapat dikonfigurasi lebih lanjut seperti yang dijelaskan di bagian berikut.

Konfigurasi CloudWatch logging

Gunakan template berikut untuk membuat logback-cloudwatch.xml file:

<?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>

Segala sesuatu di luar <appender name="cloudwatch"/> elemen adalah konfigurasi logback standar. Ada dua appender dalam file ini: appender konsol untuk mengirim log ke konsol dan CloudWatch appender untuk mengirim log ke. CloudWatch

levelAtribut dalam root elemen menentukan tingkat logging dari seluruh aplikasi.

Nilai yang diperlukan di dalam tag <appender name="cloudwatch"/> adalah:

  • <logGroup/>:Menetapkan nama grup log di CloudWatch. Jika nilai tidak ditentukan, defaultnya. BluAgeRuntimeOnEC2-Logs Jika grup log tidak ada maka akan dibuat secara otomatis. Perilaku ini dapat diubah melalui konfigurasi, yang dibahas di bawah ini.

  • <logStream/>: Menetapkan nama LogStream (di dalam grup log) di. CloudWatch

Nilai opsional:

  • <region/>: Mengganti Wilayah tempat aliran log akan ditulis. Secara default, log masuk ke Wilayah yang sama dengan instans EC2.

  • <layout/>: Pola pesan log akan digunakan.

  • <maxbatchsize/>: Jumlah maksimum pesan log untuk dikirim CloudWatch per operasi.

  • <maxbatchtimemillis/>: Waktu dalam milidetik untuk memungkinkan CloudWatch log ditulis.

  • <maxqueuewaittimemillis/>: Waktu dalam milidetik untuk mencoba memasukkan permintaan dalam antrian log internal.

  • <internalqueuesize/>: Ukuran maksimum antrian internal.

  • <createlogdests/>: Buat grup log dan aliran log jika tidak ada.

  • <initialwaittimemillis/>: Jumlah waktu yang Anda inginkan thread untuk tidur saat startup. Penantian awal ini memungkinkan akrual awal log.

  • <maxeventmessagesize/>: Ukuran maksimum peristiwa log. Log yang melebihi ukuran ini tidak akan dikirim.

  • <truncateeventmessages/>: Memutus pesan yang terlalu panjang.

  • <printrejectedevents/>: Aktifkan appender darurat.

CloudWatch penyiapan

Agar konfigurasi di atas dapat mendorong log dengan benar CloudWatch, perbarui peran profil instans Amazon EC2 IAM Anda untuk memberinya izin tambahan untuk grup log `BluAgeRuntimeOnEC2-Logs` dan aliran lognya:

  • logs:CreateLogStream

  • logs:DescribeLogStreams

  • logs:CreateLogGroup

  • logs:PutLogEvents

  • logs:DescribeLogGroups

Pengaturan alarm

Berkat CloudWatch log, Anda kemudian dapat mengonfigurasi metrik dan alarm yang berbeda, tergantung pada aplikasi dan kebutuhan Anda. Secara khusus, Anda dapat mengatur alarm proaktif untuk peringatan penggunaan, agar diperingatkan jika terjadi kesalahan yang mungkin menempatkan aplikasi Anda dalam masa tenggang (dan pada akhirnya, mencegahnya berfungsi sama sekali). Untuk mencapai ini, Anda dapat menambahkan metrik mengenai string “Kesalahan C5001" di log, yang menyoroti kesalahan dalam koneksi ke AWS Transform untuk sistem kontrol mainframe. Anda kemudian dapat menentukan alarm yang bereaksi terhadap metrik ini.