IMetricCollector

public interface IMetricCollector
implements IDisableable, ILogSaverListener

com.android.tradefed.device.metric.IMetricCollector

ऐसे सबक्लास जिनके बारे में पहले से पता है AtraceCollector, AtraceRunMetricCollector, BaseDeviceMetricCollector, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CodeCoverageCollector, CountTestCasesCollector, DebugHostLogOnFailureCollector, DeviceTraceCollector, FilePullerDeviceMetricCollector, FilePullerLogCollector, और 13 अन्य. AtraceCollector एक IMetricCollector जो किसी टेस्ट के दौरान atrace चलाता है और नतीजे इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.  AtraceRunMetricCollector यह टूल, टेस्ट डिवाइस पर दी गई डायरेक्ट्री में मौजूद सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करता है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करता है और टेस्ट डायरेक्ट्री में मौजूद ट्रेस फ़ाइलों को पोस्ट प्रोसेस करता है. इसके बाद, मेट्रिक इकट्ठा करता है.  BaseDeviceMetricCollector IMetricCollector को लागू करने का बुनियादी तरीका, जिसकी मदद से onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) और ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) को डेटा इकट्ठा करना शुरू और बंद किया जा सकता है.  BluetoothConnectionLatencyCollector कलेक्टर, डिवाइसों पर पहले से तय की गई statsd अवधि मेट्रिक कॉन्फ़िगरेशन को पुश करेगा और हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा.  BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा और हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा.  BluetoothHciSnoopLogCollector डीयूटी पर ब्लूटूथ HCI स्नूप लॉगिंग की सुविधा चालू करने और हर टेस्ट के लिए लॉग इकट्ठा करने वाला कलेक्टर.  BugreportzOnFailureCollector टेस्ट केस पूरा न होने पर, बग रिपोर्ट इकट्ठा करें.  BugreportzOnTestCaseFailureCollector जब किसी टेस्ट केस को चलाने में गड़बड़ी होती है, तो बग रिपोर्ट इकट्ठा करें.  ClangCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Clang के कवरेज मेज़रमेंट को खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java और नेटिव कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CountTestCasesCollector किसी दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या की गिनती करें और उसकी रिपोर्ट बनाएं.  DebugHostLogOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर होस्ट-साइड लॉग इकट्ठा और लॉग करेगा.  DeviceTraceCollector यह एक कलेक्टर है, जो टेस्ट रन शुरू होने पर, perfetto ट्रेस शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा.  FilePullerDeviceMetricCollector एक BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है.  FilePullerLogCollector डिवाइस की ओर से रिपोर्ट की गई फ़ाइल का लॉगर.  GcovCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से कवरेज मेज़रमेंट को खींचकर, उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector, जो gcov kernel coverage के मेज़रमेंट को debugfs और डिवाइस से बाहर खींचेगा और फिर उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  HostStatsdMetricCollector एक IMetricCollector, जो statsd की सुविधा वाले कमांड का इस्तेमाल करके, होस्ट साइड से statsd मेट्रिक इकट्ठा करता है.  JavaCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  LogcatOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर logcat को कैप्चर और लॉग करेगा.  LogcatTimingMetricCollector यह एक मेट्रिक कलेक्टर है, जो एक या एक से ज़्यादा बार किए गए टेस्ट के दौरान, logcat से समय की जानकारी इकट्ठा करता है.उदाहरण के लिए, उपयोगकर्ता के स्विच करने में लगने वाला समय. इसके लिए, यह logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स करने के लिए, दिए गए रेगुलर एक्सप्रेशन पैटर्न का इस्तेमाल करता है.  ModuleLogcatCollector मॉड्यूल के लिए, logcat कलेक्टर का वर्शन.  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से Perfetto फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  RebootReasonCollector यह एक कलेक्टर है, जो टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है.  RuntimeRestartCollector यह एक कलेक्टर है, जो टेस्ट के दौरान रनटाइम रीस्टार्ट (सिस्टम सर्वर क्रैश) के टाइमस्टैंप इकट्ठा करता है.  ScreenshotOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर स्क्रीनशॉट कैप्चर करके उसे लॉग करेगा.  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से शोमैप फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  TraceCmdCollector ऐसा IMetricCollector जो trace-cmd का इस्तेमाल करके, टेस्ट के दौरान ट्रेस इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.

---

टेस्ट के नतीजों की रिपोर्टिंग करते समय, मिलती-जुलती मेट्रिक इकट्ठा करने के लिए, इस इंटरफ़ेस को डेकोरेटर के तौर पर जोड़ा जाएगा.

इस इंटरफ़ेस का इस्तेमाल के तौर पर नहीं किया जा सकता, भले ही यह ITestInvocationListener को एक्सटेंड करता हो. कॉन्फ़िगरेशन की जांच करने पर, इसे अस्वीकार कर दिया जाएगा. इसका इस्तेमाल, "metrics_collector" के तौर पर किया जाना चाहिए.

कलेक्टर को कोई इंटरनल स्टेटस नहीं रखना चाहिए, क्योंकि उनका कई जगहों पर फिर से इस्तेमाल किया जा सकता है. अगर किसी इंटरनल स्टेट का इस्तेमाल करना ज़रूरी है, तो उसे init(com.android.tradefed.invoker.IInvocationContext, com.android.tradefed.result.ITestInvocationListener) पर क्लीन किया जाना चाहिए.

खास जानकारी

सार्वजनिक तरीके
default boolean	captureModuleLevel() कलेक्टर, मॉड्यूल लेवल पर कैप्चर करने के लिए लागू है या नहीं और उसे शुरू किया जाना चाहिए या नहीं.
abstract	getBuildInfos() यह फ़ंक्शन, कॉल के दौरान उपलब्ध बिल्ड की जानकारी की सूची दिखाता है.
abstract	getDevices() यह फ़ंक्शन, बोलकर दिए गए निर्देश में उपलब्ध डिवाइसों की सूची दिखाता है.
abstract ITestInvocationListener	getInvocationListener() वह ओरिजनल ITestInvocationListener दिखाता है जहां हम नतीजे फ़ॉरवर्ड कर रहे हैं.
abstract ITestInvocationListener	init(IInvocationContext context, ITestInvocationListener listener) मौजूदा कॉन्टेक्स्ट के साथ कलेक्टर को शुरू करना और नतीजों को कहां फ़ॉरवर्ड करना है.
abstract void	onTestAssumptionFailure(DeviceMetricData testData, TestDescription test) जब कोई टेस्ट केस, अनुमान के गलत होने की वजह से फ़ेल होता है, तब कॉलबैक.
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics, TestDescription test) टेस्ट केस खत्म होने पर कॉलबैक.
abstract void	onTestEnd(DeviceMetricData testData, currentTestCaseMetrics) टेस्ट केस खत्म होने पर कॉलबैक.
abstract void	onTestFail(DeviceMetricData testData, TestDescription test) टेस्ट केस के पूरा न होने पर कॉलबैक.
default void	onTestModuleEnded() मॉड्यूल खत्म होने के इवेंट को कैप्चर करने की अनुमति देता है.
default void	onTestModuleStarted() मॉड्यूल शुरू होने के इवेंट को कैप्चर करने की अनुमति देता है.
abstract void	onTestRunEnd(DeviceMetricData runData, currentRunMetrics) टेस्ट रन खत्म होने पर कॉलबैक.
abstract void	onTestRunStart(DeviceMetricData runData) टेस्ट रन शुरू होने पर कॉलबैक.
default void	onTestRunStart(DeviceMetricData runData, int testCount) टेस्ट रन शुरू होने पर कॉलबैक.
abstract void	onTestStart(DeviceMetricData testData) टेस्ट केस शुरू होने पर कॉलबैक.

सार्वजनिक तरीके

captureModuleLevel

public boolean captureModuleLevel ()

कलेक्टर, मॉड्यूल लेवल पर कैप्चर करने के लिए लागू है या नहीं और उसे शुरू किया जाना चाहिए या नहीं.

रिटर्न
boolean

getBuildInfos

public abstract  getBuildInfos ()

यह फ़ंक्शन, कॉल के दौरान उपलब्ध बिल्ड की जानकारी की सूची दिखाता है.

रिटर्न

getDevices

public abstract  getDevices ()

यह फ़ंक्शन, बोलकर दिए गए निर्देश में उपलब्ध डिवाइसों की सूची दिखाता है.

रिटर्न

getInvocationListener

public abstract ITestInvocationListener getInvocationListener ()

वह ओरिजनल ITestInvocationListener दिखाता है जहां हम नतीजे फ़ॉरवर्ड कर रहे हैं.

रिटर्न
ITestInvocationListener

init

public abstract ITestInvocationListener init (IInvocationContext context, 
                ITestInvocationListener listener)

मौजूदा कॉन्टेक्स्ट के साथ कलेक्टर को शुरू करना और नतीजों को कहां फ़ॉरवर्ड करना है. हर इंस्टेंस के लिए सिर्फ़ एक बार कॉल किया जाएगा. साथ ही, कलेक्टर को अपने इंटरनल कॉन्टेक्स्ट और लिसनर को अपडेट करना होगा. किसी टेस्ट के दौरान, init को कभी भी नहीं बुलाया जाएगा.

जब तक आपको यह नहीं पता कि क्या करना है, तब तक बदलाव न करें.

पैरामीटर
context	IInvocationContext: IInvocationContext, जिसका इस्तेमाल करके फ़ंक्शन को ट्रिगर किया जा रहा है.
listener	ITestInvocationListener: ITestInvocationListener, जहां नतीजे डालने हैं.

रिटर्न
ITestInvocationListener	ओरिजनल दर्शक को नए दर्शक ने रैप किया हो.

थ्रो
DeviceNotAvailableException

onTestAssumptionFailure

public abstract void onTestAssumptionFailure (DeviceMetricData testData, 
                TestDescription test)

जब कोई टेस्ट केस, अनुमान के गलत होने की वजह से फ़ेल होता है, तब कॉलबैक.

पैरामीटर
testData	DeviceMetricData: वह DeviceMetricData जिसमें टेस्ट केस का डेटा हो.
test	TestDescription: चल रहे टेस्ट केस का TestDescription.

थ्रो
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics, 
                TestDescription test)

टेस्ट केस खत्म होने पर कॉलबैक. अब समय आ गया है कि आप अपने खाते को साफ़ करें.

पैरामीटर
testData	DeviceMetricData: वह DeviceMetricData जिसमें टेस्ट केस का डेटा हो. यह वही ऑब्जेक्ट होगा जो onTestStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान था.
currentTestCaseMetrics	: ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) को भेजी गई मेट्रिक का मौजूदा मैप.
test	TestDescription: चल रहे टेस्ट केस का TestDescription.

थ्रो
DeviceNotAvailableException

onTestEnd

public abstract void onTestEnd (DeviceMetricData testData, 
                 currentTestCaseMetrics)

टेस्ट केस खत्म होने पर कॉलबैक. अब समय आ गया है कि आप अपने खाते को साफ़ करें.

पैरामीटर
testData	DeviceMetricData: वह DeviceMetricData जिसमें टेस्ट केस का डेटा हो. यह वही ऑब्जेक्ट होगा जो onTestStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान था.
currentTestCaseMetrics	: ERROR(/#testEnded(com.android.tradefed.result.TestDescription,Map)) को भेजी गई मेट्रिक का मौजूदा मैप.

थ्रो
DeviceNotAvailableException

onTestFail

public abstract void onTestFail (DeviceMetricData testData, 
                TestDescription test)

टेस्ट केस के पूरा न होने पर कॉलबैक.

पैरामीटर
testData	DeviceMetricData: वह DeviceMetricData जिसमें टेस्ट केस का डेटा हो.
test	TestDescription: चल रहे टेस्ट केस का TestDescription.

थ्रो
DeviceNotAvailableException

onTestModuleEnded

public void onTestModuleEnded ()

मॉड्यूल खत्म होने के इवेंट को कैप्चर करने की अनुमति देता है.

थ्रो
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestModuleStarted

public void onTestModuleStarted ()

मॉड्यूल शुरू होने के इवेंट को कैप्चर करने की अनुमति देता है.

थ्रो
	com.android.tradefed.device.DeviceNotAvailableException
DeviceNotAvailableException

onTestRunEnd

public abstract void onTestRunEnd (DeviceMetricData runData, 
                 currentRunMetrics)

टेस्ट रन खत्म होने पर कॉलबैक. अब समय आ गया है कि आप अपने खाते को साफ़ करें.

पैरामीटर
runData	DeviceMetricData: DeviceMetricData, जिसमें रन का डेटा सेव है. यह वही ऑब्जेक्ट होगा जो onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) के दौरान था.
currentRunMetrics	: ERROR(/#testRunEnded(long,Map)) को भेजी गई मेट्रिक का मौजूदा मैप.

थ्रो
DeviceNotAvailableException

onTestRunStart

public abstract void onTestRunStart (DeviceMetricData runData)

टेस्ट रन शुरू होने पर कॉलबैक.

पैरामीटर
runData	DeviceMetricData: DeviceMetricData, जिसमें रन का डेटा सेव है.

थ्रो
DeviceNotAvailableException

onTestRunStart

public void onTestRunStart (DeviceMetricData runData, 
                int testCount)

टेस्ट रन शुरू होने पर कॉलबैक.

पैरामीटर
runData	DeviceMetricData: DeviceMetricData, जिसमें रन का डेटा सेव है.
testCount	int: इस टेस्ट रन में टेस्ट केस की संख्या.

थ्रो
DeviceNotAvailableException

onTestStart

public abstract void onTestStart (DeviceMetricData testData)

टेस्ट केस शुरू होने पर कॉलबैक.

पैरामीटर
testData	DeviceMetricData: वह DeviceMetricData जिसमें टेस्ट केस का डेटा हो.

थ्रो
DeviceNotAvailableException