نصب داشبورد پایش نسخه بتا

Edge for Private Cloud نسخه ۴.۱۷.۰۹

ملزومات سیستم

برای جمع‌آوری داده‌های داشبورد، باید apigee-telegraf را در همه گره‌های Edge نصب کنید. بنابراین، الزامات سیستم برای apigee-telegraf همانند الزامات سیستم برای گره Edge است که آن را روی آن نصب می‌کنید.

می‌توانید apigee-grafana را در گره‌ای جداگانه نصب کنید یا از یکی از گره‌های Edge موجود مثل Management Server یا گره Edge UI دوباره استفاده کنید.

برای apigee-influxdb، می‌توانید آن را روی یک گره Edge موجود، مانند گره سرور مدیریت یا گره Edge UI، بدون تغییر در الزامات سیستم نصب کنید.

اگر تصمیم گرفتید apigee-influxdb را به‌دلایل عملکردی در گره خودش نصب کنید، گره باید شرایط زیر را داشته باشد:

• واحد پردازش مرکزی ۲ هسته‌ای
• ‫۴ گیگابایت RAM
• ‫۲۵۰ گیگابایت فضای دیسک (داده‌های نظارت پس‌از ۱ ماه پاک می‌شود)
• ‫۱۰۰۰ یا بیشتر IOPS

برای اطلاعات بیشتر، به سند InfluxData مراجعه کنید.

الزامات درگاه برای apigee-influxdb

درگاه‌های ۸۰۸۶ و ۸۱۸۳ باید در گره‌های داده apigee-influxdb باز باشند تا گره‌ای که apigee-grafana و apigee-telegraf را اجرا می‌کند بتواند به آن‌ها دسترسی داشته باشد.

فایل‌های پیکربندی برای نصب مؤلفه‌های داشبورد

برای نصب مؤلفه‌های apigee-telegraf و apigee-grafana، یک فایل پیکربندی را به ابزار کمکی apigee-service ارسال می‌کنید. این فایل‌ها را در فهرست راهنمایی که برای کاربر «apigee» قابل‌دسترسی است، مثل /opt/apigee/customer/application، ذخیره کنید و کاربر «apigee» را مالک آن‌ها کنید.

پارامترهای پیکربندی برای apigee-telegraf

این ویژگی‌ها را در فایل نوشتاری‌ای تنظیم کنید که به فرمان setup apigee-telegraf ارسال می‌کنید. برای مثال، آن‌ها را در یک فایل نوشتاری به نام sa_telegraf.txt تنظیم کنید:

http://192.168.0.1:8086

پارامترهای پیکربندی برای apigee-grafana

این ویژگی‌ها را در فایل نوشتاری‌ای تنظیم کنید که به فرمان apigee-grafana setup ارسال می‌کنید. برای مثال، آن‌ها را در فایل نوشتاری با نام sa_grafana.txt تنظیم کنید:

192.168.0.1

دستورالعمل‌های نصب

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

• apigee-influxdb (در گره مرکزی)
• apigee-telegraf (در هر گره)
• apigee-grafana (در سرور مرکزی)

نصب کردن apigee-influxdb در یک گره Edge یا گره مستقل

در گره مستقل، یا گره Edge که Management Server یا Edge UI را اجرا می‌کند:

1. apigee-influxdb را نصب کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
2. پایگاه داده apigee-influxdb را پیکربندی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
3. ‫apigee-influxdb را شروع کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start

apigee-telegraf را روی هر گره Edge نصب کنید

در هر گره از نصب Edge:

1. در اولین گره Edge،‏ apigee-telegraf را نصب کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
2. فایل پیکربندی برای apigee-telegraf با نام sa_telegraf.txt ایجاد کنید. معمولاً این فایل را در دایرکتوری‌ای ذخیره می‌کنید که برای کاربر «apigee» قابل‌دسترسی باشد، مثل /opt/apigee/customer/application، و آن را تحت مالکیت کاربر «apigee» قرار می‌دهید.
   
   ویژگی زیر را در فایل تنظیم کنید تا نشانی وب گره apigee-influxdb، ازجمله درگاه ۸۰۸۶، مشخص شود:
   INFLUXDB_URL=http://influx_IP:8086
3. مالک را به «apigee» تغییر دهید:
   > chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
4. ‫apigee-telegraf را پیکربندی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
5. apigee-telegraf را بازراه‌اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
6. این فرایند را در همه گره‌های Edge تکرار کنید.

نصب apigee-grafana در یک گره Edge

در یک گره از نصب Edge، مانند گره Edge UI:

1. در اولین گره Edge،‏ apigee-grafana را نصب کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
2. یک فایل پیکربندی برای apigee-grafana با نام sa_grafana.txt ایجاد کنید. معمولاً، این فایل را در دایرکتوری قابل‌دسترس توسط کاربر «apigee» ذخیره می‌کنید، مانند /opt/apigee/customer/application، و آن را متعلق به کاربر «apigee» می‌کنید.
   
   ویژگی‌های زیر را در فایل تنظیم کنید. این ویژگی‌ها در بالا شرح داده شده است:
   INFLUXDB_HOST=192.168.56.101
   INFLUXDB_PORT=8086
   GRAFANA_USERNAME=admin
   GRAFANA_PASSWORD=admin
3. مالک را به «apigee» تغییر دهید:
   > chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
4. apigee-grafana را بااستفاده از فایل پیکربندی پیکربندی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
5. apigee-grafana را بازراه‌اندازی کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart

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

http://grafana_IP_or_DNS:3000

بااستفاده از اطلاعات اعتباری که در فایل پیکربندی برای apigee-grafana مشخص کرده‌اید به سیستم وارد شوید. در مثال بالا نام کاربری/گذرواژه admin/admin است.

عیب‌یابی نصب

اگر داده‌ای در داشبورد نمی‌بینید، از روش زیر برای عیب‌یابی نصب استفاده کنید:

1. برای اطمینان از اینکه apigee-telegraf داده‌ها را جمع‌آوری می‌کند
   1. apigee-service apigee-telegraf setup را اجرا کنید، این دستور یکسان‌توان است، خطاها و وابستگی‌های مفقود را بررسی کنید و آن‌ها را برطرف کنید.
   2. apigee-telegraf را بازراه‌اندازی کنید و /opt/apigee/var/log/apigee-telegraf/apigee-telegraf.log را برای هرگونه خطا بررسی کنید
2. برای اطمینان از اینکه apigee-influxdb داده دریافت می‌کند:
   1. مطمئن شوید درگاه‌های TCP زیر در گره‌های داده apigee-influxdb باز باشند: ۸۰۸۶ و ۸۱۸۳.
   2. از نشانی وب زیر برای باز کردن واسط کاربر influxdb در مرورگر استفاده کنید:
      http://influxdb_IP_or_DNS:8183
      1. در فیلد «پُرسمان»، «نمایش پایگاه‌های داده» را وارد کنید.
         مطمئن شوید پایگاه‌های داده زیر ایجاد شده باشند: system،‏ application،‏ events،‏ _internal.
      2. در فیلد «پرس‌وجو»، «نمایش سرورها» را وارد کنید.
         مطمئن شوید که گره‌های apigee-influxdb را در فهرست می‌بینید.
3. منابع داده را در داشبورد بررسی کنید:
   1. منابع داده را در منو اصلی انتخاب کنید. باید نمادهای سه منبع داده را ببینید.
   2. برای هر منبع داده، نماد را انتخاب کنید.
   3. در صفحه جزئیات منبع داده، دکمه ذخیره و آزمایش را انتخاب کنید.
   4. اگر منبع داده به‌درستی پیکربندی شده باشد، باید پیامی به این شکل ببینید:
      موفقیت
      منبع داده کار می‌کند

درحال به‌روزرسانی داشبورد پایش نسخه بتا

براساس نسخه Edge که از آن ارتقا می‌دهید، از یکی از دو روش زیر استفاده کنید:

• ‫4.16.09،‏ 4.17.01، و 4.17.05 از رویه یکسانی استفاده می‌کنند
• ‫4.16.05 لازم می‌داند apigee-collectd را به‌عنوان بخشی از به‌روزرسانی حذف نصب کنید.

به‌روزرسانی از نسخه ۴.۱۶.۰۹،‏ ۴.۱۷.۰۱، یا ۴.۱۷.۰۵

اگر نسخه «بتا» از «داشبورد نظارت Apigee» را در 4.16.09،‏ 4.17.01، یا 4.17.05 نصب کرده‌اید، می‌توانید آن را به نسخه «بتا» برای 4.17.09 به‌روز کنید.

برای به‌روزرسانی داشبورد پایش نسخه بتا:

1. Edge را به نسخه ۴.۱۷.۰۹ به‌روز کنید، همان‌طور که در به‌روزرسانی Apigee Edge نسخه ۴.۱۷.۰۱/۴.۱۷.۰۵ به ۴.۱۷.۰۹، به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۹ به ۴.۱۷.۰۹، و به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۱/۴.۱۶.۰۵ به ۴.۱۷.۰۹ شرح داده شده است.
2. apigee-influxdb را در گره «سرور مدیریت» به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   که configFile فایل پیکربندی‌ای است که برای نصب apigee-influx استفاده کردید.
   
   اگر apigee-grafana را نیز در گره «سرور مدیریت» نصب کرده‌اید، این مرحله apigee-grafana را نیز به‌روز می‌کند. درغیراین‌صورت، apigee-granfana را همان‌طور که در مرحله زیر نشان داده شده است به‌روز کنید.
3. اگر apigee-grafana را در گره سرور مدیریت نصب نکرده‌اید، apigee-grafana را در گره‌ای که آن را نصب کرده‌اید به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. apigee-telegraf را در گره ۱ به‌روز کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
5. مرحله ۴ را برای هر گره تکرار کنید.

به‌روزرسانی از نسخه 4.16.05

نسخه 4.16.05 داشبورد به‌جای apigee-telegraf از apigee-collectd استفاده می‌کرد. به‌عنوان بخشی از به‌روزرسانی به 4.17.09، apigee-collectd را حذف نصب می‌کنید و apigee-telegraf را نصب می‌کنید.

برای به‌روزرسانی داشبورد پایش نسخه بتا:

1. Edge را به نسخه ۴.۱۷.۰۹ به‌روز کنید، همان‌طور که در به‌روزرسانی Apigee Edge نسخه ۴.۱۷.۰۱/۴.۱۷.۰۵ به ۴.۱۷.۰۹، به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۹ به ۴.۱۷.۰۹، و به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۱/۴.۱۶.۰۵ به ۴.۱۷.۰۹ شرح داده شده است.
2. apigee-influxdb را در گره «سرور مدیریت» به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
   
   که configFile فایل پیکربندی‌ای است که برای نصب apigee-influx استفاده کردید.
   
   اگر apigee-grafana را نیز در گره «سرور مدیریت» نصب کرده‌اید، این مرحله apigee-grafana را نیز به‌روز می‌کند. درغیراین‌صورت، apigee-granfana را همان‌طور که در مرحله زیر نشان داده شده است به‌روز کنید.
3. اگر apigee-grafana را در گره سرور مدیریت نصب نکرده‌اید، apigee-grafana را در گره‌ای که آن را نصب کرده‌اید به‌روز کنید:
   > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
4. apigee-telegraf را در گره ۱ نصب کنید:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
   > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
   > /opt/apigee/apigee-service/bin/apigee-service apigee-collectd uninstall
5. مرحله ۴ را برای هر گره تکرار کنید.