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

Edge for Private Cloud، الإصدار 4.17.09

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

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

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

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

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

  • وحدة معالجة مركزية (CPU) ثنائية النواة
  • ذاكرة وصول عشوائي (RAM) بسعة 4 غيغابايت
  • مساحة قرص قدرها 250 غيغابايت (تتم معالجة البيانات التي تتم إزالتها نهائيًا بعد شهر واحد)
  • 1000 عملية شراء أو أكثر (IOPS)

يمكنك الاطّلاع على مستند InfluxData للحصول على مزيد من المعلومات.

متطلبات منفذ apigee-influxdb

يجب فتح المنفذين 8086 و8183 على عُقد بيانات igee-influxdb حتى يمكن الوصول إليه من خلال العقدة التي تشغِّل apigee-grafana apigee-telegraf.

ملفات الإعداد لتثبيت لوحة البيانات المكونات

لتثبيت apigee-telegraf وapigee-grafana، تمرِّر ملف إعداد إلى أداة apigee-service. يمكنك تخزين هذه الملفات في دليل يمكن الوصول إليه عن طريق "apigee" المستخدم، مثلاً /opt/apigee/customer/application، وجعلها ملكًا لـ "واجهة برمجة تطبيقات" المستخدم.

مَعلمات الإعدادات لواجهة برمجة التطبيقات 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 أو اسم نظام أسماء النطاقات لعقدة InfluxDB.

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

192.168.0.1

INFLUXDB_PORT

منفذ واجهة برمجة التطبيقات InfluxDB الذي يستخدمه مصدر بيانات Grafana يُرجى تحديد الرقم 8086.

GRAFANA_USERNAME

اسم مستخدم Grafana لتسجيل الدخول إلى واجهة مستخدم لوحة البيانات.

GRAFANA_PASSWORD

كلمة مرور Grafana لتسجيل الدخول إلى واجهة مستخدم لوحة البيانات.

تعليمات التثبيت

اتبع الإرشادات أدناه لتثبيت مكونات لوحة البيانات بالتسلسل التالي:

  • apigee-influxdb (على العقدة المركزية)
  • apigee-telegraf (في كل لعبة العقدة)
  • apigee-grafana (على الخادم المركزي)

تثبيت apigee-influxdb على عقدة واحدة Edge أو عقدة مستقلة

على عقدة مستقلة أو عقدة Edge تعمل على "خادم الإدارة" أو واجهة مستخدم Edge:

  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 إعداد
  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، وجعله ملكًا لـ "واجهة برمجة تطبيقات" المستخدم.

    عيِّن الخاصية التالية في الملف لتحديد عنوان URL لعقدة apigee-influxdb، بما في ذلك المنفذ 8086:
    INFLUXDB_URL=http://influx_IP:8086
  3. تغيير المالك إلى "apigee":
    > تشون 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 rename
  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، وجعله ملكًا لـ "واجهة برمجة تطبيقات" المستخدم.

    اضبط السمات التالية في الملف. تم توضيح السمات التالية أعلاه:
    INFLUXDB_HOST=192.168.56.101
    INFLUXDB_PORT=8086
    GRAFANA_USERNAME=admin
    GRAFANA_PASSWORD=admin
  3. تغيير المالك إلى "apigee":
    > تشون 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 إعادة تشغيل

للوصول إلى لوحة البيانات، افتح عنوان URL التالي في متصفّح:

http://grafana_IP_or_DNS:3000

سجِّل الدخول باستخدام بيانات الاعتماد التي حدّدتها في ملف إعداد apigee-grafana. في المثال الوارد أعلاه يكون اسم المستخدم/كلمة المرور هو المشرف/المشرف.

تحديد مشاكل التثبيت وحلّها

إذا لم تظهر لك بيانات في لوحة البيانات، اتّبِع الإجراء التالي لتحديد المشاكل وحلّها. التثبيت:

  1. لضمان apigee-telegraf يجمع البيانات
    1. تشغيل apigee-service إعداد apigee-telegraf، فهو غير فعال، ويتحقق من الأخطاء، ويفتقر إلى التبعيات. وحلها.
    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.17.05 تستخدم الإجراء نفسه
  • يتطلب الإصدار 4.16.05 منك إلغاء تثبيت apigee-collectd كجزء من التحديث.

التعديل من الإصدارات 4.16.09 أو 4.17.01 أو 4.17.05

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

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

  1. تحديث Edge إلى الإصدار 4.17.09 كما هو موضّح في تحديث 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
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf setup -f configFile
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf rename
  5. كرر الخطوة 4 لكل عقدة.

التحديث من الإصدار 4.16.05

استخدم الإصدار 4.16.05 من لوحة البيانات واجهة apigee-collectd بدلاً من apigee-telegraf. كجزء من التحديث إلى عليك إلغاء تثبيت apigee-collectd، وتثبيت apigee-collectd.

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

  1. تحديث Edge إلى الإصدار 4.17.09 كما هو موضّح في تحديث 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-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 إعادة تشغيل
    > /opt/apigee/apigee-service/bin/apigee-service apigee-collectdUninstall
  5. كرر الخطوة 4 لكل عقدة.