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

الإصدار 4.18.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

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

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. في حقل "طلب البحث"، أدخِل "عرض قواعد البيانات". تأكَّد من إنشاء قواعد البيانات التالية: system, application, events, _internal.
      2. في حقل "طلب البحث"، أدخِل "عرض الخوادم". تأكَّد من ظهور عُقد apigee-influxdb في القائمة.
3. تحقَّق من مصادر البيانات في لوحة البيانات:
   1. انقر على مصادر البيانات في القائمة الرئيسية. من المفترض أن تظهر لك رموز لثلاثة مصادر بيانات.
   2. انقر على الرمز لكل مصدر بيانات.
   3. في صفحة تفاصيل مصدر البيانات، انقر على الزر حفظ واختبار.
   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. حدِّث Edge إلى الإصدار 4.18.01 كما هو موضّح في تحديث Apigee Edge 4.17.01/4.17.05 إلى 4.17.09 وتحديث Apigee Edge 4.16.09 إلى 4.17.09 وتحديث Apigee Edge 4.16.01/4.16.05 إلى 4.17.09.
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. حدِّث Edge إلى الإصدار 4.18.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-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 لكل عقدة.