Memantau Praktik Terbaik

Edge for Private Cloud v. 4.16.05

Pemberitahuan Monitoring

Apigee Edge memungkinkan Anda meneruskan pemberitahuan ke syslog atau sistem/alat pemantauan eksternal saat terjadi error atau kegagalan karena kegagalan peristiwa. Pemberitahuan ini dapat berupa pemberitahuan/peristiwa tingkat sistem atau tingkat aplikasi. Notifikasi tingkat aplikasi sebagian besar adalah notifikasi kustom yang dibuat berdasarkan peristiwa yang dihasilkan. Administrator jaringan biasanya mengonfigurasi kondisi kustom. Untuk mengetahui informasi selengkapnya tentang pemberitahuan, hubungi Dukungan Apigee.

Menetapkan Nilai Minimum Pemberitahuan

Tetapkan nilai minimum yang akan memicu pembuatan pemberitahuan. Apa yang Anda tetapkan bergantung pada konfigurasi hardware Anda? Nilai minimum harus ditetapkan sehubungan dengan kapasitas Anda. Misalnya, Apigee Edge mungkin terlalu rendah jika Anda hanya memiliki kapasitas 6 GB. Anda dapat menetapkan nilai minimum dengan kriteria sama dengan (=) atau lebih besar dari (>). Anda juga dapat menentukan interval waktu antara dua pembuatan pemberitahuan berturut-turut. Anda dapat menggunakan opsi jam/menit/detik.

Kriteria untuk Menetapkan Pemberitahuan Tingkat Sistem

Tabel berikut menjelaskan kriteria tersebut:

Notifikasi

Suggested Threshold

Deskripsi

Memori rendah

500MB

Memori terlalu rendah untuk memulai komponen

Kapasitas disk hampir penuh (/var/log)

8 GB

Kapasitas disk terlalu rendah.

Beban tinggi

3+

Proses yang menunggu untuk dijalankan meningkat secara tidak terduga

Proses dihentikan

T/A, nilai Boolean true atau false

Proses Java Apigee dalam sistem telah berhenti

Memeriksa Port Khusus Apigee dan Pihak Ketiga

Pantau port berikut untuk memastikan port tersebut aktif

  • Port 4526, 4527, dan 4528 di Server Pengelolaan, Router, dan Message Processor
  • Port 1099, 1100, dan 1101 di Server Pengelolaan, Router, dan Message Processor
  • Port 8081 di Router
  • Port 8082 dan 8998 di Message Processor
  • Port 8080 di Server Pengelolaan

Periksa port pihak ketiga berikut untuk memastikan port tersebut aktif:

  • Port Qpid 5672
  • Port Postgres 5432
  • Port Cassandra 7000, 7199, 9042, 9160
  • Port ZooKeeper 2181
  • Port OpenLDAP 10389

Untuk menentukan port yang dipantau setiap komponen Apigee untuk panggilan API, lakukan panggilan API berikut ke Server Pengelolaan (yang umumnya berada di port 8080):

curl -v -u <username>:<password> http://<host>:<port>/v1/servers?pod=gateway&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=central&region=dc-1
curl -v -u <username>:<password> http:// <host>:<port>/v1/servers?pod=analytics&region=dc-1

Output perintah ini akan berisi bagian yang mirip dengan yang ditampilkan di bawah. Bagian "http.management.port" memberikan nomor port untuk komponen yang ditentukan.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

Melihat Log

File log melacak pesan terkait peristiwa/operasi sistem. Pesan muncul dalam log saat proses dimulai dan selesai atau saat terjadi kondisi error. Dengan melihat file log, Anda dapat memperoleh informasi tentang komponen sistem, misalnya, CPU, memori, disk, beban, proses, dan sebagainya, sebelum dan setelah mencapai status gagal. Hal ini juga memungkinkan Anda mengidentifikasi dan mendiagnosis sumber masalah sistem saat ini atau membantu Anda memprediksi potensi masalah sistem.

Misalnya, log sistem umum dari sebuah komponen berisi entri berikut seperti yang terlihat di bawah:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;    
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

Anda dapat mengedit file /<inst_root>/apigee/conf/logback.xml untuk mengontrol mekanisme logging tanpa harus memulai ulang server. File logback.xml berisi properti berikut yang menetapkan frekuensi mekanisme logging memeriksa file logback.xml untuk mengetahui perubahan konfigurasi:

<configuration scan="true" scanPeriod="30 seconds" >

Secara default, mekanisme logging memeriksa perubahan setiap menit. Jika Anda menghapus satuan waktu ke atribut scanPeriod, atribut tersebut akan ditetapkan secara default ke milidetik.

Tabel berikut menunjukkan lokasi file log komponen Apigee Edge Private Cloud.

Komponen

Lokasi

Server Pengelolaan

<inst_root>/apigee/var/log/edge-management-server

Router

<inst_root>/apigee/var/log/edge-router

Message Processor

<inst_root>/apigee/var/log/edge-message-processor

Server Qpid

<inst_root>/apigee/var/log/edge-qpid-server

Server Postgres Apigee

<inst_root>/apigee/var/log/edge-postgres-server

Edge UI

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

Database PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

Mengaktifkan log debug untuk Message Processor dan Edge UI

Untuk mengaktifkan log debug bagi Message Processor:

  1. Pada node Message Processor, edit /<install_dir>/apigee/customer/application/messsage-processor.properties. Jika file tersebut tidak ada, buat file tersebut.
  2. Tambahkan properti berikut ke file:
    conf_system_log.level=DEBUG
  3. Mulai ulang Message Processor:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Untuk mengaktifkan log debug untuk Edge UI:

  1. Pada node UI Edge, edit /<install_dir>/apigee/customer/application/ui.properties. Jika file tersebut tidak ada, buat file tersebut.
  2. Tambahkan properti berikut ke file:
    conf_application_logger.application=DEBUG
  3. Mulai ulang Edge UI:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service edge-ui restart

Alat Pemantauan

Alat pemantauan open source seperti Nagios, Collectd, Graphite, Splunk, Sumologic, dan Monit dapat membantu Anda memantau seluruh lingkungan perusahaan dan proses bisnis.

Komponen

Nagios

Collectd

Splunk

Pemeriksaan tingkat sistem

Pemakaian CPU

?

?

Memori kosong/terpakai

?

?

Penggunaan kapasitas disk

?

?

Statistik jaringan

?

?

Proses

?

Pemeriksaan API

?

JMX

?

Java

?

File log

?

Peristiwa penting

Batas Kapasitas tercapai

?

Server backend (Hybris atau SharePoint) tidak dapat dijangkau

?

FaaS (STS) tidak dapat dijangkau

?

Peristiwa peringatan

Server SMTP tidak dapat dijangkau

?

SLA dilanggar

?