المتغير المخصّص غير مرئي في تقارير "إحصاءات Google" المخصّصة

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

المشكلة

المتغير المخصص الذي تم إنشاؤه باستخدام سياسة StatisticsCollector هي لا يظهر ضمن "السمات المخصّصة" في "التقارير المخصّصة" في "إحصاءات Google" في واجهة مستخدم Edge.

رسائل الخطأ

لا يتم رصد أي أخطاء.

الأسباب المحتملة

يسرد الجدول التالي الأسباب المحتملة لهذه المشكلة:

انقر على أحد الروابط في الجدول لمعرفة الحلول الممكنة لذلك السبب.

المتغير المخصّص غير ملتزم بالإرشادات القياسية

التشخيص

إذا لم يكن اسم المتغيّر المخصّص المستخدَم في سياسة StatisticsCollector تلتزم بالإرشادات القياسية (راجع الحل)، فلن تظهر في التقارير المخصصة.

يوضح مقتطف الرمز أدناه أن اسم المتغير "product id" على مساحة، لذلك لن يظهر ضمن البُعد المخصّص في التقرير المخصّص.

  <StatisticsCollector name="publishPurchaseDetails">
    <Statistics>
      <Statistic name="productID" ref="product id" type="string">999999</Statistic>
    </Statistics>
  </StatisticsCollector>

الدقة

أسماء المتغيرات المخصَّصة المستخدَمة في سياسة StatisticsCollector ضمن واجهة برمجة التطبيقات الخادم الوكيل بالإرشادات التالية:

• يمكن أن تتضمن الأسماء [a-z][0-9] و'_'.
• لا يمكن أن تحتوي الأسماء على مسافات. على سبيل المثال، في عينة التعليمات البرمجية الموضحة أعلاه، قد يمثل اسم المتغير إلى "product_id".
• ويتم تجاهل حالة الأحرف.
• لا يتم تصنيف الكلمات الرئيسية المحجوزة في الجدول على الرابط التالي المسموح بها. على سبيل المثال، "المستخدم" غير مسموح به. لمزيد من المعلومات، يُرجى مراجعة الكلمات الأساسية في SQL:

إذا استمرت المشكلة، ثم تابع إلى ما مِن زيارات من خلال خادم وكيل واجهة برمجة التطبيقات الذي ينفِّذ سياسة StatisticsCollector.

عدم السماح بأي زيارات من خلال خادم وكيل واجهة برمجة التطبيقات الذي ينفّذ سياسة StatisticsCollector

التشخيص

في حال عدم وجود زيارات على الخادم الوكيل لواجهة برمجة التطبيقات الذي يستخدم أداة StatisticsCollector لن يظهر المتغير المخصّص في التقارير المخصَّصة.

الدقة

عليك إجراء بعض الطلبات للوصول إلى الخادم الوكيل لواجهة برمجة التطبيقات الذي يستخدم أداة StatisticsCollector. .

انتظِر لبعض الوقت وتأكّد من ظهور المتغيّرات المخصّصة في السمات المخصّصة تقرير مخصَّص

إذا استمرت المشكلة، انتقِل إلى Custom Variable not Pushed to (لم يتم إرسال المتغيّر المخصّص إلى) خادم Postgres

لم يتم إرسال المتغيّر المخصَّص إلى خادم Postgres.

التشخيص

عند إنشاء متغير مخصَّص في الخادم الوكيل لواجهة برمجة التطبيقات وإجراء طلبات بيانات من واجهة برمجة التطبيقات، يتم تخزين المتغير أولاً في الذاكرة في معالج الرسائل. الرسالة ثم يرسل المعالج معلومات عن المتغير الجديد إلى ZooKeeper، وترسله بدوره إلى خادم Postgres لإضافته كعمود في Postgres قاعدة البيانات.

في بعض الأحيان، قد لا يصل الإشعار من ZooKeeper إلى خادم Postgres بسبب الشبكة المشكلات. وبسبب هذا الخطأ، قد لا يظهر المتغير المخصّص في تقرير مخصَّص

لتحديد موضع عدم توفّر المتغيّر المخصَّص:

1. أنشئ شجرة ZooKeeper باستخدام الأمر التالي:

   /opt/apigee/apigee-zookeeper/contrib/zk-tree.sh > zktree-output.txt

2. ابحث عن المتغيّر المخصَّص في ناتج شجرة ZooKeeper.
3. إذا كان المتغير المخصّص موجودًا في شجرة ZooKeeper، فنفذ الأوامر التالية للتحقق مما إذا تمت إضافة المتغير المخصص إلى Postgres قاعدة البيانات:
   1. في عقدة Postgres، سجِّل الدخول إلى PostgreSQL:

      psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

   2. قم بتشغيل استعلام SQL التالي:

      select column_name, data_type, character_maximum_length from INFORMATION_SCHEMA.COLUMNS
        where table_name = 'orgname.envname.fact';

4. من المرجّح جدًا أن تلاحظ عدم توفّر عمود المتغيّر المخصّص في جدول الحقائق، الأمر الذي أدى إلى عدم ظهوره في "السمات المخصّصة".

الدقة

الحل 1: إعادة تشغيل خادم Postgres

1. أعِد تشغيل خادم Postgres لإجباره على قراءة جميع المعلومات ذات الصلة بـ إحصاءات من Zookeeper:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

   في حال استمرار المشكلة، قم بتطبيق الحل 2.

الحل 2: تفعيل سمة forceonboard

تفعيل سمة forceonboard باستخدام الخطوات التالية:

1. إنشاء ملف /opt/apigee/customer/application/postgres-server.properties على جهاز خادم Postgres، إذا لم يكن موجودًا من قبل.
2. أضِف السطر التالي إلى هذا الملف:

   conf_pg-agent_forceonboard=true

3. تأكَّد من ملكية هذا الملف في Apigee باستخدام الأمر التالي:

   chown apigee:apigee /opt/apigee/customer/application/postgres-server.properties

4. أعِد تشغيل خادم Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

5. إذا كان لديك أكثر من خادم Postgres واحد، فكرر الخطوات أعلاه على جميع خوادم Postgres.
6. يمكنك إلغاء نشر الخادم الوكيل لواجهة برمجة التطبيقات الذي يستخدم تطبيق StatisticsCollector. .
7. نفِّذ طلبات بيانات من واجهة برمجة التطبيقات.
8. التأكّد من ظهور المتغيّرات المخصّصة في السمات المخصّصة إبلاغ.

في حال استمرار المشكلة، يُرجى التواصل مع فريق دعم Apigee Edge.