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

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 تنظیم کنید:

دارایی

شرح

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 ایجاد کنید. معمولاً این فایل را در دایرکتوری‌ای ذخیره می‌کنید که برای کاربر «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 ایجاد کنید. معمولاً این فایل را در دایرکتوری‌ای ذخیره می‌کنید که برای کاربر «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. اگر منبع داده به‌درستی پیکربندی شده باشد، باید پیامی به این شکل ببینید:
      موفقیت
      منبع داده کار می‌کند

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

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

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

  • apigee-influxdb
  • ‫apigee-telegraf در هر گره
  • apigee-grafana

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

  1. Edge را به نسخه ۴.۱۷.۰۱ به‌روز کنید، همان‌طور که در به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۱/۴.۱۶.۰۵ به ۴.۱۷.۰۱ و به‌روزرسانی Apigee Edge نسخه ۴.۱۶.۰۹ به ۴.۱۷.۰۱ شرح داده شده است.
  2. apigee-influxdb را به‌روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
    > /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb restart
  3. apigee-telegraf را در گره ۱ به‌روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
  4. مرحله ۳ را برای هر گره تکرار کنید.
  5. ‫apigee-grafana را به‌روز کنید:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana update
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt
    > /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart