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

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

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

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

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

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

اگر تصمیم گرفتید 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

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

دارایی

شرح

INFLUXDB_URL

نشانی وب گره apigee-influxdb را، ازجمله درگاه ۸۰۸۶، مشخص کنید. برای مثال:

http://192.168.0.1:8086

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

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

دارایی

شرح

INFLUXDB_HOST

نشانی IP یا نام DNS گره InfluxDB را مشخص کنید. به عنوان مثال:

192.168.0.1

INFLUXDB_PORT

درگاه InfluxDB API که توسط منبع داده Grafana استفاده می‌شود. ‫8086 را مشخص کنید.

GRAFANA_USERNAME

نام کاربری Grafana برای ورود به سیستم واسط کاربر داشبورد.

GRAFANA_PASSWORD

گذرواژه Grafana برای ورود به سیستم واسط کاربر داشبورد.

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

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

  • 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 باز باشند: 8086 و 8183.
    2. از نشانی وب زیر برای باز کردن میانای کاربر influxdb در مرورگر استفاده کنید:
      http://influxdb_IP_or_DNS:8183
      1. در فیلد «پُرسمان»، «نمایش پایگاه‌های داده» را وارد کنید. مطمئن شوید پایگاه‌های داده زیر ایجاد شده باشند: system, application, events, _internal.
      2. در فیلد «پرس‌وجو»، عبارت «show servers» را وارد کنید. مطمئن شوید که apigee-influxdb گره فهرست‌شده را می‌بینید.
  3. منابع داده را در داشبورد بررسی کنید:
    1. منابع داده را در منو اصلی انتخاب کنید. باید نمادهای سه منبع داده را ببینید.
    2. برای هر منبع داده، نماد را انتخاب کنید.
    3. در صفحه جزئیات منبع داده، دکمه ذخیره و آزمایش را انتخاب کنید.
    4. اگر منبع داده به‌درستی پیکربندی شده باشد، باید پیامی به این شکل ببینید:
      موفقیت
      منبع داده کار می‌کند

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

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

  • ‫4.16.09 و 4.17.0x از همان روال استفاده می‌کنند
  • ‫۴.۱۶.۰۵ لازم می‌داند apigee-collectd را به‌عنوان بخشی از به‌روزرسانی حذف نصب کنید.

به‌روزرسانی از نسخه 4.16.09 یا 4.17.0x

اگر نسخه Beta از «داشبورد پایش Apigee» را در 4.16.09 یا 4.17.0x نصب کرده‌اید، می‌توانید آن را به نسخه Beta برای 4.18.01 به‌روز کنید.

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

  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

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

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

  1. 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. مرحله ۴ را برای هر گره تکرار کنید.