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

الإصدار 4.17.05 من 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:

الموقع

الوصف

INFLUXDB_URL

حدِّد عنوان URL لعقدة apigee-influxdb، بما في ذلك المنفذ 8086.

على سبيل المثال:

http://192.168.0.1:8086

مَعلمات الإعدادات لـ apigee-grafana

اضبط هذه السمات في ملف نصي يتم تمريره إلى الأمر apigee-grafana setup. على سبيل المثال، قم بتعيينها في ملف نصي باسم sa_grafana.txt:

الموقع

الوصف

INFLUXDB_HOST

حدِّد عنوان IP أو اسم نظام أسماء النطاقات لعقدة 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 باسم 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.01 الإجراء نفسه
  • يتطلّب الإصدار 4.16.05 إلغاء تثبيت apigee-collectd كجزء من التحديث.

التحديث من الإصدار 4.16.09 أو 4.17.01

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

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

  1. حدِّث Edge إلى الإصدار 4.17.05 كما هو موضّح في تحديث Apigee Edge من الإصدار 4.17.01 إلى 4.17.05 وتحديث Apigee Edge من الإصدار 4.16.09 إلى 4.17.05 وتحديث Apigee Edge من الإصدار 4.16.01/4.16.05 إلى 4.17.05.
  2. حدِّث apigee-influxdb على عقدة خادم الإدارة:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    حيث configFile هو ملف الإعداد الذي استخدمته لتثبيت apigee-influx.

    إذا ثبّت أيضًا apigee-grafana على عقدة خادم الإدارة، ستؤدي هذه الخطوة أيضًا إلى تحديث apigee-grafana. Otherwise, update apigee-granfana as shown in the following step.
  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. As part of updating to 4.17.05 you uninstall apigee-collectd and install apigee-telegraf.

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

  1. حدِّث Edge إلى الإصدار 4.17.05 كما هو موضّح في تحديث Apigee Edge من الإصدار 4.17.01 إلى 4.17.05 وتحديث Apigee Edge من الإصدار 4.16.09 إلى 4.17.05 وتحديث Apigee Edge من الإصدار 4.16.01/4.16.05 إلى 4.17.05.
  2. حدِّث apigee-influxdb على عقدة خادم الإدارة:
    > /opt/apigee/apigee-setup/bin/update.sh -c pp -f configfile

    حيث configFile هو ملف الإعداد الذي استخدمته لتثبيت apigee-influx.

    إذا ثبّت أيضًا apigee-grafana على عقدة خادم الإدارة، ستؤدي هذه الخطوة أيضًا إلى تحديث apigee-grafana. Otherwise, update apigee-granfana as shown in the following step.
  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 لكل عقدة.