com.android.tradefed.device.metric

टिप्पणियां

MetricOption @Test के साथ एनोटेट किए गए टेस्ट के तरीकों के लिए एनोटेशन. इसके अलावा, अगर एनोटेशन, TestDescription की एनोटेशन सूची का हिस्सा है, तो कुछ अतिरिक्त पैरामीटर तय किए जा सकते हैं. ये पैरामीटर इनके लिए फ़ायदेमंद होते हैं: कलेक्टर के व्यवहार को ट्यून करना, कुछ तरीकों को फ़िल्टर करना. 

इंटरफ़ेस

IMetricCollector इस इंटरफ़ेस को डेकोरेटर के तौर पर तब जोड़ा जाएगा, जब टेस्ट के नतीजे रिपोर्ट किए जा रहे हों. ऐसा इसलिए किया जाएगा, ताकि मिलती-जुलती मेट्रिक इकट्ठा की जा सकें. 
IMetricCollectorReceiver यह IRemoteTest के लिए इंटरफ़ेस है. अगर उन्हें टेस्ट रन के लिए IMetricCollector की सूची चाहिए, तो उन्हें इसे लागू करना होगा. 

कक्षाएं

AtraceCollector एक IMetricCollector, जो टेस्ट के दौरान atrace चलाता है. साथ ही, नतीजे इकट्ठा करता है और उन्हें इनवोकेशन में लॉग करता है. 
AtraceRunMetricCollector यह कमांड, टेस्ट डिवाइस से दी गई डायरेक्ट्री के तहत सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करती है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करती है और टेस्ट डायरेक्ट्री के तहत ट्रेस फ़ाइलों को प्रोसेस करती है. इसके अलावा, यह मेट्रिक को एग्रीगेट करती है. 
BaseDeviceMetricCollector IMetricCollector को लागू करने का बुनियादी तरीका. इससे onTestRunStart(DeviceMetricData) और onTestRunEnd(DeviceMetricData,Map) पर डेटा इकट्ठा करने की प्रोसेस शुरू और बंद की जा सकती है. 
BluetoothConnectionLatencyCollector कलेक्टर, पहले से तय की गई statsd अवधि की मेट्रिक कॉन्फ़िगरेशन को डिवाइसों पर पुश करेगा. साथ ही, हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा. 
BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा. साथ ही, हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा. 
BluetoothHciSnoopLogCollector कलेक्टर, DUT पर ब्लूटूथ एचसीआई स्नूप लॉगिंग को चालू करता है और हर टेस्ट के लिए लॉग इकट्ठा करता है. 
BugreportzOnFailureCollector टेस्ट केस फ़ेल होने पर, bugreportz इकट्ठा करता है. 
BugreportzOnTestCaseFailureCollector किसी रन में टेस्ट केस के फ़ेल होने पर, bugreportz इकट्ठा करता है. 
ClangCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Clang कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा. 
CodeCoverageCollector एक BaseDeviceMetricCollector जो डिवाइस से Java और नेटिव कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा. 
CollectorHelper यह हेल्पर, कई जगहों पर ज़रूरी IMetricCollector कार्रवाइयां करता है. 
CountTestCasesCollector किसी दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या गिनें और उसकी रिपोर्ट बनाएं. 
DebugHostLogOnFailureCollector यह कलेक्टर, टेस्ट केस के फ़ेल होने पर होस्ट-साइड के लॉग इकट्ठा करेगा और उन्हें लॉग करेगा. 
DeviceMetricData यह ऑब्जेक्ट, मेट्रिक कलेक्टर से इकट्ठा किया गया पूरा डेटा सेव करता है. 
DeviceTraceCollector यह कलेक्टर, टेस्ट रन शुरू होने पर perfetto ट्रेस शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा. 
EmulatorMemoryCpuCapturer  
FilePullerDeviceMetricCollector एक BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक की कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है. 
FilePullerLogCollector यह डिवाइस-साइड से रिपोर्ट की गई फ़ाइल का लॉगर है. 
GcovCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से gcov कवरेज मेज़रमेंट को खींच लेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग कर देगा. 
GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector जो debugfs से gcov कर्नल कवरेज मेज़रमेंट को डिवाइस से बाहर निकालता है और फिर उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करता है. 
HostStatsdMetricCollector यह IMetricCollector, statsd यूटिलिटी कमांड का इस्तेमाल करके होस्ट साइड से statsd मेट्रिक इकट्ठा करता है. 
JavaCodeCoverageCollector एक BaseDeviceMetricCollector जो डिवाइस से Java कवरेज मेज़रमेंट को पुल करेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा. 
LogcatOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस या टेस्ट रन के फ़ेल होने पर, logcat को कैप्चर और लॉग करेगा. 
LogcatTimingMetricCollector यह एक मेट्रिक कलेक्टर है. यह logcat से समय की जानकारी इकट्ठा करता है. जैसे, उपयोगकर्ता के स्विच करने का समय. यह जानकारी, एक या एक से ज़्यादा बार दोहराए गए टेस्ट के दौरान इकट्ठा की जाती है. इसके लिए, दिए गए regex पैटर्न का इस्तेमाल किया जाता है. इससे logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स किया जाता है. 
LogOffsets यह एक ऐसी क्लास है जो अलग-अलग टेस्ट लेवल के लिए, लॉग फ़ाइल के शुरुआती ऑफ़सेट सेव करती है. 
ModuleLogcatCollector यह logcat collector का वर्शन है, लेकिन यह मॉड्यूल के लिए है. 
ModulePerfettoCollector यह कलेक्टर, टेस्ट मॉड्यूल के शुरू और खत्म होने पर, परफ़ेक्टो ट्रेस शुरू करेगा. साथ ही, डिवाइस के रीबूट होने पर भी ऐसा करेगा. 
PerfettoFilePullerCollector यह एक कलेक्टर है, जो डिवाइस से Perfect Trace फ़ाइलों को खींचता है. इसके अलावा, यह फ़ाइलों को कंप्रेस भी कर सकता है. साथ ही, उन्हें टेस्ट लॉग में जोड़ता है. 
PerfettoPullerMetricCollector इस क्लास का इस्तेमाल बंद कर दिया गया है. इसके बजाय, PerfettoFilePullerCollector और ERROR(/PerfettoTracePostProcessor) का इस्तेमाल करें. 
RebootReasonCollector यह कलेक्टर, टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है. 
RuntimeRestartCollector यह कलेक्टर, टेस्ट रन के दौरान सिस्टम सर्वर क्रैश होने पर, रनटाइम रीस्टार्ट के टाइमस्टैंप इकट्ठा करता है. 
ScreenRecordOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस के फ़ेल होने पर, स्क्रीन रिकॉर्डिंग को कैप्चर और लॉग करेगा. 
ScreenRecordOnFailureCollector.LineCapturingOutputStream  
ScreenshotOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस के फ़ेल होने पर, स्क्रीनशॉट कैप्चर और लॉग करेगा. 
ShowmapPullerMetricCollector FilePullerDeviceMetricCollector का बुनियादी तौर पर लागू किया गया वर्शन. इससे डिवाइस से showmap फ़ाइलें पुल की जा सकती हैं और उनसे मेट्रिक इकट्ठा की जा सकती हैं. 
TraceCmdCollector यह एक IMetricCollector है, जो trace-cmd का इस्तेमाल करके टेस्ट के दौरान ट्रेस इकट्ठा करता है. साथ ही, उन्हें इनवॉकेशन में लॉग करता है. 

एनम्स

AutoLogCollector गिनती करके बताया गया है कि किस कलेक्टर को हार्नेस अपने-आप मैनेज कर सकता है. 
IMetricCollector.MetricCollectionLevel गिनती, जो मेट्रिक कलेक्शन के मौजूदा लेवल को दिखाती है. 
PerfettoPullerMetricCollector.METRIC_FILE_FORMAT