ILogSaverListener

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener

ऐसे सबक्लास जिनके बारे में पहले से पता है AggregatePostProcessor, AtraceCollector, AtraceRunMetricCollector, AveragePostProcessor, BaseDeviceMetricCollector, BasePostProcessor, BluetoothConnectionLatencyCollector, BluetoothConnectionStateCollector, BluetoothConnectionSuccessRatePostProcessor, BluetoothHciSnoopLogCollector, BugreportzOnFailureCollector, BugreportzOnTestCaseFailureCollector, ClangCodeCoverageCollector, CollectingTestListener, ConsoleResultReporter, और 49 अन्य. AggregatePostProcessor यह एक मेट्रिक एग्रीगेटर है, जो कई बार किए गए टेस्ट के दौरान इकट्ठा की गई संख्या वाली मेट्रिक के लिए, कम से कम, ज़्यादा से ज़्यादा, औसत, वैरिएंस, स्टैंडर्ड डिविएशन, कुल, गिनती, और वैकल्पिक रूप से प्रतिशत देता है. साथ ही, इन मेट्रिक को डबल के तौर पर इस्तेमाल करता है.  AtraceCollector एक IMetricCollector जो किसी टेस्ट के दौरान atrace चलाता है और नतीजे इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.  AtraceRunMetricCollector यह टूल, टेस्ट डिवाइस पर दी गई डायरेक्ट्री में मौजूद सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करता है. साथ ही, टेस्ट डायरेक्ट्री को लॉग करता है और टेस्ट डायरेक्ट्री में मौजूद ट्रेस फ़ाइलों को पोस्ट प्रोसेस करता है. इसके बाद, मेट्रिक इकट्ठा करता है.  AveragePostProcessor पोस्ट प्रोसेसर लागू करना, जो मेट्रिक की सूची का औसत निकालता है.  BaseDeviceMetricCollector IMetricCollector को लागू करने का बुनियादी तरीका, जिसकी मदद से onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) और ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) को डेटा इकट्ठा करने की प्रोसेस शुरू और बंद की जा सकती है.  BasePostProcessor बुनियादी IPostProcessor, जिसे हर लागू करने की प्रक्रिया में शामिल किया जाना चाहिए.  BluetoothConnectionLatencyCollector कलेक्टर, डिवाइसों पर पहले से तय की गई statsd अवधि मेट्रिक कॉन्फ़िगरेशन को पुश करेगा और हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि इकट्ठा करेगा.  BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा और हर प्रोफ़ाइल के लिए कनेक्शन की स्थिति का नंबर रिकॉर्ड करेगा.  BluetoothConnectionSuccessRatePostProcessor पोस्टप्रोसेसर लागू करना, जो ब्लूटूथ प्रोफ़ाइल के लिए सफलता दर का हिसाब लगाता है "मेट्रिक-की-मैच" का इस्तेमाल करके, उन मेट्रिक की जानकारी दें जिनमें संख्याओं के ऐरे में ब्लूटूथ कनेक्शन की स्थितियां शामिल हैं. उदाहरण के लिए, [0, 1, 2, 3, 0, 1, 2, 3].  BluetoothHciSnoopLogCollector डीयूटी पर ब्लूटूथ HCI स्नूप लॉगिंग की सुविधा चालू करने और हर टेस्ट के लिए लॉग इकट्ठा करने वाला कलेक्टर.  BugreportzOnFailureCollector टेस्ट केस पूरा न होने पर, बग रिपोर्ट इकट्ठा करें.  BugreportzOnTestCaseFailureCollector जब किसी टेस्ट केस को चलाने में गड़बड़ी होती है, तो बग रिपोर्ट इकट्ठा करें.  ClangCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Clang के कवरेज मेज़रमेंट को खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  CollectingTestListener एक ITestInvocationListener, जो टेस्ट के सभी नतीजे इकट्ठा करेगा.  ConsoleResultReporter टेस्ट के नतीजों को कंसोल पर प्रिंट करने के लिए, नतीजा रिपोर्टर.  CountTestCasesCollector किसी दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या की गिनती करें और उसकी रिपोर्ट बनाएं.  DebugHostLogOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर होस्ट-साइड लॉग इकट्ठा और लॉग करेगा.  DeviceTraceCollector यह एक कलेक्टर है, जो टेस्ट रन शुरू होने पर, perfetto ट्रेस शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा.  EventsLoggerListener ऐसा लिसनर जो मिलने वाले सभी इवेंट को किसी फ़ाइल में लॉग करता है  FileProtoResultReporter प्रोटो रिपोर्टर, जो TestRecord को किसी फ़ाइल में डंप करता है.  FilePullerDeviceMetricCollector एक BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है.  FilePullerLogCollector डिवाइस की ओर से रिपोर्ट की गई फ़ाइल का लॉगर.  FormattedGeneratorReporter रिपोर्टर, जो किसी खास फ़ॉर्मैट में रिपोर्ट जनरेट करने की सुविधा देता है.  GcovCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से कवरेज मेज़रमेंट को खींचकर, उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector, जो gcov kernel coverage के मेज़रमेंट को debugfs और डिवाइस से बाहर खींचेगा. इसके बाद, उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  GranularRetriableTestWrapper.StartEndCollector रन शुरू और खत्म होने के समय की जानकारी पाने के लिए क्लास हेल्पर.  HostStatsdMetricCollector एक IMetricCollector, जो statsd की सुविधा वाले कमांड का इस्तेमाल करके, होस्ट साइड से statsd मेट्रिक इकट्ठा करता है.  IMetricCollector टेस्ट के नतीजों की रिपोर्टिंग करते समय, मिलती-जुलती मेट्रिक इकट्ठा करने के लिए, इस इंटरफ़ेस को डेकोरेटर के तौर पर जोड़ा जाएगा.  IPostProcessor पोस्ट प्रोसेसर, एक ट्रेड फ़ेडरेशन ऑब्जेक्ट है. इसका मकसद, टेस्ट के बाद और नतीजों की रिपोर्टिंग से पहले, मेट्रिक और लॉग को प्रोसेस करने की अनुमति देना है.  JavaCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  JsonHttpTestResultReporter नतीजों की जानकारी देने वाला टूल, जो जांच की मेट्रिक के नतीजों और शाखा, डिवाइस की जानकारी को JSON में बदलता है और HTTP सेवा के एंडपॉइंट में पोस्ट करता है  LUCIResultReporter नतीजों की जानकारी देने वाला टूल, जो ResultDB और LUCI के लिए ज़रूरी टेस्ट के नतीजों को JSON फ़ॉर्मैट (go/result-sink) में सेव करता है. साथ ही, फ़ाइल की जगह को कंसोल में लॉग करता है.  LegacySubprocessResultsReporter सबप्रोसेस के नतीजों की रिपोर्टर को फ़्रीज़ किया गया है. यह सुपरक्लास में हुए बदलावों के बावजूद, TF/CTS के पुराने वर्शन (जैसे, 8 और उसके बाद के वर्शन) के साथ काम करती रहेगी.  LogSaverResultForwarder ग्लोबल फ़ाइल सेवर की मदद से लॉग सेव करने के लिए ResultForwarder.  LogcatOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर logcat को कैप्चर और लॉग करेगा.  LogcatTimingMetricCollector यह एक मेट्रिक कलेक्टर है, जो एक या एक से ज़्यादा बार किए गए टेस्ट के दौरान, logcat से समय की जानकारी इकट्ठा करता है.उदाहरण के लिए, उपयोगकर्ता के स्विच करने में लगने वाला समय. इसके लिए, यह logcat लाइनों से किसी इवेंट के शुरू और खत्म होने के सिग्नल को पार्स करने के लिए, दिए गए रेगुलर एक्सप्रेशन पैटर्न का इस्तेमाल करता है.  MetricFilePostProcessor इसका इस्तेमाल, टेस्ट और रन लेवल के दौरान इकट्ठा की गई मेट्रिक लॉग फ़ाइल को अपलोड करने के लिए किया जाता है.  MetricsXMLResultReporter MetricsXMLResultReporter, टेस्ट की मेट्रिक लिखता है और मेट्रिक को टेस्ट के invocationEnded फ़ेज़ के दौरान, मेट्रिक-फ़ोल्डर पैरामीटर से तय किए गए फ़ोल्डर में मौजूद एक्सएमएल फ़ाइल में चलाता है.  ModuleListener नतीजों की सूची इकट्ठा करने के लिए, हर मॉड्यूल के हर IRemoteTest से जुड़ा Listener.  ModuleLogcatCollector मॉड्यूल के लिए, logcat कलेक्टर का वर्शन.  ModuleProtoResultReporter नतीजों की रिपोर्ट करने वाला टूल, सिर्फ़ मॉड्यूल लेवल के नतीजों की रिपोर्ट करता है.  PerfettoGenericPostProcessor एक पोस्ट प्रोसेसर, जो टेक्स्ट/बाइनरी मेट्रिक की परफ़ेक्टो प्रोटो फ़ाइल को की-वैल्यू पेयर में प्रोसेस करता है. इसके लिए, वह स्ट्रिंग वैल्यू वाले प्रोटो मैसेज और फ़ील्ड को बार-बार बड़ा करता है, जब तक कि संख्या वाली वैल्यू वाला फ़ील्ड न मिल जाए.  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से Perfetto फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  ProtoResultReporter नतीजे की जानकारी देने वाला टूल, सभी नतीजों के साथ एक TestRecord प्रोटोबबल बनाता है.  RebootReasonCollector यह एक कलेक्टर है, जो टेस्ट रन के दौरान डिवाइस के रीबूट होने की जानकारी इकट्ठा करता है. साथ ही, इसकी वजह और संख्या के हिसाब से रिपोर्ट करता है.  ReportPassedTests पास किए गए टेस्ट को बाहर रखने के लिए, फ़ाइल में संभावित फ़िल्टर की रिपोर्ट करें.  ResultAggregator यह एक खास फ़ॉरवर्डर है, जो ज़रूरत पड़ने पर, फिर से कोशिश करने की रणनीति के आधार पर नतीजों को इकट्ठा करता है.  ResultAndLogForwarder नतीजों और लॉग इवेंट के लिए फ़ॉरवर्डर.  RetryLogSaverResultForwarder फ़ॉरवर्डर, जो मौजूदा कोशिश को भी पास करता है.  RuntimeRestartCollector यह एक कलेक्टर है, जो टेस्ट के दौरान रनटाइम रीस्टार्ट (सिस्टम सर्वर क्रैश) के टाइमस्टैंप इकट्ठा करता है.  ScreenshotOnFailureCollector कलेक्टर, जो टेस्ट केस के पूरा न होने पर स्क्रीनशॉट कैप्चर करके उसे लॉग करेगा.  ShardListener एक ITestInvocationListener जो किसी invocaton shard (जिसे एक साथ कई संसाधनों पर चलाने के लिए invocaton split भी कहा जाता है) से नतीजे इकट्ठा करता है और उन्हें किसी दूसरे listener को भेजता है.  ShardMainResultForwarder एक ResultForwarder जो शर्ड किए गए टेस्ट के आह्वान के नतीजों को जोड़ता है.  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से शोमैप फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  StatsdBeforeAfterGaugeMetricPostProcessor एक पोस्ट प्रोसेसर, जो "पहले/बाद" वाले तरीके से इकट्ठा की गई मेट्रिक को प्रोसेस करता है, जैसे कि  StatsdEventMetricPostProcessor एक पोस्ट प्रोसेसर, जो प्रोसेसर पर बताए गए फ़ॉर्मैटर का इस्तेमाल करके, statsd रिपोर्ट में इवेंट मेट्रिक को की-वैल्यू पेयर में प्रोसेस करता है.  StatsdGenericPostProcessor एक पोस्ट प्रोसेसर, जो रिपोर्ट को ट्री स्ट्रक्चर के तौर पर बड़ा करके, बाइनरी प्रोटो statsd रिपोर्ट को की-वैल्यू पेयर में प्रोसेस करता है.  StreamProtoResultReporter ProtoResultReporter को लागू करने का तरीका  SubprocessResultsReporter ITestInvocationListener को result_reporter के तौर पर लागू करता है और सब-प्रोसेस से टेस्ट, टेस्ट रन, और टेस्ट के आह्वान के नतीजे फ़ॉरवर्ड करता है.  SuiteResultReporter पूरे सुइट के लिए टेस्ट के नतीजे इकट्ठा करें और आखिरी नतीजे दिखाएं.  TextResultReporter टेस्ट के नतीजे की जानकारी देने वाला टूल, जो JUnit के टेक्स्ट के नतीजे वाले प्रिंटर को नतीजे भेजता है.  TraceCmdCollector ऐसा IMetricCollector जो trace-cmd का इस्तेमाल करके, टेस्ट के दौरान ट्रेस इकट्ठा करता है और उन्हें कॉल करने के लिए लॉग करता है.  XmlFormattedGeneratorReporter FormattedGeneratorReporter को लागू करना, जो सुइट के नतीजों को एक्सएमएल फ़ॉर्मैट में फ़ॉर्मैट करता है.  XmlResultReporter JUnit के नतीजों को एक्सएमएल फ़ाइलों में लिखता है. यह फ़ॉर्मैट, Ant के XMLJUnitResultFormatter के फ़ॉर्मैट से मेल खाता है.

---

इससे ITestInvocationListener को यह सुनने में मदद मिलती है कि लॉग फ़ाइलें कब सेव की गईं.

इससे, रिपोर्ट जनरेट करते समय कई ITestInvocationListener, एक ही सेव की गई लॉग फ़ाइल का इस्तेमाल कर सकते हैं. साथ ही, ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) को कॉल करने पर, हर लिसनर को फ़ाइल को अलग से सेव करने की ज़रूरत नहीं पड़ती.

इस इंटरफ़ेस को लागू करने वाली क्लास को पता होना चाहिए कि ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) को कॉल करने पर, testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) को भी कॉल किया जाएगा.

यह क्लास, ग्लोबल ILogSaver इंस्टेंस को भी पास करती है, ताकि ITestInvocationListener उसी जगह पर अन्य फ़ाइलें सेव कर सकें.

खास जानकारी

सार्वजनिक तरीके
default void	logAssociation(String dataName, LogFile logFile) कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है.
default void	setLogSaver(ILogSaver logSaver) ILogSaver को सेट करें, ताकि लागू करने वाले व्यक्ति को फ़ाइलें सेव करने की अनुमति मिल सके.
default void	testLogSaved(String dataName, LogDataType dataType, InputStreamSource dataStream, LogFile logFile) टेस्ट लॉग सेव होने पर कॉल किया जाता है.

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

logAssociation

public void logAssociation (String dataName, 
                LogFile logFile)

कुछ मामलों में, लॉग को टेस्ट केस से ज़्यादा से ज़्यादा जोड़ा जाना चाहिए. हालांकि, डायरेक्ट testLogSaved(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource, com.android.tradefed.result.LogFile) callback पर ऐसा करना संभव नहीं है. इसलिए, इस कॉलबैक की मदद से, साफ़ तौर पर एक बेहतर असोसिएशन दिया जा सकता है.

पैरामीटर
dataName	String: डेटा का नाम
logFile	LogFile: वह LogFile जो पहले लॉग किया गया था और जो जांच के उदाहरण से जुड़ा होना चाहिए.

setLogSaver

public void setLogSaver (ILogSaver logSaver)

ILogSaver को सेट करें, ताकि लागू करने वाले व्यक्ति को फ़ाइलें सेव करने की अनुमति मिल सके.

पैरामीटर
logSaver	ILogSaver: ILogSaver

testLogSaved

public void testLogSaved (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream, 
                LogFile logFile)

टेस्ट लॉग सेव होने पर कॉल किया जाता है.

इसका इस्तेमाल ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) के बजाय किया जाना चाहिए.

पैरामीटर
dataName	String: डेटा का String ब्यौरा देने वाला नाम. उदाहरण के लिए, "device_logcat". ध्यान दें हर बार कॉल करने पर, dataName यूनीक नहीं हो सकता. इसका मतलब है कि लागू करने वाले, एक ही dataName वाले कई कॉल को मैनेज कर पाएं
dataType	LogDataType: डेटा का LogDataType
dataStream	InputStreamSource: डेटा का InputStreamSource. डेटा पढ़ना शुरू करने के लिए, लागू करने वाले लोगों को createInputStream को कॉल करना चाहिए. साथ ही, डेटा पढ़ने के बाद, InputStream को बंद करना न भूलें.
logFile	LogFile: LogFile, जिसमें सेव की गई फ़ाइल का मेटाडेटा होता है.