Memantau praktik terbaik

Pemberitahuan Monitoring

Apigee Edge memungkinkan Anda meneruskan pemberitahuan ke syslog atau sistem/alat pemantauan eksternal saat terjadi {i>error<i} atau kegagalan yang disebabkan oleh kegagalan sebuah peristiwa. Peringatan ini dapat berupa peringatan tingkat sistem atau pemberitahuan/peristiwa tingkat aplikasi. Pemberitahuan tingkat aplikasi sebagian besar merupakan peringatan khusus yang dibuat berdasarkan peristiwa yang dibuat. Administrator jaringan biasanya mengonfigurasi aturan khusus kondisi tertentu. Untuk mengetahui informasi selengkapnya tentang pemberitahuan, hubungi Dukungan Apigee.

Menetapkan batas pemberitahuan

Tetapkan batas setelah pemberitahuan perlu dibuat. Apa yang Anda tetapkan bergantung pada konfigurasi hardware-nya sendiri. Nilai minimum harus ditetapkan sesuai dengan kapasitas Anda. Misalnya, Apigee Edge mungkin terlalu rendah jika Anda hanya memiliki kapasitas 6 GB. Anda dapat menetapkan ambang batas dengan sama dengan (=) atau lebih dari (>). Anda juga dapat menentukan interval waktu antara dua pembuatan pemberitahuan. Anda dapat menggunakan opsi jam/menit/detik.

Kriteria untuk Menetapkan Pemberitahuan Tingkat Sistem

Tabel berikut menjelaskan kriterianya:

Pemberitahuan Nilai Minimum yang Disarankan Deskripsi

Memori hampir penuh

500MB

Memori terlalu sedikit untuk memulai komponen

Kapasitas disk hampir penuh (/var/log)

8 GB

Kapasitas disk terlalu sedikit.

Beban tinggi

3+

Proses yang menunggu untuk dijalankan telah meningkat secara tidak terduga

Proses dihentikan

T/A, nilai Boolean dari benar atau salah

Proses Java Apigee dalam sistem telah dihentikan

Memeriksa masalah khusus Apigee dan Pihak ketiga Porta

Pantau port berikut untuk memastikannya 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 di Router
  • Port 8082 dan 8998 pada Pemroses Pesan
  • Port 8080 di Server Pengelolaan

Periksa port pihak ketiga berikut untuk memastikannya sudah aktif:

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

Untuk menentukan port mana yang didengarkan oleh setiap komponen Apigee yang mendengarkan panggilan API, masalahkan 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 dari perintah ini akan berisi bagian yang mirip dengan yang ditunjukkan di bawah ini. Tujuan 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 mengenai peristiwa/operasi pada sistem. Pesan muncul di log ketika proses dimulai dan selesai atau ketika kondisi {i>error<i} terjadi. Dengan melihat log {i>file<i}, Anda bisa mendapatkan informasi tentang komponen sistem, misalnya, CPU, memori, {i>disk<i}, beban, proses, seterusnya, sebelum dan sesudah mencapai status gagal. Hal ini juga memungkinkan Anda untuk mengidentifikasi dan mendiagnosis sumber masalah sistem saat ini atau membantu Anda memprediksi menyelesaikan semua jenis permasalahan.

Misalnya, log sistem standar dari sebuah 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 memulai ulang server. File logback.xml berisi properti berikut yang menyetel atribut frekuensi mekanisme logging memeriksa file logback.xml untuk perubahan konfigurasi:

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

Secara default, mekanisme logging akan memeriksa perubahan setiap menit. Jika Anda menghilangkan satuan waktu ke atribut scanPeriod, setelan default-nya adalah 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 Postgres Apigee

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 Pesan UI Prosesor dan Edge

Guna mengaktifkan log debug untuk Pemroses Pesan:

  1. Pada node Message Processor, edit /opt/apigee/customer/application/messsage-processor.properties. Jika file tersebut tidak ada, buatlah.
  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, buat 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

Praktik terbaik apigee-monit

Saat menggunakan apigee-monit, Apigee merekomendasikan agar Anda:

  • Berhenti memantau komponen sebelum Anda melakukan operasi yang memulai atau menghentikannya seperti pencadangan atau upgrade.
  • Pantau apigee-monit menggunakan alat seperti cron. Untuk selengkapnya informasinya, lihat Memantau apigee-monit.

Alat Pemantauan

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

Komponen Nagios Dikumpulkan Splunk

Pemeriksaan tingkat sistem

Pemakaian CPU

Memori bebas/terpakai

Penggunaan ruang disk

Statistik jaringan

Proses

Pemeriksaan API

JMX

Java

File log

Peristiwa penting

Hit Batas Kapasitas

Server backend (Hybris atau SharePoint) tidak dapat dijangkau

FaaS (STS) tidak dapat dijangkau

Peristiwa peringatan

Server SMTP tidak dapat dijangkau

SLA dilanggar