İzlemeyle ilgili en iyi uygulamalar

İ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ıları 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ış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

Etkin olduklarından emin olmak için aşağıdaki bağlantı noktalarını izleyin:

  • Yönetim Sunucusu, Yönlendirici ve Mesaj İşlemcisi'nde 4526, 4527 ve 4528 numaralı bağlantı noktaları
  • Yönetim sunucusu, yönlendirici ve Mesaj İşleyici üzerinde 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
  • 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 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 çıktısı, 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 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 ;

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şiklikleri 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 Server

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

Yeni Edge kullanıcı arayüzü

/opt/apigee/var/log/edge-management-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 İşleyici 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

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 herhangi bir işlem gerçekleştirmeden önce bileşeni izlemeyi durdurun.
  • apigee-monit gibi bir araç kullanarak cron izleyin. 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

Sıklık sınırı aşıldı

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

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

Uyarı etkinlikleri

SMTP sunucusuna erişilemiyor

HDS ihlalleri