خود درمانی با آپیجی مونیت، خود درمانی با آپیجی مونیت

Apigee Edge for Private Cloud شامل apigee-monit است، ابزاری مبتنی بر ابزار منبع باز monit . apigee-monit به صورت دوره ای خدمات Edge را نظرسنجی می کند. اگر سرویسی در دسترس نباشد، apigee-monit سعی می کند آن را دوباره راه اندازی کند.

برای استفاده از apigee-monit ، باید آن را به صورت دستی نصب کنید . بخشی از نصب استاندارد نیست.

به طور پیش فرض، apigee-monit هر 60 ثانیه وضعیت سرویس های Edge را بررسی می کند.

شروع سریع

این بخش به شما نشان می‌دهد که چگونه با apigee-monit سریع راه بیفتید.

اگر از لینوکس آمازون استفاده می کنید، ابتدا فدورا را نصب کنید. در غیر این صورت از این مرحله صرف نظر کنید.

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 مراحل زیر را انجام دهید:

/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

هر یک از این موضوعات و سایر موضوعات در بخش های بعدی به تفصیل توضیح داده شده است.

درباره apigee-monit

apigee-monit کمک می کند تا اطمینان حاصل شود که تمام اجزای یک گره فعال و فعال می مانند. این کار را با ارائه خدمات مختلف انجام می دهد، از جمله:

• راه اندازی مجدد سرویس های ناموفق
• نمایش خلاصه اطلاعات
• ثبت وضعیت نظارت
• ارسال نوتیفیکیشن
• نظارت بر خدمات غیر لبه

Apigee توصیه می‌کند که apigee-monit برای اطمینان از اجرای آن نظارت کنید. برای اطلاعات بیشتر، به Monitor apigee-monit مراجعه کنید.

معماری apigee-monit

در طول نصب و پیکربندی Apigee Edge for Private Cloud، به صورت اختیاری یک نمونه جداگانه از apigee-monit را روی هر گره در کلاستر خود نصب می‌کنید. این نمونه‌های apigee-monit جداگانه مستقل از یکدیگر عمل می‌کنند: آنها وضعیت اجزای خود را به گره‌های دیگر منتقل نمی‌کنند، و همچنین خرابی‌های خود ابزار نظارت را به هیچ سرویس مرکزی منتقل نمی‌کنند.

تصویر زیر معماری apigee-monit را در یک خوشه 5 گره نشان می دهد:

پلتفرم های پشتیبانی شده

apigee-monit از پلتفرم های زیر برای کلاستر ابر خصوصی شما پشتیبانی می کند. (سیستم عامل پشتیبانی شده برای apigee-monit به نسخه Private Cloud بستگی دارد.)

تنظیمات کامپوننت

apigee-monit از پیکربندی‌های مؤلفه استفاده می‌کند تا تعیین کند کدام مؤلفه‌ها باید نظارت شود، چه جنبه‌هایی از مؤلفه باید بررسی شود و در صورت خرابی چه اقداماتی باید انجام شود.

به‌طور پیش‌فرض، apigee-monit تمام اجزای Edge را در یک گره با استفاده از پیکربندی‌های مؤلفه از پیش تعریف‌شده آن‌ها نظارت می‌کند. برای مشاهده تنظیمات پیش فرض، می توانید به فایل های پیکربندی جزء apigee-monit نگاه کنید. شما نمی توانید تنظیمات اجزای پیش فرض را تغییر دهید.

apigee-monit بسته به اینکه کدام جزء را بررسی می کند، جنبه های مختلف یک جزء را بررسی می کند. جدول زیر آنچه را که apigee-monit برای هر مؤلفه بررسی می‌کند فهرست می‌کند و به شما نشان می‌دهد که پیکربندی مؤلفه برای هر مؤلفه کجاست. توجه داشته باشید که برخی از مؤلفه ها در یک فایل پیکربندی واحد تعریف شده اند که برخی دیگر تنظیمات خاص خود را دارند.

مثال زیر پیکربندی کامپوننت پیش فرض را برای کامپوننت edge-router نشان می دهد:

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

مثال زیر پیکربندی پیش فرض مولفه کلاسیک UI ( edge-ui ) را نشان می دهد:

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"

این در مورد رابط کاربری کلاسیک صدق می‌کند، نه رابط کاربری جدید Edge که نام مؤلفه آن edge-management-ui است.

نمی‌توانید پیکربندی‌های مؤلفه پیش‌فرض را برای هر مؤلفه Apigee Edge for Private Cloud تغییر دهید. با این حال، می‌توانید پیکربندی‌های مؤلفه خود را برای سرویس‌های خارجی، مانند نقطه پایانی هدف یا سرویس httpd ، اضافه کنید. برای اطلاعات بیشتر، تنظیمات مؤلفه غیر Apigee را ببینید.

به طور پیش‌فرض، apigee-monit تمام اجزای گره‌ای را که روی آن اجرا می‌شود، نظارت می‌کند. شما می توانید آن را برای همه اجزا یا برای اجزای جداگانه فعال یا غیرفعال کنید. برای اطلاعات بیشتر ببین:

• توقف کنید و نظارت بر یک جزء را شروع کنید
• توقف، شروع و غیرفعال کردن apigee-monit

apigee-monit را نصب کنید

apigee-monit به طور پیش فرض نصب نشده است. می توانید پس از ارتقا یا نصب نسخه 4.19.01 یا جدیدتر Apigee Edge برای Private Cloud آن را به صورت دستی نصب کنید.

این بخش نحوه نصب apigee-monit بر روی پلتفرم های پشتیبانی شده توضیح می دهد.

برای اطلاعات در مورد حذف نصب apigee-monit ، به Uninstall apigee-monit مراجعه کنید.

apigee-monit را روی یک پلت فرم پشتیبانی شده نصب کنید

این بخش نحوه نصب apigee-monit بر روی یک پلت فرم پشتیبانی شده توضیح می دهد.

برای نصب apigee-monit بر روی یک پلت فرم پشتیبانی شده :

1. apigee-monit با دستور زیر نصب کنید:

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

2. apigee-monit با دستور زیر پیکربندی کنید:

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

3. apigee-monit با دستور زیر شروع کنید:

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

4. این روش را در هر گره در خوشه خود تکرار کنید.

توقف و شروع به نظارت بر اجزا

هنگامی که یک سرویس به هر دلیلی متوقف می شود، apigee-monit سعی می کند سرویس را دوباره راه اندازی کند.

اگر بخواهید به طور هدفمند یک مؤلفه را متوقف کنید، ممکن است مشکل ایجاد کند. به عنوان مثال، ممکن است بخواهید زمانی که یک مؤلفه باید از آن نسخه پشتیبان تهیه کنید یا آن را ارتقا دهید، آن را متوقف کنید. اگر apigee-monit سرویس را در حین پشتیبان گیری یا ارتقاء مجدد راه اندازی کند، روند تعمیر و نگهداری شما ممکن است مختل شود و احتمالاً باعث از کار افتادن آن شود.

بخش های زیر گزینه های توقف نظارت بر اجزا را نشان می دهد.

یک کامپوننت را متوقف کنید و آن را حذف کنید

برای متوقف کردن یک کامپوننت و حذف آن، دستور زیر را اجرا کنید:

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

• apigee-cassandra (کاساندرا)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (پایگاه داده PostgreSQL)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge SSO)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (مدیریت سرور)
• edge-management-ui (Edge UI جدید)
• edge-message-processor (پردازنده پیام)
• edge-postgres-server (سرور Postgres)
• edge-qpid-server (سرور Qpid)
• edge-router (Edge Router)
• edge-ui (واسط کاربری کلاسیک)

توجه داشته باشید که "همه" گزینه معتبری برای stop-component نیست. با stop-component می‌توانید هر بار فقط یک مؤلفه را متوقف و از حالت نظارت خارج کنید.

برای راه اندازی مجدد کامپوننت و از سرگیری نظارت، دستور زیر را اجرا کنید:

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

توجه داشته باشید که "همه" گزینه معتبری برای start-component نیست.

برای دستورالعمل‌هایی در مورد نحوه متوقف کردن و حذف نظارت بر همه مؤلفه‌ها، به توقف همه مؤلفه‌ها و حذف نظارت بر آنها مراجعه کنید.

یک مؤلفه را حذف کنید (اما آن را متوقف نکنید)

برای حذف مانیتور یک جزء (اما آن را متوقف نکنید)، دستور زیر را اجرا کنید:

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

• apigee-cassandra (کاساندرا)
• apigee-openldap (OpenLDAP)
• apigee-postgresql (پایگاه داده PostgreSQL)
• apigee-qpidd (Qpidd)
• apigee-sso (Edge SSO)
• apigee-zookeeper (ZooKeeper)
• edge-management-server (مدیریت سرور)
• edge-management-ui (Edge UI جدید)
• edge-message-processor (پردازنده پیام)
• edge-postgres-server (سرور Postgres)
• edge-qpid-server (سرور Qpid)
• edge-router (Edge Router)
• edge-ui (واسط کاربری کلاسیک)

برای از سرگیری نظارت بر کامپوننت، دستور زیر را اجرا کنید:

/opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor -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 all

تمام اجزا را متوقف کنید و آنها را از مانیتور بردارید

برای متوقف کردن تمام اجزا و حذف نظارت بر آنها، دستورات زیر را اجرا کنید:

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

برای راه اندازی مجدد همه اجزا و از سرگیری نظارت، دستورات زیر را اجرا کنید:

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

برای توقف نظارت بر همه مؤلفه‌ها، می‌توانید apigee-monit نیز غیرفعال کنید، همانطور که در Stop، start و غیرفعال کردن apigee-monit توضیح داده شده است.

توقف، شروع و غیرفعال کردن apigee-monit

مانند هر سرویس دیگری، می‌توانید apigee-monit با استفاده از دستور apigee-service متوقف کرده و شروع کنید. علاوه بر این، apigee-monit از دستور unmonitor پشتیبانی می کند که به شما امکان می دهد تا به طور موقت نظارت بر اجزا را متوقف کنید.

توقف apigee-monit

برای توقف apigee-monit از دستور زیر استفاده کنید:

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

apigee-monit را شروع کنید

برای شروع apigee-monit از دستور زیر استفاده کنید:

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

apigee-monit را غیرفعال کنید

با استفاده از دستور زیر می توانید نظارت بر تمام اجزای گره را به حالت تعلیق درآورید:

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

از طرف دیگر، می‌توانید apigee-monit با حذف نصب از گره، همانطور که در Uninstall apigee-monit توضیح داده شده است، برای همیشه غیرفعال کنید.

apigee-monit را حذف کنید

برای حذف نصب apigee-monit :

1. اگر یک کار cron را برای نظارت بر apigee-monit تنظیم کرده اید، قبل از حذف نصب apigee-monit کار cron را حذف کنید:

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

2. apigee-monit با دستور زیر متوقف کنید:

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

3. apigee-monit با دستور زیر حذف نصب کنید:

   /opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall

4. این روش را در هر گره در خوشه خود تکرار کنید.

مانیتور کردن یک مؤلفه تازه نصب شده

اگر کامپوننت جدیدی را روی گره‌ای نصب کنید که در حال اجرای apigee-monit است، می‌توانید با اجرای دستور restart apigee-monit نظارت بر آن را آغاز کنید. این یک فایل monit.conf جدید ایجاد می کند که کامپوننت جدید را در پیکربندی اجزای خود شامل می شود.

مثال زیر apigee-monit را مجددا راه اندازی می کند:

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

apigee-monit را سفارشی کنید

شما می توانید تنظیمات مختلف apigee-monit را سفارشی کنید، از جمله:

1. تنظیمات کنترل پیش فرض apigee-monit
2. تنظیمات پیکربندی جهانی
3. پیکربندی اجزای غیر Apigee

تنظیمات کنترل پیش فرض apigee-monit

می‌توانید تنظیمات پیش‌فرض کنترل apigee-monit مانند دفعات بررسی وضعیت و مکان فایل‌های apigee-monit را سفارشی کنید. شما این کار را با ویرایش یک فایل خصوصیات با استفاده از کد با تکنیک پیکربندی انجام می دهید. فایل‌های Properties حتی پس از ارتقای Apigee Edge برای Private Cloud نیز باقی خواهند ماند.

جدول زیر تنظیمات پیش‌فرض کنترل apigee-monit را که می‌توانید سفارشی کنید، توضیح می‌دهد:

conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1

برای سفارشی کردن تنظیمات پیش فرض کنترل apigee-monit :

1. فایل زیر را ویرایش کنید:

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

   اگر فایل وجود ندارد، آن را ایجاد کنید و مالک را روی کاربر "apigee" تنظیم کنید:

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

   توجه داشته باشید که اگر فایل از قبل وجود داشته باشد، ممکن است ویژگی‌های پیکربندی اضافی در آن تعریف شده باشد، فراتر از آنچه در جدول بالا ذکر شده است. شما نباید ویژگی هایی غیر از موارد ذکر شده در بالا را تغییر دهید.

2. مقادیر ویژگی را با مقادیر جدید خود تنظیم یا جایگزین کنید.

   به عنوان مثال، برای تغییر مکان فایل log به /tmp ، ویژگی زیر را اضافه یا ویرایش کنید:

   conf_monit_monit_logdir=/tmp/apigee-monit.log

3. تغییرات خود را در فایل monit.properties ذخیره کنید.
4. apigee-monit با دستور زیر پیکربندی مجدد کنید:

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

5. apigee-monit با دستور زیر بارگیری مجدد کنید:

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

   اگر نمی‌توانید apigee-monit مجدداً راه‌اندازی کنید، فایل گزارش را برای خطاهایی که در فایل‌های گزارش Access apigee-monit توضیح داده شده بررسی کنید.

6. این روش را برای هر گره در خوشه خود تکرار کنید.

تنظیمات پیکربندی جهانی

شما می توانید تنظیمات پیکربندی جهانی را برای apigee-monit تعریف کنید. برای مثال، می‌توانید اعلان‌های ایمیل را برای هشدارها اضافه کنید. این کار را با ایجاد یک فایل پیکربندی در پوشه /opt/apigee/data/apigee-monit و سپس راه اندازی مجدد apigee-monit انجام می دهید.

برای تعریف تنظیمات پیکربندی جهانی برای apigee-monit :

1. یک فایل پیکربندی کامپوننت جدید در مکان زیر ایجاد کنید:

   /opt/apigee/data/apigee-monit/filename.conf

   جایی که filename می تواند هر نام فایل معتبری باشد، به جز "monit".

2. همانطور که مثال زیر نشان می دهد، مالک فایل پیکربندی جدید را به کاربر "apigee" تغییر دهید:

   chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf

3. تنظیمات پیکربندی جهانی خود را به فایل جدید اضافه کنید. مثال زیر یک سرور ایمیل را پیکربندی می کند و گیرندگان هشدار را تنظیم می کند:

   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

   برای فهرست کاملی از گزینه‌های پیکربندی جهانی، به مستندات monit مراجعه کنید.

4. تغییرات خود را در فایل پیکربندی کامپوننت ذخیره کنید.
5. apigee-monit با دستور زیر بارگیری مجدد کنید:

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

   اگر apigee-monit مجددا راه اندازی نمی شود، فایل log را برای خطاهایی که در فایل های گزارش Access apigee-monit توضیح داده شده بررسی کنید.

6. این روش را برای هر گره در خوشه خود تکرار کنید.

پیکربندی اجزای غیر Apigee

می‌توانید پیکربندی‌های خود را به apigee-monit اضافه کنید تا سرویس‌هایی را که بخشی از Apigee Edge برای Private Cloud نیستند، بررسی کند. به عنوان مثال، می توانید از apigee-monit برای بررسی اینکه آیا API های شما با ارسال درخواست ها به نقطه پایانی هدف خود در حال اجرا هستند، استفاده کنید.

برای افزودن یک پیکربندی جزء غیر Apigee:

1. یک فایل پیکربندی کامپوننت جدید در مکان زیر ایجاد کنید:

   /opt/apigee/data/apigee-monit/filename.conf

   جایی که filename می تواند هر نام فایل معتبری باشد، به جز "monit".

   شما می توانید به تعداد مورد نیاز فایل های پیکربندی کامپوننت ایجاد کنید. برای مثال، می‌توانید یک فایل پیکربندی جداگانه برای هر مؤلفه غیر Apigee که می‌خواهید روی گره نظارت کنید، ایجاد کنید.

2. همانطور که مثال زیر نشان می دهد، مالک فایل پیکربندی جدید را به کاربر "apigee" تغییر دهید:

   chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf

3. تنظیمات سفارشی خود را به فایل جدید اضافه کنید. مثال زیر نقطه پایانی هدف را در سرور محلی بررسی می کند:

   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

   برای فهرست کامل تنظیمات پیکربندی ممکن، به مستندات مانیتور مراجعه کنید.

4. تغییرات خود را در فایل پیکربندی ذخیره کنید.
5. apigee-monit با دستور زیر بارگیری مجدد کنید:

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

   اگر apigee-monit مجددا راه اندازی نمی شود، فایل log را برای خطاهایی که در فایل های گزارش Access apigee-monit توضیح داده شده بررسی کنید.

6. این روش را برای هر گره در خوشه خود تکرار کنید.

توجه داشته باشید که این فقط برای اجزای غیر Edge است. نمی‌توانید پیکربندی‌های مؤلفه را برای مؤلفه‌های Edge سفارشی کنید.

دسترسی به فایل های گزارش apigee-monit

apigee-monit تمام فعالیت‌ها، از جمله رویدادها، راه‌اندازی مجدد، تغییرات پیکربندی و هشدارها را در یک فایل گزارش ثبت می‌کند.

محل پیش‌فرض فایل log:

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

می‌توانید با سفارشی کردن تنظیمات کنترل apigee-monit مکان پیش‌فرض را تغییر دهید.

ورودی های فایل لاگ به شکل زیر است:

'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 را سفارشی کنید.

مشاهده وضعیت انبوه با apigee-monit

apigee-monit شامل دستورات زیر است که اطلاعات وضعیت انبوهی را در مورد اجزای یک گره به شما می دهد:

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

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

هر یک از این دستورات در قسمت های بعدی با جزئیات بیشتری توضیح داده شده است.

گزارش

دستور report یک خلاصه جمع‌آوری شده از تعداد مؤلفه‌های بالا، پایین، در حال حاضر اولیه یا در حال حاضر بدون نظارت بر روی یک گره به شما می‌دهد. مثال زیر دستور report فراخوانی می کند:

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

مثال زیر خروجی report در پیکربندی AIO (همه در یک) نشان می دهد:

/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

در این مثال، 11 مورد از 12 سرویس توسط apigee-monit به عنوان فعال گزارش شده است. یک سرویس در حال حاضر تحت نظارت نیست.

ممکن است هنگام اجرای دستور report برای اولین بار با خطای Connection refused مواجه شوید. در این حالت، منتظر مدت زمان ویژگی conf_monit_monit_delay_time باشید و سپس دوباره امتحان کنید.

خلاصه

دستور summary هر جزء را فهرست کرده و وضعیت آن را ارائه می دهد. مثال زیر دستور summary را فراخوانی می کند:

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

مثال زیر خروجی summary از پیکربندی AIO (همه در یک) را نشان می دهد:

/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 برای اولین بار با خطای Connection refused ، سعی کنید مدت زمان ویژگی conf_monit_monit_delay_time را منتظر بمانید و سپس دوباره امتحان کنید.

مانیتور apigee-monit

بهترین تمرین این است که به طور منظم بررسی کنید که apigee-monit در هر گره در حال اجرا است.

برای بررسی اینکه apigee-monit در حال اجرا است، از دستور زیر استفاده کنید:

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

Apigee توصیه می کند که این دستور را به صورت دوره ای در هر گره ای که apigee-monit را اجرا می کند، صادر کنید. یکی از راه های انجام این کار استفاده از ابزاری مانند cron است که وظایف برنامه ریزی شده را در فواصل زمانی از پیش تعریف شده اجرا می کند.

برای استفاده از cron برای نظارت بر apigee-monit :

1. پشتیبانی cron را با کپی کردن پوشه apigee-monit.cron در پوشه /etc/cron.d اضافه کنید، همانطور که مثال زیر نشان می دهد:

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

2. فایل apigee-monit.cron را برای ویرایش آن باز کنید.

   فایل apigee-monit.cron کار cron را برای اجرا و همچنین فرکانس اجرای آن کار را تعریف می کند. مثال زیر مقادیر پیش فرض را نشان می دهد:

   # 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

   این فایل از نحو زیر استفاده می کند که در آن پنج فیلد اول زمانی را که apigee-monit عمل خود را اجرا می کند مشخص می کند:

   min hour day_of_month month day_of_week task_to_execute

   به عنوان مثال، زمان اجرای پیش فرض */2 * * * * است که به cron دستور می دهد هر 2 دقیقه یکبار فرآیند apigee-monit بررسی کند.

   شما نمی توانید یک کار cron را بیشتر از یک بار در دقیقه اجرا کنید.

   برای اطلاعات بیشتر در مورد استفاده از cron ، به مستندات سیستم عامل سرور یا صفحات man مراجعه کنید.

3. تنظیمات cron را برای مطابقت با خط‌مشی‌های سازمان خود تغییر دهید. به عنوان مثال، برای تغییر فرکانس اجرا به هر 5 دقیقه، تعریف کار را به صورت زیر تنظیم کنید:

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

4. فایل apigee-monit.cron را ذخیره کنید.
5. این روش را برای هر گره در خوشه خود تکرار کنید.

اگر cron شروع به تماشای apigee-monit نکرد، بررسی کنید:

• بعد از تعریف cron job یک خط خالی وجود دارد.
• فقط یک کار cron در فایل تعریف شده است. (خطوط نظر به حساب نمی آیند.)

اگر می خواهید apigee-monit متوقف یا موقتاً غیرفعال کنید، باید این کار cron را نیز غیرفعال کنید، در غیر این صورت cron apigee-monit را مجددا راه اندازی می کند.

برای غیرفعال کردن cron یکی از موارد زیر را انجام دهید:

• فایل /etc/cron.d/apigee-monit.cron را حذف کنید:

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

  اگر بعداً می خواهید cron برای تماشای apigee-monit دوباره فعال کنید، باید آن را دوباره کپی کنید.

  یا

• فایل /etc/cron.d/apigee-monit.cron را ویرایش کنید و با اضافه کردن یک "#" به ابتدای خط، تعریف کار را توضیح دهید. به عنوان مثال:

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