روال‌های مطلوب پایشگری

هشدارهای پایش

Apigee Edge به شما امکان می‌دهد وقتی خطا یا خرابی به‌دلیل خرابی رویدادی رخ می‌دهد، هشدارها را به syslogs یا سیستم‌ها/ابزارهای نظارت خارجی بازارسال کنید. این هشدارها می‌توانند هشدارها/رویدادهای سطح سیستم یا سطح برنامه باشند. هشدارهای سطح برنامه بیشتر هشدارهای سفارشی هستند که براساس رویدادهای تولیدشده ایجاد می‌شوند. سرپرست شبکه معمولاً شرایط سفارشی را پیکربندی می‌کند. برای اطلاعات بیشتر درباره هشدارها، با «پشتیبانی Apigee» تماس بگیرید.

تنظیم آستانه هشدار

آستانه‌ای را تنظیم کنید که پس‌از آن هشدار باید ایجاد شود. آنچه تنظیم می‌کنید به پیکربندی سخت‌افزارتان بستگی دارد. آستانه باید در ارتباط با ظرفیت شما تنظیم شود. برای مثال، اگر فقط ۶ گیگابایت ظرفیت داشته باشید، Apigee Edge ممکن است خیلی کم باشد. می‌توانید آستانه را با معیار مساوی (=) یا بزرگ‌تر از (>) اختصاص دهید. همچنین می‌توانید فاصله زمانی بین دو هشدار متوالی را مشخص کنید. می‌توانید از گزینه ساعت/دقیقه/ثانیه استفاده کنید.

معیارهای تنظیم هشدارهای سطح سیستم

جدول زیر این معیارها را شرح می‌دهد:

بررسی درگاه‌های شخص ثالث و مختص Apigee

درگاه‌های زیر را پایش کنید تا مطمئن شوید فعال هستند

• درگاه ۴۵۲۶، ۴۵۲۷، و ۴۵۲۸ در «سرور مدیریت»، «رهیاب»، و «پردازشگر پیام»
• درگاه ۱۰۹۹، ۱۱۰۰، و ۱۱۰۱ در «سرور مدیریت»، «رهیاب»، و «پردازشگر پیام»
• درگاه ۸۰۸۱ و ۱۵۹۹۹ در رهیاب‌ها
• درگاه ۸۰۸۲ و ۸۹۹۸ در پردازشگرهای پیام
• درگاه ۸۰۸۰ در سرور مدیریت

درگاه‌های شخص ثالث زیر را بررسی کنید تا مطمئن شوید فعال هستند:

• درگاه Qpid‏ ۵۶۷۲
• درگاه Postgres ۵۴۳۲
• درگاه Cassandra‏ ۷۰۰۰،‏ ۷۱۹۹،‏ ۹۰۴۲،‏ ۹۱۶۰
• درگاه ZooKeeper‏ ۲۱۸۱
• درگاه ال‌دپ باز ۱۰۳۸۹

برای تعیین اینکه هر مؤلفه Apigee در کدام درگاه به فراخوانی‌های میانای برنامه‌سازی کاربردی گوش می‌دهد، فراخوانی‌های میانای برنامه‌سازی کاربردی زیر را به «سرور مدیریت» (که معمولاً در درگاه ۸۰۸۰ است) صادر کنید:

curl -v -u username:password http://host:port/v1/servers?pod=gateway&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=central&region=dc-1
curl -v -u username:password http://host:port/v1/servers?pod=analytics&region=dc-1

خروجی این فرمان‌ها شامل بخش‌هایی مشابه آنچه در زیر نشان داده شده است خواهد بود. بخش http.management.port شماره درگاه را برای مؤلفه مشخص‌شده ارائه می‌دهد.

{
  "externalHostName" : "localhost",
  "externalIP" : "111.222.333.444",
  "internalHostName" : "localhost",
  "internalIP" : "111.222.333.444",
  "isUp" : true,
  "pod" : "gateway",
  "reachable" : true,
  "region" : "default",
  "tags" : {
    "property" : [ {
      "name" : "Profile",
      "value" : "Router"
    }, {
      "name" : "rpc.port",
      "value" : "4527"
    }, {
      "name" : "http.management.port",
      "value" : "8081"
    }, {
      "name" : "jmx.rmi.port",
      "value" : "1100"
    } ]
  },
  "type" : [ "router" ],
  "uUID" : "2d4ec885-e20a-4173-ae87-10be38b35750"
}

مشاهده گزارش‌ها

فایل‌های گزارش پیام‌های مربوط به رویداد/عملکرد سیستم را ردیابی می‌کنند. وقتی فرایندها شروع و تکمیل می‌شوند یا وقتی شرایط خطا رخ می‌دهد، پیام‌ها در گزارش ظاهر می‌شوند. با مشاهده فایل‌های گزارش، می‌توانید اطلاعاتی درباره مؤلفه‌های سیستم، برای مثال، واحد پردازش مرکزی، حافظه، دیسک، بار، فرایندها، و غیره، قبل و بعداز رسیدن به وضعیت ناموفق به‌دست آورید. این کار همچنین به شما امکان می‌دهد منبع مشکلات فعلی سیستم را شناسایی و تشخیص دهید یا به شما کمک می‌کند مشکلات احتمالی سیستم را پیش‌بینی کنید.

برای مثال، یک گزارش سیستم معمولی از یک مؤلفه حاوی ورودی‌های زیر است که در زیر مشاهده می‌شود:

TimeStamp = 25/01/13 19:25 ; NextDelay = 30
Memory
HeapMemoryUsage = {used = 29086176}{max = 64880640} ;
NonHeapMemoryUsage = {init = 24313856}{committed = 57278464} ;
Threading
PeakThreadCount = 53 ; ThreadCount = 53 ;
OperatingSystem
SystemLoadAverage = 0.25 ;

می‌توانید فایل /opt/apigee/conf/logback.xml را ویرایش کنید تا سازوکار ثبت گزارش را بدون نیاز به بازراه‌اندازی سرور کنترل کنید. فایل logback.xml حاوی ویژگی زیر است که بسامد بررسی فایل logback.xml توسط سازوکار ثبت گزارش را برای تغییرات پیکربندی تنظیم می‌کند:

<configuration scan="true" scanPeriod="30 seconds" >

به‌طور پیش‌فرض، سازوکار ثبت گزارش هر دقیقه تغییرات را بررسی می‌کند. اگر واحدهای زمانی را برای مشخصه scanPeriod حذف کنید، به‌طور پیش‌فرض میلی‌ثانیه درنظر گرفته می‌شود.

جدول زیر مکان فایل‌های گزارش مؤلفه‌های Apigee Edge Private Cloud را نشان می‌دهد.

فعال کردن گزارش‌های اشکال‌زدایی برای «پردازشگر پیام» و «میانای کاربر Edge»

برای فعال کردن گزارش‌های اشکال‌زدایی برای «پردازشگر پیام»:

1. در گره «پردازشگر پیام»، /opt/apigee/customer/application/messsage-processor.properties را ویرایش کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید.
2. این ویژگی را به فایل اضافه کنید:

   conf_system_log.level=DEBUG

3. «پردازشگر پیام» را بازراه‌اندازی کنید:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

برای فعال کردن گزارش‌های اشکال‌زدایی برای Edge UI:

1. در گره Edge UI،‏ /opt/apigee/customer/application/ui.properties را ویرایش کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید.
2. این ویژگی را به فایل اضافه کنید:

   conf_application_logger.application=DEBUG

3. بازراه‌اندازی واسط کاربر Edge:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

روال‌های مطلوب apigee-monit

هنگام استفاده از apigee-monit، Apigee توصیه می‌کند که:

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

ابزارهای پایش

ابزارهای نظارت مانند Nagios،‏ Collectd،‏ Graphite،‏ Splunk،‏ Sumologic، و Monit می‌توانند به شما کمک کنند کل محیط سازمانی و فرایندهای کسب‌وکارتان را نظارت کنید.