BatchUsageLogEvents

Log peristiwa batch 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.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

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)
  }
  // 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.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

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

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

object (AdbShellCommandEvent)

Perintah shell dikeluarkan melalui ADB melalui “perintah shell adb”. 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)

Keyguard 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 waktu tunggu habis. Bagian dari SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

File didownload dari perangkat. Bagian dari SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

File telah diupload ke perangkat. Bagian dari SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Root certificate baru telah diinstal ke dalam penyimpanan kredensial tepercaya sistem. Bagian dari SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

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

certValidationFailureEvent

object (CertValidationFailureEvent)

Sertifikat X.509v3 gagal divalidasi, saat ini validasi ini dilakukan di titik akses Wi-Fi dan kegagalan mungkin disebabkan oleh ketidakcocokan saat validasi sertifikat server. Namun demikian, data ini mungkin mencakup acara validasi lainnya dari sertifikat X.509v3 di masa mendatang. Bagian dari SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

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

keyDestructionEvent

object (KeyDestructionEvent)

Kunci kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, dihapus dari perangkat baik oleh pengguna maupun pengelola. 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 pengelola. 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 pengelola. Bagian dari SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Kunci kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, ditentukan rusak karena kerusakan penyimpanan, kegagalan hardware, atau beberapa masalah OS. 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 dapat 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 dilepas. Bagian dari SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Perangkat dimatikan. Bagian dari SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Perangkat telah dinyalakan. 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 datanya saat diminta. Ini dapat dimulai oleh pengguna atau admin, misalnya delete diterima. Bagian dari SECURITY_LOGS.

connectEvent

object (ConnectEvent)

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

dnsEvent

object (DnsEvent)

Peristiwa pencarian DNS dimulai melalui stack 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.

KeyguardDismissedEvent

Jenis ini tidak memiliki kolom.

Keyguard ditutup. Sengaja kosong.

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 waktu tunggu habis. Kosong secara sengaja.

FilePulledEvent

File didownload dari perangkat.

Representasi JSON
{
  "filePath": string
}
Kolom
filePath

string

Jalur file yang diambil.

FilePushedEvent

File telah diupload ke perangkat.

Representasi JSON
{
  "filePath": string
}
Kolom
filePath

string

Jalur file yang di-push.

CertAuthorityInstalledEvent

Root certificate baru telah diinstal ke penyimpanan kredensial tepercaya sistem. Fitur ini tersedia di seluruh perangkat pada perangkat yang 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 peristiwa penginstalan sertifikat terjadi. 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 yang terkelola sepenuhnya dan dalam profil kerja di perangkat milik organisasi yang memiliki profil kerja.

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

string

Subjek sertifikat.

userId

integer

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

success

boolean

Apakah penghapusan berhasil.

CertValidationFailureEvent

Sertifikat X.509v3 gagal divalidasi, saat ini validasi ini dilakukan pada titik akses Wi-Fi dan kegagalan mungkin karena ketidakcocokan pada validasi sertifikat server. Namun, pada masa mendatang, peristiwa validasi lain dari sertifikat X.509v3 mungkin akan disertakan.

Representasi JSON
{
  "failureReason": string
}
Kolom
failureReason

string

Alasan kegagalan validasi sertifikasi.

CryptoSelfTestCompletedEvent

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

Representasi JSON
{
  "success": boolean
}
Kolom
success

boolean

Apakah pengujian berhasil.

KeyDestructionEvent

Kunci kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, dihapus dari perangkat oleh pengguna atau pengelola. Fitur ini tersedia di seluruh perangkat pada perangkat yang 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 atau tidak.

KeyGeneratedEvent

Kunci kriptografis termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem diinstal di perangkat oleh pengguna atau pengelola.Kunci ini tersedia di seluruh perangkat pada perangkat yang dikelola 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 oleh admin, dan dikelola sistem, diimpor pada perangkat oleh pengguna atau pengelola. Fitur ini tersedia di seluruh perangkat pada perangkat yang 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 kriptografis termasuk kunci pribadi yang diinstal pengguna, diinstal admin, dan dikelola sistem ditentukan rusak karena kerusakan penyimpanan, kegagalan hardware, atau beberapa masalah OS. Fitur ini tersedia di seluruh perangkat pada perangkat yang 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. Kosong secara sengaja.

LoggingStoppedEvent

Jenis ini tidak memiliki kolom.

Kebijakan usageLog telah dinonaktifkan. Sengaja kosong.

LogBufferSizeCriticalEvent

Jenis ini tidak memiliki kolom.

Buffer usageLog di perangkat telah mencapai 90% kapasitasnya, sehingga peristiwa yang lebih lama dapat dihapus. Kosong secara sengaja.

MediaMountEvent

Media yang dapat dilepas telah dipasang.

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

string

Titik pemasangan.

volumeLabel

string

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

MediaUnmountEvent

Media yang dapat dilepas telah dilepas.

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

string

Titik pemasangan.

volumeLabel

string

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

OsShutdownEvent

Jenis ini tidak memiliki kolom.

Perangkat dimatikan. Sengaja kosong.

OsStartupEvent

Perangkat telah dinyalakan.

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 tempat perubahan diminta.

targetUserId

integer

ID pengguna tempat perubahan diminta.

WipeFailureEvent

Jenis ini tidak memiliki kolom.

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

ConnectEvent

Peristiwa koneksi TCP dimulai melalui stack jaringan standar.

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

string

Alamat IP tujuan panggilan koneksi.

destinationPort

integer

Port tujuan panggilan koneksi.

packageName

string

Nama paket UID yang melakukan panggilan koneksi.

DnsEvent

Peristiwa pencarian DNS dimulai melalui stack jaringan standar.

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

string

Nama host yang dicari.

ipAddresses[]

string

Daftar alamat IP (mungkin terpotong) 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 dari jumlah ipAddresses jika ada terlalu banyak alamat yang akan dicatat ke dalam log.

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 menghentikan mode hilang.

LostModeOutgoingPhoneCallEvent

Jenis ini tidak memiliki kolom.

Peristiwa yang menunjukkan panggilan telepon keluar telah dilakukan saat perangkat dalam mode hilang. Kosong secara 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 seharusnya berada di peluncur. Pada tahap ini, perangkat akan mematuhi kebijakan dan semua langkah penyiapan telah selesai. Kosong secara sengaja.