BatchUsageLogEvents

Các 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)
    }
  ]
}
Các trường
device

string

Tên của thiết bị theo mẫu "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 ở dạng "enterprises/{enterpriseId}/users/{userId}".

retrievalTime

string (Timestamp format)

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

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

usageLogEvents[]

object (UsageLogEvent)

Danh sách UsageLogEvent mà thiết bị đã báo cáo, được sắp xếp theo thứ tự thời gian theo thời gian của 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.
}
Các 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ị. Dùng tính năng này để xác định cần truy cập vào trường event nào.

Trường nhóm 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 và các quy định hạn chế về thời điểm sự kiện được ghi lại cũng như những trường được đưa vào. event chỉ có thể là một trong những trạng thái sau đây:
adbShellCommandEvent

object (AdbShellCommandEvent)

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)

Đã bắt đầu một quá trình xử lý ứng dụng. Thuộc SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

Đã đóng phím tắt. Thuộc SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

Đã có người cố mở khoá thiết bị. Thuộc SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

Thiết bị đã bị người dùng khoá hoặc hết thời gian chờ. Thuộc SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

Đã tải một tệp xuống từ thiết bị. Thuộc SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

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

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Một 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. Thuộc SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Không xác thực được chứng chỉ X.509v3. Hiện 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 lỗi không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, quá trình 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. Thuộc SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

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

keyDestructionEvent

object (KeyDestructionEvent)

Người dùng hoặc cấp quản lý sẽ xoá khoá mã hoá (bao gồm cả khoá do người dùng cài đặt, khoá do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì) khỏi thiết bị. Thuộc SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Người dùng hoặc cấp quản lý cài đặt một khoá mã hoá (bao gồm cả khoá do người dùng cài đặt, do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì). Thuộc SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Người dùng hoặc người quản lý sẽ nhập một khoá mã hoá (bao gồm cả khoá do người dùng cài đặt, do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì). Thuộc SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Một khoá mã hoá bao gồm cả khoá do người dùng cài đặt, khoá 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 một số vấn đề về hệ điều hành. Thuộc SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

Đã bật chính sách usageLog. Thuộc SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

Chính sách usageLog đã bị tắt. Thuộc SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Vùng đệm nhật ký kiểm tra đã đạt đến 90% dung lượng, do đó các sự kiện cũ hơn có thể bị bỏ qua. Thuộc SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

Đã gắn phương tiện di động. Thuộc SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

Đã ngắt kết nối phương tiện di động. 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ị. Thuộc SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

Thiết bị hoặc hồ sơ đã bị khoá từ xa qua lệnh LOCK. Thuộc SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

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. Đây có thể là do người dùng yêu cầu hoặc do quản trị viên khởi tạo, ví dụ như hệ thống đã nhận delete. Thuộc 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. Thuộc NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

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

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Cố gắng đưa thiết bị ra khỏi chế độ thất lạc.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

Bạn đã thực hiện một 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í trong 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ý. Thuộc AMAPI_LOGS.

KeyguardDismissedEvent

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

Đã đóng phím tắt. Trống có chủ ý.

KeyguardDismissAuthAttemptEvent

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

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

boolean

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

strongAuthMethodUsed

boolean

Liệu có dùng phương thức xác thực mạnh mẽ (mật khẩu, mã PIN hoặc hình mở khoá) để mở khoá thiết bị hay không.

KeyguardSecuredEvent

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

Thiết bị đã bị người dùng khoá hoặc hết thời gian chờ. Trống có chủ ý.

FilePulledEvent

Đã tải một tệp xuống từ thiết bị.

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

string

Đường dẫn của tệp đượ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
}
Các trường
filePath

string

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

CertAuthorityInstalledEvent

Một 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ị 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 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
}
Các trường
certificate

string

Chủ thể của chứng chỉ.

userId

integer

Người dùng trong đó đã xảy ra sự kiện cài đặt chứng chỉ. 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ị 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 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
}
Các trường
certificate

string

Chủ thể của chứng chỉ.

userId

integer

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

success

boolean

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

CertValidationFailureEvent

Không xác thực được chứng chỉ X.509v3. Hiện 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 lỗi không khớp khi xác thực chứng chỉ máy chủ. Tuy nhiên, trong tương lai, quá trình 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
}
Các trường
failureReason

string

Lý do không xác thực được giấy chứng nhận.

CryptoSelfTestCompletedEvent

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

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

boolean

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

KeyDestructionEvent

Người dùng hoặc cấp quản lý sẽ xoá khoá mã hoá (bao gồm cả khoá do người dùng cài đặt, khoá do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì) khỏi thiết bị. Tính năng này hoạt động 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 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
}
Các 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 lý cài đặt một khoá mã hoá, bao gồm cả khoá 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 cài đặt trên thiết bị.Khoá mã hoá này có sẵn 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 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
}
Các 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

Người dùng hoặc người quản lý sẽ nhập một khoá mã hoá (bao gồm cả khoá do người dùng cài đặt, do quản trị viên cài đặt và khoá riêng tư do hệ thống duy trì). Tính năng này hoạt động 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 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
}
Các 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

Một khoá mã hoá bao gồm cả khoá do người dùng cài đặt, khoá 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 một số vấn đề về hệ điều hành. Tính năng này hoạt động 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 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
}
Các 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.

Đã bật chính sách usageLog. Trống có chủ ý.

LoggingStoppedEvent

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

Chính sách usageLog đã bị tắt. Trống có chủ ý.

LogBufferSizeCriticalEvent

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

Bộ đệm usageLog trên thiết bị đã đạt 90% dung lượng, do đó các sự kiện cũ có thể bị bỏ qua. Trống có chủ ý.

MediaMountEvent

Đã gắn phương tiện di động.

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

string

Điểm gắn.

volumeLabel

string

Nhãn số lượng. Bị 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

Đã ngắt kết nối phương tiện di động.

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

string

Điểm gắn.

volumeLabel

string

Nhãn số lượng. Bị 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.

OsShutdownEvent

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

Thiết bị đã tắt. Trống có chủ ý.

OsStartupEvent

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

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

enum (VerifiedBootState)

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

verityMode

enum (DmVerityMode)

Chế độ xác thực dm.

RemoteLockEvent

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

Biểu diễn dưới dạng JSON
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Các 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ị mà từ đó yêu cầu thay đổi được yêu cầu.

targetUserId

integer

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

WipeFailureEvent

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

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. Đây có thể là do người dùng yêu cầu hoặc do quản trị viên khởi tạo, ví dụ như hệ thống đã nhận delete. Trống có chủ ý.

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.

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

string

Địa chỉ IP đích của cuộc gọi kết nối.

destinationPort

integer

Cổng đích của cuộc gọi được 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

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

Biểu diễn dưới dạng JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Các 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ố đị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ỉ để ghi lại.

packageName

string

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

StopLostModeUserAttemptEvent

Một sự kiện về chế độ thất lạc cho biết người dùng đã cố gắng dừng chế độ thất lạc.

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

enum (Status)

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

LostModeOutgoingPhoneCallEvent

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

Một sự kiện cho biết bạn đã thực hiện một cuộc gọi điện thoại đi khi thiết bị ở chế độ thất lạc. Trống có chủ ý.

LostModeLocationEvent

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

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

object (Location)

Vị trí thiết bị

batteryLevel

integer

Mức pin ở dạng số từ 0 đến 100

Vị trí

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

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

number

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

longitude

number

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

EnrollmentCompleteEvent

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

Thể hiện rằng thiết bị đã hoàn tất quá trình đăng ký. Người dùng phải có mặt trong trình chạy tại thời điểm này. Tại thời điểm này, thiết bị sẽ tuân thủ và tất cả các bước thiết lập đều đã được hoàn tất. Trống có chủ ý.