BatchUsageLogEvents

Log peristiwa yang dikelompokkan dari events dari perangkat.

Representasi JSON
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
Kolom
device

string

Jika ada, nama perangkat dalam bentuk 'enterprises/{enterpriseId}/devices/{deviceId}’

user

string

Jika ada, nama resource pengguna yang memiliki perangkat ini dalam bentuk 'enterprises/{enterpriseId}/users/{userId}'.

retrievalTime

string (Timestamp format)

Stempel waktu perangkat saat batch peristiwa dikumpulkan dari perangkat.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

usageLogEvents[]

object (UsageLogEvent)

Daftar UsageLogEvent yang dilaporkan oleh perangkat, diurutkan secara kronologis berdasarkan waktu peristiwa.

UsageLogEvent

Peristiwa yang dicatat dalam log di perangkat.

Representasi JSON
{
  "eventId": string,
  "eventTime": string,
  "eventType": enum (EventType),

  // Union field event can be only one of the following:
  "adbShellCommandEvent": {
    object (AdbShellCommandEvent)
  },
  "adbShellInteractiveEvent": {
    object (AdbShellInteractiveEvent)
  },
  "appProcessStartEvent": {
    object (AppProcessStartEvent)
  },
  "keyguardDismissedEvent": {
    object (KeyguardDismissedEvent)
  },
  "keyguardDismissAuthAttemptEvent": {
    object (KeyguardDismissAuthAttemptEvent)
  },
  "keyguardSecuredEvent": {
    object (KeyguardSecuredEvent)
  },
  "filePulledEvent": {
    object (FilePulledEvent)
  },
  "filePushedEvent": {
    object (FilePushedEvent)
  },
  "certAuthorityInstalledEvent": {
    object (CertAuthorityInstalledEvent)
  },
  "certAuthorityRemovedEvent": {
    object (CertAuthorityRemovedEvent)
  },
  "certValidationFailureEvent": {
    object (CertValidationFailureEvent)
  },
  "cryptoSelfTestCompletedEvent": {
    object (CryptoSelfTestCompletedEvent)
  },
  "keyDestructionEvent": {
    object (KeyDestructionEvent)
  },
  "keyGeneratedEvent": {
    object (KeyGeneratedEvent)
  },
  "keyImportEvent": {
    object (KeyImportEvent)
  },
  "keyIntegrityViolationEvent": {
    object (KeyIntegrityViolationEvent)
  },
  "loggingStartedEvent": {
    object (LoggingStartedEvent)
  },
  "loggingStoppedEvent": {
    object (LoggingStoppedEvent)
  },
  "logBufferSizeCriticalEvent": {
    object (LogBufferSizeCriticalEvent)
  },
  "mediaMountEvent": {
    object (MediaMountEvent)
  },
  "mediaUnmountEvent": {
    object (MediaUnmountEvent)
  },
  "osShutdownEvent": {
    object (OsShutdownEvent)
  },
  "osStartupEvent": {
    object (OsStartupEvent)
  },
  "remoteLockEvent": {
    object (RemoteLockEvent)
  },
  "wipeFailureEvent": {
    object (WipeFailureEvent)
  },
  "connectEvent": {
    object (ConnectEvent)
  },
  "dnsEvent": {
    object (DnsEvent)
  },
  "stopLostModeUserAttemptEvent": {
    object (StopLostModeUserAttemptEvent)
  },
  "lostModeOutgoingPhoneCallEvent": {
    object (LostModeOutgoingPhoneCallEvent)
  },
  "lostModeLocationEvent": {
    object (LostModeLocationEvent)
  },
  "enrollmentCompleteEvent": {
    object (EnrollmentCompleteEvent)
  },
  "backupServiceToggledEvent": {
    object (BackupServiceToggledEvent)
  }
  // End of list of possible types for union field event.
}
Kolom
eventId

string (int64 format)

ID unik peristiwa.

eventTime

string (Timestamp format)

Stempel waktu perangkat saat peristiwa dicatat.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

eventType

enum (EventType)

Jenis peristiwa log penggunaan tertentu yang dilaporkan di perangkat. Gunakan ini untuk menentukan kolom event mana yang akan diakses.

Kolom union event. Jenis peristiwa yang dicatat di perangkat. Lihat setiap jenis peristiwa untuk mengetahui detail selengkapnya tentang kapan peristiwa dikirim dan batasan kapan peristiwa dicatat dalam log serta kolom apa yang disertakan. event hanya dapat berupa salah satu dari berikut:
adbShellCommandEvent

object (AdbShellCommandEvent)

Perintah shell dikeluarkan melalui ADB melalui “adb shell command”. Bagian dari SECURITY_LOGS.

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Shell interaktif ADB dibuka melalui “adb shell”. Bagian dari SECURITY_LOGS.

appProcessStartEvent

object (AppProcessStartEvent)

Proses aplikasi dimulai. Bagian dari SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

Penjaga kunci ditutup. Bagian dari SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

Upaya dilakukan untuk membuka kunci perangkat. Bagian dari SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

Perangkat dikunci oleh pengguna atau karena waktu tunggu habis. Bagian dari SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

File didownload dari perangkat. Bagian dari SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

File diupload ke perangkat. Bagian dari SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Sertifikat root baru diinstal ke penyimpanan kredensial tepercaya sistem. Bagian dari SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Root certificate dihapus dari penyimpanan kredensial tepercaya sistem. Bagian dari SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Validasi sertifikat X.509v3 gagal. Saat ini, validasi ini dilakukan di titik akses Wi-Fi dan kegagalan mungkin disebabkan oleh ketidakcocokan saat validasi sertifikat server. Namun, pada masa mendatang, peristiwa ini dapat mencakup peristiwa validasi lainnya dari sertifikat X.509v3. Bagian dari SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Memvalidasi apakah library kriptografi bawaan Android (BoringSSL) valid. Harus selalu berhasil saat booting perangkat. Jika gagal, perangkat harus dianggap tidak tepercaya. Bagian dari SECURITY_LOGS.

keyDestructionEvent

object (KeyDestructionEvent)

Kunci kriptografi, termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem, dihapus dari perangkat oleh pengguna atau pengelolaan. Bagian dari SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Kunci kriptografis termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem diinstal di perangkat oleh pengguna atau pengelolaan. Bagian dari SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Kunci kriptografis termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem diimpor di perangkat oleh pengguna atau pengelolaan. Bagian dari SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Kunci kriptografi, termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem, dianggap rusak karena kerusakan penyimpanan, kegagalan hardware, atau masalah OS tertentu. Bagian dari SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

Kebijakan usageLog telah diaktifkan. Bagian dari SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

Kebijakan usageLog telah dinonaktifkan. Bagian dari SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Buffer log audit telah mencapai 90% kapasitasnya, sehingga peristiwa yang lebih lama mungkin dihapus. Bagian dari SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

Media yang dapat dilepas telah dipasang. Bagian dari SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

Media yang dapat dilepas telah di-unmount. Bagian dari SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Perangkat dimatikan. Bagian dari SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Perangkat telah dimulai. Bagian dari SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

Perangkat atau profil telah dikunci dari jarak jauh melalui perintah LOCK. Bagian dari SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

Profil kerja atau perangkat milik perusahaan gagal dihapus saat diminta. Hal ini dapat dimulai oleh pengguna atau admin, misalnya, delete diterima. Bagian dari SECURITY_LOGS.

connectEvent

object (ConnectEvent)

Peristiwa koneksi TCP dimulai melalui tumpukan jaringan standar. Bagian dari NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

Peristiwa pencarian DNS dimulai melalui tumpukan jaringan standar. Bagian dari NETWORK_ACTIVITY_LOGS.

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Upaya untuk mengeluarkan perangkat dari mode hilang.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

Panggilan telepon keluar telah dilakukan saat perangkat dalam mode hilang.

lostModeLocationEvent

object (LostModeLocationEvent)

Pembaruan lokasi mode hilang saat perangkat dalam mode hilang.

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

Perangkat telah menyelesaikan pendaftaran. Bagian dari AMAPI_LOGS.

backupServiceToggledEvent

object (BackupServiceToggledEvent)

Admin telah mengaktifkan atau menonaktifkan layanan pencadangan. Bagian dari SECURITY_LOGS.

KeyguardDismissedEvent

Jenis ini tidak memiliki kolom.

Penjaga kunci ditutup. Dikosongkan dengan sengaja.

KeyguardDismissAuthAttemptEvent

Upaya dilakukan untuk membuka kunci perangkat.

Representasi JSON
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
Kolom
success

boolean

Apakah upaya membuka kunci berhasil.

strongAuthMethodUsed

boolean

Apakah bentuk autentikasi yang kuat (sandi, PIN, atau pola) digunakan untuk membuka kunci perangkat.

KeyguardSecuredEvent

Jenis ini tidak memiliki kolom.

Perangkat dikunci oleh pengguna atau karena waktu tunggu habis. Dikosongkan dengan sengaja.

FilePulledEvent

File didownload dari perangkat.

Representasi JSON
{
  "filePath": string
}
Kolom
filePath

string

Jalur file yang sedang ditarik.

FilePushedEvent

File diupload ke perangkat.

Representasi JSON
{
  "filePath": string
}
Kolom
filePath

string

Jalur file yang sedang didorong.

CertAuthorityInstalledEvent

Sertifikat root baru diinstal ke penyimpanan kredensial tepercaya sistem. Fitur ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Kolom
certificate

string

Subjek sertifikat.

userId

integer

Pengguna yang melakukan penginstalan sertifikat. Hanya tersedia untuk perangkat yang menjalankan Android 11 dan yang lebih baru.

success

boolean

Apakah peristiwa penginstalan berhasil.

CertAuthorityRemovedEvent

Root certificate dihapus dari penyimpanan kredensial tepercaya sistem. Fitur ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Kolom
certificate

string

Subjek sertifikat.

userId

integer

Pengguna tempat terjadinya peristiwa penghapusan sertifikat. Hanya tersedia untuk perangkat yang menjalankan Android 11 dan yang lebih baru.

success

boolean

Apakah penghapusan berhasil.

CertValidationFailureEvent

Validasi sertifikat X.509v3 gagal. Saat ini, validasi ini dilakukan di titik akses Wi-Fi dan kegagalan mungkin disebabkan oleh ketidakcocokan saat validasi sertifikat server. Namun, pada masa mendatang, peristiwa ini dapat mencakup peristiwa validasi lainnya dari sertifikat X.509v3.

Representasi JSON
{
  "failureReason": string
}
Kolom
failureReason

string

Alasan validasi sertifikasi gagal.

CryptoSelfTestCompletedEvent

Memvalidasi apakah library kriptografi bawaan Android (BoringSSL) valid. Harus selalu berhasil saat booting perangkat. Jika gagal, perangkat harus dianggap tidak tepercaya.

Representasi JSON
{
  "success": boolean
}
Kolom
success

boolean

Apakah pengujian berhasil.

KeyDestructionEvent

Kunci kriptografi, termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem, dihapus dari perangkat oleh pengguna atau pengelolaan. Fitur ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Kolom
keyAlias

string

Alias kunci.

applicationUid

integer

UID aplikasi yang memiliki kunci.

success

boolean

Apakah operasi berhasil.

KeyGeneratedEvent

Kunci kriptografi termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem diinstal di perangkat oleh pengguna atau pengelolaan.Kunci ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Kolom
keyAlias

string

Alias kunci.

applicationUid

integer

UID aplikasi yang membuat kunci.

success

boolean

Apakah operasi berhasil.

KeyImportEvent

Kunci kriptografis termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem diimpor di perangkat oleh pengguna atau pengelolaan. Fitur ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Kolom
keyAlias

string

Alias kunci.

applicationUid

integer

UID aplikasi yang mengimpor kunci

success

boolean

Apakah operasi berhasil.

KeyIntegrityViolationEvent

Kunci kriptografi, termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem, dianggap rusak karena kerusakan penyimpanan, kegagalan hardware, atau masalah OS tertentu. Fitur ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi dengan profil kerja.

Representasi JSON
{
  "keyAlias": string,
  "applicationUid": integer
}
Kolom
keyAlias

string

Alias kunci.

applicationUid

integer

UID aplikasi yang memiliki kunci

LoggingStartedEvent

Jenis ini tidak memiliki kolom.

Kebijakan usageLog telah diaktifkan. Dikosongkan dengan sengaja.

LoggingStoppedEvent

Jenis ini tidak memiliki kolom.

Kebijakan usageLog telah dinonaktifkan. Dikosongkan dengan sengaja.

LogBufferSizeCriticalEvent

Jenis ini tidak memiliki kolom.

Buffer usageLog di perangkat telah mencapai 90% kapasitasnya, sehingga peristiwa yang lebih lama mungkin dihapus. Dikosongkan dengan sengaja.

MediaMountEvent

Media yang dapat dilepas telah dipasang.

Representasi JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Kolom
mountPoint

string

Direktori pemasangan.

volumeLabel

string

Label volume. Disamarkan menjadi string kosong di perangkat profil terkelola milik organisasi.

MediaUnmountEvent

Media yang dapat dilepas telah di-unmount.

Representasi JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Kolom
mountPoint

string

Direktori pemasangan.

volumeLabel

string

Label volume. Disamarkan menjadi string kosong di perangkat profil terkelola milik organisasi.

OsShutdownEvent

Jenis ini tidak memiliki kolom.

Perangkat dimatikan. Dikosongkan dengan sengaja.

OsStartupEvent

Perangkat telah dimulai.

Representasi JSON
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
Kolom
verifiedBootState

enum (VerifiedBootState)

Status Booting Terverifikasi.

verityMode

enum (DmVerityMode)

mode dm-verity.

RemoteLockEvent

Perangkat atau profil telah dikunci dari jarak jauh melalui perintah LOCK.

Representasi JSON
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Kolom
adminPackageName

string

Nama paket aplikasi admin yang meminta perubahan.

adminUserId

integer

ID pengguna aplikasi admin yang meminta perubahan.

targetUserId

integer

ID pengguna yang perubahannya diminta.

WipeFailureEvent

Jenis ini tidak memiliki kolom.

Profil kerja atau perangkat milik perusahaan gagal dihapus saat diminta. Hal ini dapat dimulai oleh pengguna atau admin, misalnya, delete diterima. Dikosongkan dengan sengaja.

ConnectEvent

Peristiwa koneksi TCP dimulai melalui tumpukan jaringan standar.

Representasi JSON
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
Kolom
destinationIpAddress

string

Alamat IP tujuan panggilan penghubung.

destinationPort

integer

Port tujuan panggilan koneksi.

packageName

string

Nama paket UID yang melakukan panggilan koneksi.

DnsEvent

Peristiwa pencarian DNS dimulai melalui tumpukan jaringan standar.

Representasi JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Kolom
hostname

string

Nama host yang dicari.

ipAddresses[]

string

Daftar (yang mungkin terpotong) alamat IP yang ditampilkan untuk pencarian DNS (maks. 10 alamat IPv4 atau IPv6).

totalIpAddressesReturned

string (int64 format)

Jumlah alamat IP yang ditampilkan dari peristiwa pencarian DNS. Mungkin lebih tinggi daripada jumlah ipAddresses jika ada terlalu banyak alamat yang harus dicatat.

packageName

string

Nama paket UID yang melakukan pencarian DNS.

StopLostModeUserAttemptEvent

Peristiwa mode hilang yang menunjukkan bahwa pengguna telah mencoba menghentikan mode hilang.

Representasi JSON
{
  "status": enum (Status)
}
Kolom
status

enum (Status)

Status upaya untuk menghentikan mode hilang.

LostModeOutgoingPhoneCallEvent

Jenis ini tidak memiliki kolom.

Peristiwa yang menunjukkan bahwa panggilan telepon keluar telah dilakukan saat perangkat dalam mode hilang. Dikosongkan dengan sengaja.

LostModeLocationEvent

Peristiwa mode hilang yang berisi lokasi perangkat dan level baterai sebagai persentase.

Representasi JSON
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
Kolom
location

object (Location)

Lokasi perangkat

batteryLevel

integer

Level baterai sebagai angka antara 0 dan 100 inklusif

Lokasi

Lokasi perangkat yang berisi lintang dan bujur.

Representasi JSON
{
  "latitude": number,
  "longitude": number
}
Kolom
latitude

number

Posisi lintang lokasi

longitude

number

Posisi bujur lokasi

EnrollmentCompleteEvent

Jenis ini tidak memiliki kolom.

Menunjukkan bahwa perangkat telah menyelesaikan pendaftaran. Pengguna akan berada di peluncur pada tahap ini, perangkat akan mematuhi kebijakan dan semua langkah penyiapan telah selesai. Dikosongkan dengan sengaja.