ILogSaverListener সম্পর্কে

public interface ILogSaverListener
implements ITestInvocationListener

com.android.tradefed.result.ILogSaverListener সম্পর্কে

জ্ঞাত পরোক্ষ উপশ্রেণী AggregatePostProcessor , AtraceCollector , AtraceRunMetricCollector , AveragePostProcessor , BaseDeviceMetricCollector , BasePostProcessor , BluetoothConnectionLatencyCollector , BluetoothConnectionStateCollector , BluetoothConnectionSuccessRatePostProcessor , BluetoothHciSnoopLogCollector , BuggreportzOnFailureCollector , BuggreportzOnTestCaseFailureCollector , ClangCodeCoverageCollector , CodeCoverageCollector , CollectingTestListener , এবং আরও 57 জন। সমষ্টিগত পোস্টপ্রসেসর একটি মেট্রিক অ্যাগ্রিগেটর যা বহু-পুনরাবৃত্তি পরীক্ষা চালানোর সময় সংগৃহীত সংখ্যাসূচক মেট্রিক্সের জন্য সর্বনিম্ন, সর্বোচ্চ, গড়, প্রকরণ, মানক বিচ্যুতি, মোট, গণনা এবং ঐচ্ছিকভাবে শতকরা হার দেয়, এগুলিকে দ্বিগুণ হিসাবে বিবেচনা করে। অ্যাট্রেস কালেক্টর একটি IMetricCollector যা পরীক্ষার সময় atrace চালায় এবং ফলাফল সংগ্রহ করে এবং আমন্ত্রণে লগ করে। অ্যাট্রেসরানমেট্রিককালেক্টর প্রদত্ত ডিরেক্টরির অধীনে থাকা সমস্ত টেস্ট ডিরেক্টরি থেকে ট্রেস পরীক্ষা ডিভাইস থেকে সংগ্রহ করে, পরীক্ষা ডিরেক্টরি লগ করে এবং পরীক্ষা ডিরেক্টরির অধীনে থাকা ট্রেস ফাইলগুলি প্রক্রিয়াকরণের পরে এবং মেট্রিক্স একত্রিত করে। গড় পোস্টপ্রসেসর মেট্রিক্সের তালিকার গড় গণনা করে এমন পোস্ট প্রসেসরের বাস্তবায়ন। বেসডিভাইসমেট্রিককালেক্টর IMetricCollector এর বেস বাস্তবায়ন যা onTestRunStart(com.android.tradefed.device.metric.DeviceMetricData) এবং ERROR(/#onTestRunEnd(com.android.tradefed.device.metric.DeviceMetricData,Map)) এ সংগ্রহ শুরু এবং বন্ধ করতে দেয়। বেসপোস্টপ্রসেসর প্রতিটি বাস্তবায়নের জন্য যে বেস IPostProcessor প্রসারিত করা উচিত। ব্লুটুথ সংযোগ বিলম্বিততা সংগ্রাহক সংগ্রাহক ডিভাইসগুলিতে একটি পূর্ব-নির্ধারিত statsd সময়কাল মেট্রিক কনফিগারেশন পুশ করবেন এবং প্রতিটি প্রোফাইলের জন্য ব্লুটুথ সংযোগের সময়কাল সংগ্রহ করবেন। ব্লুটুথ সংযোগ রাজ্য সংগ্রাহক এই সংগ্রাহক প্রতিটি প্রোফাইলের জন্য BluetoothConnectionStateChanged মেট্রিক্স সংগ্রহ করবেন এবং সংযোগের অবস্থা নম্বর রেকর্ড করবেন। ব্লুটুথ সংযোগ সাফল্যের হার পোস্টপ্রসেসর ব্লুটুথ প্রোফাইলের সাফল্যের হার গণনা করে এমন পোস্টপ্রসেসর বাস্তবায়ন সাংখ্যিক অ্যারেতে ব্লুটুথ সংযোগের অবস্থা ধারণকারী মেট্রিক্স নির্দিষ্ট করতে "metric-key-match" ব্যবহার করুন। উদাহরণ [0, 1, 2, 3, 0, 1, 2, 3]। ব্লুটুথএইচসিস্নুপলগসংগ্রাহক DUT-তে ব্লুটুথ HCI স্নুপ লগিং সক্ষম করতে এবং প্রতিটি পরীক্ষার জন্য লগ সংগ্রহ করতে কালেক্টর। বাগ রিপোর্টঅনফেইলুরকালেক্টর কোনও টেস্ট কেস ব্যর্থ হলে একটি বাগরিপোর্টজ সংগ্রহ করুন। বাগ রিপোর্টঅনটেস্টকেসফেইল্যুরকালেক্টর যখন কোনও রানের টেস্ট কেস ব্যর্থ হয় তখন একটি বাগরিপোর্টজ সংগ্রহ করুন। ক্ল্যাংকোডকভারেজকালেক্টর একটি BaseDeviceMetricCollector যা ডিভাইস থেকে Clang কভারেজ পরিমাপ টেনে আনবে এবং পরীক্ষামূলক আর্টিফ্যাক্ট হিসেবে লগ করবে। কোডকভারেজ কালেক্টর একটি BaseDeviceMetricCollector যা ডিভাইস থেকে জাভা এবং নেটিভ কভারেজ পরিমাপ টেনে আনবে এবং পরীক্ষামূলক আর্টিফ্যাক্ট হিসেবে লগ করবে। সংগ্রহকারী পরীক্ষা শ্রোতা একটি ITestInvocationListener যা সমস্ত পরীক্ষার ফলাফল সংগ্রহ করবে। কনসোল রেজাল্ট রিপোর্টার পরীক্ষার ফলাফল কনসোলে প্রিন্ট করার জন্য রেজাল্ট রিপোর্টার। কাউন্টটেস্টকেসকালেক্টর একটি প্রদত্ত IRemoteTest এর জন্য পরীক্ষার সংখ্যা গণনা করুন এবং রিপোর্ট করুন। ডিবাগহোস্টলগঅনফেইলুরকালেক্টর সংগ্রাহক যিনি টেস্ট কেস ব্যর্থতার ক্ষেত্রে হোস্ট-সাইড লগ সংগ্রহ এবং লগ করবেন। ডিভাইসট্রেসকালেক্টর সংগ্রাহক যা পরীক্ষামূলক রান শুরু হলে পারফেটো ট্রেস শুরু করবে এবং শেষে লগ ট্রেস ফাইল তৈরি করবে। ইভেন্টসলগারলিসেনার লিসেনার যা তার প্রাপ্ত সমস্ত ইভেন্ট একটি ফাইলে লগ করে ফাইলপ্রোটোরেজাল্ট রিপোর্টার প্রোটো রিপোর্টার যা TestRecord একটি ফাইলে ডাম্প করে। ফাইলপুলারডিভাইসমেট্রিককালেক্টর একটি BaseDeviceMetricCollector যা ডিভাইস থেকে আসা মেট্রিক্স কী শোনে এবং ডিভাইস থেকে ফাইল হিসেবে টেনে নেয়। ফাইলপুলারলগ কালেক্টর ডিভাইস-সাইড দ্বারা রিপোর্ট করা ফাইলের লগার। ফর্ম্যাটেডজেনারেটররিপোর্টার প্রতিবেদক যা একটি নির্দিষ্ট বিন্যাসে প্রতিবেদন তৈরি করতে দেয়। GcovCodeCoverageCollector সম্পর্কে একটি BaseDeviceMetricCollector যা ডিভাইস থেকে gcov কভারেজ পরিমাপ টেনে আনবে এবং পরীক্ষামূলক আর্টিফ্যাক্ট হিসেবে লগ করবে। GcovKernelCodeCoverageCollector সম্পর্কে একটি BaseDeviceMetricCollector যা debugfs থেকে gcov কার্নেল কভারেজ পরিমাপ টেনে ডিভাইসের বাইরে আনবে এবং অবশেষে সেগুলিকে পরীক্ষামূলক আর্টিফ্যাক্ট হিসাবে লগ করবে। গ্রানুলার রিট্রাইবল টেস্ট র‍্যাপার.স্টার্টএন্ড কালেক্টর ক্লাস হেল্পার অনুপস্থিত রান শুরু এবং শেষ ধরবে। হোস্টস্ট্যাটসডিমেট্রিককালেক্টর একটি IMetricCollector যা statsd ইউটিলিটি কমান্ড ব্যবহার করে হোস্ট পক্ষ থেকে statsd মেট্রিক্স সংগ্রহ করে। আইমেট্রিক কালেক্টর ম্যাচিং মেট্রিক্স সংগ্রহ করার জন্য পরীক্ষার ফলাফল রিপোর্ট করার সময় এই ইন্টারফেসটি ডেকোরেটর হিসেবে যোগ করা হবে। আইপোস্টপ্রসেসর পোস্ট প্রসেসর হল একটি ট্রেড ফেডারেশন অবজেক্ট যার উদ্দেশ্য পরীক্ষার পরে এবং ফলাফল রিপোর্ট করার আগে মেট্রিক্স এবং লগ প্রক্রিয়াকরণের অনুমতি দেওয়া। ইনভোকেশন প্রোটোরেসাল্ট রিপোর্টার রিপোর্টাররা ইনভোকেশন লেভেল ক্যাশিং তথ্য এবং এর মডিউলের তালিকা সংরক্ষণ করবে জাভাকোডকভারেজকালেক্টর একটি BaseDeviceMetricCollector যা ডিভাইস থেকে জাভা কভারেজ পরিমাপ টেনে আনবে এবং পরীক্ষামূলক আর্টিফ্যাক্ট হিসেবে লগ করবে। JsonHttpTestResultReporter সম্পর্কে একটি ফলাফল রিপোর্টার যা পরীক্ষার মেট্রিক্স ফলাফল এবং শাখা, ডিভাইসের তথ্য JSON এবং POST-এ HTTP পরিষেবার শেষ বিন্দুতে এনকোড করে। লুসিআইআরসাল্ট রিপোর্টার একটি রেজাল্ট রিপোর্টার যা ResultDB এবং LUCI-এর প্রয়োজনীয় পরীক্ষার ফলাফল JSON ফর্ম্যাটে (go/result-sink) সংরক্ষণ করে এবং কনসোলে ফাইলের অবস্থান লগ করে। লিগ্যাসি সাবপ্রসেস ফলাফল রিপোর্টার সাবপ্রসেস রেজাল্ট রিপোর্টারের একটি হিমায়িত বাস্তবায়ন যা TF/CTS এর পূর্ববর্তী সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ থাকা উচিত (যেমন 8+), এর সুপারক্লাসে পরিবর্তন সত্ত্বেও। লগসেভার রেজাল্ট ফরওয়ার্ডার গ্লোবাল ফাইল সেভার দিয়ে লগ সংরক্ষণের জন্য একটি ResultForwarder । লগক্যাটঅনফেইলুরকালেক্টর একটি সংগ্রাহক যিনি একটি পরীক্ষামূলক কেস ব্যর্থ হলে একটি লগক্যাট ক্যাপচার এবং লগ করবেন। লগক্যাটটাইমিংমেট্রিককালেক্টর একটি মেট্রিক সংগ্রাহক যা লগক্যাট লাইন থেকে একটি ইভেন্টের শুরু এবং শেষ সংকেত বিশ্লেষণ করার জন্য প্রদত্ত রেজেক্স প্যাটার্ন ব্যবহার করে এক বা একাধিক পুনরাবৃত্তি পরীক্ষার সময় লগক্যাট থেকে সময় তথ্য (যেমন ব্যবহারকারীর পরিবর্তনের সময়) সংগ্রহ করে। মেট্রিকফাইলপোস্টপ্রসেসর পরীক্ষা এবং রান স্তরের সময় সংগৃহীত মেট্রিক্স লগ ফাইল আপলোড করার জন্য ব্যবহৃত হয়। মেট্রিক্সএক্সএমএলরেজাল্টরিপোর্টার MetricsXMLResultReporter পরীক্ষার মেট্রিক্স লেখে এবং পরীক্ষার invocationEnded পর্যায়ে metrics-folder প্যারামিটার দ্বারা নির্দিষ্ট ফোল্ডারে একটি XML ফাইলে মেট্রিক্স চালায়। মডিউললিসেনার ফলাফলের তালিকা সংগ্রহের জন্য প্রতিটি মডিউলের প্রতিটি IRemoteTest এর সাথে শ্রোতা সংযুক্ত করা হয়েছে। মডিউললগক্যাটসংগ্রাহক লগক্যাট সংগ্রাহকের সংস্করণ কিন্তু মডিউলের জন্য। মডিউলপ্রোটোরেজাল্টরিপোর্টার একজন ফলাফল প্রতিবেদক কেবল মডিউল স্তরের ফলাফল রিপোর্ট করতেন। মডিউল ফলাফল এবং মেট্রিক্স ফরোয়ার্ডার ResultAndLogForwarder এর একটি এক্সটেনশন যা পরীক্ষার ফলাফলে অতিরিক্ত মডিউল সম্পর্কিত মেট্রিক্স যোগ করে। পারফেটোফাইলপুলারকালেক্টর একটি সংগ্রাহক যা ডিভাইস থেকে পারফেটো ট্রেস ফাইলগুলি টেনে আনে, ঐচ্ছিকভাবে সেগুলিকে সংকুচিত করে এবং পরীক্ষার লগে যোগ করে। পারফেটোজেনেরিকপোস্টপ্রসেসর একটি পোস্ট প্রসেসর যা টেক্সট/বাইনারি মেট্রিক পারফেটো প্রোটো ফাইলকে কী-মান জোড়ায় প্রক্রিয়া করে, প্রোটো বার্তা এবং স্ট্রিং মান সহ ক্ষেত্রগুলিকে পুনরাবৃত্তভাবে প্রসারিত করে যতক্ষণ না সংখ্যাসূচক মান সহ ক্ষেত্রটি দেখা যায়। পারফেটোপুলারমেট্রিককালেক্টর এই ক্লাসটি বন্ধ করা হয়েছে। পরিবর্তে PerfettoFilePullerCollector এবং ERROR(/PerfettoTracePostProcessor) ব্যবহার করুন। পারফেটোট্রেসপোস্টপ্রসেসর একটি পোস্ট প্রসেসর যা টেস্ট লগ থেকে পারফেটো ট্রেস ফাইলগুলি পুনরুদ্ধার করে এবং একটি পারফেটো মেট্রিক প্রোটো তৈরি করতে তাদের উপর ট্রেস প্রসেসর চালায়। প্রোটোরেসাল্ট রিপোর্টার রেজাল্ট রিপোর্টার সমস্ত ফলাফল ভিতরে রেখে একটি TestRecord প্রোটোবাফ তৈরি করে। রিবুট করুন কারণ সংগ্রাহক পরীক্ষার সময় ডিভাইস রিবুট সংগ্রহকারী সংগ্রাহক এবং কারণ এবং গণনা অনুসারে তাদের রিপোর্ট করুন। রিমোটটেস্টটাইমআউটএনফোর্সার শ্রোতা যা একটি প্রদত্ত পরীক্ষার কনফিগারেশনের কার্যকর সময় পরীক্ষা করতে এবং যদি এটি একটি নির্দিষ্ট সময়সীমা অতিক্রম করে তবে এটি ব্যর্থ করতে দেয়। রিপোর্ট করুনপরীক্ষায় উত্তীর্ণ পাস করা পরীক্ষা বাদ দেওয়ার জন্য সম্ভাব্য ফিল্টারগুলি একটি ফাইলে রিপোর্ট করুন। ফলাফল সংগ্রাহক বিশেষ ফরোয়ার্ডার যা প্রয়োজনের সময় ফলাফল একত্রিত করে, যা পুনরায় চেষ্টা করার কৌশলের উপর ভিত্তি করে তৈরি করা হয়েছিল। ResultAndLogForwarder সম্পর্কে ফলাফল এবং লগ ইভেন্টের জন্য ফরোয়ার্ডার। ফলাফল ডিবি রিপোর্টার রেজাল্ট রিপোর্টার যে পরীক্ষার ফলাফল ResultDB-তে আপলোড করে। ফলাফল প্রতিবেদক রিট্র্যালগসেভার রেজাল্ট ফরওয়ার্ডার ফরোয়ার্ডার যে আমাদের বর্তমান প্রচেষ্টায় পাস করার কাজও পরিচালনা করে। রানটাইম রিস্টার্ট কালেক্টর টেস্ট রানের সময় রানটাইম রিস্টার্টের (সিস্টেম সার্ভার ক্র্যাশ) টাইমস্ট্যাম্প সংগ্রহকারী কালেক্টর, যদি থাকে। স্ক্রিনশটঅনফেইল্যুরকালেক্টর একটি সংগ্রাহক যিনি একটি টেস্ট কেস ব্যর্থ হলে একটি স্ক্রিনশট ক্যাপচার এবং লগ করবেন। ShardListener সম্পর্কে একটি ITestInvocationListener যা একটি ইনভোকেশন শার্ড (যার অর্থ একাধিক রিসোর্সে সমান্তরালভাবে চালানোর জন্য একটি ইনভোকেশন স্প্লিট) থেকে ফলাফল সংগ্রহ করে এবং সেগুলি অন্য শ্রোতার কাছে ফরোয়ার্ড করে। ShardMainResultForwarder সম্পর্কে একটি ResultForwarder যা একটি sharded পরীক্ষার আমন্ত্রণের ফলাফল একত্রিত করে। শোম্যাপপুলারমেট্রিককালেক্টর FilePullerDeviceMetricCollector এর বেসিক বাস্তবায়ন যা ডিভাইস থেকে শোম্যাপ ফাইলগুলি টেনে আনতে এবং এটি থেকে মেট্রিক্স সংগ্রহ করতে দেয়। StatsdBeforeAfterGaugeMetricPostProcessor একটি পোস্ট প্রসেসর যা "আগে/পরে" পদ্ধতিতে সংগৃহীত গেজ মেট্রিক্স প্রক্রিয়া করে, অর্থাৎ StatsdEventMetricPostProcessor একটি পোস্ট প্রসেসর যা প্রসেসরে নির্দিষ্ট ফর্ম্যাটর ব্যবহার করে স্ট্যাটসড রিপোর্টের ইভেন্ট মেট্রিক্সকে কী-মান জোড়ায় প্রক্রিয়া করে। StatsdGenericPostProcessor সম্পর্কে একটি পোস্ট প্রসেসর যা বাইনারি প্রোটো স্ট্যাটাসড রিপোর্টগুলিকে কী-মান জোড়ায় প্রক্রিয়া করে রিপোর্টটিকে একটি ট্রি স্ট্রাকচার হিসাবে প্রসারিত করে। স্ট্রিমপ্রোটোরেসাল্ট রিপোর্টার ProtoResultReporter এর একটি বাস্তবায়ন সাবপ্রসেস রেজাল্ট রিপোর্টার ITestInvocationListener প্রয়োগ করে যা result_reporter হিসেবে নির্দিষ্ট করা হয় এবং সাবপ্রসেস থেকে পরীক্ষা, পরীক্ষা রান, পরীক্ষা আহ্বানের ফলাফল ফরোয়ার্ড করে। স্যুইট রেজাল্ট রিপোর্টার একটি সম্পূর্ণ স্যুট ইনভোকেশনের জন্য পরীক্ষার ফলাফল সংগ্রহ করুন এবং চূড়ান্ত ফলাফল আউটপুট করুন। টেক্সটরেজাল্ট রিপোর্টার একটি পরীক্ষার ফলাফল রিপোর্টার যা JUnit টেক্সট ফলাফল প্রিন্টারে ফলাফল ফরোয়ার্ড করে। ট্রেসসিএমডিকালেক্টর একটি IMetricCollector যা trace-cmd ব্যবহার করে পরীক্ষার সময় ট্রেস সংগ্রহ করে এবং সেগুলিকে ইনভোকেশনে লগ করে। XmlFormattedGeneratorReporter সম্পর্কে স্যুটটি ফরম্যাট করার জন্য FormattedGeneratorReporter বাস্তবায়নের ফলে xml ফরম্যাট তৈরি হয়। XmlResultReporter সম্পর্কে JUnit ফলাফলগুলিকে একটি XML ফাইলে Ant এর XMLJUnitResultFormatter এর সাথে সামঞ্জস্যপূর্ণ ফর্ম্যাটে লেখে।

---

লগ ফাইলগুলি সংরক্ষণ করা হলে ITestInvocationListener ব্যবহারকারীদের শোনার অনুমতি দেয়।

এটি একাধিক ITestInvocationListener কে রিপোর্ট তৈরি করার সময় একই সংরক্ষিত লগ ফাইল ব্যবহার করার অনুমতি দেয় এবং 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) কল করা হবে যখনই ITestLogger.testLog(String, com.android.tradefed.result.LogDataType, com.android.tradefed.result.InputStreamSource) কল করা হবে।

এই ক্লাসটি গ্লোবাল 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) পরীক্ষার লগ সংরক্ষণ করা হলে কল করা হবে।

পাবলিক পদ্ধতি

লগঅ্যাসোসিয়েশন

public void logAssociation (String dataName, 
                LogFile logFile)

কিছু ক্ষেত্রে, log কে অবশ্যই একটি টেস্ট কেসের সাথে দৃঢ়ভাবে যুক্ত করতে হবে, কিন্তু সরাসরি 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

testLogসংরক্ষিত

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

পরীক্ষার লগ সংরক্ষণ করা হলে কল করা হবে।

ITestInvocationListener.testLog(String, LogDataType, InputStreamSource) এর পরিবর্তে ব্যবহার করা উচিত।

পরামিতি
dataName	String : ডেটার একটি String বর্ণনামূলক নাম। যেমন "device_logcat"। দ্রষ্টব্য: dataName প্রতিটি ইনভোকেশনের জন্য অনন্য নাও হতে পারে। অর্থাৎ, বাস্তবায়নকারীদের একই ডেটানাম দিয়ে একাধিক কল পরিচালনা করতে সক্ষম হতে হবে।
dataType	LogDataType : ডেটার LogDataType
dataStream	InputStreamSource : ডেটার InputStreamSource । ইমপ্লিমেন্টারদের ডেটা পড়া শুরু করার জন্য createInputStream কল করা উচিত, এবং সম্পূর্ণ হলে ফলাফল InputStream বন্ধ করার বিষয়টি নিশ্চিত করা উচিত।
logFile	LogFile : সংরক্ষিত ফাইলের মেটা ডেটা ধারণকারী LogFile ।