ITestLogger

public interface ITestLogger

com.android.tradefed.log.ITestLogger

Bekannte indirekte Unterklassen AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BugreportCollector , BugreportzOnFailureCollector , BugreportzOnTestCaseFailure Collector, ClangCodeCoverageCollector , CollectingTestListener und 74 weitere. AggregatePostProcessor Ein Metrikaggregator, der Min., Max., Mittelwert, Varianz, Standardabweichung, Summe, Anzahl und optional Perzentile für numerische Metriken angibt, die während Testläufen mit mehreren Iterationen erfasst wurden, und diese als Doubles behandelt. AtraceCollector Ein IMetricCollector , der während eines Tests atrace ausführt, die Ergebnisse sammelt und sie beim Aufruf protokolliert. AtraceRunMetricCollector Sammelt die Ablaufverfolgungen aus allen Testverzeichnissen im angegebenen Verzeichnis vom Testgerät, protokolliert das Testverzeichnis, verarbeitet die Ablaufverfolgungsdateien im Testverzeichnis nach und aggregiert die Metriken. AveragePostProcessor Implementierung eines Postprozessors, der den Durchschnitt der Metrikliste berechnet. BaseDeviceMetricCollector Basisimplementierung von IMetricCollector , die das Starten und Stoppen der Sammlung auf onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) und ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) ermöglicht. BasePostProcessor Der Basis IPostProcessor , den jede Implementierung erweitern sollte. BluetoothConnectionLatencyCollector Der Collector überträgt eine vordefinierte Konfiguration der Statistikdauermetrik an Geräte und erfasst die Bluetooth-Verbindungsdauer für jedes Profil. BluetoothConnectionStateCollector Dieser Kollektor erfasst BluetoothConnectionStateChanged-Metriken und zeichnet die Verbindungsstatusnummer für jedes Profil auf. BluetoothConnectionSuccessRatePostProcessor Implementierung eines Postprozessors, der die Erfolgsrate für ein Bluetooth-Profil berechnet Verwenden Sie „metric-key-match“, um Metriken anzugeben, die Bluetooth-Verbindungszustände in einem numerischen Array enthalten. Beispiel [0, 1, 2, 3, 0, 1, 2, 3]. BluetoothHciSnoopLogCollector Collector zum Aktivieren der Bluetooth-HCI-Snoop-Protokollierung auf dem DUT und zum Sammeln des Protokolls für jeden Test. BugreportCollector Ein Pass-Through- ITestInvocationListener , der Fehlerberichte sammelt, wenn konfigurierbare Ereignisse auftreten, und dann ITestInvocationListener#testLog für seine untergeordneten Elemente aufruft, nachdem jeder Fehlerbericht erfasst wurde. BugreportzOnFailureCollector Sammeln Sie einen Fehlerbericht, wenn ein Testfall fehlschlägt. BugreportzOnTestCaseFailureCollector Sammeln Sie einen Fehlerbericht, wenn ein Testfall in einem Lauf fehlschlägt. ClangCodeCoverageCollector Ein BaseDeviceMetricCollector , der Clang-Abdeckungsmessungen vom Gerät abruft und sie als Testartefakte protokolliert. CollectingTestListener Ein ITestInvocationListener , der alle Testergebnisse sammelt. CommandStatusHandler Handler, der dabei hilft, den Status eines Aufrufs zu überwachen und zu aktualisieren. ConditionFailureMonitor Überwachen Sie den Aufruf auf etwaige Fehler. ConsoleResultReporter Ergebnisreporter zum Drucken der Testergebnisse auf der Konsole. CountTestCasesCollector Zählen und melden Sie die Anzahl der Testfälle für einen bestimmten IRemoteTest . DebugHostLogOnFailureCollector Collector, der die hostseitigen Protokolle sammelt und protokolliert, wenn ein Testfallfehler auftritt. DeviceReleaseReporter Gerätefreigabe-Reporter, der die Kommunikation der freizugebenden Geräte mit dem übergeordneten Prozess übernimmt. DeviceTraceCollector Kollektor, der den Perfetto-Trace startet, wenn ein Testlauf beginnt, und die Trace-Datei am Ende protokolliert. DeviceUnavailableMonitor Dieser Listener versucht nur, einen DNAE auf Testfallebene zu erfassen. EventsLoggerListener Listener, der alle empfangenen Ereignisse in einer Datei protokolliert FileProtoResultReporter Proto-Reporter, der den TestRecord in eine Datei speichert. FilePullerDeviceMetricCollector Ein BaseDeviceMetricCollector , der auf vom Gerät kommende Metrikschlüssel wartet und diese als Datei vom Gerät abruft. FilePullerLogCollector Logger der von der Geräteseite gemeldeten Datei. FilteredResultForwarder Variante von ResultForwarder , die nur die Meldung einer Zulassungsliste von TestDescription zulässt. FormattedGeneratorReporter Reporter, der die Erstellung von Berichten in einem bestimmten Format ermöglicht. GcovCodeCoverageCollector Ein BaseDeviceMetricCollector , der GCOV-Abdeckungsmessungen vom Gerät abruft und sie als Testartefakte protokolliert. GcovKernelCodeCoverageCollector Ein BaseDeviceMetricCollector , der gcov-Kernelabdeckungsmessungen aus debugfs und vom Gerät abruft und sie schließlich als Testartefakte protokolliert. GranularRetriableTestWrapper.StartEndCollector Klassenhelfer, um fehlenden Laufanfang und -ende abzufangen. HostStatsdMetricCollector Ein IMetricCollector , der statsd-Metriken von der Hostseite mithilfe von statsd-Dienstprogrammbefehlen sammelt. ICommandScheduler.IScheduledInvocationListener Listener für Aufrufereignisse, wenn der Aufruf abgeschlossen ist. ILogSaverListener Ermöglicht ITestInvocationListener s, darauf zu warten, wann Protokolldateien gespeichert werden. IMetricCollector Diese Schnittstelle wird als Dekorator hinzugefügt, wenn Testergebnisse gemeldet werden, um passende Metriken zu sammeln. IPostProcessor Postprozessoren sind ein Objekt der Handelsföderation, das die Verarbeitung von Metriken und Protokollen NACH den Tests und VOR der Ergebnisberichterstattung ermöglichen soll. IShardableListener Ein ITestInvocationListener , der fragmentiert werden kann. ISupportGranularResults Schnittstelle, die angibt, ob ein ITestInvocationListener den Empfang der detaillierten Ergebnisse unterstützt oder nicht. ITestInvocationListener Listener für Testergebnisse aus dem Testaufruf. ITestSummaryListener Schnittstelle, die es ITestInvocationListener ermöglicht, einige begrenzte Informationen über Zusammenfassungen auszutauschen. InvocationToJUnitResultForwarder Eine Klasse, die ITestInvocationListener Ereignisse abhört und sie an einen TestListener weiterleitet. JarHostTest.HostTestListener Wrapper-Listener, der alle Ereignisse außer testRunStarted() und testRunEnded() an den eingebetteten Listener weiterleitet. JavaCodeCoverageCollector Ein BaseDeviceMetricCollector , der Java-Abdeckungsmessungen vom Gerät abruft und sie als Testartefakte protokolliert. JsonHttpTestResultReporter Ein Ergebnisreporter, der Testmetrikergebnisse kodiert und Geräteinformationen in JSON verzweigt und an einen HTTP-Dienstendpunkt sendet LUCIResultReporter Ein Ergebnisreporter, der von ResultDB und LUCI benötigte Testergebnisse im JSON-Format (go/result-sink) speichert und den Dateispeicherort in der Konsole protokolliert. LastShardDetector Wenn wir lokales Sharding ausführen, möchten wir manchmal einige Aktionen erst dann ausführen, wenn der letzte Shard invocationEnded(long) erreicht. LegacySubprocessResultsReporter Eine eingefrorene Implementierung des Subprozess-Ergebnisreporters, die trotz Änderungen in ihrer Oberklasse mit früheren Versionen von TF/CTS (z. B. 8+) kompatibel bleiben sollte. LogSaverResultForwarder Ein ResultForwarder zum Speichern von Protokollen mit dem globalen Dateispeicher. LogcatCrashResultForwarder Spezieller Listener: Bei Fehlern (Absturz des Instrumentierungsprozesses) wird versucht, den Absturz aus dem Logcat zu extrahieren und ihn der mit dem Test verknüpften Fehlermeldung hinzuzufügen. LogcatOnFailureCollector Collector, der einen Logcat erfasst und protokolliert, wenn ein Testfall fehlschlägt. LogcatTimingMetricCollector Ein Metriksammler, der Zeitinformationen (z. B. Benutzerwechselzeit) von Logcat während eines oder mehrerer wiederholter Tests sammelt, indem er bestimmte Regex-Muster verwendet, um Start- und Endsignale eines Ereignisses aus Logcat-Zeilen zu analysieren. MetricFilePostProcessor Wird zum Hochladen der während der Test- und Ausführungsebene erfassten Metrikprotokolldatei verwendet. MetricsXMLResultReporter MetricsXMLResultReporter schreibt Testmetriken und führt Metriken in eine XML-Datei in einem Ordner aus, der durch den Parameter „metrics-folder“ in der invocationEnded-Phase des Tests angegeben wird. ModuleListener Listener, der an jeden IRemoteTest jedes Moduls angehängt ist, um die Ergebnisliste zu sammeln. ModuleLogcatCollector Version des Logcat-Kollektors, jedoch für Modul. NameMangleListener Ein Proxy-Listener zum Übersetzen von Testmethoden-, Klassen- und Paketnamen, wenn Ergebnisse gemeldet werden. PassingTestFileReporter Ein ITestInvocationListener , der die Liste der bestandenen Testfälle in einer Testdatei speichert PerfettoGenericPostProcessor Ein Postprozessor, der Text-/Binärmetrik-Perfetto-Protodateien in Schlüssel-Wert-Paare verarbeitet, indem er die Protonachrichten und Felder mit Zeichenfolgenwerten rekursiv erweitert, bis das Feld mit dem numerischen Wert gefunden wird. PerfettoPullerMetricCollector Basisimplementierung von FilePullerDeviceMetricCollector , die es ermöglicht, die Perfetto-Dateien vom Gerät abzurufen und die Metriken davon zu sammeln. PrettyTestEventLogger Logger, der die Ereignisse abgleicht und protokolliert, um das Debuggen zu erleichtern. ProtoResultReporter Der Ergebnisreporter erstellt einen TestRecord Protobuf mit allen darin enthaltenen Ergebnissen. PythonBinaryHostTest.PythonForwarder Ergebnisweiterleitung zum Ersetzen des Laufnamens durch den Binärnamen. RebootReasonCollector Collector, der Geräteneustarts während des Testlaufs erfasst und sie nach Grund und Anzahl meldet. RemoteTestTimeOutEnforcer Listener, die es ermöglichen, die Ausführungszeit einer bestimmten Testkonfiguration zu überprüfen und sie fehlzuschlagen, wenn sie ein bestimmtes Zeitlimit überschreitet. ReportPassedTests Melden Sie in einer Datei mögliche Filter, um bestandene Tests auszuschließen. ErgebnisAggregator Spezieller Forwarder, der die Ergebnisse bei Bedarf basierend auf der gewählten Wiederholungsstrategie aggregiert. ResultAndLogForwarder Weiterleitung für Ergebnisse und Protokollereignisse. ResultForwarder Ein ITestInvocationListener , der Aufrufergebnisse an eine Liste anderer Listener weiterleitet. RetryLogSaverResultForwarder Weiterleitung, die auch für die Weiterleitung des aktuellen Versuchs zuständig ist. RetryResultForwarder Eine Erweiterung von ResultForwarder , die immer an eine bestimmte Versuchsnummer pusht. RuntimeRestartCollector Kollektor, der gegebenenfalls Zeitstempel von Laufzeitneustarts (Abstürze des Systemservers) während des Testlaufs sammelt. ScreenshotOnFailureCollector Collector, der einen Screenshot erfasst und protokolliert, wenn ein Testfall fehlschlägt. ShardListener Ein ITestInvocationListener , der Ergebnisse von einem Aufruf-Shard (auch bekannt als Aufrufaufteilung zur parallelen Ausführung auf mehreren Ressourcen) sammelt und sie an einen anderen Listener weiterleitet. ShardMainResultForwarder Ein ResultForwarder , der die Ergebnisse von Shard-Testaufrufen kombiniert. ShowmapPullerMetricCollector Basisimplementierung von FilePullerDeviceMetricCollector , die es ermöglicht, die Showmap-Dateien vom Gerät abzurufen und die Metriken von diesem zu sammeln. StatsdBeforeAfterGaugeMetricPostProcessor Ein Postprozessor, der Messgerätemetriken verarbeitet, die in einem „Vorher/Nachher“-Ansatz erfasst wurden, d. h StatsdEventMetricPostProcessor Ein Postprozessor, der Ereignismetriken in Statistikberichten in Schlüssel-Wert-Paare verarbeitet und dabei die auf dem Prozessor angegebenen Formatierer verwendet. StatsdGenericPostProcessor Ein Postprozessor, der binäre Proto-Statistikberichte in Schlüssel-Wert-Paare verarbeitet, indem er den Bericht als Baumstruktur erweitert. StreamProtoResultReporter Eine Implementierung von ProtoResultReporter SubprocessResultsReporter Implementiert ITestInvocationListener , um als result_reporter angegeben zu werden und vom Unterprozess die Ergebnisse von Tests, Testläufen und Testaufrufen weiterzuleiten. SuiteResultReporter Sammeln Sie Testergebnisse für einen gesamten Suite-Aufruf und geben Sie die Endergebnisse aus. TestFailureListener Der Listener hat bei einem Testfehler auf Anfrage Maßnahmen ergriffen, z. B. einen Screenshot, einen Fehlerbericht oder eine Logcat-Erfassung. TestTimeoutEnforcer Listener, die es ermöglichen, die Ausführungszeit eines bestimmten Testfalls zu überprüfen und ihn fehlzuschlagen, wenn er eine bestimmte Zeitüberschreitung überschreitet. TextResultReporter Ein Testergebnis-Reporter, der Ergebnisse an den JUnit-Textergebnisdrucker weiterleitet. TraceCmdCollector Ein IMetricCollector , der während des Tests mithilfe von „trace-cmd“ Ablaufverfolgungen sammelt und diese beim Aufruf protokolliert. TradefedSandboxRunner.StubScheduledInvocationListener Ein Stub IScheduledInvocationListener , der nichts tut. XmlFormattedGeneratorReporter Die Implementierung des FormattedGeneratorReporter , der die Suite formatiert, führt zu einem XML-Format. XmlResultReporter Schreibt JUnit-Ergebnisse in eine XML-Datei in einem Format, das mit dem XMLJUnitResultFormatter von Ant konsistent ist.

---

Eine Entität, die die Protokollierung von Datenströmen unterschiedlicher Art durchführen kann.

Zusammenfassung

Öffentliche Methoden
default void	testLog (String dataName, LogDataType dataType, InputStreamSource dataStream) Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

Öffentliche Methoden

testLog

public void testLog (String dataName, 
                LogDataType dataType, 
                InputStreamSource dataStream)

Stellt die zugehörigen Protokoll- oder Debugdaten aus dem Testaufruf bereit.

Muss vor ERROR(/ITestInvocationListener#invocationFailed(Throwable)) oder ERROR(/ITestInvocationListener#invocationEnded(long)) aufgerufen werden.

Das TradeFederation-Framework ruft diese Methode automatisch auf und stellt das Host-Protokoll und gegebenenfalls das Geräte-Logcat bereit.

Parameter
dataName	String : ein String der den Namen der Daten beschreibt. zB „device_logcat“. Beachten Sie, dass dataName pro Aufruf möglicherweise nicht eindeutig ist. Das heißt, Implementierer müssen in der Lage sein, mehrere Aufrufe mit demselben Datennamen zu verarbeiten
dataType	LogDataType : der LogDataType der Daten
dataStream	InputStreamSource : die InputStreamSource der Daten. Implementierer sollten createInputStream aufrufen, um mit dem Lesen der Daten zu beginnen, und sicherstellen, dass der resultierende InputStream nach Abschluss geschlossen wird. Aufrufer sollten sicherstellen, dass die Datenquelle vorhanden und zugänglich bleibt, bis die testLog-Methode abgeschlossen ist.