মনিটর সিস্টেম স্বাস্থ্য

ওয়াচডগ বিক্রেতা পরিষেবা এবং VHAL পরিষেবার স্বাস্থ্য পর্যবেক্ষণ করে এবং যে কোনও অস্বাস্থ্যকর প্রক্রিয়া বন্ধ করে। যখন একটি অস্বাস্থ্যকর প্রক্রিয়া বন্ধ করা হয়, তখন ওয়াচডগ অন্যান্য অ্যাপ্লিকেশন নট রেসপন্ডিং (ANR) ডাম্পের মতো প্রক্রিয়ার অবস্থা /data/anr এ ডাম্প করে। এটি ডিবাগিং প্রক্রিয়াটিকে সহজতর করে।

বিক্রেতা সেবা স্বাস্থ্য পর্যবেক্ষণ

বিক্রেতা পরিষেবাগুলি নেটিভ এবং জাভা উভয় দিকেই পর্যবেক্ষণ করা হয়। একটি বিক্রেতা পরিষেবা নিরীক্ষণের জন্য, পরিষেবাটিকে অবশ্যই একটি পূর্ব-নির্ধারিত সময়সীমা নির্দিষ্ট করে ওয়াচডগের সাথে একটি স্বাস্থ্য পরীক্ষা প্রক্রিয়া নিবন্ধন করতে হবে। ওয়াচডগ রেজিস্ট্রেশনের সময় নির্দিষ্ট সময়সীমার সাথে সম্পর্কিত একটি বিরতিতে পিং করে একটি নিবন্ধিত স্বাস্থ্য পরীক্ষা প্রক্রিয়ার স্বাস্থ্য পর্যবেক্ষণ করে। যখন একটি পিংড প্রক্রিয়া সময়সীমার মধ্যে সাড়া দেয় না, তখন প্রক্রিয়াটিকে অস্বাস্থ্যকর বলে মনে করা হয়।

স্থানীয় সেবা স্বাস্থ্য পর্যবেক্ষণ

ওয়াচডগ এআইডিএল মেকফাইল উল্লেখ করুন

  1. shared_libs carwatchdog_aidl_interface-ndk_platform অন্তর্ভুক্ত করুন।

    Android.bp

    cc_binary {
        name: "sample_native_client",
        srcs: [
            "src/*.cpp"
        ],
        shared_libs: [
            "carwatchdog_aidl_interface-ndk_platform",
            "libbinder_ndk",
        ],
        vendor: true,
    }
    

একটি SELinux নীতি যোগ করুন

  1. একটি SELinux নীতি যোগ করতে, বিক্রেতা পরিষেবা ডোমেনকে বাইন্ডার ব্যবহার করার অনুমতি দিন ( binder_use macro) এবং carwatchdog ক্লায়েন্ট ডোমেনে ( carwatchdog_client_domain ম্যাক্রো) বিক্রেতা পরিষেবা ডোমেন যোগ করুন। sample_client.te এবং file_contexts এর জন্য নিচের কোডটি দেখুন:

    sample_client.te

    type sample_client, domain;
    type sample_client_exec, exec_type, file_type, vendor_file_type;
    
    carwatchdog_client_domain(sample_client)
    
    init_daemon_domain(sample_client)
    binder_use(sample_client)
    

    file_contexts

    /vendor/bin/sample_native_client  u:object_r:sample_client_exec:s0
    

BnCarWatchdogClient উত্তরাধিকারসূত্রে পেয়ে একটি ক্লায়েন্ট ক্লাস বাস্তবায়ন করুন

  1. checkIfAlive এ, স্বাস্থ্য পরীক্ষা করুন। একটি বিকল্প হল থ্রেড লুপ হ্যান্ডলারে পোস্ট করা। সুস্থ থাকলে ICarWatchdog::tellClientAlive কল করুন। SampleNativeClient.h এবং SampleNativeClient.cpp এর জন্য নীচের কোডটি দেখুন:

    SampleNativeClient.h

    class SampleNativeClient : public BnCarWatchdogClient {
    public:
        ndk::ScopedAStatus checkIfAlive(int32_t sessionId, TimeoutLength
            timeout) override;
        ndk::ScopedAStatus prepareProcessTermination() override;
        void initialize();
    
    private:
        void respondToDaemon();
    private:
        ::android::sp<::android::Looper> mHandlerLooper;
        std::shared_ptr<ICarWatchdog> mWatchdogServer;
        std::shared_ptr<ICarWatchdogClient> mClient;
        int32_t mSessionId;
    };
    

    SampleNativeClient.cpp

    ndk::ScopedAStatus WatchdogClient::checkIfAlive(int32_t sessionId, TimeoutLength timeout) {
        mHandlerLooper->removeMessages(mMessageHandler,
            WHAT_CHECK_ALIVE);
        mSessionId = sessionId;
        mHandlerLooper->sendMessage(mMessageHandler,
            Message(WHAT_CHECK_ALIVE));
        return ndk::ScopedAStatus::ok();
    }
    // WHAT_CHECK_ALIVE triggers respondToDaemon from thread handler
    void WatchdogClient::respondToDaemon() {
      // your health checking method here
      ndk::ScopedAStatus status = mWatchdogServer->tellClientAlive(mClient,
            mSessionId);
    }
    

একটি বাইন্ডার থ্রেড শুরু করুন এবং ক্লায়েন্ট নিবন্ধন করুন

গাড়ির ওয়াচডগ ডেমন ইন্টারফেসের নাম হল android.automotive.watchdog.ICarWatchdog/default

  1. নাম দিয়ে ডেমন খুঁজুন এবং ICarWatchdog::registerClient কল করুন। main.cpp এবং SampleNativeClient.cpp এর জন্য নীচের কোডটি দেখুন:

    main.cpp

    int main(int argc, char** argv) {
        sp<Looper> looper(Looper::prepare(/*opts=*/0));
    
        ABinderProcess_setThreadPoolMaxThreadCount(1);
        ABinderProcess_startThreadPool();
        std::shared_ptr<SampleNativeClient> client =
            ndk::SharedRefBase::make<SampleNatvieClient>(looper);
    
        // The client is registered in initialize()
        client->initialize();
        ...
    }
    

    SampleNativeClient.cpp

    void SampleNativeClient::initialize() {
        ndk::SpAIBinder binder(AServiceManager_getService(
            "android.automotive.watchdog.ICarWatchdog/default"));
        std::shared_ptr<ICarWatchdog> server =
            ICarWatchdog::fromBinder(binder);
        mWatchdogServer = server;
        ndk::SpAIBinder binder = this->asBinder();
        std::shared_ptr<ICarWatchdogClient> client =
            ICarWatchdogClient::fromBinder(binder)
        mClient = client;
        server->registerClient(client, TimeoutLength::TIMEOUT_NORMAL);
    }
    

জাভা পরিষেবা স্বাস্থ্য পর্যবেক্ষণ

CarWatchdogClientCallback উত্তরাধিকারসূত্রে একটি ক্লায়েন্ট বাস্তবায়ন করুন

  1. নতুন ফাইলটি নিম্নরূপ সম্পাদনা করুন:
    private final CarWatchdogClientCallback mClientCallback = new CarWatchdogClientCallback() {
        @Override
        public boolean onCheckHealthStatus(int sessionId, int timeout) {
            // Your health check logic here
            // Returning true implies the client is healthy
            // If false is returned, the client should call
            // CarWatchdogManager.tellClientAlive after health check is
            // completed
        }
    
        @Override
        public void onPrepareProcessTermination() {}
    };
    

ক্লায়েন্ট নিবন্ধন

  1. CarWatchdogManager.registerClient() কল করুন :
    private void startClient() {
        CarWatchdogManager manager =
            (CarWatchdogManager) car.getCarManager(
            Car.CAR_WATCHDOG_SERVICE);
        // Choose a proper executor according to your health check method
        ExecutorService executor = Executors.newFixedThreadPool(1);
        manager.registerClient(executor, mClientCallback,
            CarWatchdogManager.TIMEOUT_NORMAL);
    }
    

ক্লায়েন্ট নিবন্ধনমুক্ত করুন

  1. পরিষেবাটি শেষ হলে CarWatchdogManager.unregisterClient() কে কল করুন:
    private void finishClient() {
        CarWatchdogManager manager =
            (CarWatchdogManager) car.getCarManager(
            Car.CAR_WATCHDOG_SERVICE);
        manager.unregisterClient(mClientCallback);
    }
    

VHAL স্বাস্থ্য পর্যবেক্ষণ

বিক্রেতা পরিষেবা স্বাস্থ্য পর্যবেক্ষণের বিপরীতে, ওয়াচডগ VHAL_HEARTBEAT যানবাহনের সম্পত্তিতে সদস্যতা নিয়ে VHAL পরিষেবা স্বাস্থ্য পর্যবেক্ষণ করে। ওয়াচডগ আশা করে যে এই সম্পত্তির মান প্রতি N সেকেন্ডে একবার আপডেট করা হবে। এই সময়সীমার মধ্যে হার্টবিট আপডেট না হলে, ওয়াচডগ VHAL পরিষেবা বন্ধ করে দেয়।

দ্রষ্টব্য: ওয়াচডগ শুধুমাত্র VHAL পরিষেবার স্বাস্থ্য পর্যবেক্ষণ করে যখন VHAL_HEARTBEAT গাড়ির সম্পত্তি VHAL পরিষেবা দ্বারা সমর্থিত হয়।

VHAL অভ্যন্তরীণ বাস্তবায়ন বিক্রেতা দ্বারা বিক্রেতা পরিবর্তিত হতে পারে. নিম্নলিখিত কোড নমুনা রেফারেন্স হিসাবে ব্যবহার করা যেতে পারে.

  1. VHAL_HEARTBEAT গাড়ির সম্পত্তি নিবন্ধন করুন।

    VHAL পরিষেবা শুরু করার সময়, VHAL_HEARTBEAT গাড়ির সম্পত্তি নিবন্ধন করুন। নীচের উদাহরণে, একটি unordered_map , যা কনফিগারে প্রপার্টি আইডি ম্যাপ করে সমস্ত সমর্থিত কনফিগগুলি ধরে রাখতে ব্যবহৃত হয়। VHAL_HEARTBEAT এর জন্য কনফিগ মানচিত্রে যোগ করা হয়েছে, যাতে VHAL_HEARTBEAT জিজ্ঞাসা করা হলে, সংশ্লিষ্ট কনফিগারটি ফেরত দেওয়া হয়।

    void registerVhalHeartbeatProperty() {
            const VehiclePropConfig config = {
                    .prop = toInt(VehicleProperty::VHAL_HEARTBEAT),
                    .access = VehiclePropertyAccess::READ,
                    .changeMode = VehiclePropertyChangeMode::ON_CHANGE,
            };
           // mConfigsById is declared as std::unordered_map<int32_t, VehiclePropConfig>.
           mConfigsById[config.prop] = config;
    }
    
  2. VHAL_HEARTBEAT গাড়ির সম্পত্তি আপডেট করুন।

    VHAL হেলথ চেক ফ্রিকোয়েন্সির উপর ভিত্তি করে ( VHAL হেলথ চেকের ফ্রিকোয়েন্সি সংজ্ঞায়িত করুন" এ ব্যাখ্যা করা হয়েছে), প্রতি N সেকেন্ডে একবার VHAL_HEARTBEAT গাড়ির সম্পত্তি আপডেট করুন। এটি করার একটি উপায় হল RecurrentTimer ব্যবহার করে সেই অ্যাকশনটি কল করা যা VHAL স্বাস্থ্য পরীক্ষা করে এবং সময়সীমার মধ্যে VHAL_HEARTBEAT গাড়ির সম্পত্তি আপডেট করে।

    নীচে RecurrentTimer ব্যবহার করে একটি নমুনা বাস্তবায়ন দেখানো হয়েছে:

    int main(int argc, char** argv) {
            RecurrentTimer recurrentTimer(updateVhalHeartbeat);
            recurrentTimer.registerRecurrentEvent(kHeartBeatIntervalNs,
                                               static_cast<int32_t>(VehicleProperty::VHAL_HEARTBEAT));
            … Run service …
            recurrentTimer.unregisterRecurrentEvent(
                    static_cast<int32_t>(VehicleProperty::VHAL_HEARTBEAT));
    }
    
    void updateVhalHeartbeat(const std::vector<int32_t>& cookies) {
           for (int32_t property : cookies) {
                  if (property != static_cast<int32_t>(VehicleProperty::VHAL_HEARTBEAT)) {
                         continue;
                  }
    
                  // Perform internal health checking such as retrieving a vehicle property to ensure
                  // the service is responsive.
                  doHealthCheck();
    
                  // Construct the VHAL_HEARTBEAT property with system uptime.
                  VehiclePropValuePool valuePool;
                  VehicleHal::VehiclePropValuePtr propValuePtr = valuePool.obtainInt64(uptimeMillis());
                  propValuePtr->prop = static_cast<int32_t>(VehicleProperty::VHAL_HEARTBEAT);
                  propValuePtr->areaId = 0;
                  propValuePtr->status = VehiclePropertyStatus::AVAILABLE;
                  propValuePtr->timestamp = elapsedRealtimeNano();
    
                  // Propagate the HAL event.
                  onHalEvent(std::move(propValuePtr));
           }
    }
    
  3. ( ঐচ্ছিক ) VHAL স্বাস্থ্য পরীক্ষার ফ্রিকোয়েন্সি সংজ্ঞায়িত করুন।

    ওয়াচডগের ro.carwatchdog.vhal_healthcheck.interval শুধুমাত্র পঠনযোগ্য পণ্য বৈশিষ্ট্য VHAL স্বাস্থ্য পরীক্ষার ফ্রিকোয়েন্সি সংজ্ঞায়িত করে। ডিফল্ট স্বাস্থ্য পরীক্ষার ফ্রিকোয়েন্সি (যখন এই সম্পত্তি সংজ্ঞায়িত করা হয় না) তিন (3) সেকেন্ড। যদি VHAL পরিষেবার জন্য VHAL_HEARTBEAT গাড়ির বৈশিষ্ট্য আপডেট করার জন্য তিন (3) সেকেন্ড পর্যাপ্ত না হয়, তাহলে পরিষেবার প্রতিক্রিয়াশীলতার উপর নির্ভর করে VHAL স্বাস্থ্য পরীক্ষার ফ্রিকোয়েন্সি সংজ্ঞায়িত করুন।

ওয়াচডগ দ্বারা বন্ধ অস্বাস্থ্যকর প্রক্রিয়া ডিবাগ

ওয়াচডগ প্রক্রিয়া অবস্থা ডাম্প করে এবং অস্বাস্থ্যকর প্রক্রিয়া বন্ধ করে। একটি অস্বাস্থ্যকর প্রক্রিয়া বন্ধ করার সময়, ওয়াচডগ টেক্সট carwatchdog terminated <process name> (pid:<process id>) লগক্যাটে লগ করে। এই লগ লাইনটি প্রক্রিয়ার নাম এবং প্রক্রিয়া আইডির মতো সমাপ্ত প্রক্রিয়া সম্পর্কে তথ্য সরবরাহ করে।

  1. $ adb logcat -s CarServiceHelper | fgrep "carwatchdog killed"
    
    চালিয়ে লগক্যাটটি পূর্বোক্ত পাঠ্যের জন্য অনুসন্ধান করা যেতে পারে

    উদাহরণ স্বরূপ, যখন KitchenSink অ্যাপটি একটি নিবন্ধিত ওয়াচডগ ক্লায়েন্ট এবং ওয়াচডগ পিং-এর প্রতি প্রতিক্রিয়াহীন হয়ে পড়ে, তখন ওয়াচডগ নিবন্ধিত কিচেনসিঙ্ক প্রক্রিয়াটি বন্ধ করার সময় নিচের লাইনের মতো একটি লাইন লগ করে।

    05-01 09:50:19.683   578  5777 W CarServiceHelper: carwatchdog killed com.google.android.car.kitchensink (pid: 5574)
    
  2. প্রতিক্রিয়াহীনতার মূল কারণ শনাক্ত করতে, /data/anr এ সংরক্ষিত প্রসেস ডাম্পটি ব্যবহার করুন যেভাবে আপনি অ্যাক্টিভিটি ANR ক্ষেত্রে ব্যবহার করবেন। সমাপ্ত প্রক্রিয়ার জন্য ডাম্প ফাইল পুনরুদ্ধার করতে নীচের কমান্ডগুলি ব্যবহার করুন।
    $ adb root
    $ adb shell grep -Hn "pid process_pid" /data/anr/*
    

    নিম্নলিখিত নমুনা আউটপুট কিচেনসিঙ্ক অ্যাপের জন্য নির্দিষ্ট:

    $ adb shell su root grep -Hn "pid 5574" /data/anr/*.
    
    /data/anr/anr_2020-05-01-09-50-18-290:3:----- pid 5574 at 2020-05-01 09:50:18 -----
    /data/anr/anr_2020-05-01-09-50-18-290:285:----- Waiting Channels: pid 5574 at 2020-05-01 09:50:18 -----
    

    সমাপ্ত কিচেনসিঙ্ক প্রক্রিয়ার ডাম্প ফাইলটি /data/anr/anr_2020-05-01-09-50-18-290 এ অবস্থিত। সমাপ্ত প্রক্রিয়ার ANR ডাম্প ফাইল ব্যবহার করে আপনার বিশ্লেষণ শুরু করুন।