نصب داشبورد مانیتورینگ (بتا)

Edge for Private Cloud نسخه 4.18.01

سیستم مورد نیاز

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

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

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

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

  • سی پی یو 2 هسته ای
  • رم 4 گیگابایت
  • 250 گیگابایت فضای دیسک (داده های مانیتورینگ پس از 1 ماه پاک می شود)
  • 1000 یا بیشتر IOPS

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

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

پورت‌های 8086 و 8183 باید روی گره‌های داده 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

URL گره apigee-influxdb، از جمله پورت 8086 را مشخص کنید. به عنوان مثال:

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 که سرور مدیریت یا 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' قرار می دهید.

    ویژگی زیر را در فایل تنظیم کنید تا URL گره apigee-influxdb از جمله پورت 8086 را مشخص کنید: 

    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

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

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. از URL زیر برای باز کردن رابط کاربری influxdb در مرورگر استفاده کنید: 
      http://influxdb_IP_or_DNS:8183
      1. در قسمت Query "show databases" را وارد کنید. اطمینان حاصل کنید که پایگاه داده های زیر ایجاد شده اند: system, application, events, _internal .
      2. در قسمت Query "show servers" را وارد کنید. مطمئن شوید که گره‌های apigee-influxdb فهرست شده‌اند.
  3. منابع داده را در داشبورد بررسی کنید:
    1. منابع داده را در منوی اصلی انتخاب کنید. شما باید نمادهای سه منبع داده را مشاهده کنید.
    2. برای هر منبع داده، نماد را انتخاب کنید.
    3. در صفحه جزئیات منبع داده، دکمه Save & Test را انتخاب کنید.
    4. اگر منبع داده به درستی پیکربندی شده باشد، باید پیامی را به شکل زیر مشاهده کنید:
      موفقیت
      منبع داده کار می کند

به روز رسانی داشبورد نظارت بتا

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

  • 4.16.09 و 4.17.0x از همین رویه استفاده می کنند
  • 4.16.05 از شما می خواهد که apigee-collectd به عنوان بخشی از به روز رسانی حذف نصب کنید.

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

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

برای به روز رسانی داشبورد نظارت بتا:

  1. همانطور که در Update Apigee Edge 4.17.01/4.17.05 به 4.17.09 توضیح داده شده است، Apigee Edge 4.16.09 را به 4.17.09 به روز کنید و Apigee Edge 4.17.10 به 4.16.16.1 را به روز کنید. .
  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 در گره 1: 
    > /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 را برای هر گره تکرار کنید.

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

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

برای به روز رسانی داشبورد نظارت بتا:

  1. همانطور که در Update Apigee Edge 4.16.01/4.16.05 به 4.17.01 توضیح داده شده است Edge را به 4.18.01 به روز کنید و Apigee Edge 4.16.09 را به 4.17.01 به روز کنید .
  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 را روی گره 1 نصب کنید: 
    > /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. مرحله 4 را برای هر گره تکرار کنید.