Apigee-monit ile kendi kendine iyileşme

Edge for Private Cloud 4.19.01 sürümü

Apigee Edge for Private Cloud, açık kaynak monit yardımcı programını temel alan bir araç olan apigee-monit'i içerir. apigee-monit, Edge hizmetlerini düzenli olarak sorgular. Bir hizmet kullanılamıyorsa apigee-monit bu 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 her 60 saniyede bir kontrol eder.

Hızlı başlangıç

Aşağıdaki tabloda, apigee-monit ile hemen çalışmaya nasıl başlayacağınız gösterilmektedir:

  apigee-monit uygulamasını yükleme
/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 uygulamasını 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
  İzleme bileşenlerini başlatma
/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 bakma
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log

Bu konuların her biri ve diğer konular, 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ını sağlar. Bunu, aşağıdakiler de dahil olmak üzere çeşitli hizmetler sunarak yapar:

  • Başarısız hizmetleri yeniden başlatma
  • Özet bilgiler gösteriliyor
  • Günlük kaydı izleme durumu
  • Bildirim gönderme
  • Edge dışı hizmetler izleniyor

Apigee, çalıştığından emin olmak için apigee-monit hizmetini izlemenizi önerir. Daha fazla bilgi için apigee-monit'i izleme başlıklı makaleyi inceleyin.

apigee-monit mimarisi

Apigee Edge for Private Cloud 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 olarak çalışır: Bileşenlerinin durumunu diğer düğümlere iletmezler ve izleme yardımcı programının hatalarını herhangi bir merkezi hizmete iletmezler.

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

Şekil 1: apigee-monit'ın ayrı bir örneği, bir kümedeki her düğümde ayrı olarak çalışır

Desteklenen platformlar

apigee-monit, özel bulut 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 Özel 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 desteklenmese de Private Cloud sürüm 4.19.01 için Apigee Edge'de 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.

apigee-monit, varsayılan olarak bir düğümdeki tüm Edge bileşenlerini önceden tanımlanmış bileşen yapılandırmalarını kullanarak izler. Varsayılan ayarları görüntülemek için apigee-monit bileşen 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 bir bileşenin farklı yönlerini kontrol eder. Aşağıdaki tabloda, apigee-monit aracının her bileşen için neleri kontrol ettiği ve her bileşenin 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 ise kendi yapılandırmaları olduğunu unutmayın.

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

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

  • İşlem yapmadan önce belirli sayıda döngü içinde birden fazla hata oluşmasını gerektirir.
  • Özel bir istek yolu ayarlar.
Mesaj İşlemcisi /opt/apigee/edge-message-processor/monit/default.conf
Postgres Server /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"

Herhangi bir Apigee Edge for Private Cloud bileşeni için 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ı başlıklı makaleyi inceleyin.

Varsayılan olarak apigee-monit, çalıştığı düğümdeki tüm bileşenleri izler. Bu özelliği tüm bileşenler veya ayrı ayrı 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ükleme

apigee-monit varsayılan olarak yüklenmez. 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, apigee-monit aracının desteklenen platformlara ve desteklenmeyen CentOS/RHEL/Oracle Linux'un 6.9 sürümüne nasıl yükleneceği açıklanmaktadır.

apigee-monit uygulamasını kaldırma hakkında bilgi için apigee-monit uygulamasını kaldırma başlıklı makaleyi inceleyin.

Desteklenen bir platforma apigee-monit'i yükleme

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

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

  1. Aşağıdaki komutu kullanarak apigee-monit uygulamasını yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit install
  2. Aşağıdaki komutla apigee-monit aracını 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. Bu prosedürü kümenizdeki her düğümde tekrarlayın.

Desteklenmeyen bir platforma apigee-monit yükleme

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

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

  1. Enterprise Linux için Ekstra Paketler 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 Temporarily etkinleştirin ve monit paketini yükleyin:
    yum --enablerepo=epel install monit

    monit yüklendikten sonra EPEL deposunun devre dışı bırakılması gerektiğini unutmayın. enablerepo seçeneği, belirtilen depoyu yalnızca geçerli komut için etkinleştirir.

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

    Bu örnekte EPEL deposunun devre dışı olduğu gösterilmektedir. Ancak devre dışı bırakılmamışsa devre dışı bırakmanız gerekir:

    sudo yum-config-manager --disable epel

Bileşenleri izlemeyi durdurma ve başlatma

Bir hizmet herhangi bir nedenle durduğunda apigee-monit, hizmeti yeniden başlatmayı dener.

Bir bileşeni kasıtlı olarak durdurmak istediğinizde bu durum sorun yaratabilir. Ö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 başarısız olabilir.

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

Bileşeni durdurma ve izlemeyi bırakma

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

/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
component_name aşağıdakilerden 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ü)

"all" (tümü) seçeneğinin stop-component için geçerli bir seçenek olmadığını unutmayın. stop-component ile aynı anda yalnızca bir bileşeni durdurabilir ve izlemeyi bırakabilirsiniz.

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

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

"all" (tümü) seçeneğinin start-component için geçerli bir seçenek olmadığını unutmayın.

Tüm bileşenleri durdurma ve izlemeyi kaldırma talimatları için Tüm bileşenleri durdurma ve izlemeyi kaldırma başlıklı makaleyi inceleyin.

Bir bileşeni izlemeyi durdurma (ancak bileşeni durdurmama)

Bir bileşenin izlenmesini durdurmak (ancak bileşeni durdurmamak) 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 aşağıdakilerden 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 çalıştırın:

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

Tüm bileşenleri izlemeyi durdur (ancak bileşenleri durdurma)

Tüm bileşenleri izlemeyi durdurmak (ancak bileşenleri durdurmamak) için aşağıdaki komutu çalıştırı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 durdurma ve izlemeyi bırakma

Tüm bileşenleri durdurmak ve izlemeyi sonlandırmak 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 izlemeye devam etmek 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 özelliğini de devre dışı bırakabilirsiniz. Bu işlem, apigee-monit'i durdurma, başlatma ve devre dışı bırakma bölümünde açıklanmıştır.

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

Her hizmette olduğu gibi apigee-monit hizmetini de apigee-service komutunu kullanarak durdurup başlatabilirsiniz. Ayrıca apigee-monit, bileşenleri izlemeyi geçici olarak durdurmanıza olanak tanıyan unmonitor komutunu destekler.

apigee-monit'i durdurma

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şlatma

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ırakma

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'yi izlemek için bir cron işi ayarladıysanız apigee-monit'yi kaldırmadan önce cron işini kaldırın:
    sudo rm /etc/cron.d/apigee-monit.cron
  2. Aşağıdaki komutla apigee-monit hizmetini durdurun:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
  3. Aşağıdaki komutu kullanarak apigee-monit uygulamasını kaldırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
  4. Bu prosedürü kümenizdeki her düğümde 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'in restart komutunu çalıştırarak bu bileşeni izlemeye başlayabilirsiniz. Bu işlem, bileşen yapılandırmalarında yeni bileşeni içerecek yeni bir monit.conf yapılandırma 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ştirme

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

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

Varsayılan apigee-monit kontrol ayarları

Durum kontrollerinin sıklığı ve apigee-monit dosyalarının konumları gibi varsayılan apigee-monit kontrol ayarlarını özelleştirebilirsiniz. Bunu, yapılandırmalı kod tekniğini kullanarak bir özellikler dosyasını düzenleyerek yaparsınız. Özellik dosyaları, Apigee Edge for Private Cloud'u yükselttikten sonra bile kalır.

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

Mülk Açıklama
conf_monit_httpd_port httpd arka plan işleminin bağlantı noktası. apigee-monit, kontrol paneli uygulaması için ve raporları/özetleri etkinleştirmek üzere httpd kullanıyor. Varsayılan değer 2812'dir.
conf_monit_httpd_allow httpd arka plan programına gönderilen isteklerle ilgili kısıtlamalar. apigee-monit, kontrol paneli uygulamasını çalıştırmak ve raporları/özetleri etkinleştirmek için httpd kullanır. Bu değer, yerel ana makineyi (httpd uygulamasını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ıtlama arasına "\n" ekleyin. 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 uygulamasının belleğe ilk yüklendikten sonra çalıştırılmadan önce beklediği süre. Bu durum yalnızca ilk işlem kontrolünü etkiler.apigee-monit
conf_monit_monit_logdir apigee-monit günlük dosyasının konumu.
conf_monit_monit_retry_time apigee-monit aracının her bir işlemi kontrol etme sıklığı. Varsayılan değer 60 saniyedir.
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 kontrol ayarlarını özelleştirmek için:

  1. Aşağıdaki dosyayı düzenleyin:
    /opt/apigee/customer/application/monit.properties

    Dosya yoksa dosyayı oluşturun ve sahibini "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 ek yapılandırma özellikleri tanımlanmış olabilir. Yukarıda listelenenler dışındaki özellikleri değiştirmemeniz gerekir.

  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 özelliği ekleyin veya düzenleyin:

    conf_monit_monit_logdir=/tmp/apigee-monit.log
  3. Değişikliklerinizi monit.properties dosyasına kaydedin.
  4. Aşağıdaki komutla apigee-monit aracını yeniden yapılandırın:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
  5. Aşağıdaki komutla apigee-monit hizmetini yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit uygulamasını yeniden başlatamıyorsanız apigee-monit günlük dosyalarına erişme başlıklı makalede açıklandığı gibi günlük dosyasında 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. Bunu yapmak için /opt/apigee/data/apigee-monit dizininde bir yapılandırma dosyası oluşturun ve ardından apigee-monit hizmetini yeniden başlatın.

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

    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ılmakta ve uyarı alıcıları ayarlanmaktadı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ındaki değişikliklerinizi kaydedin.
  5. Aşağıdaki komutla apigee-monit hizmetini yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit yeniden başlatılmazsa apigee-monit günlük dosyalarına erişme bölümünde açıklandığı gibi günlük dosyasında hata olup olmadığını kontrol edin.

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

Apigee dışı bileşen yapılandırmaları

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

Apigee dışı 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

    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 her Apigee dışı 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 edilmektedir:
    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ındaki değişiklikleri kaydedin.
  5. Aşağıdaki komutla apigee-monit hizmetini yeniden yükleyin:
    /opt/apigee/apigee-service/bin/apigee-service apigee-monit reload

    apigee-monit yeniden başlatılmazsa apigee-monit günlük dosyalarına erişme bölümünde açıklandığı gibi günlük dosyasında hata olup olmadığını kontrol edin.

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

Bu seçeneğin 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 şöyledir:

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

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

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

'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örüntüleme

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 aşağıdaki bölümlerde daha ayrıntılı olarak açıklanmıştır.

rapor

report komutu, bir düğümde kaç bileşenin çalışır durumda, çalışmıyor durumda, başlatılmakta olduğunu veya şu anda izlenmediğini gösteren bir özet sunar. Aşağıdaki örnekte report komutu çağrılmaktadır:

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

Aşağıdaki örnekte, hepsi bir arada (AIO) 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, 12 hizmetten 11'inin çalıştığı apigee-monit tarafından bildirilmiştir. Bir hizmet şu anda izlenmiyor.

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

özet

summary komutu her bileşeni listeler ve durumunu gösterir. Aşağıdaki örnekte summary komutu çağrılmaktadır:

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

Aşağıdaki örnekte, hepsi bir arada (AIO) 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üresi kadar bekleyip tekrar deneyin.

apigee-monit'i izleme

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

apigee-monit aracının çalıştığı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 çalıştırmanızı önerir. Bunu yapmanın bir yolu, önceden tanımlanmış aralıklarla planlanmış görevleri yürüten cron gibi bir yardımcı program kullanmaktır.

apigee-monit izlemek için cron kullanma:

  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 dosyada aşağıdaki söz dizimi kullanılır. İlk beş alan, apigee-monit işleminin yürütüleceğ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 * * * * şeklindedir. Bu, cron aracına apigee-monit işlemini 2 dakikada bir kontrol etmesini söyler.

    cron işini dakikada bir kereden daha sık çalıştıramazsınız.

    cron kullanımı hakkında 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 olacak şekilde değiştirmek için iş tanımını aşağıdaki gibi 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 izlemeye başlamazsa şunları kontrol edin:

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

apigee-monit hizmetini durdurmak veya geçici olarak devre dışı bırakmak istiyorsanız bu cron işini de devre dışı bırakmanız gerekir. Aksi takdirde cron, apigee-monit hizmetini 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 hizmetini yeniden etkinleştirmek isterseniz bu kodu 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ı açıklama satırı yapın. Örneğin:
    # 10 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit