İzleme ile İlgili En İyi Uygulamalar

Edge for Private Cloud sürüm 4.17.05

İzleme Uyarıları

Apigee Edge, bir etkinliğin başarısız olması nedeniyle hata veya arıza oluştuğunda uyarıları sistem günlüklerine 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 yapılandırır. Uyarılar hakkında daha fazla bilgi için Apigee Destek Ekibi ile iletişime geçin.

Uyarı eşiklerini ayarlama

Uyarı oluşturulması gereken bir eşik belirleyin. Seçtiğiniz ayar, 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şittir (=) veya büyüktür (>) ölçütüyle eşik atayabilirsiniz. Ayrıca, art arda iki uyarı oluşturma işlemi arasındaki zaman aralığını da belirtebilirsiniz. Saat/dakika/saniye seçeneğini kullanabilirsiniz.

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

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

Uyarı

Önerilen Eşik

Açıklama

Bellek az

500MB

Bellek, bir bileşeni başlatmak için çok düşük

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

8 GB

Disk alanı çok azaldı.

Yüksek yük

3+

Çalıştırılmayı bekleyen işlemler beklenmedik şekilde arttı

İşlem durduruldu

Yok, doğru veya yanlış Boole değeri

Sistemdeki Apigee Java işlemi durduruldu

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

Aşağıdaki bağlantı noktalarını izleyerek etkin olduklarından emin olun:

  • Yönetim Sunucusu, Yönlendirici ve Mesaj İşlemcisi'nde 4526, 4527 ve 4528 numaralı bağlantı noktaları
  • Yönetim Sunucusu, Yönlendirici ve Mesaj İşlemcisi'nde 1099, 1100 ve 1101 numaralı bağlantı noktaları
  • Yönlendiricilerde 8081 ve 15999 numaralı bağlantı noktaları
  • Mesaj İşlemciler'de 8082 ve 8998 numaralı bağlantı noktaları

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
  • OpenLDAP 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 numaralı 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 çıkışı, aşağıda gösterilene benzer bölümler içerir. "http.management.port" bölümü, belirtilen bileşenin bağlantı noktası numarasını verir.

{
  "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şlayıp tamamlandığında veya bir hata durumu oluştuğunda günlükte mesajlar görünür. Günlük dosyalarını görüntüleyerek sistem bileşenleri (ör. CPU, bellek, disk, yük, işlemler vb.) hakkında, başarısız duruma ulaşmadan önce ve sonra 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ğıdaki 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 ;

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 kaydı 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şiklikleri kontrol eder. scanPeriod özelliğinde zaman birimlerini atlarsanız varsayılan olarak milisaniye kullanılır.

Aşağıdaki tabloda, Apigee Edge Private Cloud bileşenlerinin günlük dosyası konumu gösterilmektedir.

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 Server

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

OpenLDAP

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

Message Processor 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/messsage-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 dosyasını 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

İ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

Sıklık sınırına ulaşıldı

?

Arka uç sunucusuna (Hybris veya SharePoint) erişilemiyor.

?

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

?

Uyarı etkinlikleri

SMTP sunucusuna erişilemiyor

?

İhlal edilen HDS'ler

?