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

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

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

يجب تثبيت 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 على عُقدة البيانات apigee-influxdb للوصول إليها من خلال العقدة التي تعمل apigee-grafana apigee-telegraf

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

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

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

   عيِّن الخاصية التالية في الملف لتحديد عنوان 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 في المثال الوارد أعلاه يكون اسم المستخدم/كلمة المرور هو المشرف/المشرف.

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

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

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 Monitoring من خلال الإصدار 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 لكل عقدة.