BatchUsageLogEvents

Nhật ký sự kiện theo lô của events từ thiết bị.

Biểu diễn dưới dạng JSON
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
Trường
device

string

Tên của thiết bị (nếu có) ở dạng "enterprises/{enterpriseId}/devices/{deviceId}"

user

string

Tên tài nguyên của người dùng sở hữu thiết bị này (nếu có) sẽ có dạng "enterprises/{enterpriseId}/users/{userId}".

retrievalTime

string (Timestamp format)

Dấu thời gian của thiết bị khi một loạt sự kiện được thu thập từ thiết bị.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

usageLogEvents[]

object (UsageLogEvent)

Danh sách UsageLogEvent do thiết bị báo cáo, được sắp xếp theo thứ tự thời gian theo thời gian sự kiện.

UsageLogEvent

Một sự kiện được ghi lại trên thiết bị.

Biểu diễn dưới dạng 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.
}
Trường
eventId

string (int64 format)

Mã nhận dạng duy nhất của sự kiện.

eventTime

string (Timestamp format)

Dấu thời gian của thiết bị khi sự kiện được ghi lại.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

Loại sự kiện cụ thể trong nhật ký sử dụng đã được báo cáo trên thiết bị. Sử dụng thông tin này để xác định trường event cần truy cập.

Trường hợp hợp nhất event. Các loại sự kiện được ghi lại trên thiết bị. Hãy xem từng loại sự kiện để biết thêm thông tin chi tiết về thời điểm sự kiện được gửi, các quy định hạn chế về thời điểm sự kiện được ghi lại và các trường được đưa vào. event chỉ có thể là một trong những giá trị sau:
adbShellCommandEvent

object (AdbShellCommandEvent)

Một lệnh shell đã được phát hành qua ADB thông qua "lệnh shell adb". Một phần của SECURITY_LOGS.

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Một shell tương tác ADB đã được mở thông qua "adb shell". Một phần của SECURITY_LOGS.

appProcessStartEvent

object (AppProcessStartEvent)

Một quy trình ứng dụng đã bắt đầu. Một phần của SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

Màn hình khoá đã bị đóng. Một phần của SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

Đã có người cố gắng mở khoá thiết bị. Một phần của SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

Thiết bị đã bị người dùng hoặc hết thời gian chờ khoá. Một phần của SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

Đã tải tệp xuống từ thiết bị. Một phần của SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

Một tệp đã được tải lên thiết bị. Thuộc SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Chứng chỉ gốc mới đã được cài đặt vào bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Thuộc SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Một chứng chỉ gốc đã bị xoá khỏi bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Một phần của SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Không xác thực được chứng chỉ X.509v3. Hiện tại, quá trình xác thực này được thực hiện trên điểm truy cập Wi-Fi và lỗi có thể là do giá trị không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, tệp này có thể bao gồm các sự kiện xác thực khác của chứng chỉ X.509v3. Một phần của SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Xác thực xem thư viện mã hoá tích hợp của Android (BoringSSL) có hợp lệ hay không. Phải luôn thành công khi khởi động thiết bị, nếu không thành công, thiết bị sẽ được coi là không đáng tin cậy. Một phần của SECURITY_LOGS.

keyDestructionEvent

object (KeyDestructionEvent)

Khoá mã hoá bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì sẽ bị người dùng hoặc quản trị viên xoá khỏi thiết bị. Một phần của SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Người dùng hoặc quản trị viên sẽ cài đặt khoá mã hoá, bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì trên thiết bị. Một phần của SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Khoá mã hoá bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì được người dùng hoặc quản trị viên nhập trên thiết bị. Một phần của SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Một khoá mã hoá bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì được xác định là bị hỏng do hỏng bộ nhớ, lỗi phần cứng hoặc vấn đề nào đó về hệ điều hành. Một phần của SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

Đã bật chính sách usageLog. Một phần của SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

Chính sách usageLog đã bị vô hiệu hoá. Một phần của SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Vùng đệm nhật ký kiểm tra đã đạt 90% dung lượng, do đó, các sự kiện cũ có thể bị loại bỏ. Một phần của SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

Đã kết nối phương tiện di động. Một phần của SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

Phương tiện có thể tháo rời đã bị tháo. Thuộc SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

Thiết bị đã tắt. Thuộc SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

Đã khởi động thiết bị. Một phần của SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

Thiết bị hoặc hồ sơ đã được khoá từ xa thông qua lệnh LOCK. Một phần của SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

Không xoá được hồ sơ công việc hoặc thiết bị thuộc quyền sở hữu của công ty khi có yêu cầu. Quá trình này có thể do người dùng hoặc quản trị viên khởi tạo, ví dụ: delete đã được nhận. Một phần của SECURITY_LOGS.

connectEvent

object (ConnectEvent)

Sự kiện kết nối TCP đã được bắt đầu thông qua ngăn xếp mạng tiêu chuẩn. Một phần của NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

Một sự kiện tra cứu DNS đã được bắt đầu thông qua ngăn xếp mạng chuẩn. Một phần của NETWORK_ACTIVITY_LOGS.

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Một nỗ lực để đưa thiết bị ra khỏi chế độ thất lạc.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

Đã thực hiện cuộc gọi điện thoại đi khi thiết bị ở chế độ thất lạc.

lostModeLocationEvent

object (LostModeLocationEvent)

Thông tin cập nhật vị trí ở chế độ thất lạc khi thiết bị ở chế độ thất lạc.

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

Thiết bị đã hoàn tất quá trình đăng ký. Một phần của AMAPI_LOGS.

KeyguardDismissedEvent

Loại này không có trường nào.

Màn hình khoá đã bị đóng. Để trống theo ý định.

KeyguardDismissAuthAttemptEvent

Đã có người cố gắng mở khoá thiết bị.

Biểu diễn dưới dạng JSON
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
Trường
success

boolean

Liệu lần mở khoá đó có thành công hay không.

strongAuthMethodUsed

boolean

Liệu có sử dụng hình thức xác thực mạnh (mật khẩu, mã PIN hoặc hình mở khóa) để mở khóa thiết bị hay không.

KeyguardSecuredEvent

Loại này không có trường nào.

Thiết bị đã bị người dùng hoặc hết thời gian chờ khoá. Để trống theo ý định.

FilePulledEvent

Tệp đã được tải xuống từ thiết bị.

Biểu diễn dưới dạng JSON
{
  "filePath": string
}
Trường
filePath

string

Đường dẫn của tệp đang được kéo.

FilePushedEvent

Một tệp đã được tải lên thiết bị.

Biểu diễn dưới dạng JSON
{
  "filePath": string
}
Trường
filePath

string

Đường dẫn của tệp đang được đẩy.

CertAuthorityInstalledEvent

Chứng chỉ gốc mới đã được cài đặt vào bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Tính năng này hoạt động trên toàn thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Trường
certificate

string

Chủ đề của chứng chỉ.

userId

integer

Người dùng mà sự kiện cài đặt chứng chỉ đã xảy ra. Chỉ dành cho các thiết bị chạy Android 11 trở lên.

success

boolean

Liệu sự kiện cài đặt có thành công hay không.

CertAuthorityRemovedEvent

Một chứng chỉ gốc đã bị xoá khỏi bộ nhớ thông tin xác thực đáng tin cậy của hệ thống. Tính năng này hoạt động trên toàn thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Trường
certificate

string

Chủ đề của chứng chỉ.

userId

integer

Người dùng mà sự kiện xoá chứng chỉ đã xảy ra. Chỉ dành cho các thiết bị chạy Android 11 trở lên.

success

boolean

Liệu quá trình xoá có thành công hay không.

CertValidationFailureEvent

Không xác thực được chứng chỉ X.509v3, hiện tại, quá trình xác thực này được thực hiện trên điểm truy cập Wi-Fi và có thể không thành công do không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, tệp này có thể bao gồm các sự kiện xác thực khác của chứng chỉ X.509v3.

Biểu diễn dưới dạng JSON
{
  "failureReason": string
}
Trường
failureReason

string

Lý do không xác thực được chứng chỉ.

CryptoSelfTestCompletedEvent

Xác thực xem thư viện mã hoá tích hợp của Android (BoringSSL) có hợp lệ hay không. Phải luôn thành công khi khởi động thiết bị, nếu không thành công, thiết bị sẽ được coi là không đáng tin cậy.

Biểu diễn dưới dạng JSON
{
  "success": boolean
}
Trường
success

boolean

Liệu quá trình kiểm thử có thành công hay không.

KeyDestructionEvent

Khoá mã hoá bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì sẽ bị người dùng hoặc quản trị viên xoá khỏi thiết bị. Tính năng này hoạt động trên toàn thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng sở hữu khoá.

success

boolean

Liệu thao tác có thành công hay không.

KeyGeneratedEvent

Người dùng hoặc quản trị viên sẽ cài đặt khoá mã hoá, bao gồm khoá riêng do người dùng cài đặt, khoá riêng do quản trị viên cài đặt và khoá riêng do hệ thống duy trì trên thiết bị.Khoá này có trên toàn thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị thuộc sở hữu của tổ chức có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng đã tạo khoá.

success

boolean

Liệu thao tác có thành công hay không.

KeyImportEvent

Khoá mã hoá bao gồm khoá riêng tư do người dùng cài đặt, khoá riêng tư do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì được người dùng hoặc quản trị viên nhập trên thiết bị. Tính năng này hoạt động trên toàn thiết bị đối với các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên các thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng đã nhập khoá

success

boolean

Liệu thao tác có thành công hay không.

KeyIntegrityViolationEvent

Khoá mã hoá (bao gồm cả khoá riêng tư do người dùng cài đặt, quản trị viên cài đặt và hệ thống duy trì) được xác định là bị hỏng do bộ nhớ bị hỏng, lỗi phần cứng hoặc một số vấn đề về hệ điều hành. Tính năng này có trên toàn thiết bị trên các thiết bị được quản lý hoàn toàn và trong hồ sơ công việc trên thiết bị do tổ chức sở hữu có hồ sơ công việc.

Biểu diễn dưới dạng JSON
{
  "keyAlias": string,
  "applicationUid": integer
}
Trường
keyAlias

string

Bí danh của khoá.

applicationUid

integer

UID của ứng dụng sở hữu khoá

LoggingStartedEvent

Loại này không có trường nào.

Đã bật chính sách usageLog. Để trống theo ý định.

LoggingStoppedEvent

Loại này không có trường nào.

Chính sách usageLog đã bị tắt. Để trống theo ý định.

LogBufferSizeCriticalEvent

Loại này không có trường nào.

Vùng đệm usageLog trên thiết bị đã đạt 90% dung lượng, do đó, các sự kiện cũ có thể bị loại bỏ. Để trống theo ý định.

MediaMountEvent

Phương tiện có thể tháo rời đã được gắn.

Biểu diễn dưới dạng JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Trường
mountPoint

string

Điểm gắn.

volumeLabel

string

Nhãn ổ đĩa. Được loại bỏ thành chuỗi trống trên các thiết bị hồ sơ được quản lý thuộc sở hữu của tổ chức.

MediaUnmountEvent

Phương tiện có thể tháo rời đã bị tháo.

Biểu diễn dưới dạng JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Trường
mountPoint

string

Điểm gắn.

volumeLabel

string

Nhãn ổ đĩa. Được loại bỏ thành chuỗi trống trên các thiết bị có hồ sơ được quản lý do tổ chức sở hữu.

OsShutdownEvent

Loại này không có trường nào.

Thiết bị đã tắt. Để trống theo ý định.

OsStartupEvent

Đã khởi động thiết bị.

Biểu diễn dưới dạng JSON
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
Trường
verifiedBootState

enum (VerifiedBootState)

Trạng thái khởi động được xác minh.

verityMode

enum (DmVerityMode)

chế độ dm-verity.

RemoteLockEvent

Thiết bị hoặc hồ sơ đã được khoá từ xa thông qua lệnh LOCK.

Biểu diễn dưới dạng JSON
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Trường
adminPackageName

string

Tên gói của ứng dụng quản trị yêu cầu thay đổi.

adminUserId

integer

Mã nhận dạng người dùng của ứng dụng quản trị đã yêu cầu thay đổi.

targetUserId

integer

Mã nhận dạng người dùng đã yêu cầu thay đổi.

WipeFailureEvent

Loại này không có trường nào.

Không xoá được hồ sơ công việc hoặc thiết bị thuộc sở hữu của công ty khi được yêu cầu. Quá trình này có thể do người dùng hoặc quản trị viên khởi tạo, ví dụ: delete đã được nhận. Để trống theo ý định.

ConnectEvent

Sự kiện kết nối TCP đã được bắt đầu thông qua ngăn xếp mạng chuẩn.

Biểu diễn dưới dạng JSON
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
Trường
destinationIpAddress

string

Địa chỉ IP đích của lệnh gọi kết nối.

destinationPort

integer

Cổng đích của lệnh gọi kết nối.

packageName

string

Tên gói của UID đã thực hiện lệnh gọi kết nối.

DnsEvent

Một sự kiện tra cứu DNS đã được bắt đầu thông qua ngăn xếp mạng chuẩn.

Biểu diễn dưới dạng JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Trường
hostname

string

Tên máy chủ đã được tra cứu.

ipAddresses[]

string

Danh sách (có thể bị cắt bớt) các địa chỉ IP được trả về để tra cứu DNS (tối đa 10 địa chỉ IPv4 hoặc IPv6).

totalIpAddressesReturned

string (int64 format)

Số lượng địa chỉ IP được trả về từ sự kiện tra cứu DNS. Có thể cao hơn số lượng ipAddresses nếu có quá nhiều địa chỉ cần ghi lại.

packageName

string

Tên gói của UID đã thực hiện tra cứu DNS.

StopLostModeUserAttemptEvent

Sự kiện chế độ bị mất cho biết người dùng đã cố gắng dừng chế độ bị mất.

Biểu diễn dưới dạng JSON
{
  "status": enum (Status)
}
Trường
status

enum (Status)

Trạng thái của lượt cố gắng dừng chế độ thất lạc.

LostModeOutgoingPhoneCallEvent

Loại này không có trường nào.

Một sự kiện cho biết một cuộc gọi điện thoại đi đã được thực hiện khi thiết bị ở chế độ thất lạc. Để trống theo ý định.

LostModeLocationEvent

Sự kiện chế độ thất lạc chứa vị trí thiết bị và mức pin dưới dạng tỷ lệ phần trăm.

Biểu diễn dưới dạng JSON
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
Trường
location

object (Location)

Vị trí của thiết bị

batteryLevel

integer

Mức pin ở dạng một số nằm trong khoảng từ 0 đến 100

Vị trí

Vị trí thiết bị có chứa vĩ độ và kinh độ.

Biểu diễn dưới dạng JSON
{
  "latitude": number,
  "longitude": number
}
Trường
latitude

number

Vị trí theo vĩ độ

longitude

number

Vị trí kinh độ của vị trí

EnrollmentCompleteEvent

Loại này không có trường nào.

Cho biết thiết bị đã hoàn tất quy trình đăng ký. Tại thời điểm này, người dùng phải sử dụng trình chạy, thiết bị tại thời điểm này sẽ tuân thủ và tất cả các bước thiết lập đã hoàn tất. Để trống theo ý định.