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

Edge for Private Cloud نسخه ۴.۱۶.۰۵

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

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

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

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

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

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

هشدار

آستانه پیشنهادی

شرح

حافظه کم است

‫۵۰۰ مگابایت

حافظه برای شروع مؤلفه بسیار کم است

فضای دیسک کم (/var/log)

‫۸ گیگابایت

فضای دیسک بسیار کم شده است.

بار زیاد

بیش‌از ۳ بار

فرایندهای درانتظار اجرا به‌طور غیرمنتظره‌ای افزایش یافته است

فرایند متوقف شد

N/A، مقدار بولی درست یا نادرست

فرایند Apigee Java در سیستم متوقف شده است

بررسی درگاه‌های شخص ثالث و مختص 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 ;

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

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

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

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

اجزا

مکان

سرور مدیریت

<inst_root>/apigee/var/log/edge-management-server

رهیاب

<inst_root>/apigee/var/log/edge-router

پردازشگر پیام

<inst_root>/apigee/var/log/edge-message-processor

سرور Qpid

<inst_root>/apigee/var/log/edge-qpid-server

Apigee Postgres Server

<inst_root>/apigee/var/log/edge-postgres-server

میانای کاربر Edge

<inst_root>/apigee/var/log/edge-ui

ZooKeeper

<inst_root>/apigee/var/log/apigee-zookeeper

OpenLDAP

<inst_root>/apigee/var/log/apigee-openldap

Cassandra

<inst_root>/apigee/var/log/apigee-cassandra

Qpidd

<inst_root>/apigee/var/log/apigee-qpidd

پایگاه داده PostgreSQL

<inst_root>/apigee/var/log/apigee-postgresql

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

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

  1. در گره «پردازشگر پیام»، /<install_dir>/apigee/customer/application/messsage-processor.properties را ویرایش کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید.
  2. ویژگی زیر را به فایل اضافه کنید:
    conf_system_log.level=DEBUG
  3. «پردازشگر پیام» را بازراه‌اندازی کنید:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service edge-message-processor restart

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

  1. در گره Edge UI،‏ /<install_dir>/apigee/customer/application/ui.properties را ویرایش کنید. اگر آن فایل وجود ندارد، آن را ایجاد کنید.
  2. ویژگی زیر را به فایل اضافه کنید:
    conf_application_logger.application=DEBUG
  3. رابط کاربری Edge را بازراه‌اندازی کنید:
    > /<install_dir>/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

عنصر

Nagios

جمع‌آوری‌شده

Splunk

بررسی‌های سطح سیستم

استفاده از واحد پردازش مرکزی

؟

؟

حافظه آزاد/استفاده‌شده

؟

؟

استفاده از فضای دیسک

؟

؟

آمار شبکه

؟

؟

فرایندها

؟

بررسی‌های میانای برنامه‌سازی کاربردی

؟

JMX

؟

جاوا

؟

فایل‌های گزارش

؟

رویدادهای بحرانی

به محدودیت نرخ رسیدید

؟

سرور زیرینه (Hybris یا SharePoint) دردسترس نیست

؟

FaaS (STS) دردسترس نیست

؟

رویدادهای هشدار

سرور SMTP دردسترس نیست

؟

نقض SLA (قرارداد سطح سرویس)

؟