View a markdown version of this page

Melihat log penerapan untuk lingkungan Elastic Beanstalk - AWS Elastic Beanstalk
Operasi yang didukungIsi logKonsolFile log contoh

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

Melihat log penerapan untuk lingkungan Elastic Beanstalk

Elastic Beanstalk menghasilkan log penerapan untuk setiap penerapan ke lingkungan Anda. Log penerapan memberikan tampilan kronologis yang terkonsolidasi tentang apa yang terjadi selama penerapan, termasuk instalasi dependensi, keluaran build, startup aplikasi, dan kesalahan apa pun yang ditemui. Anda dapat menggunakan log penerapan untuk mendiagnosis penerapan yang gagal dengan cepat tanpa perlu SSH ke dalam instance atau menghubungkan beberapa file log.

Log penyebaran ditulis ke setiap instance secara lokal. Untuk penerapan yang dipicu melalui konsol, CLI, API, atau pembaruan terkelola, satu instance terus mengunggah lognya ke Amazon S3 selama penerapan. Konsol Elastic Beanstalk membaca log dari Amazon S3, sehingga Anda dapat memantau kemajuan tanpa menghubungkan ke instance.

Log penyebaran dirancang agar ringkas. Jika berhasil, log hanya menampilkan pesan ringkasan (misalnya, perintah mana yang dijalankan dan diselesaikan). Pada kegagalan, log mencakup hingga 50 baris output dari langkah gagal, sehingga Anda dapat melihat kesalahan tanpa memilah-milah output verbose.

catatan

Log penyebaran tersedia di Amazon Linux 2 dan Amazon Linux 2023 versi platform yang dirilis pada atau setelah 11 Maret 2026. Platform Windows saat ini tidak didukung.

Operasi yang didukung

Log penyebaran dibuat untuk operasi berikut:

  • Penerapan aplikasi — Menyebarkan versi aplikasi baru ke lingkungan Anda.

  • Pembaruan konfigurasi — Mengubah pengaturan konfigurasi lingkungan yang memerlukan pembaruan instans.

  • Pembuatan lingkungan — Penerapan awal saat Anda membuat lingkungan baru.

  • Mulai ulang server aplikasi — Memulai ulang server aplikasi pada instance Anda.

Operasi yang tidak mengubah status aplikasi atau konfigurasi pada instance, seperti meminta log, menukar, atau memperbarui tag CNAMEs, tidak menghasilkan log penerapan.

Konten log penyebaran

Log penerapan menangkap informasi berikut selama penerapan:

  • Siklus hidup penerapan - Memulai dan menyelesaikan pesan untuk setiap fase penerapan, seperti dan. Starting Application deployment Completed Application deployment

  • .ebextensions output — Pada keberhasilan, nama-nama perintah yang berjalan. Pada kegagalan, 50 baris cfn-init output terakhir untuk membantu mendiagnosis masalah.

  • Output kait platform — Saat sukses, nama-nama skrip kait yang berjalan. Pada kegagalan, 50 baris terakhir dari output hook.

  • Instalasi ketergantungan - Output dari manajer paket sepertinpm install,pip install,composer install, danbundle install. Setelah berhasil, hanya pesan penyelesaian yang dicatat. Pada kegagalan, 50 baris output terakhir disertakan.

  • Build output — Output dari perintah build sepertidocker build,go build, dan build Java. Pada kegagalan, 50 baris output terakhir disertakan.

  • Output startup aplikasi — Output awal dari aplikasi Anda setelah dimulai. Sumbernya tergantung pada platform Anda:

    • Docker - Log kontainer dari docker logs atau docker compose logs

    • Java SE, Go, Node.js, Python, Ruby, .NET - Proses log stdout

    • Tomcat — Keluaran log Catalina

    • PHP - PHP-FPM master dan log kesalahan kolam

    • ECS - Log kontainer dari setiap wadah tugas

    catatan

    Output aplikasi ditangkap mulai 2 detik setelah aplikasi dimulai. Hanya pesan awal startup yang disertakan — jika aplikasi Anda membutuhkan waktu lebih lama untuk menghasilkan output, itu tidak akan muncul di log penerapan. Untuk melihat log aplikasi lengkap, minta log bundel atau sambungkan ke instance secara langsung. Untuk informasi selengkapnya, lihat Tampilkan log instans.

Ketika langkah penerapan gagal, log menandainya dengan [ERROR] dan menyertakan hingga 50 baris output dari langkah yang gagal. Jika log penerapan tidak berisi cukup detail, Anda dapat mengambil log instance lengkap (termasukeb-engine.log,eb-hooks.log, dan log aplikasi) dari tab Log. Untuk informasi selengkapnya, lihat Melihat log dari instans Amazon EC2 di lingkungan Elastic Beanstalk Anda.

Melihat log penerapan di konsol

Konsol Elastic Beanstalk menyediakan tab Deployment di dasbor lingkungan tempat Anda dapat melihat riwayat penerapan dan log.

Melihat riwayat penyebaran

Untuk melihat riwayat penerapan

  1. Buka konsol Elastic Beanstalk, dan di daftar Wilayah, pilih konsol Elastic Beanstalk. Wilayah AWS

  2. Di panel navigasi, pilih Lingkungan, dan kemudian pilih nama lingkungan Anda dari daftar.

  3. Di dasbor lingkungan, pilih tab Deployment.

    Tab Deployments menampilkan tabel penerapan untuk lingkungan. Setiap baris mencakup informasi berikut:

    • Permintaan ID - Pengenal unik untuk penerapan.

    • Status - Berhasil, Gagal, atau Sedang berlangsung.

    • Jenis — Jenis penerapan, seperti Pembuatan Lingkungan, Penerapan Aplikasi, Pembaruan Konfigurasi, Pembaruan Platform Terkelola, Mulai Ulang Server Aplikasi, Membangun Kembali Lingkungan, Memulihkan Lingkungan, Menukar Domain Lingkungan, atau Mengakhiri Lingkungan.

    • Waktu Mulai — Saat penyebaran dimulai.

    • Durasi — Berapa lama waktu yang dibutuhkan untuk menyelesaikan.

Saat penerapan sedang berlangsung, tab secara otomatis melakukan polling untuk pembaruan. Anda juga dapat memilih tombol refresh untuk memuat ulang daftar secara manual.

Melihat detail penerapan dan log

Untuk melihat detail penerapan

  1. Pada tab Deployments, pilih link Request ID untuk penyebaran yang ingin Anda periksa.

  2. Halaman detail penerapan menampilkan bagian ringkasan dengan ID permintaan, status, jenis penerapan, waktu mulai, durasi, dan kebijakan penerapan. Kebijakan penerapan (misalnya, Semua sekaligus, Rolling, Rolling dengan batch tambahan, Immutable, atau Traffic splitting) ditampilkan ketika dapat ditentukan dari peristiwa penerapan.

  3. Di bawah ringkasan, pilih salah satu tab berikut:

    • Peristiwa — Garis waktu peristiwa yang terkait dengan penerapan ini, difilter untuk hanya menampilkan peristiwa untuk penerapan yang dipilih.

    • Log Deployment — Log penerapan terkonsolidasi dari instance. Anda dapat mencari, memfilter berdasarkan level log, dan mengunduh file log.

Untuk penerapan yang sedang berlangsung, tab log secara otomatis menyegarkan untuk menampilkan entri log baru saat ditulis. Setelah penerapan selesai, konsol mengambil status log akhir untuk memastikan Anda melihat output lengkap.

penting

Melihat log penerapan di konsol memerlukan s3:GetObject izin pada bucket elasticbeanstalk-region-account-id penyimpanan Amazon S3 () lingkungan. Jika kebijakan IAM Anda tidak menyertakan izin ini, riwayat penerapan dan peristiwa akan tetap tersedia, tetapi tab log akan menampilkan kesalahan.

File log penyebaran pada instance

Log penyebaran ditulis ke /var/log/deployments/ direktori pada setiap instance. Nama file log tergantung pada bagaimana penerapan dipicu:

  • Penerapan yang dikendalikan alur kerja (dipicu melalui konsol, CLI, atau API) —eb-deployment-request-id.log, di mana request-id ID permintaan penerapan yang unik.

  • Penerapan self-startup (peluncuran instance atau restart server aplikasi) —. eb-deployment-unix-timestamp.log

Elastic Beanstalk secara otomatis memutar file-file ini, menyimpan 50 log penerapan terbaru pada setiap instance.

Untuk penerapan yang dikontrol alur kerja, log diunggah ke Amazon S3 di jalur berikut:

s3://elasticbeanstalk-region-account-id/resources/environments/logs/deployments/environment-id/log-filename

Di lingkungan multi-instance, instance pertama yang mulai mengunggah mengklaim peran untuk seluruh penerapan. Instans itu mengunggah lognya ke Amazon S3 selama durasi penerapan. Semua instance masih menulis log penerapan secara lokal.

penting

Mengunggah log penerapan ke Amazon S3 s3:PutObject memerlukan izin pada bucket penyimpanan Amazon S3 lingkungan di profil instans, dan konfigurasi VPC harus mengizinkan konektivitas ke Amazon S3.

Unggahan log penerapan dibatasi pada 1 MB per file. Jika log penerapan melebihi ukuran ini, versi yang diunggah akan dipotong dengan pesan yang menunjukkan bahwa log lengkap tersedia pada instance.

Menonaktifkan unggahan log S3

Untuk mencegah log penerapan diunggah ke Amazon S3, setel properti lingkungan berikut di lingkungan Anda:

option_settings:
  - namespace:  aws:elasticbeanstalk:application:environment
    option_name:  EB_DEPLOYMENT_LOG_S3_DISABLED
    value:  true

Saat properti lingkungan ini disetel, log penerapan masih ditulis secara lokal /var/log/deployments/ pada setiap instance, tetapi tidak diunggah ke Amazon S3 dan tidak akan tersedia di tab Penerapan konsol. Anda juga dapat mengatur properti ini di halaman Konfigurasi di bawah Perangkat Lunak, atau dengan menggunakan EB AWS CLI CLI atau.