com.android.tradefed.device.metric

एनोटेशन

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

इंटरफ़ेस

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

कक्षाएं

AtraceCollector IMetricCollector, टेस्ट के दौरान ट्रेस करता है. साथ ही, नतीजे इकट्ठा करता है और उन्हें इनवोकेशन में लॉग करता है. 
AtraceRunMetricCollector यह फ़ंक्शन, टेस्ट डिवाइस से दी गई डायरेक्ट्री के तहत सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करता है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करता है और टेस्ट डायरेक्ट्री के तहत ट्रेस फ़ाइलों को प्रोसेस करता है. इसके अलावा, यह मेट्रिक को एग्रीगेट करता है. 
BaseDeviceMetricCollector IMetricCollector को लागू करने का बुनियादी तरीका. इससे onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) और ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) पर डेटा इकट्ठा करने की प्रोसेस शुरू और बंद की जा सकती है. 
BluetoothConnectionLatencyCollector कलेक्टर, डिवाइसों पर पहले से तय की गई statsd अवधि की मेट्रिक कॉन्फ़िगरेशन को पुश करेगा. साथ ही, हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा. 
BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा. साथ ही, हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा. 
BluetoothHciSnoopLogCollector कलेक्टर, DUT पर ब्लूटूथ HCI स्नूप लॉग इन करने की सुविधा चालू करता है. साथ ही, हर टेस्ट के लिए लॉग इकट्ठा करता है. 
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 से समय की जानकारी इकट्ठा करता है. जैसे, उपयोगकर्ता के स्विच करने का समय. यह जानकारी, एक या एक से ज़्यादा बार दोहराए गए टेस्ट के दौरान इकट्ठा की जाती है. इसके लिए, दिए गए रेगुलर एक्सप्रेशन पैटर्न का इस्तेमाल किया जाता है, ताकि logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स किया जा सके. 
ModuleLogcatCollector यह logcat collector का वर्शन है, लेकिन यह मॉड्यूल के लिए है. 
PerfettoFilePullerCollector यह एक ऐसा कलेक्टर है जो डिवाइस से Perfect Trace फ़ाइलें इकट्ठा करता है. इसके पास फ़ाइलों को कंप्रेस करने का विकल्प होता है. साथ ही, यह फ़ाइलों को टेस्ट लॉग में जोड़ता है. 
PerfettoPullerMetricCollector इस क्लास का इस्तेमाल बंद कर दिया गया है. इसके बजाय, PerfettoFilePullerCollector और ERROR(/PerfettoTracePostProcessor) का इस्तेमाल करें. 
RebootReasonCollector यह कलेक्टर, टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है. 
RuntimeRestartCollector यह कलेक्टर, टेस्ट रन के दौरान रनटाइम रीस्टार्ट (सिस्टम सर्वर क्रैश) के टाइमस्टैंप इकट्ठा करता है. 
ScreenshotOnFailureCollector यह एक ऐसा कलेक्टर है जो टेस्ट केस के फ़ेल होने पर, स्क्रीनशॉट कैप्चर और लॉग करेगा. 
ShowmapPullerMetricCollector FilePullerDeviceMetricCollector का बुनियादी तौर पर लागू किया गया वर्शन. इससे डिवाइस से showmap फ़ाइलें पुल की जा सकती हैं और उनसे मेट्रिक इकट्ठा की जा सकती हैं. 
TraceCmdCollector एक IMetricCollector जो trace-cmd का इस्तेमाल करके, टेस्ट के दौरान ट्रेस इकट्ठा करता है और उन्हें इनवोकेशन में लॉग करता है. 

Enums

AutoLogCollector गिनती करके यह बताया जाता है कि किस कलेक्टर को हार्नेस अपने-आप मैनेज कर सकता है. 
PerfettoPullerMetricCollector.METRIC_FILE_FORMAT