Pembatas Memori

Android 17 dan yang lebih tinggi menyertakan Pembatas Memori, layanan sistem yang memantau dan membatasi penggunaan memori proses aplikasi menggunakan cgroup v2 Linux. Pembatas Memori mencegah setiap aplikasi menggunakan memori sistem secara tidak proporsional, sehingga mengurangi tekanan memori secara keseluruhan dan mencegah penghentian agresif akibat memori rendah pada proses latar depan dan cache yang penting.

Mekanisme

Pembatas Memori terintegrasi dengan Activity Manager Service (AMS) untuk melacak peristiwa siklus proses dan perubahan status proses. Pembatas Memori menerapkan batas memori menggunakan hierarki cgroup v2 kernel Linux.

Untuk mendukung Pembatas Memori, kernel perangkat harus mengaktifkan cgroup v2 dan pengontrol memory. Layanan ini secara khusus mengandalkan atribut berikut:

memory.high
Batas klaim kembali ringan yang diterapkan ke cgroup UID paket, atau ke cgroup PID proses saat anggaran memori per proses aktif. Nilai defaultnya adalah 90% dari batas memori platform, kecuali jika diperketat oleh anggaran memori. Jika terlampaui, kernel akan membatasi alokasi dan mengklaim kembali halaman dari cgroup tersebut.
memory.max
Batas memori ketat yang diterapkan ke cgroup UID paket sebesar 100% dari batas memori platform. Jika klaim kembali tidak dapat menjaga penggunaan memori di bawah memory.max, kernel akan menghentikan proses kehabisan memori.
memory.swap.max
Membatasi ruang swap maksimum, seperti ZRAM, yang dapat digunakan oleh setiap cgroup PID proses.

Persyaratan cgroup dan kernel

Perangkat yang menjalankan Android 17 (level API 37) dan yang lebih tinggi harus memenuhi persyaratan cgroup v2 dan kernel berikut untuk batas platform, serta untuk anggaran manifes dan MemoryBudgetManager di level API 37.2 dan yang lebih tinggi:

  • Aktivasi cgroup per proses: Pertahankan "NeedsActivation": true di pengontrol memory cgroup v2 di /system/etc/cgroups.json sehingga init awal mengaktifkan +memory sebelum membuat /sys/fs/cgroup/apps/uid_<UID>/pid_<PID> dan /sys/fs/cgroup/system/uid_<UID>/pid_<PID>. Jangan menonaktifkan "NeedsActivation", menetapkan ro.config.per_app_memcg=false, atau menambahkan penggantian cgroups.json vendor yang menonaktifkan cgroup memori per UID atau per proses. Jika /vendor/etc/task_profiles.json mengganti atribut pengontrol memori seperti MemLimit atau MemSoftLimit, pastikan "File" tidak kosong dan sertakan pemetaan "FileV2" ke nama file cgroup v2.

  • Izin file cgroup: File kontrol pid_<PID> per proses dan uid_<UID> induk memory.high, memory.max, dan memory.swap.max di bagian /sys/fs/cgroup/apps dan /sys/fs/cgroup/system harus dapat ditulis oleh system_server di UID atau GID 1000 sehingga batas UID, anggaran proses, dan batas swap berlaku tanpa error EACCES. File memory.current, memory.events, memory.events.local, memory.stat, dan memory.high per UID dan per proses, beserta memory.max dan memory.swap.max per UID, harus dapat dibaca oleh UID aplikasi yang memiliki sehingga kueri MemoryBudgetManager dan pemroses yang melebihi anggaran beroperasi dalam proses.

  • Isolasi PSI lokal: Mengisolasi penundaan klaim kembali memory.high per cgroup dari informasi penundaan tekanan memori (PSI) global dengan menyertakan perubahan PSI memcg lokal GKI dan mempertahankan record_psi=false di hook vendor android_vh_mem_cgroup_handle_over_high mana pun. Tanpa isolasi PSI, throttling memory.high yang dilokalkan akan meningkatkan PSI memori global dan dapat memicu penghentian proses lmkd yang tidak perlu saat memori di seluruh sistem tidak berada di bawah tekanan.

Dampak pada aplikasi

Aplikasi yang beroperasi dalam batas memorinya tidak akan terpengaruh oleh Pembatas Memori.

Saat aplikasi melampaui batas memory.high, kernel akan mengeluarkan memori yang didukung file bersih aplikasi dan menukar memori anonim yang tidak aktif untuk menjaga aplikasi tetap dalam batas. Sebagai akibat dari aktivitas pengosongan dan pertukaran halaman ini, aplikasi mungkin mengalami throttling eksekusi sementara, tetapi terus berjalan.

Dalam situasi ekstrem, seperti kebocoran memori yang tidak terkontrol saat aplikasi terus mengalokasikan memori melebihi memory.max atau setelah ruang swap habis, aplikasi akan gagal mengalokasikan memori dan dihentikan.

Pemantauan proses

Pembatas Memori menerapkan batas platform di halaman ini ke proses aplikasi (UID >= 10000). Proses dengan UID di bawah 10.000 tidak menerima batas platform, begitu juga paket layanan inferensi dalam sandbox di perangkat default (config_defaultOnDeviceSandboxedInferenceService). Aplikasi dan layanan sistem masih dapat mendeklarasikan anggaran memori yang lebih ketat, seperti yang dijelaskan dalam Anggaran memori sistem.

Pembatas Memori menetapkan batas memori berdasarkan status visibilitas proses:

  • Proses yang terlihat: Proses yang menghosting UI yang terlihat oleh pengguna, seperti aktivitas yang difokuskan atau interaksi aktif. Karena menampilkan UI memerlukan set kerja yang lebih besar untuk pipeline rendering dan grafis, proses yang terlihat menerima batas memori yang lebih besar.

  • Proses yang tidak terlihat: Proses yang melakukan pekerjaan di latar belakang tanpa menampilkan UI, seperti layanan latar belakang atau penerima siaran. Karena tidak merender komponen UI, widget ini beroperasi di bawah batas yang lebih ketat.

Tabel berikut memetakan status proses tertentu ke klasifikasi batas memori platform:

Status prosesBatas memori
PERSISTENT Tidak dibatasi
PERSISTENT_UI Tidak dibatasi
TOP visible
BOUND_TOP visible
FOREGROUND_SERVICE not-visible
BOUND_FOREGROUND_SERVICE not-visible
IMPORTANT_FOREGROUND visible
IMPORTANT_BACKGROUND not-visible
TRANSIENT_BACKGROUND not-visible
BACKUP not-visible
SERVICE not-visible
RECEIVER not-visible
TOP_SLEEPING visible
HEAVY_WEIGHT not-visible
HOME not-visible
LAST_ACTIVITY not-visible
CACHED_ACTIVITY not-visible
CACHED_ACTIVITY_CLIENT not-visible
CACHED_RECENT not-visible
CACHED_EMPTY not-visible

Proses PERSISTENT dan PERSISTENT_UI tidak menerima batas platform. Jika salah satu proses ini mendeklarasikan anggaran memori, anggaran latar depannya akan berlaku, seperti yang dijelaskan dalam Bucket anggaran memori.

Dalam status di-cache, proses mempertahankan batas platform not-visible bersama dengan pembekuan dan pemadatan aplikasi yang di-cache, sehingga tetap terikat meskipun pembekuan atau reklamasi maksimal tidak terjadi.

Jika suatu proses melebihi batas memory.high yang ditetapkan, Pembatas Memori akan mendeteksi peristiwa tersebut dan dapat memicu tindakan diagnostik, seperti mengambil profil memori atau mencatat anomali ke statsd.

Bucket anggaran memori

Di level API 37.2 dan yang lebih tinggi, aplikasi dan layanan sistem dapat mendeklarasikan anggaran memori yang lebih ketat daripada batas platform atau menetapkan anggaran runtime yang lebih ketat melalui MemoryBudgetManager. Aplikasi mengonfigurasi anggaran seperti yang dijelaskan dalam Menetapkan anggaran memori aplikasi. Untuk aplikasi dan layanan sistem, lihat Anggaran memori sistem. Anggaran menetapkan memory.high dan tidak boleh melebihi batas platform untuk status proses yang sama, dan anggaran runtime tidak boleh melebihi anggaran manifes yang berlaku.

Saat proses mendeklarasikan anggaran manifes, Pembatas Memori memetakan status prosesnya ke salah satu dari tiga bucket anggaran, sedangkan anggaran runtime menerapkan satu batas atas hingga diperbarui atau dihapus. Nilai android:state manifes foreground, perceptible, dan background menentukan anggaran untuk bucket yang cocok. Proses yang di-cache dalam status CACHED_ACTIVITY hingga CACHED_EMPTY mempertahankan anggaran background bersama dengan pembekuan dan pemadatan aplikasi yang di-cache.

Status prosesBucket anggaran
PERSISTENTLatar depan
PERSISTENT_UILatar depan
TOPLatar depan
BOUND_TOPLatar depan
TOP_SLEEPINGLatar depan
FOREGROUND_SERVICEDapat dipersepsikan
BOUND_FOREGROUND_SERVICEDapat dipersepsikan
IMPORTANT_FOREGROUNDDapat dipersepsikan
IMPORTANT_BACKGROUNDDapat dipersepsikan
TRANSIENT_BACKGROUNDLatar belakang
BACKUPLatar belakang
SERVICELatar belakang
RECEIVERLatar belakang
HEAVY_WEIGHTLatar belakang
HOMELatar belakang
LAST_ACTIVITYLatar belakang
CACHED_ACTIVITYLatar belakang
CACHED_ACTIVITY_CLIENTLatar belakang
CACHED_RECENTLatar belakang
CACHED_EMPTYLatar belakang

Persyaratan penerapan perangkat

Anggaran adalah milik aplikasi. Aplikasi dapat menetapkan, mengubah, atau menghapus anggaran runtime-nya sendiri melalui MemoryBudgetManager, misalnya sebagai respons terhadap konfigurasi jarak jauhnya sendiri, dan aplikasi hanya mengubah anggaran manifes melalui update aplikasi. Implementasi perangkat, termasuk perubahan pada system_server, layanan vendor, dan sinyal dari framework OEM atau aplikasi pendamping, tidak boleh menetapkan, menaikkan, menghapus, atau mengabaikan anggaran runtime atau manifes aplikasi atas nama aplikasi. Hal ini tidak membatasi OEM untuk mendeklarasikan atau mengkalibrasi ulang anggaran dalam manifes aplikasi sistem yang mereka bangun, seperti yang dijelaskan dalam Anggaran memori sistem.

Pasal 8.6 Dokumen Definisi Kompatibilitas Android melarang metode, daftar yang diizinkan, atau kebijakan yang mengabaikan batas memori aplikasi. Build produksi tidak boleh mengirimkan daftar yang diizinkan, penggantian per aplikasi, atau tombol global yang menonaktifkan batas memori platform atau anggaran memori aplikasi.

Konfigurasi

Di Android 17 dan yang lebih tinggi, Pembatas Memori dikonfigurasi menggunakan file konfigurasi platform standar pada partisi sistem di /system/etc/memory-limiter-config.xml.

Format XML

File konfigurasi mengikuti skema yang ditentukan dalam memory-limiter-config.xsd. File ini menentukan beberapa set batas yang diurutkan berdasarkan memori yang tersedia; layanan akan memilih set batas pencocokan tertinggi berdasarkan RAM yang tersedia di perangkat. Semua nilai memori ditentukan dalam mebibyte (MiB).

<MemoryLimiterConfig>
  <version>1</version>
  <configList>
    <!-- RAM boundaries account for MemTotal excluding carve-outs. -->
    <limitSet>
      <!-- Limits for 16GB RAM device [14336, 18432): 10G/5G/5G/5G -->
      <minimumRequiredMemTotal>14336</minimumRequiredMemTotal>
      <maximumAllowedMemTotal>18432</maximumAllowedMemTotal>
      <memVisible>10240</memVisible>
      <memNotVisible>5120</memNotVisible>
      <swapVisible>5120</swapVisible>
      <swapNotVisible>5120</swapNotVisible>
    </limitSet>
    <limitSet>
      <!-- Limits for 12GB RAM device [9216, 14336): 8G/4G/4G/4G -->
      <minimumRequiredMemTotal>9216</minimumRequiredMemTotal>
      <maximumAllowedMemTotal>14336</maximumAllowedMemTotal>
      <memVisible>8192</memVisible>
      <memNotVisible>4096</memNotVisible>
      <swapVisible>4096</swapVisible>
      <swapNotVisible>4096</swapNotVisible>
    </limitSet>
    <limitSet>
      <!-- Limits for 8GB RAM device [6800, 9216): 5G/3G/3G/3G -->
      <minimumRequiredMemTotal>6800</minimumRequiredMemTotal>
      <maximumAllowedMemTotal>9216</maximumAllowedMemTotal>
      <memVisible>5120</memVisible>
      <memNotVisible>3072</memNotVisible>
      <swapVisible>3072</swapVisible>
      <swapNotVisible>3072</swapNotVisible>
    </limitSet>
    <limitSet>
      <!-- Limits for 6GB RAM device [4800, 6800): 4G/2G/2G/2G -->
      <minimumRequiredMemTotal>4800</minimumRequiredMemTotal>
      <maximumAllowedMemTotal>6800</maximumAllowedMemTotal>
      <memVisible>4096</memVisible>
      <memNotVisible>2048</memNotVisible>
      <swapVisible>2048</swapVisible>
      <swapNotVisible>2048</swapNotVisible>
    </limitSet>
    <limitSet>
      <!-- Limits for 4GB RAM device [3200, 4800): 2G/1G/1G/1G -->
      <minimumRequiredMemTotal>3200</minimumRequiredMemTotal>
      <maximumAllowedMemTotal>4800</maximumAllowedMemTotal>
      <memVisible>2048</memVisible>
      <memNotVisible>1024</memNotVisible>
      <swapVisible>1024</swapVisible>
      <swapNotVisible>1024</swapNotVisible>
    </limitSet>
  </configList>
</MemoryLimiterConfig>
version
Bilangan bulat positif yang mengidentifikasi versi konfigurasi. Nilai ini harus berupa 1.
minimumRequiredMemTotal

MemTotal sistem minimum (dalam MiB, batas bawah inklusif) yang diperlukan agar set batas ini berlaku. Layanan ini mengevaluasi hal ini terhadap total memori yang tersedia yang dilaporkan oleh kernel di /proc/meminfo.

Memahami batas dan alokasi memori: Nilai MemTotal kernel mencerminkan DRAM fisik yang dapat diakses oleh sistem operasi setelah alokasi memori hardware dan firmware dikurangi. Carve-out mencadangkan RAM untuk komponen hardware khusus seperti GPU, modem baseband, ISP kamera, lingkungan eksekusi yang aman, dan hypervisor, yang biasanya menggunakan antara 500 MiB dan lebih dari 2 GiB memori fisik.

Karena MemTotal lebih rendah daripada DRAM fisik yang diiklankan perangkat, nilai minimum minimumRequiredMemTotal menyertakan margin untuk carve-out ini. Misalnya, konfigurasi yang menargetkan perangkat 16 GB menentukan batas minimum 14336 (14 GiB), bukan 16384 (16 GiB), dan tingkat untuk perangkat 12 GB menentukan batas minimum 9216 (9 GiB). Hal ini memastikan bahwa setiap perangkat cocok dengan tingkat yang diinginkan, terlepas dari variasi carve-out tingkat board.

maximumAllowedMemTotal

MemTotal sistem maksimum (dalam MiB, batas atas eksklusif) agar set batas ini berlaku. Jika MemTotal lebih besar dari atau sama dengan batas ini, batas yang ditetapkan tidak berlaku. Untuk perangkat dengan MemTotal kurang dari 3.200 MiB atau setidaknya 18.432 MiB, Pembatas Memori tidak menerapkan batas platform default, meskipun cgroup memori per proses tetap aktif (bersama dengan anggaran runtime manifes, sistem, dan MemoryBudgetManager di API level 37.2 dan yang lebih tinggi).

memVisible

Batas memori hard memory.max dalam MiB yang diterapkan ke cgroup UID paket saat paket memiliki proses yang terlihat. Batas reclaim ringan memory.high default adalah 90% dari nilai ini, dibulatkan ke MiB terdekat.

memNotVisible

Batas memori tetap memory.max dalam MiB yang diterapkan ke cgroup UID paket saat paket tidak memiliki proses yang terlihat. Batas reclaim ringan memory.high default adalah 90% dari nilai ini, dibulatkan ke MiB terdekat.

swapVisible

Batas ruang swap memory.swap.max dalam MiB yang diterapkan ke setiap cgroup PID proses yang terlihat.

swapNotVisible

Batas ruang swap memory.swap.max dalam MiB yang diterapkan ke setiap cgroup PID proses yang tidak terlihat.

Batas platform standar

Di Android 17 dan yang lebih baru, platform menentukan batas memori dan swap standar di /system/etc/memory-limiter-config.xml di seluruh tingkat RAM fisik umum menggunakan interval rentang [floor, ceiling):

RAM fisik target Rentang MemTotal [floor, ceiling)
(minimumRequiredMemTotal,
maximumAllowedMemTotal)
Batas memori yang terlihat
(memVisible)
Batas memori tidak terlihat
(memNotVisible)
Batas swap yang terlihat
(swapVisible)
Batas penukaran tidak terlihat
(swapNotVisible)
16 GB [14336, 18432) MiB 10.240 MiB (10 GiB) 5.120 MiB (5 GiB) 5.120 MiB (5 GiB) 5.120 MiB (5 GiB)
12 GB [9216, 14336) MiB 8.192 MiB (8 GiB) 4.096 MiB (4 GiB) 4.096 MiB (4 GiB) 4.096 MiB (4 GiB)
8 GB [6800, 9216) MiB 5.120 MiB (5 GiB) 3.072 MiB (3 GiB) 3.072 MiB (3 GiB) 3.072 MiB (3 GiB)
6 GB [4800, 6800) MiB 4.096 MiB (4 GiB) 2.048 MiB (2 GiB) 2.048 MiB (2 GiB) 2.048 MiB (2 GiB)
4 GB [3200, 4800) MiB 2.048 MiB (2 GiB) 1.024 MiB (1 GiB) 1.024 MiB (1 GiB) 1.024 MiB (1 GiB)

Prinsip batas memori

Konfigurasi Pembatas Memori dirancang berdasarkan prinsip platform berikut:

  • Konsistensi ekosistem dan kompatibilitas aplikasi: Batas memori yang konsisten di seluruh perangkat memastikan performa aplikasi yang dapat diprediksi di seluruh ekosistem Android. Aplikasi dikembangkan dan diuji berdasarkan ekspektasi memori standar; mempertahankan batas platform yang seragam akan menghindari throttling yang tidak terduga atau penghentian dini.

  • Alokasi resource proporsional: Batas platform dikalibrasi sesuai dengan kapasitas RAM fisik:

    • Proses yang terlihat: Mengalokasikan sekitar 1/2 hingga 2/3 dari total RAM fisik untuk mendukung workload UI, komposisi, dan rendering yang aktif.
    • Proses yang tidak terlihat: Mengalokasikan sekitar 1/4 hingga 1/3 dari total RAM fisik untuk tugas latar belakang.
  • Penerapan universal: Batas berlaku secara seragam untuk semua proses aplikasi di perangkat (UID >= 10000), termasuk aplikasi sistem dan OEM bawaan. Selain layanan inferensi dalam sandbox di perangkat default, Pembatas Memori tidak mengecualikan aplikasi individual, sehingga memastikan tata kelola memori yang adil di semua aplikasi. Untuk mengonfigurasi batas bawah perlindungan memory.min yang dapat menyesuaikan sendiri pada daemon interaktif penting dan batas atas memory.high yang lebih ketat dan dikalibrasi workload pada setiap aplikasi dan layanan sistem, lihat Anggaran memori sistem.

  • Anggaran runtime yang dapat diprediksi: Di level API 37.2 dan yang lebih tinggi, aplikasi dapat membuat kueri batas memori dan penggunaan memori cgroup serta menetapkan anggaran runtime yang lebih ketat melalui MemoryBudgetManager. Mempertahankan batas platform dan manifes standar tanpa penggantian vendor akan menjaga perilaku anggaran runtime tetap konsisten di seluruh perangkat.

  • Dinamika reclaim dan swap kernel: Saat proses aplikasi mendekati batas memory.high, kernel Linux mengarahkan reclaim memori secara khusus ke cgroup proses tersebut. Hal ini termasuk menghapus halaman yang didukung file yang tidak aktif dan menukar halaman anonim yang tidak aktif ke ZRAM, sehingga menjaga kelancaran sistem tanpa membebani memori global.

Perintah shell

Perintah am memory-limiter memungkinkan developer dan integrator sistem berinteraksi dengan layanan saat runtime untuk pengembangan, pengujian, dan proses debug:

am memory-limiter <SUB-COMMAND>

status

Subperintah status melaporkan status operasional, batas platform yang dikonfigurasi, dan penghitung pemantauan aktif Pembatas Memori:

adb shell am memory-limiter status

Menjalankan adb shell am memory-limiter status version akan mencetak 2 saat Pembatas Memori dua nilai minimum diaktifkan, atau 0 saat dinonaktifkan.

Berikut adalah contoh output status di perangkat 8 GB:

Memory limiter
  enabled           limits=true       killing=true      ignored=none
  visible:          memHigh=4608MB    memMax=5120MB     swapMax=3072MB
  not-visible:      memHigh=2765MB    memMax=3072MB     swapMax=3072MB
  active=64         uid-started=32    uid-current=28    uid-updated=4
  started=72        watched=72        watch-failed=0
  limiters=64       limiters-hwm=70   red-poll=0        red-limiter=0
  events=0          false-events=0    modify=84

Kolom utama dalam output mencakup:

limits dan killing
Menunjukkan apakah batas memori platform memory.high dan memory.max dikonfigurasi dan diterapkan untuk tingkat RAM perangkat.
ignored
UID yang dikecualikan oleh sub-perintah ignore, all saat pembatasan dijeda secara global, atau none.
visible dan not-visible
Batas UID memHigh default untuk memory.high, batas UID memMax untuk memory.max, dan batas swapMax per proses untuk memory.swap.max yang diterapkan untuk setiap klasifikasi visibilitas.
active
Jumlah pembatas proses dan UID yang dilacak di system_server.
uid-started, uid-current, dan uid-updated
Jumlah kumulatif yang dimulai, jumlah aktif, dan jumlah penggantian kumulatif untuk pembatas UID yang diperbarui dengan anggaran manifes.
watched dan watch-failed
Jumlah kumulatif watch memory.events cgroup yang terdaftar dan gagal.
limiters dan limiters-hwm
Jumlah dan batas maksimum pemantau cgroup native yang aktif.
events dan false-events
Jumlah peristiwa yang melebihi batas yang dikirim ke notifikasi system_server dan memory.events yang tidak melewati batas yang dipantau.

ignore

Subperintah ignore mengecualikan sementara UID tertentu atau semua proses dari pembatasan memori. Hal ini berguna untuk tolok ukur performa, pengujian stres, kalibrasi anggaran memori aplikasi otomatis, atau mendiagnosis perilaku memori:

# Ignore a specific UID
adb shell am memory-limiter ignore 10087
# Ignore all processes (temporarily disables limiting)
adb shell am memory-limiter ignore all
# Resume normal limiting operation
adb shell am memory-limiter ignore none

manual

Subperintah manual mengganti batas memory.high, memory.max, dan memory.swap.max yang dihitung dengan batas bilangan bulat kustom hingga batas yang dikonfigurasi target. Teruskan PID, dengan atau tanpa -p, untuk menargetkan satu proses, atau teruskan -u <UID> untuk menargetkan semua proses dalam UID paket. Tentukan ukuran dalam byte, tambahkan MB untuk MiB atau GB untuk GiB, atau teruskan none untuk menghapus penggantian. Untuk kompatibilitas mundur, bilangan bulat tanpa akhiran di bawah 20 ditafsirkan sebagai MiB:

# Set a 1 GiB limit for PID 1234, with or without -p
adb shell am memory-limiter manual 1234 1073741824
adb shell am memory-limiter manual 1234 1024MB
adb shell am memory-limiter manual -p 1234 1GB
# Set a 1 GiB limit for all processes in UID 10087
adb shell am memory-limiter manual -u 10087 1GB
# Remove the manual override for PID 1234 or UID 10087
adb shell am memory-limiter manual 1234 none
adb shell am memory-limiter manual -u 10087 none

Penggantian proses manual hanya berlaku selama masa aktif instance proses tertentu tersebut. Jika proses dimulai ulang, proses tersebut akan kembali ke batas standar berdasarkan statusnya. Sebaliknya, penggantian manual -u <UID> akan tetap ada selama UID tetap aktif, hingga semua proses di UID keluar atau Anda menghapus penggantian dengan none.

Penggantian manual tidak boleh melebihi batas sistem fisik.