Apigee-monit ile kendi kendine iyileşme

Private Cloud için Apigee Edge, açık kaynak tabanlı apigee-monit aracını içerir monit yardımcı programı. Düzenli aralıklarla apigee-monit Edge hizmetleri anketleri; Bir hizmet kullanılamıyorsa apigee-monit hizmeti yeniden başlatmayı dener.

apigee-monit uygulamasını kullanmak için manuel olarak yüklemeniz gerekir. standart bir yükleme gerektirir.

apigee-monit, varsayılan olarak Edge hizmetlerinin durumunu 60 saniyede bir kontrol eder.

Hızlı başlangıç

Bu bölümde, apigee-monit ürününü hızla kullanmaya nasıl başlayacağınız gösterilmektedir.

Amazon Linux veya Oracle-Linux-7.X kullanıyorsanız önce monit'i yükleyin. Aksi halde bu adımı atlayın.

sudo yum install -y https://kojipkgs.fedoraproject.org/packages/monit/5.25.1/1.el6/x86_64/monit-5.25.1-1.el6.x86_64.rpm

apigee-monit uygulamasını yüklemek için aşağıdaki adımları uygulayın:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Bu konuların ve diğer konuların her biri sonraki bölümlerde ayrıntılı olarak açıklanmıştır.

Apigee-monit hakkında

apigee-monit, bir düğümdeki tüm bileşenlerin çalışır durumda kalmasına yardımcı olur. Bu işlemi çok çeşitli hizmetler sunar:

• Başarısız hizmetler yeniden başlatılıyor
• Özet bilgileri görüntüleme
• Günlük kaydı izleme durumu
• Bildirim gönderme
• Edge dışı hizmetleri izleme

Apigee, çalıştığından emin olmak için apigee-monit uygulamasını izlemenizi önerir. Daha fazla bilgi için View Apigee-monit bölümünü inceleyin.

Apigee-monit mimarisi

Private Cloud için Apigee Edge kurulumu ve yapılandırması sırasında isteğe bağlı olarak ayrı bir örnek yükleyebilirsiniz Kümenizdeki her düğümde apigee-monit tane var. Bu ayrı apigee-monit örnekleri şunlardan bağımsız olarak çalışır: bir diğeri: bileşenlerinin durumunu diğer düğümlere iletmez veya izleme yardımcı programının arızalarını merkezi bir hizmete iletme.

Aşağıdaki resimde, 5 düğümlü bir kümedeki apigee-monit mimarisi gösterilmektedir:

Bileşen yapılandırmaları

apigee-monit, hangi bileşenlerin izleneceğini belirlemek için bileşen yapılandırmalarını kullanır. kontrol edilecek bileşenin özellikleri ve hata durumunda hangi işlemin yapılacağı.

Varsayılan olarak apigee-monit, önceden tanımlanmış bileşenlerini kullanarak bir düğümdeki tüm Edge bileşenlerini izler yapılandırmanın üç yolu vardır. Varsayılan ayarları görüntülemek için apigee-monit bileşeni yapılandırmasına bakabilirsiniz dosyası olarak da kaydedebilir. Varsayılan bileşen yapılandırmalarını değiştiremezsiniz.

apigee-monit, kontrol ettiği bileşene bağlı olarak bir bileşenin farklı özelliklerini kontrol eder. İlgili içeriği oluşturmak için kullanılan Aşağıdaki tabloda, apigee-monit ürününün her bileşen için neleri kontrol ettiği ve bileşenin nerede her bir bileşen için geçerli olduğunu unutmayın. Bazı bileşenlerin tek bir yapılandırmada tanımlandığını unutmayın dosyası oluşturabilirsiniz. Bu dosyalarda diğerlerinin kendi yapılandırmaları vardır.

Aşağıdaki örnekte edge-router için varsayılan bileşen yapılandırması gösterilmektedir bileşen:

check host edge-router with address localhost
  restart program = "/opt/apigee/apigee-service/bin/apigee-service edge-router monitrestart"
  if failed host 10.1.1.0 port 8081 and protocol http
    and request "/v1/servers/self/uuid"
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

  if failed port 15999 and protocol http
    and request "/v1/servers/self"
    and status < 600
    with timeout 15 seconds
    for 2 times within 3 cycles
  then restart

Aşağıdaki örnekte Klasik Kullanıcı Arayüzü (edge-ui) için varsayılan yapılandırma gösterilmektedir bileşen:

check process edge-ui
 with pidfile /opt/apigee/var/run/edge-ui/edge-ui.pid
 start program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui start" with timeout 55 seconds
 stop program = "/opt/apigee/apigee-service/bin/apigee-service edge-ui stop"

Bu, bileşen adı edge-management-ui

Herhangi bir Apigee Edge for Private Cloud bileşeninin varsayılan bileşen yapılandırmalarını değiştiremezsiniz. Bu sayede, Ancak, harici hizmetler için hedef uç noktanız gibi kendi bileşen yapılandırmalarınızı ekleyin veya httpd hizmeti. Daha fazla bilgi için bkz. Apigee dışı bileşen yapılandırmaları.

Varsayılan olarak apigee-monit, üzerinde çalıştığı düğümdeki tüm bileşenleri izler. Bu ayarları devre dışı bırakmak için bunu tüm bileşenler veya ayrı ayrı bileşenler için devre dışı bırakabilirsiniz. Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

• Bir bileşeni izlemeyi durdurma ve başlatma
• apigee-monit uygulamasını durdurma, başlatma ve devre dışı bırakma

Apigee-monit uygulamasını yükleme

apigee-monit varsayılan olarak yüklü değil; yeni sürüme geçtikten veya yükledikten sonra manuel olarak yükleyebilirsiniz. Private Cloud için Apigee Edge'in 4.19.01 veya daha yeni bir sürümü kullanılmalıdır.

Bu bölümde apigee-monit uygulamasının nasıl yükleneceği açıklanmaktadır.

apigee-monit uygulamasının kaldırılması hakkında bilgi için bkz. apigee-monit uygulamasını kaldırın.

Apigee-monit uygulamasını yükleme

Bu bölümde apigee-monit uygulamasının nasıl yükleneceği açıklanmaktadır.

apigee-monit uygulamasını yüklemek için:

1. apigee-monit uygulamasını aşağıdaki komutla yükleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit install

2. Aşağıdaki komutla apigee-monit hizmetini yapılandırın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure

3. apigee-monit uygulamasını şu komutla başlatın:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit start

4. Kümenizdeki her düğümde bu prosedürü tekrarlayın.

Bileşenleri izlemeyi durdurma ve başlatma

Bir hizmet herhangi bir nedenle durdurulduğunda apigee-monit hizmeti yeniden başlatmaya çalışır.

Bir bileşeni kasıtlı olarak durdurmak istiyorsanız bu durum bir soruna neden olabilir. Örneğin, eğitime bir bileşeni yedeklemeniz veya yeni sürüme geçirmeniz gerektiğinde durdurmak isterseniz. apigee-monit, yedekleme veya yükseltme sırasında hizmeti yeniden başlatırsa bakım prosedürünüz aşağıdaki gibi olabilir: bozulmasına neden olabilir.

Aşağıdaki bölümlerde, bileşenlerin izlenmesini durdurma seçenekleri gösterilmektedir.

Bir bileşeni durdurma ve izlemeyi kaldırma

Bir bileşeni durdurmak ve izlemeyi kaldırmak için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL veritabanı)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge TOA)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (Yönetim Sunucusu)
• edge-management-ui (yeni Edge kullanıcı arayüzü)
• edge-message-processor (Mesaj İşleyici)
• edge-postgres-server (Postgres Sunucusu)
• edge-qpid-server (Qpid Sunucusu)
• edge-router (Edge Yönlendirici)
• edge-ui (Klasik kullanıcı arayüzü)

Not: "all" , stop-component için geçerli bir seçenek değil. Durdurulabilir ve stop-component ile aynı anda yalnızca bir bileşenin izlemeyi kaldırın.

Bileşeni yeniden başlatmak ve izlemeyi devam ettirmek için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start-component -c component_name

Not: "all" , start-component için geçerli bir seçenek değil.

Tüm bileşenleri durdurma ve izleme kaldırma talimatları için Tüm bileşenleri durdurun ve bileşenlerin izlemesini kaldırın.

Bir bileşenin izlemesini kaldırma (ancak durdurmayın)

Bir bileşenin izlemesini kaldırmak (ancak durdurmayın) için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c component_name

• apigee-cassandra (Cassandra)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (PostgreSQL veritabanı)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge TOA)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (Yönetim Sunucusu)
• edge-management-ui (yeni Edge kullanıcı arayüzü)
• edge-message-processor (Mesaj İşleyici)
• edge-postgres-server (Postgres Sunucusu)
• edge-qpid-server (Qpid Sunucusu)
• edge-router (Edge Yönlendirici)
• edge-ui (Klasik kullanıcı arayüzü)

Bileşeni izlemeye devam etmek için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c component_name

Tüm bileşenlerin takibini kaldır (ancak durdurmayın)

Tüm bileşenlerin izlenmesini kaldırmak (ama durdurmamak) için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Tüm bileşenleri izlemeye devam etmek için aşağıdaki komutu yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Tüm bileşenleri durdur ve izlemeyi kaldır

Tüm bileşenleri durdurmak ve izlemeyi kaldırmak için aşağıdaki komutları yürütün:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all
/opt/apigee/apigee-service/bin/apigee-all stop

Tüm bileşenleri yeniden başlatmak ve izlemeyi devam ettirmek için aşağıdaki komutları çalıştırın:

/opt/apigee/apigee-service/bin/apigee-all start
/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -c all

Tüm bileşenleri izlemeyi durdurmak için apigee-monit öğesini de şurada açıklandığı gibi devre dışı bırakabilirsiniz: Apigee-monit'i durdurma, başlatma ve devre dışı bırakma.

Apigee-monit'i durdurma, başlatma ve devre dışı bırakma

Her hizmette olduğu gibi, apigee-service kullanarak apigee-monit hizmetini durdurabilir ve başlatabilirsiniz komutunu kullanın. Buna ek olarak, apigee-monit, şunları yapmanıza olanak tanıyan unmonitor komutunu destekler: İzleme bileşenlerini geçici olarak durdurabilir.

Apigee-monit'i durdurma

apigee-monit uygulamasını durdurmak için aşağıdaki komutu kullanın:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop

Apigee-monit uygulamasını başlat

apigee-monit uygulamasını başlatmak için aşağıdaki komutu kullanın:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit start

Apigee-monit'i devre dışı bırak

Aşağıdaki komutu kullanarak düğümdeki tüm bileşenleri izlemeyi askıya alabilirsiniz:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit unmonitor -c all

Alternatif olarak, açıklandığı gibi apigee-monit öğesini düğümden kaldırarak kalıcı olarak devre dışı bırakabilirsiniz. apigee-monit uygulamasını kaldır bölümünde bulabilirsiniz.

Apigee-monit uygulamasını kaldırma

apigee-monit uygulamasını kaldırmak için:

conf_monit_httpd_port httpd arka plan programının bağlantı noktası. apigee-monit, kontrol paneli için httpd kullanıyor uygulamasını kullanarak raporları/özetleri etkinleştirebilirsiniz. Varsayılan değer 2812'dir. conf_monit_httpd_allow httpd arka plan programına yapılan isteklerde kısıtlamalar. apigee-monit kullanımları Kontrol paneli uygulamasını çalıştırmak ve raporları/özetleri etkinleştirmek için httpd. Bu değer, localhost'a (httpd ürününün çalıştığı ana makine) işaret eder.

Bu isteklerin kullanıcı adı ve şifre içermesini zorunlu kılmak için aşağıdaki söz dizimini kullanın:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

Kullanıcı adı ve şifre eklerken "\n" girin arasına yerleştirin. Şunları yapmayın: değere gerçek yeni satırları veya satır başı karakterlerini ekleyin.

conf_monit_monit_datadir Etkinlik ayrıntılarının depolandığı dizin. conf_monit_monit_delay_time apigee-monit uygulamasının belleğe ilk kez yüklendikten sonra işlem yapmadan önce beklediği süre koşar. Bu durum, yalnızca apigee-monit işlemini yalnızca ilk işlem kontrolünü etkiler. conf_monit_monit_logdir apigee-monit günlük dosyasının konumu. conf_monit_monit_retry_time apigee-monit uygulamasının her bir işlemi kontrol etme sıklığı; varsayılan değer 60'tır saniye. conf_monit_monit_rundir apigee-monit tarafından işlemleri kontrol etmek için kullanılan PID ve durum dosyalarının konumu.

Varsayılan apigee-monit denetim ayarlarını özelleştirmek için:

1. Aşağıdaki dosyayı düzenleyin:

   /opt/apigee/customer/application/monit.properties

   Dosya mevcut değilse dosyayı oluşturun ve sahibi "Apigee"ye ayarlayın kullanıcı:

   chown apigee:apigee /opt/apigee/customer/application/monit.properties

   Dosya zaten mevcutsa, tanımlanmış ek yapılandırma özellikleri olabilir. Yukarıdaki tabloda listelenenlerin dışında. Aşağıdakiler dışındaki özellikleri değiştirmemeniz gerekir: izin verilenler listesine eklenir.

2. Özellik değerlerini yeni değerlerinizle ayarlayın veya değiştirin.

   Örneğin, günlük dosyasının konumunu /tmp olarak değiştirmek için aşağıdaki mülk:

   conf_monit_monit_logdir=/tmp/apigee-monit.log

3. monit.properties dosyasında yaptığınız değişiklikleri kaydedin.
4. Aşağıdaki komutla apigee-monit uygulamasını yeniden yükleyin:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

   apigee-monit yeniden başlatılmazsa günlük dosyasındaki hataları kontrol etmek için aşağıdaki adımları uygulayın: apigee-monit günlük dosyalarına erişin.

5. Kümenizdeki her düğüm için bu prosedürü tekrarlayın.

Bunun yalnızca Edge dışı bileşenler için olduğunu unutmayın. Bileşen yapılandırmalarını özelleştiremezsiniz kontrol edebilirsiniz.

Apigee-monit günlük dosyalarına erişme

apigee-monit; etkinlikler, yeniden başlatmalar, yapılandırma değişiklikleri ve uyarılar dahil olmak üzere tüm etkinlikleri bir günlüğe kaydeder dosyası olarak kaydedebilirsiniz.

Günlük dosyasının varsayılan konumu şöyledir:

/opt/apigee/var/log/apigee-monit/apigee-monit.log

Varsayılan konumu, apigee-monit denetimini özelleştirerek Ayarlar'ı tıklayın.

Günlük dosyası girişleri aşağıdaki biçimdedir:

'edge-message-processor' trying to restart
[UTC Dec 14 16:20:42] info     : 'edge-message-processor' trying to restart
'edge-message-processor' restart: '/opt/apigee/apigee-service/bin/apigee-service edge-message-processor monitrestart'

apigee-monit günlük dosyası girişlerinin biçimini özelleştiremezsiniz.

Apigee-monit ile birleştirilmiş durumu göster

apigee-monit, bir düğümdeki bileşenler:

Komut	Kullanım
report	/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
summary	/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Bu komutların her biri sonraki bölümlerde daha ayrıntılı olarak açıklanmıştır.

rapor

report komutu, kaç bileşenin bulunduğuna dair özet bir görünüm sunar. kapalı, şu anda başlatılıyor veya bir düğümde izlenmiyor. İlgili içeriği oluşturmak için kullanılan aşağıdaki örnek, report komutunu çağırır:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report

Aşağıdaki örnekte bir AIO'da (hepsi bir arada) report çıkışı gösterilmektedir yapılandırma:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
up:            11 (100.0%)
down:           0 (0.0%)
initialising:   0 (0.0%)
unmonitored:    1 (8.3%)
total:         12 services

Bu örnekte, apigee-monit tarafından 12 hizmetten 11'inin etkin olduğu bildirilmiştir. Bir hizmet şu anda izleniyor.

Connection refused report komutudur. Bu durumda, conf_monit_monit_delay_time mülk ve ardından tekrar deneyin.

özet

summary komutu, her bir bileşeni listeler ve durumlarını sunar. Aşağıdakiler örnek, summary komutunu çağırır:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary

Aşağıdaki örnekte bir AIO'da (hepsi bir arada) summary çıkışı gösterilmektedir yapılandırma:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
Monit 5.25.1 uptime: 4h 20m
 Service Name                     Status                      Type
 host_name                        OK                          System
 apigee-zookeeper                 OK                          Process
 apigee-cassandra                 OK                          Process
 apigee-openldap                  OK                          Process
 apigee-qpidd                     OK                          Process
 apigee-postgresql                OK                          Process
 edge-ui                          OK                          Process
 edge-qpid-server                 OK                          Remote Host
 edge-postgres-server             OK                          Remote Host
 edge-management-server           OK                          Remote Host
 edge-router                      OK                          Remote Host
 edge-message-processor           OK                          Remote Host

Connection refused summary komutu, conf_monit_monit_delay_time mülk ve ardından tekrar deneyin.

Apigee-monit izleme

apigee-monit ürününün her düğümde çalışıp çalışmadığını düzenli olarak kontrol etmeniz önerilir.

apigee-monit hizmetinin çalışıp çalışmadığını kontrol etmek için aşağıdaki komutu kullanın:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

Apigee, apigee-monit çalıştıran her düğümde bu komutu düzenli olarak vermenizi önerir. Bunu yapmanın bir yolu, planlanmış görevleri şurada yürüten cron gibi bir yardımcı program kullanmaktır: önceden tanımlanmış aralıklarda kullanılabilir.

apigee-monit aracını izlemek amacıyla cron uygulamasını kullanmak için:

1. apigee-monit.cron kodunu kopyalayarak cron desteği ekleyin dizinini /etc/cron.d dizinine ekleyin:

   cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/

2. Düzenlemek için apigee-monit.cron dosyasını açın.

   apigee-monit.cron dosyası, yürütülecek cron işini tanımlar hem de işin ne sıklıkta yürütüleceğini belirler. Aşağıdaki örnekte, varsayılan olarak gelen değerleri:

   # Cron entry to check if monit process is running. If not start it
   */2 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

   Bu dosya şu söz dizimini kullanır; burada ilk beş alan, apigee-monit, işlemini gerçekleştirir:

   min hour day_of_month month day_of_week task_to_execute

   Örneğin, varsayılan yürütme süresi */2 * * * * şeklindedir. Bu değer, apigee-monit işlemini 2 dakikada bir kontrol etmek için cron.

   Bir cron işini dakikada bir defadan daha sık yürütemezsiniz.

   cron kullanımı hakkında daha fazla bilgi için sunucunuzun işletim sistemi dokümanlarına veya yönetim kılavuzuna bakın sayfalar.

3. cron ayarlarını kuruluşunuzun politikalarıyla eşleşecek şekilde değiştirin. Örneğin, yürütme sıklığını her 5 dakikada bir olarak değiştirip iş tanımını şu şekilde ayarlayabilirsiniz:

   */5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit

4. apigee-monit.cron dosyasını kaydedin.
5. Kümenizdeki her düğüm için bu prosedürü tekrarlayın.

cron, apigee-monit videosunu izlemeye başlamazsa şunlardan emin olun:

• cron iş tanımından sonra boş bir satır var.
• Dosyada tanımlanmış yalnızca bir cron işi var. (Yorumlanan satırlar count.)

apigee-monit işini durdurmak veya geçici olarak devre dışı bırakmak istiyorsanız bu cron işini devre dışı bırakmanız gerekir. aksi takdirde cron, apigee-monit uygulamasını yeniden başlatacaktır.

cron uygulamasını devre dışı bırakmak için aşağıdakilerden birini yapın:

• /etc/cron.d/apigee-monit.cron dosyasını silin:

  sudo rm /etc/cron.d/apigee-monit.cron

  Şu durumlarda e-postayı yeniden kopyalamanız gerekir: daha sonra apigee-monit izlemek için cron eklentisini yeniden etkinleştirmek istiyor.

  VEYA

• /etc/cron.d/apigee-monit.cron dosyasını düzenle ve iş hakkında yorum yap "#" ekleyerek tanımla satır başına ekleyin; örneğin:

  # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit