Penyembuhan diri dengan apigee-monit

Apigee Edge untuk Private Cloud mencakup apigee-monit, alat yang didasarkan pada utilitas monit open source. apigee-monit secara berkala melakukan polling pada layanan Edge; jika layanan tidak tersedia, apigee-monit akan mencoba memulai ulang layanan tersebut.

Untuk menggunakan apigee-monit, Anda harus menginstalnya secara manual. Fitur ini bukan bagian dari penginstalan standar.

Secara default, apigee-monit memeriksa status layanan Edge setiap 60 detik.

Mulai cepat

Bagian ini menunjukkan cara cepat menyiapkan dan menjalankan apigee-monit.

Jika Anda menggunakan Amazon Linux atau Oracle-Linux-7.X, instal monit melalui Fedora terlebih dahulu. Jika tidak, lewati langkah ini.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

Untuk menginstal apigee-monit, lakukan langkah-langkah berikut:

  Menginstal apigee-monit
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Tindakan ini akan menginstal apigee-monit dan mulai memantau semua komponen di node secara default.

  Menghentikan pemantauan komponen
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
  Mulai memantau komponen
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all
  Mendapatkan informasi status ringkasan
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  Lihat file log apigee-monit
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Setiap topik ini dan topik lainnya dijelaskan secara mendetail di bagian selanjutnya.

Tentang apigee-monit

apigee-monit membantu memastikan semua komponen di node tetap aktif dan berjalan. Hal ini dilakukan dengan menyediakan berbagai layanan, termasuk:

  • Memulai ulang layanan yang gagal
  • Menampilkan informasi ringkasan
  • Status pemantauan logging
  • Mengirim notifikasi
  • Memantau layanan non-Edge

Apigee merekomendasikan agar Anda memantau apigee-monit untuk memastikan bahwa layanan tersebut berjalan. Untuk mengetahui informasi selengkapnya, lihat Memantau apigee-monit.

Arsitektur apigee-monit

Selama penginstalan dan konfigurasi Apigee Edge untuk Private Cloud, Anda dapat menginstal instance apigee-monit terpisah di setiap node dalam cluster. Setiap instance apigee-monit yang terpisah ini beroperasi secara independen satu sama lain: instance ini tidak mengomunikasikan status komponennya ke node lain, dan juga tidak mengomunikasikan kegagalan utilitas pemantauan itu sendiri ke layanan pusat mana pun.

Gambar berikut menunjukkan arsitektur apigee-monit dalam cluster 5 node:

Arsitektur
  Apigee monit dalam cluster 5 node
Gambar 1: Instance apigee-monit yang terpisah berjalan secara terisolasi di setiap node dalam cluster

Konfigurasi komponen

apigee-monit menggunakan konfigurasi komponen untuk menentukan komponen yang akan dipantau, aspek komponen yang akan diperiksa, dan tindakan yang akan diambil jika terjadi kegagalan.

Secara default, apigee-monit memantau semua komponen Edge pada node menggunakan konfigurasi komponen yang telah ditentukan sebelumnya. Untuk melihat setelan default, Anda dapat melihat file konfigurasi komponen apigee-monit. Anda tidak dapat mengubah konfigurasi komponen default.

apigee-monit memeriksa berbagai aspek komponen, bergantung pada komponen yang diperiksa. Tabel berikut mencantumkan pemeriksaan apigee-monit untuk setiap komponen dan menunjukkan lokasi konfigurasi komponen untuk setiap komponen. Perhatikan bahwa beberapa komponen ditentukan dalam satu file konfigurasi, sedangkan komponen lainnya memiliki konfigurasi sendiri.

Komponen Lokasi konfigurasi Yang dipantau
Server Pengelolaan /opt/apigee/edge-management-server/monit/default.conf apigee-monit pemeriksaan:
  • Port yang ditentukan terbuka dan menerima permintaan
  • Protokol yang ditentukan didukung
  • Status respons

Selain itu, untuk komponen apigee-monit ini:

  • Memerlukan beberapa kegagalan dalam sejumlah siklus tertentu sebelum mengambil tindakan
  • Menetapkan jalur permintaan kustom
Message Processor /opt/apigee/edge-message-processor/monit/default.conf
Server Postgres /opt/apigee/edge-postgres-server/monit/default.conf
Server Qpid /opt/apigee/edge-qpid-server/monit/default.conf
Router /opt/apigee/edge-router/monit/default.conf
Cassandra
Edge UI
SymasLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf apigee-monit pemeriksaan:
  • Layanan sedang berjalan

Contoh berikut menunjukkan konfigurasi komponen default untuk komponen edge-router:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

Contoh berikut menunjukkan konfigurasi default untuk komponen UI Klasik (edge-ui):

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

Hal ini berlaku untuk UI Klasik, bukan UI Edge baru yang nama komponennya adalah edge-management-ui.

Anda tidak dapat mengubah konfigurasi komponen default untuk komponen Apigee Edge untuk Private Cloud. Namun, Anda dapat menambahkan konfigurasi komponen Anda sendiri untuk layanan eksternal, seperti endpoint target atau layanan httpd. Untuk mengetahui informasi selengkapnya, lihat Konfigurasi komponen non-Apigee.

Secara default, apigee-monit memantau semua komponen pada node tempatnya berjalan. Anda dapat mengaktifkan atau menonaktifkannya untuk semua komponen atau untuk setiap komponen. Untuk informasi selengkapnya, lihat:

Instal apigee-monit

apigee-monit tidak diinstal secara default; Anda dapat menginstalnya secara manual setelah mengupgrade atau menginstal Apigee Edge untuk Private Cloud versi 4.19.01 atau yang lebih baru.

Bagian ini menjelaskan cara menginstal apigee-monit.

Untuk mengetahui informasi tentang cara meng-uninstal apigee-monit, lihat Meng-uninstal apigee-monit.

Instal apigee-monit

Bagian ini menjelaskan cara menginstal apigee-monit.

Untuk menginstal apigee-monit:

  1. Instal apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Konfigurasi apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. Mulai apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit start
  4. Ulangi prosedur ini di setiap node dalam cluster Anda.

Menghentikan dan memulai komponen pemantauan

Jika layanan berhenti karena alasan apa pun, apigee-monit akan mencoba memulai ulang layanan.

Hal ini dapat menyebabkan masalah jika Anda ingin menghentikan komponen secara sengaja. Misalnya, Anda mungkin ingin menghentikan komponen saat Anda perlu mencadangkan atau mengupgradenya. Jika apigee-monit memulai ulang layanan selama pencadangan atau upgrade, prosedur pemeliharaan Anda dapat terganggu, sehingga berpotensi menyebabkan kegagalan.

Bagian berikut menunjukkan opsi untuk menghentikan pemantauan komponen.

Menghentikan komponen dan membatalkan pemantauannya

Untuk menghentikan dan membatalkan pemantauan komponen, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name dapat berupa salah satu dari berikut:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (Database PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (SSO Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Server Pengelolaan)
  • edge-management-ui (UI Edge baru)
  • edge-message-processor (Pemroses Pesan)
  • edge-postgres-server (Server Postgres)
  • edge-qpid-server (Server Qpid)
  • edge-router (Router Tepi)
  • edge-ui (UI Klasik)

Perhatikan bahwa "all" bukan opsi yang valid untuk stop-component. Anda hanya dapat menghentikan dan membatalkan pemantauan satu komponen dalam satu waktu dengan stop-component.

Untuk memulai ulang komponen dan melanjutkan pemantauan, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

Perhatikan bahwa "all" bukan opsi yang valid untuk start-component.

Untuk mengetahui petunjuk tentang cara menghentikan dan membatalkan pemantauan semua komponen, lihat Menghentikan semua komponen dan membatalkan pemantauannya.

Berhenti memantau komponen (tetapi jangan menghentikannya)

Untuk menghentikan pemantauan komponen (tetapi tidak menghentikannya), jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name
component_name dapat berupa salah satu dari berikut:
  • apigee-cassandra (Cassandra)
  • apigee-openldap (OpenLDAP)
  • apigee-postgresql (Database PostgreSQL)
  • apigee-qpidd (Qpidd)
  • apigee-sso (SSO Edge)
  • apigee-zookeeper (ZooKeeper)
  • edge-management-server (Server Pengelolaan)
  • edge-management-ui (UI Edge baru)
  • edge-message-processor (Pemroses Pesan)
  • edge-postgres-server (Server Postgres)
  • edge-qpid-server (Server Qpid)
  • edge-router (Router Tepi)
  • edge-ui (UI Klasik)

Untuk melanjutkan pemantauan komponen, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Berhenti memantau semua komponen (tetapi jangan menghentikannya)

Untuk berhenti memantau semua komponen (tetapi tidak menghentikannya), jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Untuk melanjutkan pemantauan semua komponen, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Menghentikan semua komponen dan membatalkan pemantauannya

Untuk menghentikan semua komponen dan membatalkan pemantauannya, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

Untuk memulai ulang semua komponen dan melanjutkan pemantauan, jalankan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Untuk berhenti memantau semua komponen, Anda juga dapat menonaktifkan apigee-monit, seperti yang dijelaskan dalam Menghentikan, memulai, dan menonaktifkan apigee-monit.

Menghentikan, memulai, dan menonaktifkan apigee-monit

Seperti layanan lainnya, Anda dapat menghentikan dan memulai apigee-monit menggunakan perintah apigee-service. Selain itu, apigee-monit mendukung perintah unmonitor, yang memungkinkan Anda menghentikan pemantauan komponen untuk sementara.

Hentikan apigee-monit

Untuk menghentikan apigee-monit, gunakan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

Mulai apigee-monit

Untuk memulai apigee-monit, gunakan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Nonaktifkan apigee-monit

Anda dapat menangguhkan pemantauan semua komponen di node menggunakan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Atau, Anda dapat menonaktifkan apigee-monit secara permanen dengan meng-uninstalnya dari node, seperti yang dijelaskan dalam Meng-uninstal apigee-monit.

Meng-uninstal apigee-monit

Untuk meng-uninstal apigee-monit:

  1. Jika Anda menyiapkan tugas cron untuk memantau apigee-monit, hapus tugas cron sebelum meng-uninstal apigee-monit:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Hentikan apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Uninstal apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Ulangi prosedur ini di setiap node dalam cluster Anda.

Memantau komponen yang baru diinstal

Jika menginstal komponen baru di node yang menjalankan apigee-monit, Anda dapat mulai memantaunya dengan menjalankan perintah restart apigee-monit. Tindakan ini akan menghasilkan file monit.conf baru yang akan menyertakan komponen baru dalam konfigurasi komponennya.

Contoh berikut memulai ulang apigee-monit:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

Menyesuaikan apigee-monit

Anda dapat menyesuaikan berbagai setelan apigee-monit, termasuk:

  1. Setelan kontrol apigee-monit default
  2. Setelan konfigurasi global
  3. Konfigurasi komponen non-Apigee

Setelan kontrol apigee-monit default

Anda dapat menyesuaikan setelan kontrol apigee-monit default seperti frekuensi pemeriksaan status dan lokasi file apigee-monit. Anda dapat melakukannya dengan mengedit file properti menggunakan teknik kode dengan konfigurasi. File properti akan tetap ada meskipun setelah Anda mengupgrade Apigee Edge untuk Private Cloud.

Tabel berikut menjelaskan setelan kontrol apigee-monit default yang dapat Anda sesuaikan:

Properti Deskripsi
conf_monit_httpd_port Port daemon httpd. apigee-monit menggunakan httpd untuk aplikasi dasbornya dan untuk mengaktifkan laporan/ringkasan. Nilai defaultnya adalah 2812.
conf_monit_httpd_allow Batasan pada permintaan ke daemon httpd. apigee-monit menggunakan httpd untuk menjalankan aplikasi dasbornya dan mengaktifkan laporan/ringkasan. Nilai ini harus menunjuk ke localhost (host tempat httpd berjalan).

Untuk mewajibkan permintaan menyertakan nama pengguna dan sandi, gunakan sintaksis berikut:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

Saat menambahkan nama pengguna dan sandi, sisipkan "\n" di antara setiap batasan. Jangan menyisipkan baris baru atau carriage return yang sebenarnya dalam nilai.

conf_monit_monit_datadir Direktori tempat detail acara disimpan.
conf_monit_monit_delay_time Jumlah waktu yang ditunggu apigee-monit setelah pertama kali dimuat ke dalam memori sebelum berjalan. Hal ini hanya memengaruhi apigee-monit pemeriksaan proses pertama.
conf_monit_monit_logdir Lokasi file log apigee-monit.
conf_monit_monit_retry_time Frekuensi apigee-monit mencoba memeriksa setiap proses; defaultnya adalah 60 detik.
conf_monit_monit_rundir Lokasi file PID dan status, yang digunakan apigee-monit untuk memeriksa proses.

Untuk menyesuaikan setelan kontrol apigee-monit default:

  1. Edit file berikut:
    /opt/apigee/customer/application/monit.properties

    Jika file tidak ada, buat file tersebut dan tetapkan pemiliknya ke pengguna "apigee":

    chown apigee:apigee /opt/apigee/customer/application/monit.properties

    Perhatikan bahwa jika file sudah ada, mungkin ada properti konfigurasi tambahan yang ditentukan di dalamnya selain yang tercantum dalam tabel di atas. Anda tidak boleh mengubah properti selain yang tercantum di atas.

  2. Tetapkan atau ganti nilai properti dengan nilai baru Anda.

    Misalnya, untuk mengubah lokasi file log menjadi /tmp, tambahkan atau edit properti berikut:

    conf_monit_monit_logdir=/tmp/apigee-monit.log
  3. Simpan perubahan Anda ke file monit.properties.
  4. Konfigurasi ulang apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Muat ulang apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Jika Anda tidak dapat memulai ulang apigee-monit, periksa file log untuk mengetahui error seperti yang dijelaskan dalam Mengakses file log apigee-monit.

  6. Ulangi prosedur ini untuk setiap node di cluster Anda.

Setelan konfigurasi global

Anda dapat menentukan setelan konfigurasi global untuk apigee-monit; misalnya, Anda dapat menambahkan notifikasi email untuk pemberitahuan. Anda melakukannya dengan membuat file konfigurasi di direktori /opt/apigee/data/apigee-monit, lalu memulai ulang apigee-monit.

Untuk menentukan setelan konfigurasi global untuk apigee-monit:

  1. Buat file konfigurasi komponen baru di lokasi berikut:
    /opt/apigee/data/apigee-monit/filename.conf

    Dengan filename dapat berupa nama file yang valid, kecuali "monit".

  2. Ubah pemilik file konfigurasi baru menjadi pengguna "apigee", seperti yang ditunjukkan contoh berikut:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. Tambahkan setelan konfigurasi global Anda ke file baru. Contoh berikut mengonfigurasi server email dan menetapkan penerima pemberitahuan:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    Untuk mengetahui daftar lengkap opsi konfigurasi global, lihat dokumentasi monit.

  4. Simpan perubahan Anda pada file konfigurasi komponen.
  5. Muat ulang apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Jika apigee-monit tidak dimulai ulang, periksa file log untuk mengetahui error seperti yang dijelaskan dalam Mengakses file log apigee-monit.

  6. Ulangi prosedur ini untuk setiap node di cluster Anda.

Konfigurasi komponen non-Apigee

Anda dapat menambahkan konfigurasi Anda sendiri ke apigee-monit sehingga akan memeriksa layanan yang bukan bagian dari Apigee Edge untuk Private Cloud. Misalnya, Anda dapat menggunakan apigee-monit untuk memeriksa apakah API Anda berjalan dengan mengirimkan permintaan ke endpoint target.

Untuk menambahkan konfigurasi komponen non-Apigee:

  1. Buat file konfigurasi komponen baru di lokasi berikut:
    /opt/apigee/data/apigee-monit/filename.conf

    Dengan filename dapat berupa nama file yang valid, kecuali "monit".

    Anda dapat membuat file konfigurasi komponen sebanyak yang diperlukan. Misalnya, Anda dapat membuat file konfigurasi terpisah untuk setiap komponen non-Apigee yang ingin dipantau di node.

  2. Ubah pemilik file konfigurasi baru menjadi pengguna "apigee", seperti yang ditunjukkan contoh berikut:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. Tambahkan konfigurasi kustom Anda ke file baru. Contoh berikut memeriksa endpoint target di server lokal:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    Untuk mengetahui daftar lengkap setelan konfigurasi yang mungkin, lihat dokumentasi monit.

  4. Simpan perubahan pada file konfigurasi.
  5. Muat ulang apigee-monit dengan perintah berikut:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    Jika apigee-monit tidak dimulai ulang, periksa file log untuk mengetahui error seperti yang dijelaskan dalam Mengakses file log apigee-monit.

  6. Ulangi prosedur ini untuk setiap node di cluster Anda.

Perhatikan bahwa ini hanya untuk komponen non-Edge. Anda tidak dapat menyesuaikan konfigurasi komponen untuk komponen Edge.

Mengakses file log apigee-monit

apigee-monit mencatat semua aktivitas, termasuk peristiwa, mulai ulang, perubahan konfigurasi, dan pemberitahuan dalam file log.

Lokasi default file log adalah:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

Anda dapat mengubah lokasi default dengan menyesuaikan setelan kontrol apigee-monit.

Entri file log memiliki format berikut:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

Anda tidak dapat menyesuaikan format entri file log apigee-monit.

Melihat status gabungan dengan apigee-monit

apigee-monit mencakup perintah berikut yang memberikan informasi status gabungan tentang komponen pada node:

Perintah Penggunaan
report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Setiap perintah ini dijelaskan lebih mendetail di bagian selanjutnya.

laporan

Perintah report memberi Anda ringkasan gabungan tentang jumlah komponen yang aktif, tidak aktif, sedang diinisialisasi, atau saat ini tidak dipantau di sebuah node. Contoh berikut memanggil perintah report:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

Contoh berikut menunjukkan output report pada konfigurasi AIO (all-in-one):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

Dalam contoh ini, 11 dari 12 layanan dilaporkan oleh apigee-monit sebagai aktif. Satu layanan saat ini tidak dipantau.

Anda mungkin mendapatkan error Connection refused saat pertama kali menjalankan perintah report. Jika ini terjadi, tunggu selama durasi properti conf_monit_monit_delay_time, lalu coba lagi.

ringkasan

Perintah summary mencantumkan setiap komponen dan memberikan statusnya. Contoh berikut memanggil perintah summary:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Contoh berikut menunjukkan output summary pada konfigurasi AIO (all-in-one):

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

Jika Anda mendapatkan error Connection refused saat pertama kali menjalankan perintah summary, coba tunggu durasi properti conf_monit_monit_delay_time, lalu coba lagi.

Memantau apigee-monit

Praktik terbaiknya adalah memeriksa secara rutin bahwa apigee-monit berjalan di setiap node.

Untuk memeriksa apakah apigee-monit berjalan, gunakan perintah berikut:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee merekomendasikan agar Anda mengeluarkan perintah ini secara berkala di setiap node yang menjalankan apigee-monit. Salah satu cara untuk melakukannya adalah dengan utilitas seperti cron yang menjalankan tugas terjadwal pada interval yang telah ditentukan sebelumnya.

Untuk menggunakan cron guna memantau apigee-monit:

  1. Tambahkan dukungan cron dengan menyalin direktori apigee-monit.cron ke direktori /etc/cron.d, seperti yang ditunjukkan contoh berikut:
    cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
  2. Buka file apigee-monit.cron untuk mengeditnya.

    File apigee-monit.cron menentukan tugas cron yang akan dijalankan serta frekuensi tugas tersebut akan dijalankan. Contoh berikut menunjukkan nilai default:

    # Cron entry to check if monit process is running. If not start it
    */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

    File ini menggunakan sintaksis berikut, dengan lima kolom pertama menentukan waktu saat apigee-monit menjalankan tindakannya:

    min hour day_of_month month day_of_week task_to_execute

    Misalnya, waktu eksekusi default adalah */2 * * * *, yang menginstruksikan cron untuk memeriksa proses apigee-monit setiap 2 menit.

    Anda tidak dapat menjalankan tugas cron lebih dari sekali per menit.

    Untuk mengetahui informasi selengkapnya tentang cara menggunakan cron, lihat dokumentasi atau halaman manual OS server Anda.

  3. Ubah setelan cron agar sesuai dengan kebijakan organisasi Anda. Misalnya, untuk mengubah frekuensi eksekusi menjadi setiap 5 menit, tetapkan definisi tugas ke berikut ini:
    */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
  4. Simpan file apigee-monit.cron.
  5. Ulangi prosedur ini untuk setiap node di cluster Anda.

Jika cron tidak mulai menonton apigee-monit, periksa apakah:

  • Ada baris kosong setelah definisi tugas cron.
  • Hanya ada satu tugas cron yang ditentukan dalam file. (Baris yang diberi komentar tidak dihitung.)

Jika Anda ingin menghentikan atau menonaktifkan apigee-monit untuk sementara, Anda juga harus menonaktifkan tugas cron ini, jika tidak, cron akan memulai ulang apigee-monit.

Untuk menonaktifkan cron, lakukan salah satu tindakan berikut:

  • Hapus file /etc/cron.d/apigee-monit.cron:
    sudo rm /etc/cron.d/apigee-monit.cron

    Anda harus menyalinnya lagi jika nantinya ingin mengaktifkan kembali cron untuk menonton apigee-monit.

    ATAU

  • Edit file /etc/cron.d/apigee-monit.cron dan jadikan definisi tugas sebagai komentar dengan menambahkan "#" di awal baris; misalnya:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit