Sistem sağlığını izleme

Watchdog, tedarikçi hizmetlerinin ve VHAL hizmetinin durumunu izler ve ve sağlıksız her türlü süreci sonlandırır. Sağlıklı olmayan bir işlem sonlandırıldığında Watchdog, diğer Uygulama Yanıt Vermiyor (ANR) dökümlerinde olduğu gibi işlem durumunu /data/anr olarak kaydeder. Bu sayede hata ayıklama işlemi kolaylaşır.

Tedarikçi firma hizmetinin sağlık durumunu izleme

Tedarikçi hizmetleri hem yerel hem de Java tarafında izlenir. Tedarikçi Firma İçin hizmetin bir durum denetimi süreci kaydetmesi gerekir. önceden tanımlanmış bir zaman aşımı belirleyerek ileterek. Denetçi kayıtlı bir durum denetimi işleminin belirli aralıklarla pingleyerek durumu %100'lük bir sınır olmalıdır. Pinglenen bir işlem, zaman aşımı süresi içinde yanıt vermezse sorunlu kabul edilir.

Yerel hizmet durumu izleme

Watchdog AIDL make dosyasını belirtin

  1. carwatchdog_aidl_interface-ndk_platform öğesini shared_libs öğesine dahil edin.

    Android.bp

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

SELinux politikası ekleme

  1. SELinux politikası eklemek için tedarikçi firma hizmet alanının binder'ı (binder_use makrosu) kullanmasına izin verin ve tedarikçi firma hizmet alanını carwatchdog istemci alanına (carwatchdog_client_domain makrosu) ekleyin. sample_client.te ve file_contexts için aşağıdaki koda bakın:

    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'ı devralarak bir istemci sınıfı uygulama

  1. checkIfAlive alanında bir durum denetimi gerçekleştirin. Bir seçenek, ileti dizisi döngüsü işleyicisine yayın göndermektir. Sağlık durumu iyiyse ICarWatchdog::tellClientAlive numaralı telefonu arayın. SampleNativeClient.h ve SampleNativeClient.cpp için aşağıdaki kodu inceleyin:

    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);
}

Bağlayıcı iş parçacığı başlatın ve istemciyi kaydedin

Araba güvenlik zamanlayıcısı arka plan arayüzü adı: android.automotive.watchdog.ICarWatchdog/default

  1. Ada sahip arka plan programını arayın ve ICarWatchdog::registerClient çağrısı yapın. main.cpp ve SampleNativeClient.cpp için aşağıdaki koda bakın:

    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);
}

Java hizmet durumu izleme

CarWatchdogClientCallback'ı devralarak istemci uygulama

  1. Yeni dosyayı aşağıdaki gibi düzenleyin: 
    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() {}
};

İstemciyi kaydetme

  1. CarWatchdogManager.registerClient() numaralı telefonu arayın: 
    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);
}

İstemcinin kaydını iptal et

  1. Hizmet tamamlandığında CarWatchdogManager.unregisterClient() adlı kişiyi çağırın: 
    private void finishClient() {
    CarWatchdogManager manager =
        (CarWatchdogManager) car.getCarManager(
        Car.CAR_WATCHDOG_SERVICE);
    manager.unregisterClient(mClientCallback);
}

VHAL durum izleme

Watchdog, tedarikçi hizmet durumu izlemeden farklı olarak VHAL hizmetini izler VHAL_HEARTBEAT araç özelliğine abone olarak sağlığınızı koruyabilirsiniz. Gözetmen, bu özelliğin değerinin N saniyede bir güncellenmesini bekler. Sinyal bu zaman aşımı süresi içinde güncellenmezse Watchdog VHAL'yi sonlandırır geliştirmenizi sağlar.

Not: Watchdog, VHAL hizmet durumunu yalnızca aşağıdaki durumlarda izler: VHAL_HEARTBEAT araç özelliği, VHAL hizmeti tarafından destekleniyor.

VHAL'ın dahili uygulaması tedarikçiye göre değişiklik gösterebilir. Referans olarak aşağıdaki kod örneklerini kullanın.

  1. VHAL_HEARTBEAT araç mülkünü kaydedin.

    VHAL hizmetini başlatırken VHAL_HEARTBEAT araç mülkünü kaydedin. Aşağıdaki örnekte, mülk kimliğini yapılandırma ile eşleyen unordered_map desteklenen tüm yapılandırmaları içerir. VHAL_HEARTBEAT için yapılandırma haritaya eklenir. Böylece, VHAL_HEARTBEAT sorgulandığında ilgili yapılandırma döndürülür.

    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 araç özelliğini güncelleyin.

    VHAL durum denetimi sıklığına göre (VHAL durum denetimi sıklığını tanımlama bölümünde açıklanmıştır) VHAL_HEARTBEAT araç mülkünü N saniyede bir güncelleyin. Bunu yapmanın bir yolu, işlemi çağırmak için RecurrentTimer kullanmaktır VHAL durumunu kontrol eden ve VHAL_HEARTBEAT aracını güncelleyen özelliğini zaman aşımına uğradı.

    Aşağıda, RecurrentTimer kullanılan örnek bir uygulama verilmiştir:

    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. (İsteğe bağlı) VHAL durum denetiminin sıklığını tanımlayın.

    Watchdog'un ro.carwatchdog.vhal_healthcheck.interval salt okunur ürün özelliği, VHAL sağlık kontrolü sıklığını tanımlar. Varsayılan durum denetimi sıklığı (bu özellik tanımlanmadığında) üç saniyedir. Üç saniye VHAL hizmetinin VHAL_HEARTBEAT araç özelliğini güncellemesi için yeterlidir. hizmet yanıt verme hızına bağlı olarak VHAL durum denetimi sıklığını tanımlar.

Watchdog tarafından sonlandırılan, durumu iyi olmayan işlemlerde hata ayıklama

Güvenlik zamanlayıcısı, işlem durumunu döküm haline getirir ve sağlıksız işlemleri sonlandırır. Sonlandırılırken durumu kötü bir işlemse Watchdog, carwatchdog terminated <process name> (pid:<process id>) metnini logcat'e kaydeder. Bu günlük satırı sonlandırılan süreç hakkında bilgi (ör. işlem adı, işlem adı) sağlar. Kimlik.

  1. Yukarıda bahsedilen metin için logcat şu çalıştırılarak aranabilir: 
    $ adb logcat -s CarServiceHelper | fgrep "carwatchdog killed"

    Örneğin, KitchenSink uygulaması kayıtlı bir Watchdog istemcisi olduğunda ve Watchdog ping'lerine yanıt vermediğinde Watchdog, kayıtlı KitchenSink sürecini sonlandırırken aşağıdaki satıra benzer bir satır kaydeder.

    05-01 09:50:19.683   578  5777 W CarServiceHelper: carwatchdog killed com.google.android.car.kitchensink (pid: 5574)
  2. Yanıt vermeme sorununun temel nedenini belirlemek için /data/anr adresinde depolanan işlem dökümünü, etkinlik ANR durumları için kullanacağınız gibi kullanın. Sonlandırılan işlemin döküm dosyasını almak için aşağıdaki komutları kullanın. 
    $ adb root
$ adb shell grep -Hn "pid process_pid" /data/anr/*

    Aşağıdaki örnek çıkış, KitchenSink uygulamasına özeldir:

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

    Sonlandırılan KitchenSink işleminin dökümü dosyası /data/anr/anr_2020-05-01-09-50-18-290 adresinde bulunmaktadır. Analizinize sonlandırılmış işlemin ANR döküm dosyası.