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

Edge for Private Cloud v. 4.17.05

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

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

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

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

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

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

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

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

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

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

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

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

این ویژگی‌ها را در فایل نوشتاری‌ای که به فرمان apigee-telegraf setup ارسال می‌کنید تنظیم کنید. برای مثال، آن‌ها را در فایل متنی به نام 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 که «سرور مدیریت» یا «میانای کاربر Edge» را اجرا می‌کند:

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.05 لازم می‌داند apigee-collectd را به‌عنوان بخشی از به‌روزرسانی حذف نصب کنید.

از نسخه ۴.۱۶.۰۹ یا ۴.۱۷.۰۱ به‌روزرسانی کنید

اگر نسخه «بتا» «داشبورد پایش Apigee» را در نسخه ۴.۱۶.۰۹ یا ۴.۱۷.۰۱ نصب کرده‌اید، می‌توانید آن را به نسخه «بتا» برای نسخه ۴.۱۷.۰۵ به‌روز کنید.

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

1. ‫Edge را به نسخه ۴.۱۷.۰۵ به‌روزرسانی کنید، همان‌طور که در به‌روزرسانی Apigee Edge 4.17.01 به 4.17.05، به‌روزرسانی Apigee Edge 4.16.09 به 4.17.05، و به‌روزرسانی Apigee Edge 4.16.01/4.16.05 به 4.17.05 توضیح داده شده است.
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

نسخه ۴.۱۶.۰۵ داشبورد به‌جای apigee-telegraf از apigee-collectd استفاده می‌کرد. به‌عنوان بخشی از به‌روزرسانی به ‫۴.۱۷.۰۵، apigee-collectd را حذف نصب می‌کنید و apigee-telegraf را نصب می‌کنید.

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

1. ‫Edge را به نسخه ۴.۱۷.۰۵ به‌روزرسانی کنید، همان‌طور که در به‌روزرسانی Apigee Edge 4.17.01 به 4.17.05، به‌روزرسانی Apigee Edge 4.16.09 به 4.17.05، و به‌روزرسانی Apigee Edge 4.16.01/4.16.05 به 4.17.05 توضیح داده شده است.
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. مرحله ۴ را برای هر گره تکرار کنید.