تثبيت لوحة تحكم مراقبة الإصدار التجريبي

الإصدار 4.17.01 من Edge for Private Cloud

متطلبات النظام

يجب تثبيت apigee-telegraf على جميع عُقد Edge لجمع بيانات لوحة البيانات. لذلك، فإن متطلبات النظام لـ apigee-telegraf هي نفسها متطلبات عقدة Edge التي يتم تثبيتها عليها.

يمكنك تثبيت apigee-grafana على عقدة منفصلة، أو إعادة استخدام إحدى عُقد Edge الحالية، مثل خادم الإدارة أو عقدة واجهة مستخدم Edge.

بالنسبة إلى apigee-influxdb، يمكنك تثبيته على عقدة Edge حالية، مثل عقدة خادم الإدارة أو عقدة واجهة مستخدم Edge، بدون تغيير متطلبات النظام.

إذا قررت تثبيت apigee-influxdb على العقدة الخاصة به لأسباب تتعلق بالأداء، يجب أن تستوفي العقدة المتطلبات التالية:

• وحدة معالجة مركزية (CPU) ثنائية النواة
• ذاكرة وصول عشوائي (RAM) بسعة 4 غيغابايت
• مساحة قرص تبلغ 250 غيغابايت (يتم حذف بيانات المراقبة بعد شهر واحد)
• ‫1,000 عملية إدخال/إخراج في الثانية أو أكثر

لمزيد من المعلومات، يُرجى الاطّلاع على مستند 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

اضبط هذه السمات في ملف نصي يتم تمريره إلى الأمر setup في apigee-telegraf. على سبيل المثال، يمكنك ضبطها في ملف نصي باسم 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 تشغّل 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".
   
   اضبط السمة التالية في الملف لتحديد عنوان 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:

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

للوصول إلى لوحة البيانات، افتح عنوان 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. في حقل "طلب البحث"، أدخِل "عرض قواعد البيانات".
         تأكَّد من إنشاء قواعد البيانات التالية: system, application, events, _internal.
      2. في حقل "طلب البحث"، أدخِل "عرض الخوادم".
         تأكَّد من ظهور عُقد apigee-influxdb مُدرَجة.
3. تحقَّق من مصادر البيانات في لوحة البيانات:
   1. انقر على مصادر البيانات في القائمة الرئيسية. من المفترض أن تظهر لك رموز لثلاثة مصادر بيانات.
   2. انقر على الرمز لكل مصدر بيانات.
   3. في صفحة تفاصيل مصدر البيانات، انقر على الزر حفظ واختبار.
   4. إذا تم ضبط مصدر البيانات بشكل صحيح، من المفترض أن تظهر لك رسالة بالصيغة التالية:
      تم الإجراء بنجاح
      مصدر البيانات يعمل بشكل صحيح

تعديل لوحة بيانات المراقبة التجريبية

إذا ثبّت الإصدار التجريبي من لوحة بيانات مراقبة Apigee في الإصدار 4.16.09، يمكنك تحديثه إلى الإصدار التجريبي للإصدار 4.17.01.

يجب تحديث مكوّنات لوحة البيانات بالترتيب التالي:

• apigee-influxdb
• apigee-telegraf على كل عقدة
• apigee-grafana

لتعديل لوحة بيانات التتبُّع التجريبية:

1. حدِّث Edge إلى الإصدار 4.17.01 كما هو موضّح في تحديث Apigee Edge 4.16.01/4.16.05 إلى 4.17.01 وتحديث Apigee Edge 4.16.09 إلى 4.17.01.
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 على العقدة 1:
   > /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. كرِّر الخطوة 3 لكل عقدة.
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