اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release
بدلاً من aosp-main
لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
واجهة مستخدم لوحة بيانات مراقبة الأداء
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
توفّر لوحة بيانات اختبار الفيديو على شبكة الجوّال واجهة مستخدم متماسكة تستخدم تصميم Material Design
لعرض معلومات عن نتائج الاختبار وإعداد الملفات الشخصية والتغطية بشكل فعّال.
يستخدم تصميم لوحة البيانات مكتبات JavaScript مفتوحة المصدر، بما في ذلك Materialize
CSS وjQueryUI لمعالجة البيانات التي تقدّمها تطبيقات Java servlet في Google App
Engine.
الصفحة الرئيسية لخدمة "لوحة البيانات"
تعرِض الصفحة الرئيسية في "لوحة البيانات" قائمة بمجموعات الاختبار التي أضافها المستخدم إلى ملفه الشخصي في ميزة "المفضّلة".
الشكل 1. لوحة بيانات "نظام مراقبة الفيديو"، الصفحة الرئيسية
من هذه القائمة، يمكن للمستخدمين إجراء ما يلي:
- اختَر مجموعة اختبارات لعرض النتائج الخاصة بها.
- انقر على عرض الكل لعرض جميع أسماء اختبارات VTS.
- انقر على رمز التعديل لتعديل قائمة "المحتوى المفضّل".
الشكل 2. لوحة بيانات "الاستئجار عند الطلب"، صفحة تعديل "المحتوى المفضّل"
نتائج الاختبار
تعرِض "نتائج الاختبار" أحدث المعلومات عن مجموعة الاختبار المحدّدة،
بما في ذلك قائمة بنقاط الأداء وجدول بنتائج حالات الاختبار بترتيبٍ زمني ومخطّط بياني دائري يعرض تفاصيل النتيجة الخاصة بالتشغيل
الأخير (يمكن للمستخدمين تحميل البيانات القديمة من خلال الانتقال للصفحة التالية يمينًا).
الشكل 3. لوحة بيانات VTS، نتائج الاختبار
يمكن للمستخدمين فلترة البيانات باستخدام طلبات البحث أو عن طريق تعديل نوع الاختبار (قبل الإرسال أو بعد الإرسال أو كليهما). تتيح طلبات البحث استخدام الرموز العامة والمؤهّلات الخاصة بالحقول، وتشمل حقول البحث المتوافقة ما يلي: رقم تعريف إصدار الجهاز، والفرع، والاسم المستهدَف،
واسم الجهاز، ورقم تعريف الإصدار التجريبي. يتم تحديدها بالتنسيق:
FIELD-ID="SEARCH QUERY". وتُستخدَم علامات الاقتباس لمعالجة عدةكلمات
كعنصر رمزي واحد لمطابقتها مع البيانات في الأعمدة.
تحليل الشخصية بالاستناد إلى البيانات
يمكن للمستخدمين اختيار نقطة ملف شخصي للوصول إلى عرض تفاعلي لل dataquantitative لهذه النقطة في رسم بياني خطي أو
مخطّط بياني هرمي (أمثلة أدناه). يعرِض العرض تلقائيًا
أحدث المعلومات، ويمكن للمستخدمين استخدام أداة اختيار التاريخ لتحميل فترات زمنية محدّدة.
الشكل 4. لوحة بيانات "الاستماع إلى الفيديوهات"، أداء الرسم البياني الخطي
تعرِض الرسوم البيانية الخطية بيانات من مجموعة من قيم الأداء غير المرتبطة،
ويمكن أن يكون ذلك مفيدًا عندما ينتج اختبار الأداء متجهًا لقيم الأداء
التي تتغيّر استنادًا إلى متغيّر آخر (مثل معدل نقل البيانات مقارنةً
بحجم الرسالة).
الشكل 5. لوحة بيانات "التتبّع في الوقت الفعلي"، أداء المخطّط البياني للتردد
تغطية الاختبار
يمكن للمستخدمين الاطّلاع على معلومات التغطية من رابط النسبة المئوية للّغة في نتائج الاختبار.
الشكل 6. لوحة بيانات "نظام التحكّم في الفيديو"، النسب المئوية للتغطية
لكل حالة اختبار وملف مصدر، يمكن للمستخدمين عرض عنصر قابل للتوسيع يحتوي على رمز مصدر مُرمّز بالألوان وفقًا للمحتوى الذي يغطّيه الاختبار المحدّد:
الشكل 7. لوحة بيانات VTS، رمز المصدر الخاص بالمساحة التي تغطيها الكاميرا
- يتم تمييز الخطوط غير المكشوفة باللون الأحمر.
- يتم تمييز الخطوط التي تم تغطيتها باللون الأخضر.
- تكون السطور غير القابلة للتنفيذ غير ملونة.
يتم تجميع معلومات التغطية في أقسام حسب كيفية
تقديمها في وقت التشغيل. يمكن أن تحمّل الاختبارات تغطية:
- حسب الدالة: تكون عناوين الأقسام بالتنسيق "تغطية:
FUNCTION-NAME".
- الإجمالي (يتم توفيره في نهاية عملية إجراء الاختبار). يتوفّر عنوان واحد فقط: "التغطية: الكل".
تُستخدَم واجهة برمجة التطبيقات
مفتوحة المصدر
Gerrit REST API من أجل جلب رمز المصدر من الخادم إلى جانب العميل في لوحة البيانات.
المراقبة والاختبار
توفّر لوحة بيانات VTS المراقبات واختبارات الوحدة التالية.
- اختبار التنبيهات عبر البريد الإلكتروني يتم ضبط التنبيهات في وظيفة Cron التي يتم تنفيذها في فاصل زمني ثابت يبلغ دقيقتَين. تقرأ المهمة جدول حالة اختبار مراقبة الجودة لتحديد ما إذا تم تحميل بيانات جديدة إلى كل جدول، وذلك من خلال التحقّق مما إذا كان الطابع الزمني لتحميل البيانات الأولية للاختبار أحدث من الطابع الزمني لآخر تعديل على الحالة. إذا كان الطابع الزمني للتحميل أحدث، تبحث المهمة عن بيانات جديدة
بين الآن وآخر عملية تحميل للبيانات الأوّلية. يتم تحديد حالات الفشل الجديدة في اختبارات، وحالات الفشل المستمرة في اختبارات، وحالات الفشل المؤقتة في اختبارات، وإصلاحات اختبارات، واختبارات غير نشطة، ويتم إرسال هذه المعلومات بعد ذلك بتنسيق بريد إلكتروني إلى المشتركين في كل اختبار.
- حالة خدمة الويب يتم دمج Google Stackdriver مع
Google App Engine لتوفير مراقبة سهلة لواجهة بيانات VTS. تتحقّق عمليات التحقّق البسيطة من وقت التشغيل من إمكانية الوصول إلى الصفحات، ويمكن إنشاء اختبارات أخرى للتحقّق من وقت الاستجابة في كل صفحة أو برنامج خادم صغير أو قاعدة بيانات. تضمن عمليات التحقّق هذه إمكانية الوصول إلى "لوحة البيانات"
في أي وقت (وإلا سيتم إشعار أحد المشرفين).
- إحصاءات Google: يمكنك دمج صفحة لوحة بيانات VTS مع
"إحصاءات Google Cloud" من خلال تحديد رقم تعريف صالح في "إحصاءات Google" ضمن إعدادات
الصفحة (ملف pom.xml). يقدّم الدمج تحليلاً أكثر دقة ل
استخدام الصفحة وتفاعل المستخدِم والموقع الجغرافي وإحصاءات الجلسات وما إلى ذلك.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# VTS Dashboard UI\n\nThe VTS Dashboard provides a cohesive user interface that uses material design\nto effectively display information about test results, profiling, and coverage.\nDashboard styling uses open-source Javascript libraries including Materialize\nCSS and jQueryUI to process data delivered by Java servlets in Google App\nEngine.\n\nDashboard home\n--------------\n\n\nThe Dashboard home page displays a list of test suites a user has added to\nfavorites.\n**Figure 1.** VTS Dashboard, home page.\n\n\nFrom this list, users can:\n\n- Select a test suite to view results for that suite.\n- Click **SHOW ALL** to view all VTS test names.\n- Select the **Edit** icon to modify the Favorites list. \n **Figure 2.** VTS Dashboard, editing Favorites page.\n\nTest results\n------------\n\n\nTest Results displays the latest information about the selected test suite,\nincluding a list of profiling points, a table of test case results in\nchronological order, and a pie chart displaying the result breakdown of the\nlatest run (users can load older data by paging right).\n**Figure 3.** VTS Dashboard, test results.\n\n\nUsers can filter data using queries or by modifying the test type (pre-submit,\npost-submit, or both). Search queries support general tokens and field-specific\nqualifiers; supported search fields are: device build ID, branch, target name,\ndevice name, and test build ID. These are specified in the format:\n\u003cvar translate=\"no\"\u003eFIELD-ID\u003c/var\u003e=\"\u003cvar translate=\"no\"\u003eSEARCH QUERY\u003c/var\u003e\". Quotes are used to treat multiple\nwords as a single token to match with the data in the columns.\n\nData profiling\n--------------\n\n\nUsers can select a profiling point to reach an interactive view of the\nquantitative data for that point in a **line graph** or\n**histogram** (examples below). By default, the view displays the\nlatest information; users can use the date picker to load specific time windows.\n**Figure 4.** VTS Dashboard, line graph performance.\n\n\nLine graphs display data from a collection of unordered performance values,\nwhich can be useful when a test of performance produces a vector of performance\nvalues that vary as a function of another variable (e.g., throughput versus\nmessage size).\n**Figure 5.** VTS Dashboard, histogram performance.\n\nTest coverage\n-------------\n\n\nUsers can view coverage information from the coverage percent link in test\nresults.\n**Figure 6.** VTS Dashboard, coverage percentages.\n\n\nFor each test case and source file, users can view an expandable element\ncontaining color-coded source code according to the coverage provided by the\nselected test:\n**Figure 7.** VTS Dashboard, coverage source code.\n\n- Uncovered lines are highlighted red.\n- Covered lines are highlighted green.\n- Non-executable lines are **uncolored**.\n\n\nCoverage information is grouped depending into sections depending on how it was\nprovided at run-time. Tests may upload coverage:\n\n- **Per function** . Section headers have the format \"Coverage: \u003cvar translate=\"no\"\u003eFUNCTION-NAME\u003c/var\u003e\".\n- **In Total** (provided at the end of the test run). Only one header is present: \"Coverage: All\".\n\n\nThe Dashboard fetches source code client-side from a server, which uses the\nopen-source\n[Gerrit REST API](https://gerrit-review.googlesource.com/Documentation/rest-api.html).\n\nMonitoring and testing\n----------------------\n\n\nThe VTS Dashboard provides the following monitors and unit tests.\n\n- **Test email alerts**. Alerts are configured in a Cron job that executes at a fixed interval of two (2) minutes. The job reads the VTS status table to determine if new data has been uploaded to each table, done by checking the test's raw data upload timestamp is newer than the last status update timestamp. If the upload timestamp is newer, the job queries for new data between now and the last raw data upload. New test case failures, continued test case failures, transient test case failures, test case fixes, an inactive tests are determined; this information is then sent in email format to the subscribers of each test.\n- **Web service health**. Google Stackdriver integrates with Google App Engine to provide easy monitoring of the VTS Dashboard. Simple uptime checks verify pages can be accessed while other tests can be created to verify latency on each page, servlet, or database. These checks ensure the Dashboard is always accessible (else an administrator will be notified).\n- **Analytics**. You can integrate a VTS Dashboard page with Google Cloud Analytics by specifying a valid Analytics ID in the page configuration (the pom.xml file). Integration provides a more robust analysis of page usage, user interaction, locality, session statistics, etc."]]