BatchUsageLogEvents

Batch log aktivitas events dari perangkat.

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

string

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

user

string

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

retrievalTime

string (Timestamp format)

Stempel waktu perangkat saat batch peristiwa dikumpulkan dari perangkat.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga 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, yang diurutkan secara kronologis menurut waktu peristiwa.

UsageLogEvent

Peristiwa dicatat 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 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 pada 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 waktu pengirimannya dan batasan terkait kapan peristiwa dicatat dan kolom apa saja 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 telah 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. 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 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 pada titik akses Wi-Fi dan kegagalan mungkin karena ketidakcocokan saat validasi sertifikat server. Namun, mungkin di masa mendatang mencakup acara 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 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 oleh admin, dan dikelola sistem, diinstal di perangkat baik oleh pengguna maupun pengelola. Bagian dari SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Kunci kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, diimpor pada 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, dinyatakan 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 kapasitas 90%, sehingga peristiwa lama mungkin akan 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 dilepas. Bagian dari SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Perangkat dimatikan. Bagian dari SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Perangkat 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 total saat diminta. Hal ini dapat dimulai oleh pengguna atau dimulai admin, misalnya delete telah 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.

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 pembukaan 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. Sengaja kosong.

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 dikirim.

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 yang memiliki 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 telah 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 yang mengalami peristiwa penghapusan sertifikat. 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 saat validasi sertifikat server. Namun, mungkin di masa mendatang mencakup acara validasi lainnya dari sertifikat X.509v3.

Representasi JSON
{
  "failureReason": string
}
Kolom
failureReason

string

Alasan kegagalan validasi sertifikasi.

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 kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, dihapus dari perangkat baik oleh pengguna maupun pengelola. 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
{
  "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 oleh admin, dan yang dikelola sistem, diinstal di perangkat baik oleh pengguna maupun pengelolaan.Kunci kriptografis ini tersedia di seluruh perangkat pada perangkat terkelola sepenuhnya dan dalam profil kerja pada perangkat milik organisasi yang memiliki 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 atau tidak.

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 yang memiliki 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 atau tidak.

KeyIntegrityViolationEvent

Kunci kriptografis, termasuk kunci pribadi yang diinstal pengguna, diinstal oleh admin, dan dikelola sistem, dinyatakan 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 yang memiliki 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. Sengaja kosong.

LoggingStoppedEvent

Jenis ini tidak memiliki kolom.

Kebijakan usageLog telah dinonaktifkan. Sengaja kosong.

LogBufferSizeCriticalEvent

Jenis ini tidak memiliki kolom.

Buffer usageLog di perangkat telah mencapai kapasitasnya 90%, sehingga peristiwa lama mungkin akan dihapus. Sengaja kosong.

MediaMountEvent

Media yang dapat dilepas telah dipasang.

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

string

Titik pemasangan.

volumeLabel

string

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

MediaUnmountEvent

Media yang dapat dilepas dilepas.

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

string

Titik pemasangan.

volumeLabel

string

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

OsShutdownEvent

Jenis ini tidak memiliki kolom.

Perangkat dimatikan. Sengaja kosong.

OsStartupEvent

Perangkat 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 digunakan untuk meminta perubahan.

targetUserId

integer

ID pengguna tempat perubahan diminta.

WipeFailureEvent

Jenis ini tidak memiliki kolom.

Profil kerja atau perangkat milik perusahaan gagal dihapus total saat diminta. Hal ini dapat dimulai oleh pengguna atau dimulai admin, misalnya delete telah diterima. Sengaja kosong.

ConnectEvent

Peristiwa koneksi TCP dimulai melalui tumpukan 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 tumpukan jaringan standar.

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

string

Nama host yang dicari.

ipAddresses[]

string

Daftar alamat IP (yang 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 daripada jumlah Alamat IP jika ada terlalu banyak alamat untuk 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 menghentikan mode hilang.

LostModeOutgoingPhoneCallEvent

Jenis ini tidak memiliki kolom.

Peristiwa yang mengindikasikan panggilan telepon keluar telah dilakukan saat perangkat dalam mode hilang. Sengaja kosong.

LostModeLocationEvent

Peristiwa mode hilang yang berisi lokasi perangkat dan level baterai dalam 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. Sengaja kosong.