Apigee Edge for Private Cloud شامل apigee-monit است، ابزاری مبتنی بر
ابزار کمکی monit متن‌باز. apigee-monit به‌طور دوره‌ای
سرویس‌های Edge را نظرسنجی می‌کند؛ اگر سرویسی دردسترس نباشد، apigee-monit تلاش می‌کند آن را بازراه‌اندازی کند.
برای استفاده از apigee-monit، باید آن را به‌صورت دستی نصب کنید. این برنامه بخشی از نصب استاندارد نیست.
به‌طور پیش‌فرض، apigee-monit وضعیت سرویس‌های Edge را هر ۶۰ ثانیه بررسی می‌کند.
راه‌اندازی سریع
این بخش به شما نشان می‌دهد که چگونه به‌سرعت با apigee-monit شروع‌به‌کار کنید.
اگر از Amazon Linux استفاده می‌کنید، ابتدا Fedora را نصب کنید. درغیراین‌صورت، از این مرحله رد شوید.
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، مراحل زیر را انجام دهید:
نصب apigee-monit |
|
/opt/apigee/apigee-service/bin/apigee-service apigee-monit install این کار |
|
| توقف پایش مؤلفه‌ها | |
/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 |
|
مشاهده فایل‌های گزارش apigee-monit |
|
cat /opt/apigee/var/log/apigee-monit/apigee-monit.log |
هرکدام از این موضوعات و موضوعات دیگر در بخش‌های بعدی به‌طور مفصل شرح داده شده‌اند.
درباره apigee-monit
apigee-monit کمک می‌کند تا اطمینان حاصل شود که همه مؤلفه‌های یک گره فعال و درحال اجرا باقی می‌مانند. این کار را با ارائه انواع خدمات انجام می‌دهد، ازجمله:
- درحال بازراه‌اندازی سرویس‌های ناموفق
- نمایش اطلاعات خلاصه
- وضعیت نظارت بر گزارش‌گیری
- ارسال اعلان‌ها
- پایش سرویس‌های غیر Edge
Apigee توصیه می‌کند apigee-monit را پایش کنید تا مطمئن شوید درحال اجرا است. برای اطلاعات بیشتر،
پایش apigee-monit را ببینید.
معماری apigee-monit
درطول نصب و پیکربندی Apigee Edge برای Private Cloud، به‌صورت اختیاری نمونه جداگانه‌ای از apigee-monit را در هر گره در خوشه‌تان نصب می‌کنید. این نمونه‌های جداگانه apigee-monit مستقل از یکدیگر عمل می‌کنند: آن‌ها وضعیت مؤلفه‌های خود را به گره‌های دیگر اطلاع نمی‌دهند و خرابی‌های ابزار نظارت را به هیچ سرویس مرکزی اطلاع نمی‌دهند.
تصویر زیر معماری apigee-monit را در خوشه ۵ گرهی نشان می‌دهد:
apigee-monit به‌صورت مجزا در هر گره در خوشه اجرا میشودپلاتفرمهای پشتیبانی‌شده
apigee-monit از پلاتفرم‌های زیر برای خوشه Private Cloud شما پشتیبانی می‌کند. (سیستم‌عامل پشتیبانی‌شده
برای apigee-monit به نسخه Private Cloud بستگی دارد.)
| سیستم‌عامل | نسخه فضای ابری خصوصی | ||
|---|---|---|---|
| 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 |
* اگرچه ازنظر فنی پشتیبانی نمی‌شود، می‌توانید
apigee-monit را در CentOS/RHEL/Oracle نسخه ۶.۹ برای Apigee Edge برای Private Cloud نسخه ۴.۱۹.۰۱ نصب و استفاده کنید. |
|||
پیکربندی‌های مؤلفه
apigee-monit از پیکربندی‌های مؤلفه برای تعیین اینکه کدام مؤلفه‌ها باید نظارت شوند، کدام جنبه‌های مؤلفه باید بررسی شوند، و درصورت بروز خرابی چه اقدامی باید انجام شود استفاده می‌کند.
به‌طور پیش‌فرض، apigee-monit همه مؤلفه‌های Edge را در گره بااستفاده از پیکربندی‌های مؤلفه ازپیش تعریف‌شده آن‌ها نظارت می‌کند. برای مشاهده تنظیمات پیش‌فرض، می‌توانید به فایل‌های پیکربندی مؤلفه apigee-monit نگاه کنید. نمی‌توانید پیکربندی‌های مؤلفه پیش‌فرض را تغییر دهید.
apigee-monit جنبه‌های مختلف مؤلفه را بررسی می‌کند، که به مؤلفه‌ای که بررسی می‌کند بستگی دارد. جدول زیر مواردی را که apigee-monit برای هر مؤلفه بررسی می‌کند فهرست می‌کند و نشان می‌دهد پیکربندی مؤلفه برای هر مؤلفه کجاست. توجه داشته باشید که برخی‌از مؤلفه‌ها در یک فایل پیکربندی واحد تعریف می‌شوند، درحالی‌که برخی دیگر پیکربندی‌های خاص خود را دارند.
| مؤلفه | مکان پیکربندی | چه چیزی نظارت می‌شود |
|---|---|---|
| سرور مدیریت | /opt/apigee/edge-management-server/monit/default.conf |
apigee-monit بررسی:
علاوه‌براین، برای این مؤلفه‌ها
|
| پردازشگر پیام | /opt/apigee/edge-message-processor/monit/default.conf |
|
| سرور Postgres | /opt/apigee/edge-postgres-server/monit/default.conf |
|
| سرور Qpid | /opt/apigee/edge-qpid-server/monit/default.conf |
|
| رهیاب | /opt/apigee/edge-router/monit/default.conf |
|
| Cassandra Edge UI OpenLDAP Postgres Qpid Zookeeper |
/opt/apigee/data/apigee-monit/monit.conf |
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
مثال زیر پیکربندی پیش‌فرض را برای مؤلفه
Classic 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 Edge برای Private Cloud نصب کنید.
این بخش نحوه نصب apigee-monit را در پلاتفرم‌های
پشتیبانی‌شده شرح می‌دهد.
برای اطلاعات درباره حذف نصب apigee-monit، به
حذف نصب apigee-monit مراجعه کنید.
نصب apigee-monit در پلاتفرم پشتیبانی‌شده
این بخش نحوه نصب apigee-monit را در پلاتفرم پشتیبانی‌شده شرح می‌دهد.
برای نصب apigee-monit در پلاتفرم پشتیبانی‌شده:
apigee-monitرا با فرمان زیر نصب کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit install
apigee-monitرا با فرمان زیر پیکربندی کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
apigee-monitرا با فرمان زیر شروع کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit start
- این روال را برای هر گره در خوشه‌تان تکرار کنید.
توقف و شروع پایش مؤلفه‌ها
وقتی سرویسی به هر دلیلی متوقف می‌شود، apigee-monit تلاش می‌کند سرویس را بازراه‌اندازی کند.
اگر بخواهید عمداً مؤلفه‌ای را متوقف کنید، این موضوع می‌تواند مشکل‌ساز شود. برای مثال، ممکن است بخواهید مؤلفه‌ای را هنگام پشتیبان‌گیری یا ارتقا دادن آن متوقف کنید.
اگر apigee-monit سرویس را درطول پشتیبان‌گیری یا ارتقا بازراه‌اندازی کند، ممکن است روال نگهداری شما مختل شود و احتمالاً باعث ناموفق شدن آن شود.
بخش‌های زیر گزینه‌های توقف نظارت بر مؤلفه‌ها را نشان می‌دهد.
متوقف کردن مؤلفه و لغو نظارت بر آن
برای متوقف کردن یک مؤلفه و لغو نظارت بر آن، فرمان زیر را اجرا کنید:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop-component -c component_name
-
apigee-cassandra(Cassandra) -
apigee-openldap(OpenLDAP) -
apigee-postgresql(پایگاه داده PostgreSQL) -
apigee-qpidd(Qpidd) -
apigee-sso(Edge SSO) -
apigee-zookeeper(ZooKeeper) -
edge-management-server(سرور مدیریت) -
edge-management-ui(میانای کاربر جدید Edge) -
edge-message-processor(پردازشگر پیام) -
edge-postgres-server(سرور Postgres) -
edge-qpid-server(سرور Qpid) -
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(Cassandra) -
apigee-openldap(OpenLDAP) -
apigee-postgresql(پایگاه داده PostgreSQL) -
apigee-qpidd(Qpidd) -
apigee-sso(Edge SSO) -
apigee-zookeeper(ZooKeeper) -
edge-management-server(سرور مدیریت) -
edge-management-ui(میانای کاربر جدید Edge) -
edge-message-processor(پردازشگر پیام) -
edge-postgres-server(سرور Postgres) -
edge-qpid-server(سرور Qpid) -
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 را نیز غیرفعال کنید، همان‌طور که در
توقف، شروع، و غیرفعال کردن apigee-monit شرح داده شده است.
توقف، شروع، و غیرفعال کردن apigee-monit
مانند هر سرویس دیگری، می‌توانید بااستفاده از فرمان apigee-service، apigee-monit را متوقف و راه‌اندازی کنید. علاوه‌براین، 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 را با حذف نصب آن از گره، همان‌طور که در حذف نصب apigee-monit توضیح داده شده است، برای همیشه غیرفعال کنید.
حذف نصب apigee-monit
برای حذف نصب apigee-monit:
- اگر کار
cronرا برای نظارت برapigee-monitراه‌اندازی کرده‌اید، پیش‌از حذف نصبapigee-monit، کارcronرا بردارید:sudo rm /etc/cron.d/apigee-monit.cron
apigee-monitرا با فرمان زیر متوقف کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit stop
apigee-monitرا با فرمان زیر حذف نصب کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit uninstall
- این روال را برای هر گره در خوشه‌تان تکرار کنید.
پایش عنصر تازه نصب‌شده
اگر مؤلفه جدیدی را در گره‌ای که apigee-monit را اجرا می‌کند نصب کنید، می‌توانید با اجرای فرمان restart مربوط به apigee-monit، پایش آن را شروع کنید. با این کار، فایل monit.conf جدیدی تولید می‌شود که
مؤلفه جدید را در پیکربندی‌های مؤلفه خود لحاظ می‌کند.
مثال زیر apigee-monit را بازراه‌اندازی می‌کند:
/opt/apigee/apigee-service/bin/apigee-service apigee-monit restart
سفارشی‌سازی apigee-monit
می‌توانید تنظیمات مختلف apigee-monit را سفارشی‌سازی کنید، ازجمله:
تنظیمات کنترل apigee-monit پیش‌فرض
می‌توانید تنظیمات کنترل پیش‌فرض apigee-monit را سفارشی‌سازی کنید، مثلاً دفعات بررسی وضعیت و
مکان فایل‌های apigee-monit. این کار را با ویرایش فایل ویژگی‌ها بااستفاده از تکنیک
کد با پیکربندی انجام می‌دهید. فایل‌های Properties حتی پس‌از ارتقا دادن Apigee Edge برای Private Cloud باقی خواهند ماند.
جدول زیر تنظیمات کنترل پیش‌فرض apigee-monit را که می‌توانید سفارشی‌سازی کنید شرح می‌دهد:
| دارایی | شرح |
|---|---|
conf_monit_httpd_port |
درگاه دیمون httpd. apigee-monit از httpd برای برنامه داشبورد خود و برای فعال کردن گزارش‌ها/خلاصه‌ها استفاده می‌کند. مقدار پیش‌فرض ۲۸۱۲ است.
|
conf_monit_httpd_allow |
محدودیت‌های درخواست‌ها به دیمون httpd. apigee-monit از
httpd برای اجرای برنامه داشبورد خود و فعال کردن گزارش‌ها/خلاصه‌ها استفاده می‌کند. این مقدار باید
به میزبان محلی (میزبانی که httpd در آن اجرا می‌شود) اشاره کند.
برای اینکه درخواست‌ها حتماً شامل نام کاربری و گذرواژه باشد، از نحو زیر استفاده کنید: conf_monit_httpd_allow=allow username:"password"\nallow 127.0.0.1 هنگام افزودن نام کاربری و گذرواژه، بین هر محدودیت «\n» درج کنید. خط جدید یا بازگشت نورد واقعی در مقدار وارد نکنید. |
conf_monit_monit_datadir |
فهرست راهنمایی که جزئیات رویداد در آن ذخیره می‌شود. |
conf_monit_monit_delay_time |
مدت زمانی که apigee-monit پس‌از بار شدن اولیه در حافظه منتظر می‌ماند تا اجرا شود. این موضوع فقط بر apigee-monit اولین بررسی فرایند تأثیر می‌گذارد. |
conf_monit_monit_logdir |
مکان فایل گزارش apigee-monit. |
conf_monit_monit_retry_time |
دفعاتی که apigee-monit تلاش می‌کند هر فرایند را بررسی کند؛ پیش‌فرض ۶۰ ثانیه است. |
conf_monit_monit_rundir |
مکان فایل‌های PID و وضعیت که apigee-monit از آن‌ها برای بررسی فرایندها استفاده می‌کند. |
برای سفارشی‌سازی کردن تنظیمات کنترل پیش‌فرض apigee-monit:
- فایل زیر را ویرایش کنید:
/opt/apigee/customer/application/monit.properties
اگر فایل وجود ندارد، آن را ایجاد کنید و مالک را روی کاربر «apigee» تنظیم کنید:
chown apigee:apigee /opt/apigee/customer/application/monit.properties
توجه داشته باشید که اگر فایل ازقبل وجود داشته باشد، ممکن است ویژگی‌های پیکربندی دیگری علاوه‌بر آنچه در جدول بالا فهرست شده است در آن تعریف شده باشد. نباید ویژگی‌هایی غیراز موارد فهرست‌شده در بالا را تغییر دهید.
مقادیر دارایی را با مقادیر جدیدتان تنظیم یا جایگزین کنید.
برای مثال، برای تغییر مکان فایل گزارش به
/tmp، ویژگی زیر را اضافه یا ویرایش کنید:conf_monit_monit_logdir=/tmp/apigee-monit.log
- تغییرات را در فایل
monit.propertiesذخیره کنید. apigee-monitرا با فرمان زیر دوباره پیکربندی کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit configure
apigee-monitرا با فرمان زیر مجدداً بار کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
اگر نمی‌توانید
apigee-monitرا بازراه‌اندازی کنید، فایل گزارش را برای یافتن خطاها بررسی کنید، همان‌طور که در دسترسی به فایل‌های گزارشapigee-monitشرح داده شده است.- این روال را برای هر گره در خوشه‌تان تکرار کنید.
تنظیمات پیکربندی سراسری
می‌توانید تنظیمات پیکربندی سراسری را برای apigee-monit تعریف کنید؛ برای مثال، می‌توانید اعلان‌های ایمیلی را برای هشدارها اضافه کنید. این کار را با ایجاد فایل پیکربندی در
دایرکتوری /opt/apigee/data/apigee-monit و سپس بازراه‌اندازی apigee-monit انجام می‌دهید.
برای تعریف تنظیمات پیکربندی سراسری برای apigee-monit:
- فایل پیکربندی مؤلفه جدیدی در مکان زیر ایجاد کنید:
/opt/apigee/data/apigee-monit/filename.conf
که filename می‌تواند هر نام فایل معتبری باشد، به‌جز «monit».
- مالک فایل پیکربندی جدید را به کاربر «apigee» تغییر دهید، همان‌طور که در مثال زیر نشان داده شده است:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-mail-config.conf
- تنظیمات پیکربندی سراسری‌تان را به فایل جدید اضافه کنید. مثال زیر سرور ایمیل را پیکربندی می‌کند و گیرندگان هشدار را تنظیم می‌کند:
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 را ببینید.
- تغییرات را در فایل پیکربندی مؤلفه ذخیره کنید.
apigee-monitرا با فرمان زیر مجدداً بار کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
اگر
apigee-monitبازراه‌اندازی نشد، فایل گزارش را برای یافتن خطاها بررسی کنید، همان‌طور که در دسترسی به فایل‌های گزارشapigee-monitشرح داده شده است.- این روال را برای هر گره در خوشه‌تان تکرار کنید.
پیکربندی‌های مؤلفه غیر Apigee
می‌توانید پیکربندی‌های خودتان را به apigee-monit اضافه کنید تا سرویس‌هایی را که بخشی از
Apigee Edge for Private Cloud نیستند بررسی کند. برای مثال، می‌توانید از apigee-monit استفاده کنید تا با ارسال درخواست به نقطه پایانی هدف، بررسی کنید که میاناهای برنامه‌سازی کاربردی شما درحال اجرا هستند یا نه.
برای افزودن پیکربندی مؤلفه غیرApigee:
- فایل پیکربندی مؤلفه جدیدی در مکان زیر ایجاد کنید:
/opt/apigee/data/apigee-monit/filename.conf
که filename می‌تواند هر نام فایل معتبری باشد، به‌جز «monit».
می‌توانید هر تعداد فایل پیکربندی مؤلفه که لازم است ایجاد کنید. برای مثال، می‌توانید برای هر مؤلفه غیرApigee که می‌خواهید در گره پایش کنید، فایل پیکربندی جداگانه‌ای ایجاد کنید.
- مالک فایل پیکربندی جدید را به کاربر «apigee» تغییر دهید، همان‌طور که در مثال زیر نشان داده شده است:
chown apigee:apigee /opt/apigee/data/apigee-monit/my-config.conf
- پیکربندی‌های سفارشی‌تان را به فایل جدید اضافه کنید. مثال زیر نقطه پایانی هدف را در سرور محلی بررسی می‌کند:
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برای مشاهده فهرست کامل تنظیمات پیکربندی احتمالی، سند monit را ببینید.
- تغییرات را در فایل پیکربندی ذخیره کنید.
apigee-monitرا با فرمان زیر مجدداً بار کنید:/opt/apigee/apigee-service/bin/apigee-service apigee-monit reload
اگر
apigee-monitبازراه‌اندازی نشد، فایل گزارش را برای یافتن خطاها بررسی کنید، همان‌طور که در دسترسی به فایل‌های گزارشapigee-monitشرح داده شده است.- این روال را برای هر گره در خوشه‌تان تکرار کنید.
توجه داشته باشید که این فقط برای مؤلفه‌های غیر Edge است. نمی‌توانید پیکربندی‌های مؤلفه را برای مؤلفه‌های Edge سفارشی‌سازی کنید.
دسترسی به فایل‌های گزارش apigee-monit
apigee-monit همه فعالیت‌ها، ازجمله رویدادها، بازراه‌اندازی‌ها، تغییرات پیکربندی، و هشدارها را در یک فایل گزارش ثبت می‌کند.
مکان پیش‌فرض فایل گزارش عبارت است از:
/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 شامل فرمان‌های زیر است که اطلاعات وضعیت انبوهشی درباره مؤلفه‌های گره را به شما ارائه می‌دهد:
| فرمان | کاربرد |
|---|---|
report |
/opt/apigee/apigee-service/bin/apigee-service apigee-monit report |
summary |
/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
در این مثال، 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:
- با کپی کردن دایرکتوری
apigee-monit.cronدر دایرکتوری/etc/cron.d، پشتیبانیcronرا اضافه کنید، همان‌طور که در مثال زیر نشان داده شده است:cp /opt/apigee/apigee-monit/cron/apigee-monit.cron /etc/cron.d/
- فایل
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دستور می‌دهد فرایندapigee-monitرا هر ۲ دقیقه بررسی کند.نمی‌توانید کار
cronرا بیشتر از یک‌بار در دقیقه اجرا کنید.برای اطلاعات بیشتر درباره استفاده از
cron، به اسناد راهنمایی سیستم‌عامل سرور یا صفحات راهنمای man مراجعه کنید. - تنظیمات
cronرا تغییر دهید تا با خط‌مشی‌های سازمانتان مطابقت داشته باشد. برای مثال، برای تغییر بسامد اجرا به هر ۵ دقیقه، تعریف کار را به‌صورت زیر تنظیم کنید:*/5 * * * * root /opt/apigee/apigee-service/bin/apigee-service apigee-monit monitor_monit
- فایل
apigee-monit.cronرا ذخیره کنید. - این روال را برای هر گره در خوشه‌تان تکرار کنید.
اگر cron تماشای apigee-monit را شروع نمی‌کند، موارد زیر را بررسی کنید:
- یک خط خالی بعداز تعریف شغل
cronوجود دارد. - فقط یک کار
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