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

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

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

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

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

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

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

درحال بررسی درگاه‌های ویژه Apigee و طرف سوم

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

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

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

• درگاه Qpid‏ ۵۶۷۲
• درگاه Postgres 5432
• درگاه Cassandra 7000،‏ 7199،‏ 9042،‏ 9160
• درگاه ZooKeeper 2181
• درگاه SymasLDAP 10389

برای تعیین اینکه هر مؤلفه 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 را نشان می‌دهد.

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

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

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

   conf_system_log.level=DEBUG

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

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

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

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

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

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

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