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

Edge for Private Cloud الإصدار 4.17.05

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

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

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

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

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

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

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

الموقع الإلكتروني

الوصف

INFLUXDB_URL

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

مثال:

http://192.168.0.1:8086

معلمات تهيئة apigee-grafana

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

الموقع الإلكتروني

الوصف

INFLUXDB_HOST

حدِّد عنوان IP أو اسم نظام أسماء النطاقات لعقدة InfluxDB.

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

192.168.0.1

INFLUXDB_PORT

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

GRAFANA_USERNAME

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

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 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 إعادة تشغيل
  6. كرر هذه العملية على جميع عُقد Edge.

تثبيت apigee-grafana على عقدة Edge واحدة

على عقدة واحدة من تثبيت Edge، مثل عقدة Edge UI:

  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_اسم المستخدم=المشرف
    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 إعادة تشغيل

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

http://grafana_IP_or_DNS:3000

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

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

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

  1. للتأكّد من أنّ apigee-telegraf تجمع البيانات.
    1. عليك تنفيذ إعداد 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. في حقل "Query" (الاستعلام)، أدخل "Show dataset" (إظهار قواعد البيانات).
        تأكَّد من إنشاء قواعد البيانات التالية: system، application، event، _internal.
      2. في حقل "طلب البحث"، أدخِل "Show server" (عرض الخوادم).
        تأكّد من إدراج عُقد 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.16.05.
  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 في عقدة Management Server، يجب تعديل 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 config File-service/apigeservice/apigeservice/apigeservice/apigee-service
  5. كرِّر الخطوة 4 لكل عُقدة.

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

استخدم الإصدار 4.16.05 من لوحة البيانات apigee-collectd بدلاً من apigee-telegraf. وكجزء من التحديث إلى الإصدار 4.17.05، يمكنك إلغاء تثبيت apigee-collectd وتثبيت 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.16.05.
  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 في عقدة Management Server، يجب تعديل 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 بياناتك
    > /opt/apigee/apigee-service/bin/apigee-service apigee-telegraf install apigee-telegraf install apigee-telegraf/optegee/apigee/telegraf> /opt/apigee-telegraf > /opt/apigee-telegraf/apigee-service/bin/apigee-collectd بياناتك


    configFile
  5. كرِّر الخطوة 4 لكل عُقدة.