Bagikan melalui

Mengelola dan memantau aplikasi dengan Spring Boot Actuator

  • Artikel

Catatan

Azure Spring Apps adalah nama baru untuk layanan Azure Spring Cloud. Meskipun layanan memiliki nama baru, Anda akan melihat nama lama di beberapa tempat untuk sementara saat kami berupaya memperbarui aset seperti cuplikan layar, video, dan diagram.

Artikel ini berlaku untuk: ✔️ Java ❌ C#

Artikel ini berlaku untuk: ✔️ Basic/Standard ✔️ Enterprise

Spring Boot Actuator menghadirkan fitur siap produksi ke aplikasi Anda. Anda dapat dengan mudah memantau aplikasi Anda, mengumpulkan metrik, dan memahami status atau aktivitas database dengan alat ini. Anda mendapatkan akses ke alat tingkat profesional tanpa perlu membangunnya dari awal.

Aktuator mengekspos data operasional penting tentang aplikasi Anda yang sedang berjalan, seperti status kesehatan, metrik, informasi, dan lainnya. Aktuator menggunakan titik akhir HTTP atau Java Management Extensions (JMX), sehingga mudah untuk berinteraksi. Setelah Anda mengintegrasikannya, ini menyediakan beberapa titik akhir default, dan seperti modul Spring lainnya, modul ini mudah dikonfigurasi dan diperluas.

Azure Spring Apps menggunakan aktuator untuk memperkaya metrik melalui JMX. Ini juga dapat bekerja dengan Application Live View dalam paket Enterprise untuk membantu Anda mendapatkan dan berinteraksi dengan data dari aplikasi.

Diagram yang memperlihatkan aliran data menggunakan Spring Boot Actuator.

Mengonfigurasi Spring Boot Actuator

Bagian berikut menjelaskan cara mengonfigurasi aktuator.

Menambahkan dependensi aktuator

Untuk menambahkan aktuator ke proyek berbasis Maven, tambahkan dependensi berikut:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

Konfigurasi ini berfungsi dengan versi Spring Boot apa pun karena versi tercakup dalam Spring Boot Bill of Materials (BOM).

Mengonfigurasi titik akhir aktuator

Secara default, aplikasi Spring Boot hanya mengekspos health titik akhir. Untuk mengamati konfigurasi dan lingkungan yang dapat dikonfigurasi, gunakan langkah-langkah berikut untuk mengaktifkan env titik akhir dan configprops juga:

  1. Buka panel Gambaran Umum aplikasi, pilih Konfigurasi di menu pengaturan, lalu buka halaman Konfigurasi variabel lingkungan.

  2. Tambahkan properti berikut seperti dalam bentuk "key:value". Lingkungan ini membuka titik akhir Spring Actuator berikut: health, , envdan configprops.

    management.endpoints.web.exposure.include: health,env,configprops

  3. Pilih Simpan. Aplikasi Anda dimulai ulang secara otomatis dan memuat variabel lingkungan baru.

Sekarang Anda dapat kembali ke panel Gambaran Umum aplikasi dan menunggu hingga Status Provisi berubah menjadi Berhasil.

Untuk melihat semua konfigurasi bawaan dan terkait titik akhir, lihat bagian Mengekspos Titik Akhir dari Fitur siap Produksi Spring Boot.

Titik akhir aktuator aman

Saat Anda membuka aplikasi ke publik, titik akhir aktuator ini juga diekspos ke publik. Kami menyarankan agar Anda menyembunyikan semua titik akhir dengan mengatur management.endpoints.web.exposure.exclude=*, karena exclude properti lebih diutamakan daripada include properti . Tindakan ini memblokir Tampilan Langsung Aplikasi dalam paket Enterprise dan aplikasi atau alat lain yang mengandalkan titik akhir HTTP aktuator.

Dalam paket Enterprise, ada dua cara untuk mengamankan akses:

  • Anda dapat menonaktifkan titik akhir publik aplikasi dan mengonfigurasi aturan perutean di VMware Spring Cloud Gateway untuk menonaktifkan akses aktuator dari publik. Untuk informasi selengkapnya, lihat Mengonfigurasi VMware Spring Cloud Gateway.

  • Anda dapat mengonfigurasi aktuator untuk mendengarkan pada port HTTP yang berbeda dari aplikasi utama. Dalam aplikasi mandiri, port HTTP aktuator default sama dengan port HTTP utama. Agar aplikasi mendengarkan pada port yang berbeda, atur management.server.port properti . Tampilan Langsung Aplikasi tidak dapat mendeteksi perubahan port ini secara otomatis, jadi Anda juga perlu mengonfigurasi properti pada penyebaran Azure Spring Apps. Kemudian, aktuator tidak dapat diakses secara publik, tetapi Application Live View dapat membaca dari titik akhir aktuator melalui port lain. Untuk informasi selengkapnya, lihat Menggunakan Tampilan Langsung Aplikasi dengan paket Azure Spring Apps Enterprise.

Langkah berikutnya