İzlemeyle ilgili en iyi uygulamalar

İzleme uyarıları

Apigee Edge, bir etkinlik başarısız olduğunda hata veya arıza oluştuğunda uyarıları günlüklere veya 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

Bir uyarının oluşturulması gereken eşiği ayarlayın. Bu ayar, donanım yapılandırmanıza bağlıdır. Eşik, kapasitenizle ilişkili olarak ayarlanmalıdır. Örneğin, yalnızca 6 GB kapasiteniz varsa Apigee Edge çok düşük olabilir. Eşiği eşit (=) veya büyük (>) ölçütüyle atayabilirsiniz. Ayrıca, art arda iki uyarı oluşturulması 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:

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şleyicideki 4526, 4527 ve 4528 numaralı bağlantı noktaları
• Yönetim sunucusu, yönlendirici ve ileti işleyicideki 1099, 1100 ve 1101 numaralı bağlantı noktaları
• Yönlendiricilerde 8081 ve 15999 bağlantı noktaları
• Mesaj işleyicilerde 8082 ve 8998 bağlantı noktaları
• Yönetim sunucusunda 8080 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 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ındadır) 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ı, sistemdeki etkinlik/işlemle ilgili mesajları izler. İşlemler başladığında ve tamamlandığında ya da bir hata durumu oluştuğunda günlükte mesajlar görünür. Günlük dosyalarını görüntüleyerek, başarısız duruma ulaşmadan önce ve ulaştıktan sonra CPU, bellek, disk, yük, işlemler vb. sistem bileşenleri hakkında bilgi edinebilirsiniz. Bu sayede mevcut sistem sorunlarının kaynağını tespit edip teşhis edebilir veya olası sistem sorunlarını tahmin edebilirsiniz.

Örneğin, bir bileşenin tipik sistem günlüğü aşağıdaki gibi girişler 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 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" >

Günlük kaydı mekanizması varsayılan olarak değişiklikleri her dakika 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 gösterilmektedir.

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

Mesaj iş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 değerini düzenleyin. Bu dosya yoksa oluşturun.
2. Dosyaya aşağıdaki özelliği ekleyin:

   conf_system_log.level=DEBUG

3. Mesaj işleyiciyi 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 değerini 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 en iyi uygulamaları

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

• Yedekleme veya yükseltme gibi bir bileşeni başlatan ya da durduran bir işlem yapmadan önce bileşeni izlemeyi durdurun.
• cron gibi bir araç kullanarak apigee-monit'ü 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ı, kurumsal ortamınızın ve iş süreçlerinizin tamamını izlemenize yardımcı olabilir.