Memantau Praktik Terbaik

Edge untuk Private Cloud v. 4.17.05

Pemberitahuan Pemantauan

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

Menetapkan Batas Notifikasi

Tetapkan batas yang akan digunakan untuk membuat pemberitahuan. Yang Anda tetapkan bergantung pada konfigurasi hardware Anda. Nilai minimum harus disetel sesuai 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 secara berurutan. Anda dapat menggunakan opsi jam/menit/detik.

Kriteria untuk Menyetel Pemberitahuan Tingkat Sistem

Tabel berikut menjelaskan kriteria:

Notifikasi

Nilai Minimum yang Disarankan

Deskripsi

Memori hampir penuh

500MB

Memori terlalu rendah untuk memulai komponen

Kapasitas disk hampir penuh (/var/log)

8 GB

Kapasitas disk hampir habis.

Beban tinggi

3+

Proses yang menunggu untuk dijalankan meningkat secara tidak terduga

Proses dihentikan

T/A, nilai Boolean dari true (benar) atau false (salah)

Proses Java Apigee di sistem telah berhenti

Memeriksa Port khusus Apigee dan Port Pihak Ketiga

Pantau port berikut untuk memastikan port tersebut aktif

  • Port 4526, 4527, dan 4528 pada Server Pengelolaan, Router, dan Prosesor Pesan
  • Port 1099, 1100, dan 1101 pada Server Pengelolaan, Router, dan Prosesor Pesan
  • Port 8081 dan 15999 pada Router
  • Port 8082 dan 8998 pada Prosesor Pesan

Port 8080 pada Server Pengelolaan Periksa port pihak ketiga berikut untuk memastikan port tersebut aktif:

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

Untuk menentukan port mana yang diproses oleh setiap komponen Apigee untuk panggilan API, lakukan panggilan API berikut ke Server Pengelolaan (yang umumnya ada 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 ditunjukkan di bawah ini. Bagian "http.management.port" menunjukkan 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 di log saat proses dimulai dan selesai, atau saat kondisi error terjadi. Dengan melihat file log, Anda dapat memperoleh informasi tentang komponen sistem, misalnya, CPU, memori, disk, pemuatan, proses, dll., sebelum dan setelah mencapai status gagal. Hal ini juga memungkinkan Anda mengidentifikasi dan mendiagnosis sumber masalah sistem saat ini atau membantu memprediksi potensi masalah sistem.

Misalnya, log sistem umum suatu komponen berisi entri berikut seperti yang terlihat di bawah ini:

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 /opt/apigee/conf/logback.xml untuk mengontrol mekanisme logging tanpa harus memulai ulang server. File logback.xml berisi properti berikut yang menetapkan frekuensi perubahan konfigurasi yang dilakukan mekanisme logging pada file logback.xml:

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

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

Tabel berikut memberi tahu lokasi file log komponen Apigee Edge Private Cloud.

Komponen

Lokasi

Server Pengelolaan

opt/apigee/var/log/edge-management-server

Router

opt/apigee/var/log/edge-router

Message Processor

opt/apigee/var/log/edge-message-processor

Server Qpid

opt/apigee/var/log/edge-qpid-server

Server Apigee Postgres

opt/apigee/var/log/edge-postgres-server

UI Edge

opt/apigee/var/log/edge-ui

ZooKeeper

opt/apigee/var/log/apigee-zookeeper

OpenLDAP

opt/apigee/var/log/apigee-openldap

Cassandra

opt/apigee/var/log/apigee-cassandra

Qpidd

opt/apigee/var/log/apigee-qpidd

Database PostgreSQL

opt/apigee/var/log/apigee-postgresql

Mengaktifkan log debug untuk Message Processor dan UI Edge

Untuk mengaktifkan log debug bagi Message Processor:

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

Guna mengaktifkan log debug untuk UI Edge:

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

Alat Pemantauan

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

Komponen

Nagios

Dikumpulkan

Splunk

Pemeriksaan tingkat sistem

CPU utilization

?

?

Memori bebas/digunakan

?

?

Penggunaan ruang 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

?