সিস্টেম স্বাস্থ্য নিরীক্ষণ

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

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

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

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

ওয়াচডগ AIDL মেকফাইল নির্দিষ্ট করুন

  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 ম্যাক্রো) এবং ভেন্ডর সার্ভিস ডোমেইনটিকে 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 পরিষেবাটি VHAL_HEARTBEAT নামক যানবাহন বৈশিষ্ট্যটি সমর্থন করে।

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 হেলথ চেকের ফ্রিকোয়েন্সি নির্ধারণ করে। ডিফল্ট হেলথ চেক ফ্রিকোয়েন্সি (যখন এই প্রপার্টিটি সংজ্ঞায়িত করা থাকে না) হলো তিন সেকেন্ড। যদি VHAL সার্ভিসের VHAL_HEARTBEAT ভেহিকল প্রপার্টি আপডেট করার জন্য তিন সেকেন্ড যথেষ্ট না হয়, তবে সার্ভিসের রেসপন্সিভনেসের উপর নির্ভর করে VHAL হেলথ চেক ফ্রিকোয়েন্সি নির্ধারণ করুন।

ওয়াচডগ দ্বারা বন্ধ করা অস্বাস্থ্যকর প্রসেসগুলো ডিবাগ করুন।

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

  1. নিম্নলিখিত কমান্ডটি চালিয়ে লগক্যাটে পূর্বোক্ত লেখাটি খোঁজা যেতে পারে:
    $ adb logcat -s CarServiceHelper | fgrep "carwatchdog killed"

    উদাহরণস্বরূপ, যখন KitchenSink অ্যাপটি একটি নিবন্ধিত Watchdog ক্লায়েন্ট হয় এবং Watchdog পিং-এর প্রতি সাড়া দেওয়া বন্ধ করে দেয়, তখন Watchdog নিবন্ধিত 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/*

    নিম্নলিখিত নমুনা আউটপুটটি শুধুমাত্র KitchenSink অ্যাপের জন্য প্রযোজ্য: 

    $ 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 -----

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