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 تنظیم کنید:
|
دارایی |
شرح |
|---|---|
|
|
نشانی وب گره apigee-influxdb را، ازجمله درگاه ۸۰۸۶، مشخص کنید. برای مثال: http://192.168.0.1:8086 |
پارامترهای پیکربندی برای apigee-grafana
این ویژگیها را در فایل نوشتاریای تنظیم کنید که به فرمان apigee-grafana setup
ارسال میکنید. برای مثال، آنها را در فایل نوشتاری با نام sa_grafana.txt تنظیم کنید:
|
دارایی |
شرح |
|---|---|
|
|
نشانی IP یا نام DNS گره InfluxDB را مشخص کنید. به عنوان مثال: 192.168.0.1 |
|
|
درگاه InfluxDB API که توسط منبع داده Grafana استفاده میشود. 8086 را مشخص کنید. |
|
|
نام کاربری Grafana برای ورود به سیستم واسط کاربر داشبورد. |
|
|
گذرواژه Grafana برای ورود به سیستم واسط کاربر داشبورد. |
دستورالعملهای نصب
دستورالعملهای زیر را برای نصب مؤلفههای داشبورد در این توالی دنبال کنید:
apigee-influxdb(در گره مرکزی)-
apigee-telegraf(در هر گره) apigee-grafana(در سرور مرکزی)
نصب کردن apigee-influxdb در یک گره Edge یا گره مستقل
در گره مستقل، یا گره Edge که Management Server یا Edge UI را اجرا میکند:
- نصب
apigee-influxdb:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb install
- پیکربندی پایگاه داده
apigee-influxdb:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb setup
- شروع
apigee-influxdb:> /opt/apigee/apigee-service/bin/apigee-service apigee-influxdb start
apigee-telegraf را روی هر گره Edge نصب کنید
در هر گره از نصب Edge:
- در اولین گره Edge،
apigee-telegrafرا نصب کنید:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install
- فایل پیکربندی برای
apigee-telegrafبا نامsa_telegraf.txtایجاد کنید. معمولاً این فایل را در دایرکتوریای ذخیره میکنید که برای کاربر «apigee» قابلدسترسی باشد، مثل/opt/apigee/customer/application، و آن را تحت مالکیت کاربر «apigee» قرار میدهید.ویژگی زیر را در فایل تنظیم کنید تا نشانی وب گره apigee-influxdb، ازجمله درگاه ۸۰۸۶، مشخص شود:
INFLUXDB_URL=http://influx_IP:8086
- مالک را به «apigee» تغییر دهید:
> chown apigee:apigee /opt/apigee/customer/application/sa_telegraf.txt
- پیکربندی
apigee-telegraf:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f /opt/apigee/customer/application/sa_telegraf.txt - بازراهاندازی
apigee-telegraf:> /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf restart
- این فرایند را در همه گرههای Edge تکرار کنید.
نصب apigee-grafana در یک گره Edge
در یک گره از نصب Edge، مانند گره Edge UI:
- در اولین گره Edge،
apigee-grafanaرا نصب کنید:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana install
- فایل پیکربندی برای
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
- مالک را به «apigee» تغییر دهید:
> chown apigee:apigee /opt/apigee/customer/application/sa_grafana.txt
apigee-grafanaرا بااستفاده از فایل پیکربندی پیکربندی کنید:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana setup -f /opt/apigee/customer/application/sa_grafana.txt- بازراهاندازی
apigee-grafana:> /opt/apigee/apigee-service/bin/apigee-service apigee-grafana restart
برای دسترسی به داشبورد، نشانی وب زیر را در مرورگر باز کنید:
http://grafana_IP_or_DNS:3000
بااستفاده از اطلاعات اعتباری که در فایل پیکربندی برای
apigee-grafana مشخص کردهاید به سیستم وارد شوید. در مثال بالا
نام کاربری/گذرواژه admin/admin است.
عیبیابی نصب
اگر دادهای در داشبورد نمیبینید، از روش زیر برای عیبیابی نصب استفاده کنید:
- برای اطمینان از اینکه
apigee-telegrafدادهها را جمعآوری میکندapigee-service apigee-telegraf setupرا اجرا کنید، این دستور یکسانتوان است، خطاها و وابستگیهای مفقود را بررسی کنید و آنها را برطرف کنید.apigee-telegrafرا بازراهاندازی کنید و/opt/apigee/var/log/apigee-telegraf/apigee-telegraf.logرا برای وجود خطا بررسی کنید
- برای اطمینان از اینکه
apigee-influxdbداده دریافت میکند:- مطمئن شوید درگاههای TCP زیر در گرههای داده
apigee-influxdbباز باشند: 8086 و 8183. - از نشانی وب زیر برای باز کردن میانای کاربر influxdb در مرورگر استفاده کنید:
http://influxdb_IP_or_DNS:8183
- در فیلد «پُرسمان»، «نمایش پایگاههای داده» را وارد کنید. مطمئن شوید پایگاههای داده زیر
ایجاد شده باشند:
system, application, events, _internal. - در فیلد «پرسوجو»، عبارت «show servers» را وارد کنید. مطمئن شوید که
apigee-influxdbگره فهرستشده را میبینید.
- در فیلد «پُرسمان»، «نمایش پایگاههای داده» را وارد کنید. مطمئن شوید پایگاههای داده زیر
ایجاد شده باشند:
- مطمئن شوید درگاههای TCP زیر در گرههای داده
- منابع داده را در داشبورد بررسی کنید:
- منابع داده را در منو اصلی انتخاب کنید. باید نمادهای سه منبع داده را ببینید.
- برای هر منبع داده، نماد را انتخاب کنید.
- در صفحه جزئیات منبع داده، دکمه ذخیره و آزمایش را انتخاب کنید.
- اگر منبع داده بهدرستی پیکربندی شده باشد، باید پیامی به این شکل ببینید:
موفقیت
منبع داده کار میکند
درحال بهروزرسانی داشبورد پایش نسخه بتا
براساس نسخه 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 بهروز کنید.
برای بهروزرسانی داشبورد پایش نسخه بتا:
- Edge را به نسخه ۴.۱۸.۰۱ بهروز کنید، همانطور که در بهروزرسانی Apigee Edge نسخه ۴.۱۷.۰۱/۴.۱۷.۰۵ به ۴.۱۷.۰۹، بهروزرسانی Apigee Edge نسخه ۴.۱۶.۰۹ به ۴.۱۷.۰۹، و بهروزرسانی Apigee Edge نسخه ۴.۱۶.۰۱/۴.۱۶.۰۵ به ۴.۱۷.۰۹ توضیح داده شده است.
apigee-influxdbرا در گره «سرور مدیریت» بهروز کنید:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
که configFile فایل پیکربندی است که برای نصب
apigee-influxاستفاده کردید.اگر
apigee-grafanaرا در گره «سرور مدیریت» نیز نصب کردهاید، این مرحلهapigee-grafanaرا نیز بهروز میکند. درغیراینصورت،apigee-granfanaرا همانطور که در مرحله زیر نشان داده شده است بهروز کنید.- اگر
apigee-grafanaرا در گره «سرور مدیریت» نصب نکردهاید،apigee-grafanaرا در گرهای که آن را نصب کردهاید بهروز کنید:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
- بهروزرسانی
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
- مرحله ۴ را برای هر گره تکرار کنید.
بهروزرسانی از نسخه 4.16.05
نسخه ۴.۱۶.۰۵ داشبورد بهجای apigee-telegraf از apigee-collectd استفاده میکرد. بهعنوان بخشی از بهروزرسانی به نسخه ۴.۱۸.۰۱، apigee-collectd را حذف نصب میکنید و apigee-telegraf را نصب میکنید.
برای بهروزرسانی داشبورد پایش نسخه بتا:
- Edge را به نسخه ۴.۱۸.۰۱ بهروز کنید، همانطور که در بهروزرسانی Apigee Edge ۴.۱۶.۰۱/۴.۱۶.۰۵ به ۴.۱۷.۰۱ و بهروزرسانی Apigee Edge ۴.۱۶.۰۹ به ۴.۱۷.۰۱ شرح داده شده است.
apigee-influxdbرا در گره «سرور مدیریت» بهروز کنید:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
که configFile فایل پیکربندی است که برای نصب
apigee-influxاستفاده کردید.اگر
apigee-grafanaرا در گره «سرور مدیریت» نیز نصب کردهاید، این مرحلهapigee-grafanaرا نیز بهروز میکند. درغیراینصورت،apigee-granfanaرا همانطور که در مرحله زیر نشان داده شده است بهروز کنید.- اگر
apigee-grafanaرا در گره «سرور مدیریت» نصب نکردهاید،apigee-grafanaرا در گرهای که آن را نصب کردهاید بهروز کنید:> /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile
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
- مرحله ۴ را برای هر گره تکرار کنید.