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 अन्य. Aggregateपोस्टप्रोसेसर यह ऐसा मेट्रिक एग्रीगेटर है जो कम से कम, सबसे ज़्यादा, माध्य, वैरिएंस, मानक विचलन, कुल, संख्या, और एक से ज़्यादा बार टेस्ट करने के दौरान इकट्ठा की गई संख्या वाली मेट्रिक के लिए, वैकल्पिक तौर पर पर्सेंटाइल, दो गुना ज़्यादा अनुभव करते हैं.  एट्रेस कलेक्टर IMetricCollector, जो टेस्ट के दौरान एट्रेस चलाता है और नतीजा और लॉग इकट्ठा करता है उन्हें न्योता देना.  AtraceRunMetricCollector यह फ़ंक्शन, दी गई डायरेक्ट्री के तहत आने वाली सभी टेस्ट डायरेक्ट्री से ट्रेस इकट्ठा करता है टेस्ट डिवाइस से, टेस्ट डायरेक्ट्री लॉग करें और ट्रेस फ़ाइलों को पोस्ट करें और मेट्रिक को एग्रीगेट करें.  AveragePostProcessor मेट्रिक की सूची के औसत का हिसाब लगाने वाले पोस्ट प्रोसेसर को लागू करना.  BaseDeviceMetricCollector IMetricCollector को लागू करने का आधार, जो डेटा इकट्ठा करने की प्रोसेस को शुरू और बंद करने की अनुमति देता है onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) और ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)).  Baseपोस्टप्रोसेसर हर बार लागू होने वाला बेस IPostProcessor, जिसे लागू किया जाना चाहिए.  BluetoothConnectionLatencyCollector कलेक्टर, डिवाइसों पर पहले से तय आंकड़ों की अवधि वाली मेट्रिक कॉन्फ़िगर करेगा और यह जानकारी इकट्ठा करेगा हर प्रोफ़ाइल के लिए ब्लूटूथ कनेक्शन की अवधि.  BluetoothConnectionStateCollector यह कलेक्टर, BluetoothConnectionStateChanged मेट्रिक इकट्ठा करेगा और कनेक्शन की स्थिति रिकॉर्ड करेगा प्रत्येक प्रोफ़ाइल का नंबर डालें.  BluetoothConnectionSuccessRatePostProcessor पोस्टप्रोसेसर को लागू करना, जो ब्लूटूथ प्रोफ़ाइल के लिए सफलता की दर का हिसाब लगाता है "मेट्रिक-की-मैच" का इस्तेमाल करके, उन मेट्रिक की जानकारी दें जिनमें संख्याओं के ऐरे में ब्लूटूथ कनेक्शन की स्थितियां शामिल हैं. उदाहरण के लिए, [0, 1, 2, 3, 0, 1, 2, 3].  ब्लूटूथHciSnoopLogCollector डीयूटी पर ब्लूटूथ HCI स्नूप लॉगिंग को चालू करने और हर टेस्ट के लिए लॉग इकट्ठा करने के लिए कलेक्टर.  BugreportzOnFailureCollector टेस्ट केस पूरा न होने पर, बग रिपोर्ट इकट्ठा करें.  BugreportzOnTestCaseFailureCollector जब किसी टेस्ट केस को चलाने में गड़बड़ी होती है, तो बग रिपोर्ट इकट्ठा करें.  ClangCodeCoverageCollector एक BaseDeviceMetricCollector जो क्लैंग को डिवाइस के कवरेज मेज़रमेंट को बंद करता है और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करता है.  CollectingTestListener ITestInvocationListener, जो जांच के सभी नतीजे इकट्ठा करेगा.  ConsoleResultReporter टेस्ट के नतीजों को कंसोल पर प्रिंट करने के लिए, नतीजा रिपोर्टर.  CountTestCasesCollector दिए गए IRemoteTest के लिए, टेस्ट केस की संख्या गिनें और रिपोर्ट करें.  DebugHostLogOnFailureCollector कलेक्टर, जो टेस्ट केस में गड़बड़ी होने पर होस्ट-साइड लॉग इकट्ठा और लॉग करेगा.  DeviceTraceCollector कलेक्टर, जो टेस्ट रन शुरू होने पर परफ़ेटो ट्रेस करना शुरू करेगा और आखिर में ट्रेस फ़ाइल को लॉग करेगा.  EventsLoggerListener लिसनर जो इसे मिलने वाले सभी इवेंट को फ़ाइल में लॉग करता है FileProtoResultReporter प्रोटो रिपोर्टर, जो TestRecord को फ़ाइल में डंप करता है.  FilePullerDeviceMetricCollector ऐसा BaseDeviceMetricCollector जो डिवाइस से आने वाली मेट्रिक कुंजी को सुनता है और उन्हें डिवाइस से फ़ाइल के तौर पर खींचता है.  FilePullerLogCollector डिवाइस-साइड से रिपोर्ट की गई फ़ाइल का लॉगर.  FormattedGeneratorरिपोर्टर रिपोर्टर, जिसकी मदद से किसी खास फ़ॉर्मैट में रिपोर्ट जनरेट की जा सकती हैं.  GcovCodeCoverageCollector एक BaseDeviceMetricCollector जो gcov को फ़ेच करेगा डिवाइस के कवरेज मेज़रमेंट को बंद करता है और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करता है.  GcovKernelCodeCoverageCollector एक BaseDeviceMetricCollector जो gcov कर्नेल को खींच लेगा डिवाइस के डीबग और डिवाइस के बाहर कवरेज के मेज़रमेंट को मेज़र किया जाता है. इसके बाद, आखिर में उन्हें टेस्ट के तौर पर लॉग किया जाता है आर्टफ़ैक्ट.  GranularRetriableTestWrapper.StartEndCollector रन शुरू और खत्म होने के समय की जानकारी देने वाली क्लास हेल्पर.  HostStatsdMetricCollector एक IMetricCollector, जो statsd की सुविधा वाले कमांड का इस्तेमाल करके, होस्ट साइड से statsd मेट्रिक इकट्ठा करता है.  IMetricCollector टेस्ट के नतीजों की रिपोर्टिंग करते समय, मिलती-जुलती मेट्रिक इकट्ठा करने के लिए, इस इंटरफ़ेस को डेकोरेटर के तौर पर जोड़ा जाएगा.  IPostProcessor पोस्ट प्रोसेसर, एक ट्रेड फ़ेडरेशन ऑब्जेक्ट है. इसका मकसद, टेस्ट के बाद और नतीजों की रिपोर्टिंग से पहले, मेट्रिक और लॉग को प्रोसेस करने की अनुमति देना है.  JavaCodeCoverageCollector एक BaseDeviceMetricCollector, जो डिवाइस से Java कवरेज मेज़रमेंट खींचेगा और उन्हें टेस्ट आर्टफ़ैक्ट के तौर पर लॉग करेगा.  JsonHttpTestresults Reporter नतीजों की जानकारी देने वाला रिपोर्टर, जो टेस्ट मेट्रिक के नतीजों और ब्रांच, डिवाइस की जानकारी को JSON और POST में एन्कोड करता है एक एचटीटीपी सेवा एंडपॉइंट में LUCIनतीजेरिपोर्टर नतीजों की जानकारी देने वाला टूल, जो ResultDB और LUCI के लिए ज़रूरी टेस्ट के नतीजों को JSON फ़ॉर्मैट (go/result-sink) में सेव करता है. साथ ही, फ़ाइल की जगह को कंसोल में लॉग करता है.  LegacySubprocessResultsReporter सबप्रोसेस के नतीजों की जानकारी देने वाले रिपोर्टर को लागू करने की प्रक्रिया को कुछ समय के लिए रोक दिया गया है, जो TF/CTS के पुराने वर्शन (जैसे, 8+), इसके सुपर क्लास में हुए बदलावों के बावजूद.  LogSaverresultsऐसे ने जिन्हें बताया है ग्लोबल फ़ाइल सेवर की मदद से लॉग सेव करने के लिए, ResultForwarder.  LogcatOnFailureCollector कलेक्टर, जो टेस्ट केस फ़ेल होने पर लॉगकैट को कैप्चर करके लॉग करेगा.  LogcatTimingMetricCollector मेट्रिक कलेक्टर, जो किसी रेगुलर एक्सप्रेशन पैटर्न का इस्तेमाल करके, किसी लॉगकैट लाइनों से मिला इवेंट.  MetricFilePostProcessor इसका इस्तेमाल, टेस्ट और रन लेवल के दौरान इकट्ठा की गई मेट्रिक लॉग फ़ाइल को अपलोड करने के लिए किया जाता है.  MetricsXMLResultReporter MetricsXMLReportingreporter को टेस्ट मेट्रिक लिखती है और तय किए गए फ़ोल्डर में, एक्सएमएल फ़ाइल पर उस मेट्रिक को रन करती है के हिसाब से फ़िल्टर करें.  ModuleListener नतीजों की सूची इकट्ठा करने के लिए, हर मॉड्यूल के हर IRemoteTest से जुड़ा Listener.  ModuleLogcatCollector Logcat कलेक्टर का वर्शन, लेकिन मॉड्यूल के लिए.  मॉड्यूलप्रोटोनतीजे रिपोर्टर रिज़ल्ट रिपोर्टर, जो सिर्फ़ मॉड्यूल लेवल के नतीजों को रिपोर्ट करता है.  Perfettoजेनेरिकपोस्ट प्रोसेसर यह ऐसा पोस्ट प्रोसेसर है जो टेक्स्ट/बाइनरी मेट्रिक परफ़ेटो प्रोटो फ़ाइल को की-वैल्यू पेयर में प्रोसेस करता है स्ट्रिंग वैल्यू के साथ प्रोटो मैसेज और फ़ील्ड को बार-बार तब तक बड़ा करता है, जब तक फ़ील्ड अंकीय मान मिला.  PerfettoPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जो डिवाइस से Perfetto फ़ाइलें खींचने और उनसे मेट्रिक इकट्ठा करने की अनुमति देता है.  Protoresultsरिपोर्टर नतीजा रिपोर्टर, TestRecord प्रोटोबफ़ बनाता है, जिसमें सभी नतीजे मौजूद होते हैं.  फिर से चालू करने की वजह कलेक्टर, जो टेस्ट के दौरान डिवाइस को फिर से चालू करने की जानकारी इकट्ठा करता है. साथ ही, वजह और संख्या के हिसाब से उसकी रिपोर्ट देता है.  ReportPassedTests पास किए गए टेस्ट को शामिल न करने के लिए, फ़ाइल में संभावित फ़िल्टर जोड़ें.  ResultAggregator यह एक खास फ़ॉरवर्डर है, जो ज़रूरत पड़ने पर, फिर से कोशिश करने की रणनीति के आधार पर नतीजों को इकट्ठा करता है.  नतीजेAndLogFinder नतीजों और लॉग इवेंट के लिए फ़ॉरवर्डर.  RetryLogSaverResultForwarder फ़ॉरवर्डर, जो हमारी मौजूदा कोशिश को पूरा करने का काम भी करता है.  रनटाइम रीस्टार्ट कलेक्टर यह एक कलेक्टर है, जो टेस्ट के दौरान रनटाइम रीस्टार्ट (सिस्टम सर्वर क्रैश) के टाइमस्टैंप इकट्ठा करता है.  स्क्रीनशॉटOnFailureCollector कलेक्टर, जो टेस्ट केस फ़ेल होने पर स्क्रीनशॉट लेकर लॉग करेगा.  शार्डलिसनर एक ITestInvocationListener जो किसी invocaton शर्ड (जिसे एक साथ कई संसाधनों पर चलाने के लिए invocaton split भी कहा जाता है) से नतीजे इकट्ठा करता है और उन्हें किसी दूसरे listener को भेजता है.  ShardMainresultsStatuser एक ResultForwarder जो शार्ड किए गए टेस्ट शुरू करने के नतीजों को जोड़ता है.  ShowmapPullerMetricCollector FilePullerDeviceMetricCollector को लागू करने का बुनियादी तरीका, जिससे शोमैप तैयार करने में मदद मिलती है डिवाइस से फ़ाइलें सेव कर सकता है और उससे मेट्रिक इकट्ठा कर सकता है.  StatsdBeforeAfterGaugeMetricPostProcessor एक पोस्ट प्रोसेसर, जो "पहले/बाद" वाले तरीके से इकट्ठा की गई मेट्रिक को प्रोसेस करता है. जैसे,  StatsdEventMetricPostProcessor एक पोस्ट प्रोसेसर, जो प्रोसेसर पर बताए गए फ़ॉर्मैटर का इस्तेमाल करके, statsd रिपोर्ट में इवेंट मेट्रिक को की-वैल्यू पेयर में प्रोसेस करता है.  StatsdGenericPostProcessor एक पोस्ट प्रोसेसर, जो रिपोर्ट को ट्री स्ट्रक्चर के तौर पर बड़ा करके, बाइनरी प्रोटो statsd रिपोर्ट को की-वैल्यू पेयर में प्रोसेस करता है.  StreamProtoResultReporter ProtoResultReporter को लागू करना सबप्रोसेस के नतीजे रिपोर्टर ITestInvocationListener को result_reporter के तौर पर लागू करता है और सब-प्रोसेस से टेस्ट, टेस्ट रन, और टेस्ट के आह्वान के नतीजे फ़ॉरवर्ड करता है.  Suiteनतीजे रिपोर्टर पूरे सुइट को शुरू करने के बाद, जांच के नतीजे इकट्ठा करें और नतीजे पाएं.  Textresults Reporter टेस्ट के नतीजे की जानकारी देने वाला टूल, जो JUnit के टेक्स्ट के नतीजे वाले प्रिंटर को नतीजे भेजता है.  TraceCmdCollector एक IMetricCollector जो ट्रेस-cmd का इस्तेमाल करके टेस्ट के दौरान ट्रेस इकट्ठा करता है और उन्हें इस पर लॉग करता है शुरू करना.  XmlFormattedGeneratorReporter FormattedGeneratorReporter को लागू करना, जो सुइट के नतीजों को एक्सएमएल फ़ॉर्मैट में फ़ॉर्मैट करता है.  Xmlनतीजे रिपोर्टर 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) पर कॉलबैक नहीं किया जा सकता.
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) पर कॉलबैक नहीं किया जा सकता. इसलिए, यह कॉलबैक एक मज़बूत असोसिएशन देने देता है साफ़ तौर पर बताया गया है.

पैरामीटर
dataName	String: डेटा का नाम
logFile	LogFile: वह LogFile जिसे पहले लॉग किया गया था और जिसे टेस्ट केस.

सेटलॉग सेवर

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.