Pencatatan dan pemberitahuan Tag informasi CloudWatch Kueri Wawasan Log Dasbor wawasan operasional Monitoring EventBridge Acara

Pantau solusinya

Pencatatan dan pemberitahuan

Penjadwal Instance menggunakan pencatatan terstruktur yang dioptimalkan untuk kueri Wawasan CloudWatch Log. Solusi ini mencatat informasi pemrosesan untuk setiap instance yang ditandai, hasil evaluasi periode untuk instance, status instans yang diinginkan selama periode tersebut, tindakan yang diterapkan, dan pesan debugging.

Log ditulis ke Amazon CloudWatch Logs dalam dua grup log:

{stackName}-{namespace}-administrative-logs: Log untuk pendaftaran dan deregistrasi sumber daya, operasi sumber daya khusus, permintaan CLI, dan kegiatan administratif lainnya.
{stackName}-{namespace}-scheduling-logs: Log untuk penjadwalan operasi termasuk orkestrasi dan eksekusi penangan permintaan.

Log peringatan dan kesalahan juga diteruskan ke topik Amazon SNS yang dibuat solusi, yang dapat dikonfigurasi untuk mengirim pesan ke alamat email berlangganan. Anda dapat menemukan nama topik Amazon SNS di tab Output dari tumpukan solusi.

Tag informasi

Saat penandaan informasi diaktifkan (default), Penjadwal Instance menulis tag langsung ke sumber daya terkelola untuk memberikan at-a-glance visibilitas ke aktivitas penjadwalan solusi. Tag ini diterapkan menggunakan AWS Resource Groups Tagging API dan diperbarui setiap kali penjadwal memproses sumber daya.

Anda dapat mengaktifkan atau menonaktifkan fitur ini menggunakan parameter Aktifkan penandaan informasi pada tumpukan hub. Untuk informasi selengkapnya, lihat Perbarui pengaturan konfigurasi global.

Kunci tag informasi

Tag berikut ditulis ke sumber daya yang dikelola:

Tombol tanda	Deskripsi
`IS-ManagedBy`	ARN dari stack hub Penjadwal Instance yang mengelola sumber daya ini. Diterapkan ketika sumber daya pertama kali terdaftar untuk penjadwalan dan pada setiap tindakan penjadwalan berikutnya.
`IS-LastAction`	Tindakan penjadwalan terakhir yang diambil pada sumber daya, bersama dengan stempel waktu UTC. Misalnya: `Started 2025-06-15 09:00:00 UTC` atau `Stopped 2025-06-15 17:00:00 UTC`. Tag ini hanya diperbarui ketika penjadwal secara aktif memulai atau menghentikan sumber daya (bukan saat mengevaluasi sumber daya dan menentukan tidak ada tindakan yang diperlukan).
`IS-Error`	Jika penjadwal mengalami kesalahan saat memproses sumber daya, tag ini berisi kode kesalahan dan stempel waktu UTC. Sebagai contoh: `StartFailed 2025-06-15 09:00:05 UTC`. Tag ini secara otomatis dihapus pada tindakan penjadwalan berikutnya yang berhasil.
`IS-ErrorMessage`	Deskripsi kesalahan yang dapat dibaca manusia. Tag ini hanya ada ketika juga `IS-Error` ada dan dihapus di sampingnya.

Kode eror

Kode kesalahan berikut mungkin muncul di IS-Error tag:

Kode kesalahan	Deskripsi
`UnknownSchedule`	Nama jadwal yang ditentukan dalam tag jadwal sumber daya tidak cocok dengan jadwal apa pun yang ditentukan dalam tabel konfigurasi.
`UnsupportedResource`	Jenis sumber daya tidak didukung untuk penjadwalan (misalnya, replika baca instance RDS lain).
`IncompatibleSchedule`	Jadwal yang ditetapkan ke sumber daya tidak kompatibel dengan jenis sumber daya (misalnya, jadwal ASG yang menggunakan ekspresi cron yang tidak didukung).
`StartFailed`	Penjadwal mencoba untuk memulai sumber daya tetapi operasi gagal.
`StopFailed`	Penjadwal berusaha menghentikan sumber daya tetapi operasi gagal.
`ConfigurationFailed`	Penjadwal mencoba mengonfigurasi aturan penskalaan terjadwal pada grup Auto Scaling tetapi operasi gagal.
`UnknownError`	Terjadi kesalahan tak terduga saat memproses sumber daya.

Perilaku tag

Ketika sumber daya pertama kali terdaftar untuk penjadwalan, IS-ManagedBy tag diterapkan segera.
Ketika sumber daya dideregistrasi (tag jadwal dihapus), semua tag informasi (IS-ManagedBy,, IS-LastActionIS-Error,IS-ErrorMessage) dihapus dari sumber daya.
Tag kesalahan tidak ditulis ulang pada setiap interval penjadwalan jika kesalahan yang sama berlanjut dan tag yang ada masih ada di sumber daya. Mereka hanya diperbarui ketika kode kesalahan berubah.
Semua nilai tag dipotong menjadi 256 karakter untuk mematuhi batas penandaan AWS.

Tandai pertimbangan tata kelola

penting

Penjadwal Instance membuat dan memperbarui tag yang tercantum di atas pada sumber daya terkelola sebagai bagian dari operasi normal. Jika organisasi Anda memberlakukan tata kelola tag melalui aturan AWS Config, kebijakan tag, kebijakan kontrol layanan, atau remediasi otomatis, pastikan bahwa kontrol manajemen perubahan Anda dikonfigurasi untuk mengizinkan kunci tag berikut:

IS-ManagedBy
IS-LastAction
IS-Error
IS-ErrorMessage
IS-PreferredInstanceTypes(jika menggunakan tipe instance alternatif)
IS-MinDesiredMax(jika menjadwalkan grup Auto Scaling)

Jika Anda tidak dapat mengakomodasi tag ini dalam kebijakan tata kelola, nonaktifkan penandaan informasi dengan menyetel parameter Aktifkan penandaan informasi ke No tumpukan hub. Perhatikan bahwa ini juga akan menonaktifkan IS-ManagedBy tag yang digunakan untuk mengonfirmasi pendaftaran sumber daya.

Tag kontrol

Selain tag informasi, Penjadwal Instance menggunakan tag kontrol berikut untuk fitur tertentu:

Tombol tanda	Deskripsi
`IS-PreferredInstanceTypes`	Daftar tipe instans EC2 alternatif yang dipisahkan koma untuk dicoba saat memulai instance gagal karena kapasitas yang tidak mencukupi. Untuk informasi selengkapnya, lihat Menangani Kesalahan Kapasitas Tidak Cukup EC2.
`IS-MinDesiredMax`	Nilai kapasitas minimum, yang diinginkan, dan maksimum untuk grup Auto Scaling dalam format. `min,desired,max` Untuk informasi selengkapnya, lihat Penjadwalan Grup EC2 Auto Scaling.

Kapasitas tag

penting

Sumber daya AWS biasanya memiliki batas 50 tag per sumber daya. Penjadwal Instance dapat menggunakan hingga 6 tag pada sumber daya (4 tag informasi ditambah hingga 2 tag kontrol). Pastikan sumber daya Anda memiliki kapasitas tag yang cukup untuk mengakomodasi tag Penjadwal Instance bersama strategi penandaan yang ada.

Jika sumber daya berada pada atau mendekati batas 50 tag, penulisan tag informasi mungkin gagal. Penjadwal mencatat kegagalan ini tetapi melanjutkan operasi penjadwalan. Periksa CloudWatch Log jika Anda mencurigai masalah penandaan.

CloudWatch Kueri Wawasan Log

Format logging terstruktur Instance Scheduler memungkinkan kueri yang efisien menggunakan Wawasan CloudWatch Log. Anda dapat menggunakan Wawasan Log untuk mencari, menganalisis, dan memvisualisasikan data log guna memecahkan masalah operasional dan memantau aktivitas penjadwalan.

Penjadwal Instance menyediakan kueri log yang telah diformat sebelumnya yang dapat Anda akses dari bagian Kueri Tersimpan di konsol Log: CloudWatch

SchedulingHistory: Tindakan penjadwalan kueri yang dilakukan pada sumber daya, termasuk memulai dan menghentikan operasi.
RegistrationEvents: Permintaan pendaftaran sumber daya dan acara deregistrasi.
Errors: Log kesalahan kueri untuk memecahkan masalah dengan solusinya.

Untuk informasi selengkapnya tentang Wawasan CloudWatch Log, lihat Menganalisis data CloudWatch log dengan Wawasan Log di Panduan Pengguna CloudWatch Log Amazon.

Dasbor wawasan operasional

Dasbor Operational Insights memberikan visibilitas ke dalam kinerja solusi dan penghematan biaya dari manajemen instans terjadwal.

Untuk mengakses dasbor, pastikan Pemantauan Operasional diatur ke “diaktifkan” di parameter tumpukan hub. Arahkan ke CloudWatch dan pilih “Dasbor” dari menu navigasi. Nama dasbornya adalah * {stack-name} -Operational-Insights-Dashboard*.

Dasbor menampilkan jumlah instans terkelola, jam berjalan yang disimpan, dan metrik kinerja fungsi Lambda.

Ikhtisar dasbor wawasan operasional

catatan

Informasi dalam grafik ini tergantung pada interval penjadwalan yang dikonfigurasi pada tumpukan hub solusi. Saat memperbarui interval penjadwalan solusi, dasbor hanya akan menampilkan metrik penjadwalan dari setelah pembaruan terbaru hingga interval penjadwalan.

Pantau waktu eksekusi Lambda untuk memastikan kinerja optimal (lihat Kuota). Jika waktu eksekusi secara konsisten mendekati ambang batas waktu, pertimbangkan untuk meningkatkan properti ukuran Lambda atau menerapkan Penjadwal Instance ke wilayah dengan latensi lebih rendah ke wilayah terkelola Anda.

Metrik Lambda menunjukkan durasi dan jumlah kesalahan

Biaya tambahan yang terkait dengan fitur ini

Dasbor operasional ini didukung oleh CloudWatch metrik khusus yang dikumpulkan oleh solusi yang akan dikenakan biaya tambahan. Fitur ini dapat dimatikan dengan menonaktifkan “Pemantauan Operasional” pada tumpukan hub solusi. Fitur ini dikenakan biaya tambahan $3.00/bulan ditambah biaya penskalaan tambahan berdasarkan ukuran penerapan Anda. Biayanya adalah sebagai berikut:

CloudWatch Dasbor Kustom	$3
Per-instance-type metrik	$0,90 per jenis instance*
Penggunaan API	~$0,10 per target aktif**

*Biaya ini dilacak per kategori layanan (EC2/RDS) dan hanya untuk jenis contoh yang benar-benar digunakan untuk penjadwalan.

Monitoring EventBridge Acara

Penjadwal Instans menerbitkan acara penjadwalan dan pendaftaran ke bus EventBridge acara untuk memberikan visibilitas ke dalam operasi solusi dan memungkinkan integrasi dengan layanan AWS lainnya.

Tipe peristiwa

Solusinya menerbitkan dua kategori acara utama:

Acara penjadwalan: Diterbitkan saat Penjadwal Instance mengambil tindakan untuk memulai, menghentikan, atau mengonfigurasi sumber daya terkelola. Peristiwa ini mencakup detail tentang instance, jadwal, dan tindakan yang diambil. mulai, hentikan, atau konfigurasikan sumber daya terkelola. Peristiwa ini mencakup rincian tentang contoh, jadwal, dan tindakan yang diambil.

Acara pendaftaran: Diterbitkan ketika sumber daya terdaftar atau tidak terdaftar untuk penjadwalan berdasarkan operasi penandaan.

Tujuan peristiwa

IS- bus LocalEvents acara: Bus IS-LocalEvents acara dikerahkan di setiap wilayah yang dikelola dari setiap akun anggota (termasuk akun hub). Setiap bus menerima acara untuk tindakan penjadwalan dan pendaftaran sumber daya di wilayah tersebut.

IS- bus GlobalEvents acara: Bus IS-GlobalEvents acara di akun hub menerima salinan dari setiap acara yang dikirim ke bus IS-LocalEvents acara apa pun, menyediakan pemantauan terpusat di semua akun dan wilayah.

Menggunakan EventBridge acara

Anda dapat membuat EventBridge aturan untuk:

Pantau operasi penjadwalan di seluruh infrastruktur Anda
Memicu pemberitahuan saat instance dimulai atau dihentikan
Integrasikan dengan layanan AWS lainnya untuk alur kerja otomatis
Menerapkan pemantauan dan peringatan kepatuhan

Struktur peristiwa

Semua acara menggunakan EventBridge format standar. Contoh berikut menunjukkan struktur untuk setiap jenis acara:

Acara penjadwalan:


{
  "Source": "instance-scheduler",
  "DetailType": "Scheduling Action",
  "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"],
  "Detail": {
    "account": "123456789012",
    "region": "us-east-1",
    "service": "ec2",
    "resource_id": "i-1234567890abcdef0",
    "requested_action": "Start",
    "action_taken": "Started",
    "schedule": "office-hours"
  }
}

Acara pendaftaran:


{
  "Source": "instance-scheduler",
  "DetailType": "Resource Registered",
  "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"],
  "Detail": {
    "account": "123456789012",
    "region": "us-east-1",
    "service": "ec2",
    "resource_id": "i-1234567890abcdef0",
    "schedule": "office-hours"
  }
}

Setiap acara berisi bidang-bidang kunci ini:

Source- Mengidentifikasi sumber acara sebagai “instance-scheduler”
DetailType- Menentukan kategori acara: “Penjadwalan Tindakan” untuk operasi contoh atau “Sumber Daya Terdaftar” untuk menandai peristiwa
Resources- Array yang berisi sumber daya AWS yang terpengaruh ARNs
Detail- Berisi muatan acara dengan ID akun, wilayah, jenis layanan (ec2/rds), ID sumber daya, nama jadwal, dan untuk acara penjadwalan, baik tindakan yang diminta maupun hasil aktual

requested_actionNilai yang mungkin untuk acara penjadwalan:

Start: Scheduler dimaksudkan untuk memulai instance
Stop: Scheduler dimaksudkan untuk menghentikan instance
Configure: Scheduler dimaksudkan untuk mengkonfigurasi instance

action_takenNilai yang mungkin untuk acara penjadwalan:

Started: Instance dimulai
Stopped: Instance dihentikan
Hibernated: Instance hibernasi
Configured: Konfigurasi instance telah dimodifikasi
Error: Terjadi kesalahan selama operasi penjadwalan

Membuat EventBridge aturan

Untuk memantau peristiwa Penjadwal Instance:

Arahkan ke EventBridge konsol di akun AWS Anda
Buat aturan baru yang menargetkan bus IS-GlobalEvents acara (untuk pemantauan terpusat) atau bus IS-LocalEvents acara (untuk pemantauan lokal)
Tentukan pola acara agar sesuai dengan peristiwa Penjadwal Instance
Konfigurasikan target seperti topik SNS, fungsi Lambda, atau Log CloudWatch

Untuk informasi lebih lanjut tentang EventBridge, lihat Apa itu Amazon EventBridge? di Panduan EventBridge Pengguna Amazon.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Penjadwalan Grup Penskalaan Otomatis EC2

Pemecahan masalah