İzlemeyle ilgili en iyi uygulamalar

İzleme uyarıları

Apigee Edge, bir etkinlik hatası nedeniyle hata veya arıza oluştuğunda uyarıları syslog'lara ya da harici izleme sistemlerine/araçlarına yönlendirmenize olanak tanır. Bu uyarılar sistem düzeyinde veya uygulama düzeyinde uyarılar/etkinlikler olabilir. Uygulama düzeyindeki uyarılar, çoğunlukla oluşturulan etkinliklere göre oluşturulan özel uyarılardır. Özel koşullar genellikle ağ yöneticisi tarafından yapılandırılır. Uyarılar hakkında daha fazla bilgi için Apigee Destek Ekibi ile iletişime geçin.

Uyarı eşikleri ayarlama

Uyarı oluşturulması için bir eşik belirleyin. Belirleyeceğiniz değer, donanım yapılandırmanıza bağlıdır. Eşik, kapasitenize göre ayarlanmalıdır. Örneğin, yalnızca 6 GB kapasiteniz varsa Apigee Edge çok düşük olabilir. Eşit (=) veya büyük (>) ölçütüyle eşik atayabilirsiniz. Ayrıca, iki ardışık uyarı oluşturma işlemi arasında bir zaman aralığı da belirtebilirsiniz. Saat/dakika/saniye seçeneğini kullanabilirsiniz.

Sistem Düzeyinde Uyarıları Ayarlama Ölçütleri

Aşağıdaki tabloda ölçütler açıklanmaktadır:

Uyarı Önerilen Eşik Açıklama

Yetersiz bellek

500MB

Bir bileşeni başlatmak için yeterli bellek yok

Disk alanında yer az (/var/log)

8 GB

Disk alanı çok azaldı.

Yüksek yük

3+

Çalışmayı bekleyen işlemler beklenmedik bir şekilde arttı

İşlem durduruldu

Geçersiz, doğru veya yanlış Boole değeri

Sistemdeki Apigee Java işlemi durduruldu

Apigee'ye özgü ve üçüncü taraf bağlantı noktalarını kontrol etme

Aşağıdaki bağlantı noktalarının etkin olduğundan emin olmak için bunları izleyin.

  • Yönetim sunucusu, yönlendirici ve ileti işlemcisinde 4526, 4527 ve 4528 numaralı bağlantı noktası
  • Yönetim sunucusu, yönlendirici ve ileti işlemcisinde 1099, 1100 ve 1101 numaralı bağlantı noktaları
  • Yönlendiricilerde 8081 ve 15999 numaralı bağlantı noktaları
  • Mesaj işleyicilerde 8082 ve 8998 numaralı bağlantı noktası
  • Yönetim sunucusunda 8080 numaralı bağlantı noktası

Aşağıdaki üçüncü taraf bağlantı noktalarının etkin olduğundan emin olun:

  • Qpid bağlantı noktası 5672
  • Postgres bağlantı noktası 5432
  • Cassandra bağlantı noktası 7000, 7199, 9042, 9160
  • ZooKeeper bağlantı noktası 2181
  • SymasLDAP bağlantı noktası 10389

Her bir Apigee bileşeninin API çağrılarını hangi bağlantı noktasında dinlediğini belirlemek için Yönetim Sunucusu'na (genellikle 8080 bağlantı noktasında bulunur) aşağıdaki API çağrılarını gönderin:

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

Bu komutların çıktısı, aşağıda gösterilene benzer bölümler içerir. http.management.port bölümünde, belirtilen bileşenin bağlantı noktası numarası verilir.

{
  "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"
}

Günlükleri Görüntüleme

Günlük dosyaları, sistemin etkinliği/işlemiyle ilgili mesajları takip eder. İşlemler başladığında ve tamamlandığında veya bir hata durumu oluştuğunda günlükte mesajlar gösterilir. Günlük dosyalarını görüntüleyerek sistem bileşenleri (ör. CPU, bellek, disk, yük, işlemler vb.) hakkında bilgi edinebilirsiniz. Bu sayede, mevcut sistem sorunlarının kaynağını belirleyip teşhis edebilir veya olası sistem sorunlarını tahmin edebilirsiniz.

Örneğin, bir bileşenin tipik sistem günlüğü aşağıda gösterildiği gibi şu girişleri içerir:

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 ;

Bir sunucuyu yeniden başlatmak zorunda kalmadan günlük kaydı mekanizmasını kontrol etmek için /opt/apigee/conf/logback.xml dosyasını düzenleyebilirsiniz. logback.xml dosyası, günlük mekanizmasının yapılandırma değişiklikleri için logback.xml dosyasını kontrol etme sıklığını ayarlayan aşağıdaki özelliği içerir:

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

Varsayılan olarak, günlük kaydı mekanizması her dakika değişiklik olup olmadığını kontrol eder. scanPeriod özelliğine zaman birimlerini eklemezseniz varsayılan olarak milisaniye kullanılır.

Aşağıdaki tabloda, Apigee Edge Private Cloud bileşenlerinin günlük dosyalarının konumu belirtilmektedir.

Bileşenler Konum

Yönetim Sunucusu

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

Yönlendirici

opt/apigee/var/log/edge-router

Mesaj İşleyici

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

Qpid Sunucusu

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

Apigee Postgres Sunucusu

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

Edge kullanıcı arayüzü

opt/apigee/var/log/edge-ui

ZooKeeper

opt/apigee/var/log/apigee-zookeeper

SymasLDAP

opt/apigee/var/log/apigee-openldap

Cassandra

opt/apigee/var/log/apigee-cassandra

Qpidd

opt/apigee/var/log/apigee-qpidd

PostgreSQL veritabanı

opt/apigee/var/log/apigee-postgresql

Mesaj işleyici ve Edge kullanıcı arayüzü için hata ayıklama günlüklerini etkinleştirme

Mesaj İşleyici için hata ayıklama günlüklerini etkinleştirmek üzere:

  1. Mesaj İşleyici düğümünde /opt/apigee/customer/application/message-processor.properties dosyasını düzenleyin. Bu dosya yoksa oluşturun.
  2. Dosyaya aşağıdaki özelliği ekleyin:
    conf_system_log.level=DEBUG
  3. Mesaj İşleyici'yi yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

Edge kullanıcı arayüzü için hata ayıklama günlüklerini etkinleştirmek üzere:

  1. Edge kullanıcı arayüzü düğümünde /opt/apigee/customer/application/ui.properties öğesini düzenleyin. Bu dosya yoksa oluşturun.
  2. Dosyaya aşağıdaki özelliği ekleyin:
    conf_application_logger.application=DEBUG
  3. Edge kullanıcı arayüzünü yeniden başlatın:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

apigee-monit ile ilgili en iyi uygulamalar

apigee-monit kullanırken Apigee şunları yapmanızı önerir:

  • Yedekleme veya yükseltme gibi bir bileşeni başlatan ya da durduran bir işlem gerçekleştirmeden önce bileşeni izlemeyi durdurun.
  • apigee-monit gibi bir araç kullanarak izleyin.cron Daha fazla bilgi için apigee-monit'i izleme başlıklı makaleyi inceleyin.

İzleme Araçları

Nagios, Collectd, Graphite, Splunk, Sumologic ve Monit gibi izleme araçları, tüm kurumsal ortamınızı ve iş süreçlerinizi izlemenize yardımcı olabilir.

Bileşen Nagios Collectd Splunk

Sistem düzeyinde kontroller

CPU kullanımı

Boş/kullanılan bellek

Disk alanı kullanımı

Ağ istatistikleri

İşlemler

API kontrolleri

JMX

Java

Günlük dosyaları

Kritik olaylar

Hız sınırı isabeti

Arka uç sunucusuna (Hybris veya SharePoint) ulaşılamıyor

FaaS'ye (STS) ulaşılamıyor

Uyarı etkinlikleri

SMTP sunucusuna ulaşılamıyor

İhlal edilen HDS'ler