Cara memantau

Dokumen ini menjelaskan teknik pemantauan komponen yang didukung oleh deployment Apigee Edge lokal.

Ringkasan

Edge mendukung beberapa cara untuk mendapatkan detail tentang layanan serta memeriksa statusnya. Tabel berikut mencantumkan jenis pemeriksaan yang dapat Anda lakukan pada setiap layanan yang memenuhi syarat:

Mgmt API
Layanan Penggunaan Memori [JMX*] Pemeriksaan Layanan Status Pengguna/Organisasi/ Deployment axstatus Pemeriksaan database Status apigee-service apigee-monit**
Server Pengelolaan
Message Processor
Postgres
Qpid
Router
Info Selengkapnya Info Selengkapnya Info Selengkapnya Info Selengkapnya Info Selengkapnya Info Selengkapnya Info Selengkapnya

* Sebelum dapat menggunakan JMX, Anda harus mengaktifkannya, seperti yang dijelaskan dalam Mengaktifkan JMX.

** Layanan apigee-monit memeriksa apakah komponen aktif dan akan mencoba memulai ulang jika tidak aktif. Untuk mengetahui informasi selengkapnya, lihat Perbaikan mandiri dengan apigee-monit.

Port pemantauan JMX dan Management API

Setiap komponen mendukung panggilan pemantauan JMX dan Management API pada port yang berbeda. Tabel berikut mencantumkan port JMX dan Management API untuk setiap jenis server:

Komponen Port JMX Port Management API
Server Pengelolaan 1099 8080
Router 1100 8081
Message Processor 1101 8082
Qpid 1102 8083
Postgres 1103 8084

Menggunakan JMX untuk memantau

Proses pemantauan untuk Server Pengelolaan, Message Processor, Qpid, dan Postgres semuanya menggunakan JMX. Namun, JMX diaktifkan secara default hanya untuk Cassandra, dan dinonaktifkan secara default untuk semua komponen Edge lainnya. Oleh karena itu, Anda harus mengaktifkan JMX satu per satu untuk setiap komponen sebelum dapat memantaunya.

Autentikasi JMX tidak diaktifkan secara default. Anda dapat mengaktifkan autentikasi JMX untuk semua komponen. Untuk Cassandra, gunakan petunjuk di Mengaktifkan autentikasi JMX untuk Cassandra.

Mengaktifkan JMX

JMX diaktifkan secara default hanya untuk Cassandra, dan dinonaktifkan secara default untuk semua komponen Edge lainnya. Bagian ini menjelaskan cara mengaktifkan JMX untuk komponen Edge lainnya.

Untuk mengaktifkan JMX:

  1. Edit file konfigurasi komponen. File ini terletak di opt/apigee/edge-component_name/bin/start. Dalam lingkungan produksi, file konfigurasi ini akan berada di mesin yang berbeda.

    Pilih dari lokasi file berikut di setiap server:

    • Server Pengelolaan: /opt/apigee/edge-management-server/bin/start
    • Message Processor: /opt/apigee/edge-message-processor/bin/start
    • Postgres: /opt/apigee/edge-postgres-server/bin/start
    • Qpid: /opt/apigee/edge-qpid-server/bin/start
    • Router: /opt/apigee/edge-router/bin/start

    Misalnya, file konfigurasi Server Pengelolaan di servernya berada di /opt/apigee/edge-management-server/bin/start.

  2. Tambahkan opsi com.sun.management.jmxremote berikut ke baris exec yang memulai komponen: 
    -Dcom.sun.management.jmxremote \
  -Dcom.sun.management.jmxremote.port=port_number \
  -Dcom.sun.management.jmxremote.local.only=false \
  -Dcom.sun.management.jmxremote.authenticate=false \
  -Dcom.sun.management.jmxremote.ssl=false

    Dengan port_number adalah port JMX untuk layanan. Untuk mendapatkan nomor port JMX layanan Anda, lihat Port pemantauan JMX dan Management API.

    Misalnya, untuk mengaktifkan JMX di Server Pengelolaan, tambahkan kode berikut ke file konfigurasi Server Pengelolaan:

    exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts \
  -Djava.security.auth.login.config=$conf_path/jaas.config \
  -Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path \
  -Ddata.dir=$data_dir \
  -Dcom.sun.management.jmxremote \
  -Dcom.sun.management.jmxremote.port=1099 \
  -Dcom.sun.management.jmxremote.local.only=false \
  -Dcom.sun.management.jmxremote.authenticate=false \
  -Dcom.sun.management.jmxremote.ssl=false \
   $* $debug_options com.apigee.kernel.MicroKernel

    Contoh ini menentukan port 1099 untuk Server Pengelolaan. Seperti yang dinyatakan sebelumnya, setiap layanan memiliki nomor port-nya sendiri.

    Baris yang diedit dalam file konfigurasi akan terlihat seperti berikut:

    exec $JAVA -classpath "$classpath" -Xms$min_mem -Xmx$max_mem $xx_opts -Djava.security.auth.login.config=$conf_path/jaas.config -Dinstallation.dir=$install_dir $sys_props -Dconf.dir=$conf_path -Ddata.dir=$data_dir -Dcom.sun.management.jmxremote -Dcom.sun.management.jmxremote.port=1099 -Dcom.sun.management.jmxremote.local.only=false -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false $* $debug_options com.apigee.kernel.MicroKernel
  3. Simpan file konfigurasi.
  4. Mulai ulang komponen dengan perintah restart.

    Misalnya, untuk memulai ulang Server Pengelolaan, jalankan perintah berikut:

    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

Autentikasi untuk JMX tidak diaktifkan secara default. Anda dapat mengaktifkan autentikasi JMX untuk semua komponen, seperti yang dijelaskan dalam Mengaktifkan autentikasi JMX. Untuk mengaktifkan autentikasi JMX untuk Cassandra, lihat Mengaktifkan autentikasi JMX untuk Cassandra.

Mengaktifkan autentikasi JMX

Autentikasi JMX tidak diaktifkan secara default. Anda dapat mengaktifkan autentikasi JMX untuk semua komponen. Untuk Cassandra, gunakan petunjuk di Mengaktifkan autentikasi JMX untuk Cassandra

Untuk mengaktifkan autentikasi JMX, jalankan tindakan change_jmx_auth berikut di semua node:

/opt/apigee/apigee-service/bin/apigee-service component_name change_jmx_auth [options|-f config_file]

Dengan:

  • component adalah salah satu dari berikut ini:
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router
  • options menentukan hal berikut:
    • -u username
    • -p password
    • -e [y|n] (aktifkan atau nonaktifkan)
  • config_file menentukan lokasi file konfigurasi tempat Anda menentukan hal berikut:
    • JMX_USERNAME=username
    • JMX_ENABLED=y|n
    • JMX_PASSWORD=password (jika tidak ditetapkan atau tidak diteruskan dengan -p, Anda akan diminta)

Anda dapat menggunakan opsi command line atau file konfigurasi untuk menentukan nama pengguna, sandi, dan status aktif/nonaktif. Anda tidak menentukan kumpulan opsi dan file konfigurasi.

Contoh berikut mengaktifkan autentikasi JMX untuk Server Pengelolaan menggunakan opsi command line:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server
    change_jmx_auth -u foo -p bar -e y

Contoh berikut menggunakan file konfigurasi, bukan opsi command line:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server
    change_jmx_auth -f /tmp/my-config-file

Jika Anda menjalankan Edge di beberapa node, jalankan perintah di semua node, dengan menentukan nama pengguna dan sandi yang sama.

Untuk menonaktifkan autentikasi JMX di command line, gunakan opsi "-e n", seperti yang ditunjukkan dalam contoh berikut:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server
    change_jmx_auth -e n

Memantau dengan JConsole

Gunakan JConsole (alat yang mematuhi JMX) untuk mengelola dan memantau health check dan statistik proses. Dengan JConsole, Anda dapat menggunakan statistik JMX yang ditampilkan oleh server dan menampilkannya dalam antarmuka grafis. Untuk informasi selengkapnya, lihat Menggunakan JConsole.

JConsole menggunakan URL layanan berikut untuk memantau atribut JMX (MBean) yang ditawarkan melalui JMX:

service:jmx:rmi:///jndi/rmi://IP_address:port_number/jmxrmi

Dengan:

  • IP_address adalah alamat IP server yang ingin Anda pantau.
  • port_number adalah nomor port JMX server yang ingin Anda pantau.

Misalnya, untuk memantau Server Pengelolaan, berikan perintah seperti berikut (dengan asumsi alamat IP server adalah 216.3.128.12):

service:jmx:rmi:///jndi/rmi://216.3.128.12:1099/jmxrmi

Perhatikan bahwa contoh ini menentukan port 1099, yang merupakan port JMX Server Pengelolaan. Untuk port lainnya, lihat Port pemantauan JMX dan Management API.

Tabel berikut menunjukkan statistik JMX umum:

JMX MBeans Atribut JMX

Memori

HeapMemoryUsage

NonHeapMemoryUsage

Penggunaan

Memantau dengan Management API

Edge menyertakan beberapa API yang dapat Anda gunakan untuk melakukan pemeriksaan layanan di server serta memeriksa pengguna, organisasi, dan deployment Anda. Bagian ini menjelaskan API tersebut.

Melakukan pemeriksaan layanan

Management API menyediakan beberapa endpoint untuk memantau dan mendiagnosis masalah pada layanan Anda. Endpoint ini mencakup:

Endpoint Deskripsi
/servers/self/up

Memeriksa apakah layanan sedang berjalan. Panggilan API ini tidak mengharuskan Anda melakukan autentikasi.

Jika layanan berjalan, endpoint ini akan menampilkan respons berikut:

<ServerField>
  <Up>true</Up>
</ServerField>

Jika layanan tidak berjalan, Anda akan mendapatkan respons yang mirip dengan berikut ini (bergantung pada layanan yang digunakan dan cara Anda memeriksanya):

curl: Failed connect to localhost:port_number; Connection refused
/servers/self

Menampilkan informasi tentang layanan, termasuk:

  • Properti konfigurasi
  • Waktu mulai dan waktu beroperasi
  • Informasi build, RPM, dan UUID
  • Nama host dan alamat IP internal dan eksternal
  • Region dan pod
  • Properti <isUp>, yang menunjukkan apakah layanan sedang berjalan

Panggilan API ini mengharuskan Anda melakukan autentikasi dengan kredensial admin Apigee.

Untuk menggunakan endpoint ini, panggil utilitas seperti curl dengan perintah yang menggunakan sintaksis berikut:

curl http://host:port_number/v1/servers/self/up -H "Accept: [application/json|application/xml]"
curl http://host:port_number/v1/servers/self -u username:password -H "Accept: [application/json|application/xml]"

Dengan:

  • host adalah alamat IP server yang ingin Anda periksa. Jika Anda login ke server, Anda dapat menggunakan "localhost"; jika tidak, tentukan alamat IP server serta nama pengguna dan sandi.
  • port_number adalah port Management API untuk server yang ingin Anda periksa. Ini adalah port yang berbeda untuk setiap jenis komponen. Misalnya, port Management API Server Pengelolaan adalah 8080. Untuk mengetahui daftar nomor port Management API yang akan digunakan, lihat Port pemantauan JMX dan Management API

Untuk mengubah format respons, Anda dapat menentukan header Accept sebagai "application/json" atau "application/xml".

Contoh berikut mendapatkan status Router di localhost (port 8081):

curl http://localhost:8081/v1/servers/self/up -H "Accept: application/xml"

Contoh berikut mendapatkan informasi tentang Message Processor di 216.3.128.12 (port 8082):

curl http://216.3.128.12:8082/v1/servers/self -u sysAdminEmail:password
  -H "Accept: application/xml"

Memantau status pengguna, organisasi, dan deployment

Anda dapat menggunakan Management API untuk memantau status pengguna, organisasi, dan deployment proxy Anda di Server Pengelolaan dan Message Processor dengan mengeluarkan perintah berikut:

curl http://host:port_number/v1/users -u sysAdminEmail:password
curl http://host:port_number/v1/organizations -u sysAdminEmail:password
curl http://host:port_number/v1/organizations/orgname/deployments -u sysAdminEmail:password

Dengan port_number adalah 8080 untuk Server Pengelolaan atau 8082 untuk Message Processor.

Panggilan ini mengharuskan Anda melakukan autentikasi dengan nama pengguna dan sandi administrasi sistem Anda.

Server akan menampilkan status "deployed" untuk semua panggilan. Jika langkah-langkah ini gagal, lakukan hal berikut:

  1. Periksa log server untuk menemukan error. Log berada di:
    • Server Pengelolaan: opt/apigee/var/log/edge-management-server
    • Message Processor: opt/apigee/var/log/edge-message-processor
  2. Lakukan panggilan ke server untuk memeriksa apakah server berfungsi dengan baik.
  3. Hapus server dari ELB, lalu mulai ulang: 
    /opt/apigee/apigee-service/bin/apigee-service service_name restart

    Dengan service_name adalah:

    • edge-management-server
    • edge-message-processor

Memeriksa status dengan perintah apigee-service

Anda dapat memecahkan masalah layanan Edge menggunakan perintah apigee-service saat login ke server yang menjalankan layanan.

Untuk memeriksa status layanan dengan apigee-service:

  1. Login ke server dan jalankan perintah berikut: 
    /opt/apigee/apigee-service/bin/apigee-service service_name status

    Dengan service_name adalah salah satu dari berikut ini:

    • Server Pengelolaan: edge-management-server
    • Message Processor: edge-message-processor
    • Postgres: edge-postgres-server
    • Qpid: edge-qpid-server
    • Router: edge-router

    Contoh:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor status
  2. Jika layanan tidak berjalan, mulai layanan: 
    /opt/apigee/apigee-service/bin/apigee-service service_name start
  3. Setelah memulai ulang layanan, pastikan layanan berfungsi, baik dengan menggunakan perintah apigee-service status yang Anda gunakan sebelumnya atau dengan menggunakan Management API yang dijelaskan dalam Memantau dengan Management API.

    Contoh:

    curl -v http://localhost:port_number/v1/servers/self/up

    Dengan port_number adalah port Management API untuk layanan.

    Contoh ini mengasumsikan bahwa Anda login ke server dan dapat menggunakan "localhost" sebagai nama host. Untuk memeriksa status dari jarak jauh dengan Management API, Anda harus menentukan alamat IP server dan menyertakan nama pengguna dan sandi administrator sistem dalam panggilan API Anda.

Pemantauan Postgres

Postgres mendukung beberapa utilitas yang dapat Anda gunakan untuk memeriksa statusnya. Utilitas ini dijelaskan di bagian berikut.

Memeriksa organisasi dan lingkungan di Postgres

Anda dapat memeriksa nama organisasi dan lingkungan yang diaktivasi di Server Postgres dengan mengeluarkan perintah curl berikut:

curl -v http://postgres_IP:8084/v1/servers/self/organizations

Sistem akan menampilkan nama organisasi dan lingkungan.

Memverifikasi status analisis

Anda dapat memverifikasi status server analisis Postgres dan Qpid dengan mengeluarkan perintah curl berikut:

curl -u userEmail:password http://host:port_number/v1/organizations/orgname/environments/envname/provisioning/axstatus

Sistem akan menampilkan status berhasil untuk semua server analisis, seperti yang ditunjukkan dalam contoh berikut:

{
  "environments" : [ {
    "components" : [ {
      "message" : "success at Thu Feb 28 10:27:38 CET 2013",
      "name" : "pg",
      "status" : "SUCCESS",
      "uuid" : "[c678d16c-7990-4a5a-ae19-a99f925fcb93]"
     }, {
      "message" : "success at Thu Feb 28 10:29:03 CET 2013",
      "name" : "qs",
      "status" : "SUCCESS",
      "uuid" : "[ee9f0db7-a9d3-4d21-96c5-1a15b0bf0adf]"
     } ],
    "message" : "",
    "name" : "prod"
   } ],
  "organization" : "acme",
  "status" : "SUCCESS"
}

Database PostgreSQL

Bagian ini menjelaskan teknik yang dapat Anda gunakan secara khusus untuk memantau database Postgres.

Menggunakan skrip check_postgres.pl

Untuk memantau database PostgreSQL, Anda dapat menggunakan skrip pemantauan standar, check_postgres.pl. Untuk informasi selengkapnya, lihat http://bucardo.org/wiki/Check_postgres.

Sebelum menjalankan skrip:

  1. Anda harus menginstal skrip check_postgres.pl di setiap node Postgres.
  2. Pastikan Anda telah menginstal perl-Time-HiRes.x86_64, modul Perl yang mengimplementasikan alarm, tidur, gettimeofday, dan timer interval resolusi tinggi. Misalnya, Anda dapat menginstalnya menggunakan perintah berikut:
    yum install perl-Time-HiRes.x86_64
  3. CentOS 7: Sebelum menggunakan check_postgres.pl di CentOS v7, instal RPM perl-Data-Dumper.x86_64.

Output check_postgres.pl

Output default panggilan API yang menggunakan check_postgres.pl kompatibel dengan Nagios. Setelah Anda menginstal skrip, lakukan pemeriksaan berikut:

  1. Periksa ukuran database: 
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -include=apigee -action database_size --warning='800 GB' --critical='900 GB'
  2. Periksa jumlah koneksi masuk ke database dan bandingkan dengan koneksi maksimum yang diizinkan: 
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action backends
  3. Periksa apakah database berjalan dan tersedia: 
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action connection
  4. Periksa kapasitas disk: 
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action disk_space --warning='80%' --critical='90%'
  5. Periksa jumlah organisasi dan lingkungan yang diaktivasi di node Postgres: 
    check_postgres.pl -H 10.176.218.202 -db apigee -u apigee -dbpass postgres -action=custom_query --query="select count(*) as result from pg_tables where schemaname='analytics' and tablename like '%fact'" --warning='80' --critical='90' --valtype=integer

Menjalankan pemeriksaan database

Anda dapat memverifikasi bahwa tabel yang tepat telah dibuat di database PostgreSQL. Login ke database PostgreSQL menggunakan perintah berikut:

psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee

Kemudian, jalankan:

\d analytics."org.env.fact"

Memeriksa status responsivitas proses postgres

Anda dapat melakukan pemeriksaan API pada mesin Postgres dengan memanggil perintah curl berikut:

curl -v http://postgres_IP:8084/v1/servers/self/health

Perintah ini menampilkan status ACTIVE saat proses postgres aktif. Jika proses Postgres tidak aktif dan berjalan, status INACTIVE akan ditampilkan.

Resource Postgres

Untuk informasi tambahan tentang pemantauan layanan Postgres, lihat referensi berikut:

Apache Cassandra

JMX diaktifkan secara default untuk Cassandra dan akses JMX jarak jauh ke Cassandra tidak memerlukan sandi.

Mengaktifkan autentikasi JMX untuk Cassandra

Anda dapat mengaktifkan autentikasi JMX untuk Cassandra. Setelah melakukannya, Anda akan diminta untuk meneruskan nama pengguna dan sandi ke semua panggilan ke utilitas nodetool.

Untuk mengaktifkan autentikasi JMX untuk Cassandra:

  1. Buat dan edit file cassandra.properties:
    1. Edit file /opt/apigee/customer/application/cassandra.properties. Jika file tidak ada, buat file tersebut.
    2. Tambahkan kode berikut ke file: 
      conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
conf_cassandra-env_com.sun.management.jmxremote.password.file=${APIGEE_ROOT}/data/apigee-cassandra/jmxremote.password
conf_cassandra-env_com.sun.management.jmxremote.access.file=${APIGEE_ROOT}/data/apigee-cassandra/jmxremote.access
    3. Simpan file cassandra.properties.
    4. Ubah pemilik file menjadi apigee:apigee, seperti yang ditunjukkan dalam contoh berikut: 
      chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

    Untuk mengetahui informasi selengkapnya tentang penggunaan file properti untuk menetapkan token, lihat Cara mengonfigurasi Edge.

  2. Membuat dan mengedit jmx_auth.sh:
    1. Buat file di lokasi berikut jika belum ada: 
      /opt/apigee/customer/application/jmx_auth.sh
    2. Tambahkan properti berikut ke file: 
      export CASS_JMX_USERNAME=JMX_USERNAME
export CASS_JMX_PASSWORD=JMX_PASSWORD
    3. Simpan file jmx_auth.sh.
    4. Ambil file: 
      source /opt/apigee/customer/application/jmx_auth.sh
  3. Salin dan edit file jmxremote.password:
    1. Salin file berikut dari direktori $JAVA_HOME ke /opt/apigee/data/apigee-cassandra/: 
      cp ${JAVA_HOME}/lib/management/jmxremote.password.template $APIGEE_ROOT/data/apigee-cassandra/jmxremote.password
    2. Edit file jmxremote.password, lalu tambahkan nama pengguna dan sandi JMX Anda menggunakan sintaksis berikut: 
      JMX_USERNAME JMX_PASSWORD

      Dengan JMX_USERNAME dan JMX_PASSWORD adalah nama pengguna dan sandi JMX yang Anda tetapkan sebelumnya.

    3. Pastikan file tersebut dimiliki oleh "apigee" dan mode file-nya adalah 400: 
      chown apigee:apigee /opt/apigee/data/apigee-cassandra/jmxremote.password
chmod 400 /opt/apigee/data/apigee-cassandra/jmxremote.password
  4. Salin dan edit file jmxremote.access:
    1. Salin file berikut dari direktori $JAVA_HOME ke /opt/apigee/data/apigee-cassandra/: 
      cp ${JAVA_HOME}/lib/management/jmxremote.access $APIGEE_ROOT/data/apigee-cassandra/jmxremote.access
    2. Edit file jmxremote.access dan tambahkan peran berikut: 
      JMX_USERNAME readwrite
    3. Pastikan file tersebut dimiliki oleh "apigee" dan mode file-nya adalah 400: 
      chown apigee:apigee /opt/apigee/data/apigee-cassandra/jmxremote.access
chmod 400 /opt/apigee/data/apigee-cassandra/jmxremote.access
  5. Jalankan configure di Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
  6. Mulai ulang Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  7. Ulangi proses ini pada semua node Cassandra lainnya.

Mengaktifkan enkripsi sandi JMX

Untuk mengaktifkan enkripsi sandi JMX, lakukan langkah-langkah berikut:

  1. Buka file source/conf/casssandra-env.sh.
  2. Hapus tanda komentar pada baris berikut dalam file:
    • JVM_OPTS="$JVM_OPTS -Djava.security.auth.login.config={T}conf_cassandra-env_java.security.auth.login.config{/T}"
    • JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.login.config=ApigeeSecureFileLoginModule"
  3. Pada command line, buat hash SHA1 dari sandi yang diinginkan dengan memasukkan echo -n 'Secret' | openssl dgst -sha1
  4. Tetapkan sandi untuk nama pengguna di jmxremote.password.
  5. Ubah file cassandra-env.sh kembali menjadi hanya baca setelah update.

Mengaktifkan JMX dengan SSL untuk Cassandra

Mengaktifkan JMX dengan SSL memberikan keamanan dan enkripsi tambahan untuk komunikasi berbasis JMX dengan Cassandra. Untuk mengaktifkan JMX dengan SSL, Anda harus memberikan kunci dan sertifikat ke Cassandra untuk menerima koneksi JMX berbasis SSL. Anda juga perlu mengonfigurasi nodetool (dan alat lain yang berkomunikasi dengan Cassandra melalui JMX) untuk SSL.

JMX yang mendukung SSL mendukung sandi JMX teks biasa dan terenkripsi.

Untuk mengaktifkan JMX dengan SSL untuk Cassandra, gunakan prosedur berikut:

  1. Aktifkan JMX. Aktifkan enkripsi sandi jika diperlukan.
  2. Aktifkan autentikasi JMX untuk Cassandra. seperti yang dijelaskan di atas. Pastikan nodetool berfungsi dengan nama pengguna dan sandi yang dikonfigurasi. 
    /opt/apigee/apigee-cassandra/bin/nodetool -u <JMX_USER> -pw <JMX_PASS> ring

  3. Menyiapkan keystore dan truststore.

    • Keystore harus berisi kunci dan sertifikat, dan digunakan untuk mengonfigurasi server Cassandra. Jika keystore berisi beberapa pasangan kunci, Cassandra akan menggunakan pasangan kunci pertama untuk mengaktifkan SSL.

      Perhatikan bahwa sandi untuk keystore dan kunci harus sama (default saat Anda membuat kunci menggunakan keytool).

    • Truststore hanya boleh berisi sertifikat dan digunakan oleh klien (perintah berbasis layanan apigee atau nodetool) untuk terhubung melalui JMX.

    Setelah memverifikasi persyaratan di atas:

    1. Tempatkan file keystore di /opt/apigee/data/apigee-cassandra.
    2. Pastikan file keystore hanya dapat dibaca oleh pengguna Apigee dengan memasukkan 
      chown apigee:apigee /opt/apigee/data/apigee-cassandra/keystore.node1
chmod 400 /opt/apigee/data/apigee-cassandra/keystore.node1
  4. Konfigurasikan Cassandra untuk JMX dengan SSL dengan melakukan langkah-langkah berikut:
    1. Hentikan node Cassandra dengan memasukkan 
      apigee-service apigee-cassandra stop
    2. Aktifkan SSL di Cassandra dengan membuka file /opt/apigee/customer/application/cassandra.properties dan menambahkan baris berikut: 
      conf_cassandra-env_com.sun.management.jmxremote.ssl=true

      File harus dimiliki oleh apigee:apigee.

    3. Aktifkan konfigurasi terkait SSL di Cassandra sebagai berikut. Buka file /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh dan hapus tanda komentar pada baris berikut, ubah jalur /opt/apigee/data/apigee-cassandra/keystore.node1 dan sandi keystore seperlunya. 
      JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node1"
JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keystore-password"
JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true"
       Pastikan file tersebut dimiliki oleh apigee:apigee.
    4. Mulai node Cassandra dengan memasukkan 
      apigee-service apigee-cassandra start
  5. Konfigurasikan perintah Cassandra apigee-service. Anda perlu menetapkan variabel lingkungan tertentu saat menjalankan perintah apigee-service, termasuk perintah di bawah: 
    apigee-service apigee-cassandra stop
apigee-service apigee-cassandra wait_for_ready
apigee-service apigee-cassandra ring
apigee-service apigee-cassandra backup

    Ada beberapa opsi untuk mengonfigurasi apigee-service untuk autentikasi JMX dan SSL. Pilih opsi berdasarkan kegunaan dan praktik keamanan Anda.

    Opsi 1 (Argumen SSL disimpan dalam file)

    Tetapkan variabel lingkungan berikut:

    export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y

    Buat file di direktori utama pengguna Apigee (/opt/apigee). 

    $HOME/.cassandra/nodetool-ssl.properties

    Edit file dan tambahkan baris berikut:

    -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true

    Pastikan file truststore dapat dibaca oleh pengguna Apigee.

    Jalankan perintah apigee-service berikut. Jika berjalan tanpa error, berarti konfigurasi Anda sudah benar.

    apigee-service apigee-cassandra ring

    Opsi 2 (Argumen SSL yang disimpan dalam variabel lingkungan)

    Tetapkan variabel lingkungan berikut:

    export CASS_JMX_USERNAME=ADMIN
# Provide encrypted password here if you have setup JMX password encryption
export CASS_JMX_PASSWORD=PASSWORD
export CASS_JMX_SSL=Y
# Ensure the truststore file is accessible by Apigee user.
export CASS_JMX_TRUSTSTORE=<path-to-trustore.node1>
export CASS_JMX_TRUSTSTORE_PASSWORD=<truststore-password>

    Jalankan perintah apigee-service berikut. Jika berjalan tanpa error, berarti konfigurasi Anda sudah benar. 

    apigee-service apigee-cassandra ring

    Opsi 3 (Argumen SSL diteruskan langsung ke apigee-service)

    Jalankan perintah apigee-service seperti di bawah ini. Anda tidak perlu mengonfigurasi variabel lingkungan apa pun.

    CASS_JMX_USERNAME=ADMIN CASS_JMX_PASSWORD=PASSWORD CASS_JMX_SSL=Y CASS_JMX_TRUSTSTORE=<path-to-trustore.node1> CASS_JMX_TRUSTSTORE_PASSWORD=<trustore-password> /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra ring

  6. Siapkan nodetool. Nodetool memerlukan parameter JMX untuk diteruskan ke dalamnya. Ada dua cara untuk mengonfigurasi nodetool agar berjalan dengan JMX yang mendukung SSL, seperti yang dijelaskan dalam opsi konfigurasi di bawah:

    Opsi ini berbeda dalam cara konfigurasi terkait SSL diteruskan ke nodetool. Dalam kedua kasus tersebut, pengguna yang menjalankan nodetool harus memiliki izin baca pada file truststore. Pilih opsi yang sesuai berdasarkan kegunaan dan praktik keamanan Anda.

    Untuk mempelajari parameter nodetool lebih lanjut, lihat dokumentasi DataStax.

    Opsi Konfigurasi 1

    Buat file di direktori beranda pengguna yang menjalankan nodetool.

    $HOME/.cassandra/nodetool-ssl.properties

    Tambahkan baris berikut ke file:

    -Djavax.net.ssl.trustStore=<path-to-truststore.node1>
-Djavax.net.ssl.trustStorePassword=<truststore-password>
-Dcom.sun.management.jmxremote.registry.ssl=true

    Jalur truststore yang ditentukan di atas harus dapat diakses oleh pengguna mana pun yang menjalankan nodetool.

    Jalankan nodetool dengan opsi --ssl.

    /opt/apigee/apigee-cassandra/bin/nodetool --ssl -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

    Opsi konfigurasi 2

    Jalankan nodetool sebagai satu perintah dengan parameter tambahan yang tercantum di bawah.

    /opt/apigee/apigee-cassandra/bin/nodetool -Djavax.net.ssl.trustStore=<path-to-truststore.node1> -Djavax.net.ssl.trustStorePassword=<truststore-password> -Dcom.sun.management.jmxremote.registry.ssl=true -Dssl.enable=true -u <jmx-user-name> -pw <jmx-user-password> -h localhost ring

Mengembalikan konfigurasi SSL

Jika Anda perlu mengembalikan konfigurasi SSL yang dijelaskan dalam prosedur di atas, lakukan langkah-langkah berikut:

  1. Hentikan apigee-cassandradengan memasukkan 
    apigee-service apigee-cassandra stop
  2. Hapus baris conf_cassandra-env_com.sun.management.jmxremote.ssl=true dari file /opt/apigee/customer/application/cassandra.properties.
  3. Jadikan baris berikut sebagai komentar di /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 
    # JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStore=/opt/apigee/data/apigee-cassandra/keystore.node0"
# JVM_OPTS="$JVM_OPTS -Djavax.net.ssl.keyStorePassword=keypass"
# JVM_OPTS="$JVM_OPTS -Dcom.sun.management.jmxremote.registry.ssl=true”
  4. Mulai apigee-cassandra dengan memasukkan
    5. apigee-service apigee-cassandra start
  5. Hapus variabel lingkungan CASS_JMX_SSL jika telah ditetapkan.

    unset CASS_JMX_SSL
  6. Pastikan perintah berbasis apigee-service seperti ring, stop, backup, dan sebagainya, berfungsi.
  7. Berhenti menggunakan tombol --ssl dengan nodetool

Menonaktifkan autentikasi JMX untuk Cassandra

Untuk menonaktifkan autentikasi JMX untuk Cassandra:

  1. Edit /opt/apigee/customer/application/cassandra.properties.
  2. Hapus baris berikut dalam file: 
    conf_cassandra-env_com.sun.management.jmxremote.authenticate=true
  3. Jalankan konfigurasi di Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure
  4. Mulai ulang Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  5. Ulangi proses ini pada semua node Cassandra lainnya.

Menggunakan JConsole: Memantau statistik tugas

Gunakan JConsole dan URL layanan berikut untuk memantau atribut JMX (MBean) yang ditawarkan melalui JMX:

service:jmx:rmi:///jndi/rmi://IP_address:7199/jmxrmi

Dengan IP_address adalah IP server Cassandra.

Statistik JMX Cassandra

JMX MBeans Atribut JMX

ColumnFamilies/apprepo/environments

ColumnFamilies/apprepo/organizations

ColumnFamilies/apprepo/apiproxy_revisions

ColumnFamilies/apprepo/apiproxies

ColumnFamilies/audit/audits

ColumnFamilies/audit/audits_ref

PendingTasks

MemtableColumnsCount

MemtableDataSize

ReadCount

RecentReadLatencyMicros

TotalReadLatencyMicros

WriteCount

RecentWriteLatencyMicros

TotalWriteLatencyMicros

TotalDiskSpaceUsed

LiveDiskSpaceUsed

LiveSSTableCount

BloomFilterFalsePositives

RecentBloomFilterFalseRatio

BloomFilterFalseRatio

Menggunakan nodetool untuk mengelola node cluster

Utilitas nodetool adalah antarmuka command line untuk Cassandra yang mengelola node cluster. Utilitas ini dapat ditemukan di /opt/apigee/apigee-cassandra/bin.

Panggilan berikut dapat dilakukan di semua node cluster Cassandra:

  1. Info ring umum (juga memungkinkan untuk satu node Cassandra): Cari "Up" dan "Normal" untuk semua node. 
    nodetool [-u username -pw password] -h localhost ring

    Anda hanya perlu meneruskan nama pengguna dan sandi jika mengaktifkan autentikasi JMX untuk Cassandra.

    Output perintah di atas terlihat seperti yang ditunjukkan di bawah: 

    Datacenter: dc-1
==========
Address            Rack     Status State   Load    Owns    Token
192.168.124.201    ra1      Up     Normal  1.67 MB 33,33%  0
192.168.124.202    ra1      Up     Normal  1.68 MB 33,33%  5671...5242
192.168.124.203    ra1      Up     Normal  1.67 MB 33,33%  1134...0484
  2. Info umum tentang node (panggilan per node) 
    nodetool [-u username -pw password]  -h localhost info

    Output perintah di atas terlihat seperti berikut:

    ID                     : e2e42793-4242-4e82-bcf0-oicu812
Gossip active          : true
Thrift active          : true
Native Transport active: true
Load                   : 273.71 KB
Generation No          : 1234567890
Uptime (seconds)       : 687194
Heap Memory (MB)       : 314.62 / 3680.00
Off Heap Memory (MB)   : 0.14
Data Center            : dc-1
Rack                   : ra-1
Exceptions             : 0
Key Cache              : entries 150, size 13.52 KB, capacity 100 MB, 1520781 hits, 1520923 requests, 1.000 recent hit rate, 14400 save period in seconds
Row Cache              : entries 0, size 0 bytes, capacity 0 bytes, 0 hits, 0 requests, NaN recent hit rate, 0 save period in seconds
Counter Cache          : entries 0, size 0 bytes, capacity 50 MB, 0 hits, 0 requests, NaN recent hit rate, 7200 save period in seconds
Token                  : 0
  3. Status server thrift (menyajikan API klien) 
    nodetool [-u username -pw password] -h localhost statusthrift

    Output perintah di atas terlihat seperti berikut:

    running
  4. Status operasi streaming data: Amati traffic untuk node cassandra: 
    nodetool [-u username -pw password] -h localhost netstats

    Output perintah di atas terlihat seperti berikut:

    Mode: NORMAL
Not sending any streams.
Read Repair Statistics:
Attempted: 151612
Mismatch (Blocking): 0
Mismatch (Background): 0
Pool Name                    Active   Pending      Completed   Dropped
Commands                        n/a         0              0         0
Responses                       n/a         0              0       n/a

Untuk mengetahui info selengkapnya tentang nodetool, lihat Tentang utilitas nodetool.

Resource Cassandra

Lihat URL berikut: http://www.datastax.com/docs/1.0/operations/monitoring.

Apache ZooKeeper

Memeriksa status ZooKeeper

  1. Pastikan proses ZooKeeper berjalan. ZooKeeper menulis file PID ke opt/apigee/var/run/apigee-zookeeper/apigee-zookeeper.pid.
  2. Uji port ZooKeeper untuk memastikan bahwa Anda dapat membuat koneksi TCP ke port 2181 dan 3888 di setiap server ZooKeeper.
  3. Pastikan Anda dapat membaca nilai dari database ZooKeeper. Hubungkan menggunakan library klien ZooKeeper (atau /opt/apigee/apigee-zookeeper/bin/zkCli.sh) dan baca nilai dari database.
  4. Periksa status: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper status

Menggunakan perintah empat huruf ZooKeeper

ZooKeeper dapat dipantau melalui sekumpulan kecil perintah (kata empat huruf) yang dikirim ke port 2181 menggunakan netcat (nc) atau telnet.

Untuk mengetahui info selengkapnya tentang perintah ZooKeeper, lihat: Referensi perintah Apache ZooKeeper.

Contoh:

  • srvr: Mencantumkan detail lengkap untuk server.
  • stat: Mencantumkan detail singkat untuk server dan klien yang terhubung.

Perintah berikut dapat diberikan ke port ZooKeeper:

  1. Jalankan perintah empat huruf ruok untuk menguji apakah server berjalan dalam status non-error. Respons yang berhasil akan menampilkan "imok". 
    echo ruok | nc host 2181

    Returns:

    imok
  2. Jalankan perintah empat huruf, stat, untuk mencantumkan statistik performa server dan klien yang terhubung: 
    echo stat | nc host 2181

    Returns:

    Zookeeper version: 3.4.5-1392090, built on 09/30/2012 17:52 GMT
Clients:
/0:0:0:0:0:0:0:1:33467[0](queued=0,recved=1,sent=0)
/192.168.124.201:42388[1](queued=0,recved=8433,sent=8433)
/192.168.124.202:42185[1](queued=0,recved=1339,sent=1347)
/192.168.124.204:39296[1](queued=0,recved=7688,sent=7692)
Latency min/avg/max: 0/0/128
Received: 26144
Sent: 26160
Connections: 4
Outstanding: 0
Zxid: 0x2000002c2
Mode: follower
Node count: 283
  3. Jika netcat (nc) tidak tersedia, Anda dapat menggunakan python sebagai alternatif. Buat file bernama zookeeper.py yang berisi hal berikut: 
    import time, socket,
sys c = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
c.connect((sys.argv[1], 2181))
c.send(sys.argv[2])
time.sleep(0.1)
print c.recv(512)

    Sekarang jalankan baris python berikut:

    python zookeeper.py 192.168.124.201 ruok
python zookeeper.py 192.168.124.201 stat

Pengujian level LDAP

Anda dapat memantau OpenLDAP untuk melihat apakah permintaan tertentu disajikan dengan benar. Dengan kata lain, periksa penelusuran tertentu yang menampilkan hasil yang tepat.

  1. Gunakan ldapsearch (yum install openldap-clients) untuk mengkueri entri admin sistem. Entri ini digunakan untuk mengautentikasi semua panggilan API. 
    ldapsearch -b "uid=admin,ou=users,ou=global,dc=apigee,dc=com" -x -W -D "cn=manager,dc=apigee,dc=com" -H ldap://localhost:10389 -LLL

    Kemudian, Anda akan diminta memasukkan sandi admin LDAP:

    Enter LDAP Password:

    Setelah memasukkan sandi, Anda akan melihat respons dalam formulir:

    dn:
uid=admin,ou=users,ou=global,dc=apigee,dc=com
objectClass: organizationalPerson
objectClass: person
objectClass: inetOrgPerson
objectClass: top
uid: admin
cn: admin
sn: admin
userPassword:: e1NTSEF9bS9xbS9RbVNXSFFtUWVsU1F0c3BGL3BQMkhObFp2eDFKUytmZVE9PQ=
 =
mail: opdk@google.com
  2. Periksa apakah Server Pengelolaan masih terhubung ke LDAP dengan perintah berikut: 
    curl -u userEMail:password http://localhost:8080/v1/users/ADMIN

    Returns:

    {
  "emailId" : ADMIN,
  "firstName" : "admin",
  "lastName" : "admin"
}

Anda juga dapat memantau cache OpenLDAP, yang membantu mengurangi jumlah akses disk sehingga meningkatkan performa sistem. Memantau, lalu menyesuaikan ukuran cache di server OpenLDAP dapat sangat memengaruhi performa server direktori. Anda dapat melihat file log (opt/apigee/var/log) untuk mendapatkan informasi tentang cache.