Periksa aplikasi yang mengalami error untuk menemukan error menggunakan Error Reporting

Periksa aplikasi yang mengalami error untuk menemukan error menggunakan Error Reporting

Error Reporting menyediakan satu tempat untuk memantau kondisi error dari semua aplikasi dan layanan dalam project Google Cloud serta dari aplikasi Amazon Elastic Compute Cloud (EC2).

Dalam panduan ini, kita akan mempelajari cara melakukan hal berikut:

1. Menyimulasikan error dari layanan di project Google Cloud.

2. Gunakan Error Reporting untuk melihat error dan mengubah status error agar orang lain di tim Anda tahu bahwa masalah tersebut sedang ditangani.

3. Siapkan notifikasi agar Anda mengetahui saat jenis error baru terjadi.

---

Jika ingin mengikuti panduan langkah demi langkah untuk tugas ini langsung di Konsol Google Cloud, klik Pandu saya:

Pandu saya

---

Sebelum memulai

1. Login ke akun Google Cloud Anda. Jika Anda baru menggunakan Google Cloud, buat akun untuk mengevaluasi performa produk kami dalam skenario dunia nyata. Pelanggan baru juga mendapatkan kredit gratis senilai $300 untuk menjalankan, menguji, dan men-deploy workload.

2. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

3. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

4. Di konsol Google Cloud, pada halaman pemilih project, pilih atau buat project Google Cloud.

   Catatan: Jika tidak berencana untuk menyimpan resource yang Anda buat dalam prosedur ini, buatlah project, bukan memilih project yang ada. Setelah menyelesaikan langkah ini, Anda dapat menghapus project, yang menghapus semua resource yang terkait dengan project ini.

   Buka pemilih project

5. Pastikan penagihan telah diaktifkan untuk project Google Cloud Anda.

6. Buka Cloud Shell untuk project Google Cloud Anda. Saat dimulai, pesan Connecting akan ditampilkan.

   Buka Cloud Shell.

Membuat simulasi error

1. Untuk menghasilkan 11 contoh error, jalankan skrip berikut di Cloud Shell:

     COUNTER=0
     while [  $COUNTER -lt 11 ]; do
         gcloud beta error-reporting events report --service tutorial --service-version v$((COUNTER/10+1)) \
             --message "java.lang.RuntimeException: Error rendering template $COUNTER
               at com.example.TestClass.test(TestClass.java:51)
               at com.example.AnotherClass(AnotherClass.java:25)
               at javax.servlet.http.HttpServlet.service (HttpServlet.java:617)
               at javax.servlet.http.HttpServlet.service (HttpServlet.java:717)"
         if [ $COUNTER -eq 10 ]; then
           echo "All sample errors reported."
         fi
         let COUNTER=COUNTER+1
     done
   

   Setelah selesai menghasilkan semua error, skrip akan mencetak baris berikut:

   All sample errors reported.

Lihat error di Error Reporting

1. Di panel navigasi konsol Google Cloud, pilih Error Reporting, lalu pilih project Google Cloud Anda:

   Buka Error Reporting

   Dasbor Error Reporting menampilkan daftar ringkasan setiap error yang ditemukan dan jumlah kemunculan dari setiap error. Jika Auto reload diaktifkan, Error Reporting akan otomatis memuat ulang daftar error setiap 10 detik.

   Screenshot berikut menunjukkan contoh halaman pelaporan error:

   

2. Klik nama error untuk melihat halaman detail error, yang berisi semua informasi yang tersedia tentang error. Jika Gemini diaktifkan di project, Anda dapat menggunakan Gemini untuk mendapatkan saran pemecahan masalah.

Mengonfigurasi notifikasi

Anda dapat mengonfigurasi Error Reporting untuk memberi tahu Anda saat jenis error baru muncul. Notifikasi tidak dikirim saat terjadi error baru yang sudah ada:

1. Di panel navigasi konsol Google Cloud, pilih Error Reporting, lalu pilih project Google Cloud Anda:

   Buka Error Reporting

2. Untuk mengaktifkan notifikasi email, klik More lalu pilih Turn on new error notifications for project dari menu drop-down.

3. Untuk menghasilkan jenis error baru, klik Activate Cloud Shell dan jalankan skrip berikut:

     COUNTER=0
     while [ $COUNTER -lt 3 ]; do
           gcloud beta error-reporting events report --service tutorial --service-version v1 \
               --message "java.lang.ArrayIndexOutOfBoundsException: $COUNTER
                 at com.example.AppController.createUser(AppController.java:42)
                 at com.example.User(User.java:31)
                 at javax.servlet.http.HttpServlet.service (HttpServlet.java:617)
                 at javax.servlet.http.HttpServlet.service (HttpServlet.java:717)"
         if [ $COUNTER -eq 10 ]; then
           echo "All sample errors reported."
         fi
         let COUNTER=COUNTER+1
     done
   

   Setelah selesai menghasilkan semua error, skrip akan mencetak baris berikut:

   All sample errors reported.

4. Periksa email Anda untuk melihat pesan dari "Stackdriver Notifications".

Membuat pesan error dari aplikasi App Engine

Meskipun pesan contoh yang Anda buat dari skrip sepenuhnya menyimulasikan kondisi error di Error Reporting, jika Anda ingin membuat error dari layanan sebenarnya yang berjalan di project Google Cloud, ikuti langkah-langkah di bagian ini.

Men-deploy aplikasi

Untuk mendownload dan men-deploy aplikasi ke App Engine, lakukan hal berikut:

1. Download dan konfigurasi aplikasi dari project GitHub python-docs-samples:

   1. Clone project ke Cloud Shell Anda:

      git clone https://github.com/GoogleCloudPlatform/python-docs-samples
      

      Git menampilkan pesan yang mirip dengan ini:

      git clone https://github.com/GoogleCloudPlatform/python-docs-samples
      Cloning into 'python-docs-samples'...
      

   2. Buat lingkungan Python yang terisolasi, lalu aktifkan:

      cd python-docs-samples/appengine/standard_python3/hello_world
      virtualenv env -p python3
      source env/bin/activate
      

   3. Instal dependensi:

      pip install -r requirements.txt
      

2. Pastikan penginstalan dan konfigurasi aplikasi berhasil:

   1. Jalankan aplikasi:

      python main.py
      

   2. Untuk melihat aplikasi di halaman web lokal, klik link yang ditampilkan di Cloud Shell. Halaman web menampilkan Hello World!.

   3. Untuk menghentikan aplikasi yang berjalan, masukkan Ctrl-C di Cloud Shell.

3. Upload aplikasi Anda ke App Engine:

   gcloud app deploy
   

   Jika diminta untuk memasukkan region deployment, pilih region di dekat Anda. Masukkan Y saat ditanya apakah Anda ingin melanjutkan. Setelah beberapa saat, upload selesai.

4. Lihat aplikasi Anda di browser dengan menjalankan perintah berikut di Cloud Shell:

   gcloud app browse
   

   Jika Google Cloud CLI tidak dapat menemukan browser Anda, perintah sebelumnya akan menampilkan pesan error dan link. Klik link yang ditampilkan. Pesan Hello, World! ditampilkan di browser.

Membuat error

Untuk membuat error yang dideteksi dan ditampilkan Error Reporting, lakukan langkah berikut:

1. Edit main.py dan ubah

   return 'Hello World!
   

   pada

   return 'Hello World!' + 1000
   

   Saat dijalankan, perubahan ini akan menyebabkan pengecualian TypeError Python karena menggabungkan string dan bilangan bulat adalah tindakan ilegal.

2. Upload aplikasi yang diubah ke App Engine:

   gcloud app deploy
   

3. Kembali ke tab browser yang berisi aplikasi yang berjalan, lalu muat ulang halaman. Karena perubahan Anda, halaman yang menampilkan Hello, World! akan menampilkan pesan error:

   Internal Server Error
   The server encountered an internal error and was unable to complete your
   request. Either the server is overloaded or there is an error in the
   application.
   

   Jika Anda tidak melihat pesan ini, tunggu sebentar dan muat ulang lagi. Mungkin perlu waktu beberapa saat sebelum versi baru diaktifkan.

Lihat error di Error Reporting

Untuk melihat error, ikuti petunjuk di bagian sebelumnya Melihat error di Error Reporting.

Pembersihan

Agar tidak menimbulkan biaya pada akun Google Cloud Anda untuk resource yang digunakan pada halaman ini, ikuti langkah-langkah berikut.

Perhatian: Menghapus project memiliki efek berikut:
• Semua hal dalam project akan dihapus. Jika menggunakan project yang sudah ada untuk tugas dalam dokumen ini, saat Anda menghapusnya, pekerjaan lain yang telah Anda lakukan dalam project tersebut juga akan terhapus.
• Project ID kustom hilang. Saat membuat project ini, Anda mungkin telah membuat project ID kustom yang ingin digunakan di masa mendatang. Untuk mempertahankan URL yang menggunakan project ID, seperti URL appspot.com, hapus resource yang dipilih di dalam project, bukan menghapus seluruh project.
1. Di konsol Google Cloud, buka halaman Manage resource.

   Buka Manage resource

2. Pada daftar project, pilih project yang ingin Anda hapus, lalu klik Delete.
3. Pada dialog, ketik project ID, lalu klik Shut down untuk menghapus project.

Langkah selanjutnya

• Pelajari lebih lanjut cara melihat error

• Pelajari lebih lanjut cara mengelola error