Apigee-monit ile kendi kendine iyileşme

Edge for Private Cloud 4.19.01 sürümü

Apigee Edge for Private Cloud'da açık kaynak para yardımcı programını temel alan apigee-monit aracı bulunur. apigee-monit, Edge hizmetlerini düzenli olarak yoklar. 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 kurulumun bir parçası değildir.

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

Hızlı başlangıç

Aşağıdaki tabloda, apigee-monit hizmetini hemen nasıl kullanmaya başlayabileceğiniz gösterilmektedir:

  apigee-monit uygulamasını yükle
/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

Bu işlem apigee-monit hizmetini yükler ve varsayılan olarak düğümdeki tüm bileşenleri izlemeye başlar.

  Bileşenleri izlemeyi durdurma
/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
  Bileşenleri izlemeye başlayın
/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
  Özet durum bilgilerini alma
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report
/opt/apigee/apigee-service/bin/apigee-service apigee-monit summary
  apigee-monit günlük dosyalarına bakın
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Bu konular ve diğerleri sonraki bölümlerde ayrıntılı olarak açıklanmaktadır.

Apigee-monit hakkında

apigee-monit, bir düğümdeki tüm bileşenlerin çalışır durumda kalmasını sağlar. Bunu, aşağıdakiler gibi çeşitli hizmetler sunarak yapar:

  • Başarısız hizmetler yeniden başlatılıyor
  • Özet bilgiler görüntüleniyor
  • Günlük kaydı izleme durumu
  • Bildirimler gönderiliyor
  • Edge dışı hizmetleri izleme

Apigee, çalıştığından emin olmak için apigee-monit uygulamasını izlemenizi önerir. Daha fazla bilgi için Apigee-monit programını izleme 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 kümenizdeki her düğüme ayrı bir apigee-monit örneği yükleyebilirsiniz. Bu ayrı apigee-monit örnekleri birbirinden bağımsız çalışır: Bileşenlerinin durumunu diğer düğümlere iletmezler veya izleme yardımcı programının hatalarını herhangi bir merkezi hizmete bildirmezler.

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

Şekil 1: Ayrı bir apigee-monit örneği, bir kümedeki her düğümde yalıtım halinde çalışır

Desteklenen platformlar

apigee-monit, Private Cloud kümeniz için aşağıdaki platformları destekler. (apigee-monit için desteklenen işletim sistemi, Private Cloud sürümüne bağlıdır.)

İşletim Sistemi Gizli Bulut Sürümü
v4.50.00 v4.51.00 v4.52.00
CentOS 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8
RedHat Enterprise Linux (RHEL) 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8, 7,9, 8,0 7,5, 7,6, 7,7, 7,8, 7,9, 8,0
Oracle Linux 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8 7,5, 7,6, 7,7, 7,8
* Teknik olarak desteklenmemekle birlikte, Apigee Edge for Private Cloud sürümünün 4.19.01 sürümünde CentOS/RHEL/Oracle sürüm 6.9'a apigee-monit yükleyip kullanabilirsiniz.

Bileşen yapılandırmaları

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

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

apigee-monit, kontrol ettiği bileşene bağlı olarak bileşenin farklı özelliklerini kontrol eder. Aşağıdaki tabloda, apigee-monit ürününün her bileşen için neleri kontrol ettiği ve her bileşen için bileşen yapılandırmasının nerede olduğu gösterilmektedir. Bazı bileşenlerin tek bir yapılandırma dosyasında tanımlandığını, bazılarının kendi yapılandırmalarına sahip olduğunu unutmayın.

Bileşen Yapılandırma konumu Neler izlenir?
Yönetim Sunucusu /opt/apigee/edge-management-server/monit/default.conf apigee-monit kontrolleri:
  • Belirtilen bağlantı noktaları açık ve istek kabul ediyor
  • Belirtilen protokoller destekleniyor
  • Yanıtın durumu

Ayrıca, şu bileşenler için apigee-monit:

  • İşlem yapmadan önce belirli sayıda döngü içinde birden çok hata gerektirir.
  • Özel istek yolu ayarlar
Mesaj İşleyici /opt/apigee/edge-message-processor/monit/default.conf
Postgres Sunucusu /opt/apigee/edge-postgres-server/monit/default.conf
Qpid Sunucusu /opt/apigee/edge-qpid-server/monit/default.conf
Yönlendirici /opt/apigee/edge-router/monit/default.conf
Cassandra
Edge kullanıcı arayüzü
OpenLDAP
Postgres
Qpid
Zookeeper
/opt/apigee/data/apigee-monit/monit.conf apigee-monit kontrolleri:
  • Hizmet çalışıyor

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

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 edge-ui bileşeninin varsayılan yapılandırması gösterilmektedir:

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"

Apigee Edge for Private Cloud bileşeninin varsayılan bileşen yapılandırmalarını değiştiremezsiniz. Ancak hedef uç noktanız veya httpd hizmeti gibi harici hizmetler için kendi bileşen yapılandırmalarınızı ekleyebilirsiniz. Daha fazla bilgi için Apigee dışı bileşen yapılandırmaları bölümüne bakın.

Varsayılan olarak apigee-monit, üzerinde çalıştığı düğümdeki tüm bileşenleri izler. Bu özelliği tüm bileşenler veya tek tek bileşenler için etkinleştirebilir ya da devre dışı bırakabilirsiniz. Daha fazla bilgi için aşağıdaki sayfaları inceleyin:

Apigee-monit'i yükleyin

apigee-monit varsayılan olarak yüklü değildir. Apigee Edge for Private Cloud'un 4.19.01 veya sonraki bir sürümünü yükselttikten ya da yükledikten sonra manuel olarak yükleyebilirsiniz.

Bu bölümde, desteklenen platformlarda ve desteklenmeyen CentOS/RHEL/Oracle Linux'un 6.9 sürümünün yanı sıra apigee-monit ürününün nasıl yükleneceği açıklanmaktadır.

apigee-monit uninstalling hakkında bilgi için apigee-monit uygulamasını kaldırma sayfasına bakın.

Desteklenen bir platforma Apigee-monit yükleme

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

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

  1. Aşağıdaki komutla apigee-monit uygulamasını yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. apigee-monit hizmetini aşağıdaki komutla yapılandırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  3. apigee-monit uygulamasını aşağıdaki 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.

Apigee-monit'i desteklenmeyen bir platforma yükleme

apigee-monit, CentOS/RHEL/Oracle Linux'un 6.9 sürümünde desteklenmez ancak bu bölümde, uygulamayı nasıl yükleyebileceğiniz açıklanmaktadır.

CentOS/RHEL/Oracle Linux'un 6.9 sürümüne apigee-monit uygulamasını yüklemek için:

  1. Enterprise Linux için Extra Packages deposunu (veya kısaca EPEL) yükleyin:
    sudo yum install epel-release
  2. EPEL'i devre dışı bırakın:
    yum-config-manager --disable epel
  3. EPEL'i geçici olarak etkinleştirin ve monit uygulamasını yükleyin:
    yum --enablerepo=epel install monit

    monit yüklendikten sonra EPEL deposu devre dışı bırakılmalıdır. enablerepo seçeneği, yalnızca geçerli komut için belirtilen depoyu etkinleştirir.

  4. apigee-monit eklentisini yükleme:
    apigee-service apigee-monit install
    apigee-service apigee-monit configure
    apigee-service apigee-monit start
  5. apigee-monit uygulamasını yükledikten sonra EPEL'in devre dışı bırakıldığını onaylayın:
    yum repolist all | grep epel/x86_64
    !epel/x86_64                  Extra Packages for Enterprise Linu disabled

    Bu örnekte, EPEL deposu devre dışı bırakılmıştır. Ancak devre dışı değilse bu özelliği devre dışı bırakmanız gerekir:

    sudo yum-config-manager --disable epel

Bileşenleri izlemeyi durdurup başlatın

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

Bir bileşeni kasıtlı olarak durdurmak isterseniz bu, soruna neden olabilir. Örneğin, bir bileşeni yedeklemeniz veya yükseltmeniz gerektiğinde durdurmak isteyebilirsiniz. apigee-monit, yedekleme veya yükseltme sırasında hizmeti yeniden başlatırsa bakım prosedürünüz kesintiye uğrayabilir ve büyük olasılıkla başarısız olur.

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 izlemesini kaldırmak için aşağıdaki komutu çalıştırın:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name şunlardan biri olabilir:
  • 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ü)

stop-component için "tümü" geçerli bir seçenek değildir. stop-component ile aynı anda yalnızca bir bileşeni durdurabilir ve izlemeyi bırakabilirsiniz.

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

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

start-component için "tümü" geçerli bir seçenek değildir.

Tüm bileşenleri durdurma ve izlemeyi kaldırma talimatları için Tüm bileşenleri durdurma ve izleme işlemlerini kaldırma bölümüne bakın.

Bir bileşenin izlemeyi iptal edin (ancak durdurmayın)

Bir bileşenin izlemeyi 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
component_name şunlardan biri olabilir:
  • 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 bırakın (ancak bunları durdurmayın)

Tüm bileşenlerin izlenmesini kaldırmak (ancak onları 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 çalıştırı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 izlemelerini iptal etmek için aşağıdaki komutları çalıştırı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 uygulamasını durdurma, başlatma ve devre dışı bırakma bölümünde açıklandığı üzere apigee-monit özelliğini devre dışı da bırakabilirsiniz.

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

Tüm hizmetlerde olduğu gibi apigee-service komutunu kullanarak apigee-monit hizmetini durdurabilir ve başlatabilirsiniz. Ayrıca apigee-monit, bileşenleri izlemeyi geçici olarak durdurmanızı sağlayan unmonitor komutunu destekler.

Apigee-monit'i durdur

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

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

Apigee-monit'i başlat

apigee-monit aracı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şenlerin izlenmesini askıya alabilirsiniz:

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

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

Apigee-monit'i kaldırma

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

  1. apigee-monit işlemini izlemek için bir cron işi oluşturduysanız apigee-monit uygulamasını kaldırmadan önce cron işini kaldırın:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. apigee-monit öğesini aşağıdaki komutla durdurun:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Aşağıdaki komutla apigee-monit uygulamasını kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Kümenizdeki her düğümde bu prosedürü tekrarlayın.

Yeni yüklenen bir bileşeni izleme

apigee-monit çalıştıran bir düğüme yeni bir bileşen yüklerseniz apigee-monit ürününün restart komutunu çalıştırarak bileşeni izlemeye başlayabilirsiniz. Bu işlem, bileşen yapılandırmalarına yeni bileşeni içerecek yeni bir monit.conf dosyası oluşturur.

Aşağıdaki örnekte apigee-monit yeniden başlatılır:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart

Apigee-monit'i özelleştir

Aşağıdakiler de dahil olmak üzere çeşitli apigee-monit ayarlarını özelleştirebilirsiniz:

  1. Varsayılan apigee-monit denetim ayarları
  2. Genel yapılandırma ayarları
  3. Apigee dışı bileşen yapılandırmaları

Varsayılan Apigee-monit denetim ayarları

Durum kontrollerinin sıklığı ve apigee-monit dosyalarının konumları gibi varsayılan apigee-monit kontrol ayarlarını özelleştirebilirsiniz. Bunu, config ile kod tekniğini kullanarak bir özellikler dosyasını düzenleyerek yapabilirsiniz. Özellik dosyaları, Apigee Edge for Private Cloud'u yükseltmenizden sonra bile değişmeden kalır.

Aşağıdaki tabloda özelleştirebileceğiniz varsayılan apigee-monit denetimi ayarları açıklanmaktadır:

Özellik Açıklama
conf_monit_httpd_port httpd arka plan programının bağlantı noktası. apigee-monit, kontrol paneli uygulaması ve raporları/özetleri etkinleştirmek için httpd kullanıyor. Varsayılan değer 2812'dir.
conf_monit_httpd_allow httpd arka plan programı isteklerindeki kısıtlamalar. apigee-monit, kontrol paneli uygulamasını çalıştırmak ve raporları/özetleri etkinleştirmek için httpd kullanıyor. Bu değer localhost'u (httpd'ın çalıştığı ana makine) işaret etmelidir.

İsteklerin 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 her kısıtlamanın arasına "\n" işareti koyun. Değere gerçek yeni satırlar veya satır başı karakterleri eklemeyin.

conf_monit_monit_datadir Etkinlik ayrıntılarının depolandığı dizin.
conf_monit_monit_delay_time apigee-monit ürününün, belleğe ilk yüklendikten sonra çalıştırılmadan önce beklediği süre. Bu durum apigee-monit için yalnızca ilk işlem kontrolünde geçerlidir.
conf_monit_monit_logdir apigee-monit günlük dosyasının konumu.
conf_monit_monit_retry_time apigee-monit ürününün her bir işlemi kontrol etmeye çalışma sıklığı. Varsayılan değer 60 saniyedir.
conf_monit_monit_rundir apigee-monit tarafından işlemlerin kontrol edilmesinde kullanılan PID ve durum dosyalarının konumu.

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

  1. Şu dosyayı düzenleyin:
    /opt/apigee/customer/application/monit.properties

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

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

    Dosya zaten mevcutsa yukarıdaki tabloda listelenenlerin dışında tanımlanmış ek yapılandırma özelliklerinin olabileceğini unutmayın. Yukarıda listelenenler dışındaki özellikleri değiştirmemelisiniz.

  2. Özellik değerlerini yeni değerlerle 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 özelliği ekleyin veya düzenleyin:

    conf_monit_monit_logdir=/tmp/apigee-monit.log

  3. monit.properties dosyasında yaptığınız değişiklikleri kaydedin.
  4. apigee-monit hizmetini aşağıdaki komutla yeniden yapılandırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Aşağıdaki komutla apigee-monit dosyasını yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit uygulamasını yeniden başlatamazsanız günlük dosyasında apigee-monit günlük dosyalarına erişme bölümünde açıklanan şekilde hata olup olmadığını kontrol edin.

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

Genel yapılandırma ayarları

apigee-monit için genel yapılandırma ayarları tanımlayabilirsiniz. Örneğin, uyarılar için e-posta bildirimleri ekleyebilirsiniz. Bunun için /opt/apigee/data/apigee-monit dizininde bir yapılandırma dosyası oluşturup apigee-monit uygulamasını yeniden başlatabilirsiniz.

apigee-monit için genel yapılandırma ayarlarını tanımlamak üzere:

  1. Aşağıdaki konumda yeni bir bileşen yapılandırma dosyası oluşturun:
    /opt/apigee/data/apigee-monit/filename.conf

    Burada filename, "monit" hariç geçerli herhangi bir dosya adı olabilir.

  2. Aşağıdaki örnekte gösterildiği gibi yeni yapılandırma dosyasının sahibini "Apigee" kullanıcısı olarak değiştirin:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
  3. Genel yapılandırma ayarlarınızı yeni dosyaya ekleyin. Aşağıdaki örnekte bir posta sunucusu yapılandırılır ve uyarı alıcıları ayarlanır:
    SET MAILSERVER smtp.gmail.com PORT 465
      USERNAME "example-admin@gmail.com" PASSWORD "PASSWORD"
      USING SSL, WITH TIMEOUT 15 SECONDS
    
    SET MAIL-FORMAT {
      from: edge-alerts@example.com
      subject: Monit Alert -- Service: $SERVICE $EVENT on $HOST
    }
    SET ALERT fred@example.com
    SET ALERT nancy@example.com

    Genel yapılandırma seçeneklerinin tam listesi için monit belgelerine bakın.

  4. Bileşen yapılandırma dosyasında yaptığınız değişiklikleri kaydedin.
  5. Aşağıdaki komutla apigee-monit dosyasını yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit yeniden başlatılmazsa günlük dosyasında apigee-monit günlük dosyalarına erişme bölümünde açıklanan şekilde günlük dosyasındaki hataları kontrol edin.

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

Apigee olmayan bileşen yapılandırmaları

apigee-monit platformuna kendi yapılandırmalarınızı ekleyerek Private Cloud'un Apigee Edge'in bir parçası olmayan hizmetleri kontrol etmesini sağlayabilirsiniz. Örneğin, hedef uç noktanıza istek göndererek API'lerinizin çalışıp çalışmadığını kontrol etmek için apigee-monit kullanabilirsiniz.

Apigee olmayan bir bileşen yapılandırması eklemek için:

  1. Aşağıdaki konumda yeni bir bileşen yapılandırma dosyası oluşturun:
    /opt/apigee/data/apigee-monit/filename.conf

    Burada filename, "monit" hariç geçerli herhangi bir dosya adı olabilir.

    Gerektiği kadar bileşen yapılandırma dosyası oluşturabilirsiniz. Örneğin, düğümde izlemek istediğiniz Apigee olmayan her bileşen için ayrı bir yapılandırma dosyası oluşturabilirsiniz.

  2. Aşağıdaki örnekte gösterildiği gibi yeni yapılandırma dosyasının sahibini "Apigee" kullanıcısı olarak değiştirin:
    chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
  3. Özel yapılandırmalarınızı yeni dosyaya ekleyin. Aşağıdaki örnekte, yerel sunucudaki hedef uç nokta kontrol edilir:
    CHECK HOST localhost_validate_test WITH ADDRESS localhost
      IF FAILED
        PORT 15999
        PROTOCOL http
        REQUEST "/validate__test"
        CONTENT = "Server Ready"
        FOR 2 times WITHIN 3 cycles
      THEN alert

    Olası yapılandırma ayarlarının tam listesi için monit belgelerine bakın.

  4. Yapılandırma dosyasında yaptığınız değişiklikleri kaydedin.
  5. Aşağıdaki komutla apigee-monit dosyasını yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit yeniden başlatılmazsa günlük dosyasında apigee-monit günlük dosyalarına erişme bölümünde açıklanan şekilde günlük dosyasındaki hataları kontrol edin.

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

Bunun yalnızca Edge olmayan bileşenler için geçerli olduğunu unutmayın. Edge bileşenleri için bileşen yapılandırmalarını özelleştiremezsiniz.

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ük dosyasına kaydeder.

Günlük dosyasının varsayılan konumu:

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

apigee-monit denetim ayarlarını özelleştirerek varsayılan konumu değiştirebilirsiniz.

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 toplu durumu görüntüleyin

apigee-monit, bir düğümdeki bileşenler hakkında toplu durum bilgileri sağlayan aşağıdaki komutları içerir:

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, bir düğümde kaç bileşenin yukarıda, aşağıya, şu anda başlatılmakta veya izlenmiyor olduğuna dair kapsamlı bir özet sunar. Aşağıdaki örnek, report komutunu çağırır:

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

Aşağıdaki örnekte, AIO (hepsi bir arada) yapılandırmasındaki report çıkışı gösterilmektedir:

/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 artışta olduğu bildirilir. Bir hizmet şu anda izlenmemektedir.

report komutunu ilk kez çalıştırdığınızda Connection refused hatası alabilirsiniz. Bu durumda, conf_monit_monit_delay_time özelliğinin süresini bekleyip tekrar deneyin.

özet

summary komutu, her bir bileşeni listeler ve durumunu sağlar. Aşağıdaki örnek, summary komutunu çağırır:

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

Aşağıdaki örnekte, AIO (hepsi bir arada) yapılandırmasındaki summary çıkışı gösterilmektedir:

/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

summary komutunu ilk kez çalıştırdığınızda Connection refused hatası alırsanız conf_monit_monit_delay_time özelliğinin süresini bekleyip tekrar deneyin.

Apigee-monit'i izleme

apigee-monit hizmetinin her düğümde çalışıp çalışmadığını düzenli olarak kontrol etmek en iyi uygulamadır.

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, bu komutu apigee-monit çalıştıran her düğümde düzenli olarak vermenizi önerir. Bunu yapmanın bir yolu, planlanmış görevleri önceden tanımlanmış aralıklarla yürüten cron gibi bir yardımcı programı kullanmaktır.

apigee-monit uygulamasını izlemek üzere cron kullanmak için:

  1. Aşağıdaki örnekte gösterildiği gibi apigee-monit.cron dizinini /etc/cron.d dizinine kopyalayarak cron desteği 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 ve bu işin yürütülme sıklığını tanımlar. Aşağıdaki örnekte varsayılan değerler gösterilmektedir:

    # 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. Bu söz diziminde ilk beş alan, apigee-monit ürününün işlemini gerçekleştirdiği zamanı tanımlar:

    min hour day_of_month month day_of_week task_to_execute

    Örneğin, varsayılan yürütme süresi */2 * * * *'dir. Bu süre, cron uygulamasına apigee-monit işlemini 2 dakikada bir kontrol etmesi talimatını verir.

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

    cron kullanımıyla ilgili daha fazla bilgi için sunucu işletim sisteminizin belgelerine veya kılavuz sayfalarına bakın.

  3. cron ayarlarını, kuruluşunuzun politikalarına uyacak şekilde değiştirin. Örneğin, yürütme sıklığını 5 dakikada bir olarak değiştirmek için iş tanımını aşağıdaki şekilde ayarlayın:
    */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 şunları kontrol edin:

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

apigee-monit hizmetini durdurmak veya geçici olarak devre dışı bırakmak isterseniz bu cron işini de devre dışı bırakmanız gerekir. Aksi takdirde cron, apigee-monit uygulamasını yeniden başlatır.

cron özelliğini 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

    Daha sonra apigee-monit izlemek için cron öğesini yeniden etkinleştirmek isterseniz tekrar kopyalamanız gerekir.

    VEYA

  • /etc/cron.d/apigee-monit.cron dosyasını düzenleyin ve satırın başına "#" ekleyerek iş tanımını yorumlayın. Örneğin:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit