BatchUsageLogEvents

デバイスからの events のイベントログをバッチ処理しました。

JSON 表現
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
フィールド
device

string

デバイスの名前。形式は「enterprises/{enterpriseId}/devices/{deviceId}」です。

user

string

このデバイスを所有しているユーザーのリソース名。形式は「enterprises/{enterpriseId}/users/{userId}」です。

retrievalTime

string (Timestamp format)

デバイスからイベントのバッチが収集されたときのデバイスのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

usageLogEvents[]

object (UsageLogEvent)

デバイスによって報告された UsageLogEvent のリスト。イベント時間の時系列で並べ替えられています。

UsageLogEvent

デバイスに記録されたイベント。

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.
}
フィールド
eventId

string (int64 format)

イベントの一意の ID。

eventTime

string (Timestamp format)

イベントが記録されたときのデバイスのタイムスタンプ。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

eventType

enum (EventType)

デバイスで報告された特定の使用状況ログのイベントタイプ。これを使用して、アクセスする event フィールドを決定します。

共用体フィールド event。デバイスに記録されたイベントの種類。イベントが送信されるタイミングや、イベントがログに記録されるタイミングや記録されるフィールドに関する制限について詳しくは、各イベントタイプをご覧ください。event は次のいずれかになります。
adbShellCommandEvent

object (AdbShellCommandEvent)

シェルコマンドが「adb shell コマンド」を介して ADB に対して発行された。SECURITY_LOGS の一部。

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

ADB インタラクティブ シェルが「adb shell」を介して開かれました。SECURITY_LOGS の一部。

appProcessStartEvent

object (AppProcessStartEvent)

アプリプロセスが開始されました。SECURITY_LOGS の一部。

keyguardDismissedEvent

object (KeyguardDismissedEvent)

キーガードが閉じられました。SECURITY_LOGS の一部。

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

デバイスのロック解除を試みた。SECURITY_LOGS の一部。

keyguardSecuredEvent

object (KeyguardSecuredEvent)

デバイスはユーザーまたはタイムアウトによりロックされました。SECURITY_LOGS の一部。

filePulledEvent

object (FilePulledEvent)

デバイスからファイルがダウンロードされました。SECURITY_LOGS の一部。

filePushedEvent

object (FilePushedEvent)

デバイスにファイルがアップロードされました。SECURITY_LOGS の一部。

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

新しいルート証明書がシステムの信頼できる認証情報ストレージにインストールされました。SECURITY_LOGS の一部。

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

ルート証明書がシステムの信頼できる認証情報ストレージから削除されました。SECURITY_LOGS の一部。

certValidationFailureEvent

object (CertValidationFailureEvent)

X.509v3 証明書の検証で不合格になりました。現在、この検証は Wi-Fi アクセス ポイントで実行されており、サーバー証明書の検証の不一致が原因で失敗している可能性があります。ただし、将来的には X.509v3 証明書の他の検証イベントが含まれる可能性もあります。SECURITY_LOGS の一部。

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Android の組み込み暗号ライブラリ(BoringSSL)が有効かどうかを検証します。デバイスの起動時に常に成功し、失敗した場合、デバイスは信頼できないデバイスと見なされます。SECURITY_LOGS の一部。

keyDestructionEvent

object (KeyDestructionEvent)

ユーザーがインストールした暗号鍵、管理者がインストールした秘密鍵、システムが保持する秘密鍵が、ユーザーまたは管理者によってデバイスから削除されます。SECURITY_LOGS の一部。

keyGeneratedEvent

object (KeyGeneratedEvent)

暗号鍵(ユーザーがインストールしたもの、管理者によってインストールされたもの、システムによって管理される秘密鍵を含む)が、ユーザーまたは管理者によってデバイスにインストールされます。SECURITY_LOGS の一部。

keyImportEvent

object (KeyImportEvent)

ユーザーがインストールした暗号鍵、管理者がインストールした秘密鍵、システムが管理している秘密鍵が、ユーザーまたは管理者によってデバイスにインポートされます。SECURITY_LOGS の一部。

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

暗号鍵(ユーザーがインストールしたもの、管理者がインストールしたもの、システムが保持しているものを含む)が、ストレージの破損、ハードウェア障害、または OS に関するなんらかの問題により破損していると判断されました。SECURITY_LOGS の一部。

loggingStartedEvent

object (LoggingStartedEvent)

usageLog ポリシーが有効になりました。SECURITY_LOGS の一部。

loggingStoppedEvent

object (LoggingStoppedEvent)

usageLog ポリシーを無効にしました。SECURITY_LOGS の一部。

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

監査ログバッファが容量の 90% に達したため、古いイベントは破棄される可能性があります。SECURITY_LOGS の一部。

mediaMountEvent

object (MediaMountEvent)

リムーバブル メディアがマウントされました。SECURITY_LOGS の一部。

mediaUnmountEvent

object (MediaUnmountEvent)

リムーバブル メディアのマウントが解除されました。SECURITY_LOGS の一部。

osShutdownEvent

object (OsShutdownEvent)

デバイスがシャットダウンされました。SECURITY_LOGS の一部。

osStartupEvent

object (OsStartupEvent)

デバイスが起動しました。SECURITY_LOGS の一部。

remoteLockEvent

object (RemoteLockEvent)

デバイスまたはプロファイルが LOCK コマンドでリモートでロックされています。SECURITY_LOGS の一部。

wipeFailureEvent

object (WipeFailureEvent)

仕事用プロファイルまたは会社所有デバイスのリクエスト時にワイプできなかった。これは、ユーザーによって開始されたもの、または管理者によって開始されたものになります(例: delete を受け取った)。SECURITY_LOGS の一部。

connectEvent

object (ConnectEvent)

標準のネットワーク スタックを介して TCP 接続イベントが開始されました。NETWORK_ACTIVITY_LOGS の一部。

dnsEvent

object (DnsEvent)

標準のネットワーク スタックを介して DNS ルックアップ イベントが開始されました。NETWORK_ACTIVITY_LOGS の一部。

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

デバイスの紛失モードを解除しようとしている。

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

デバイスが紛失モードのときに電話の発信が行われました。

lostModeLocationEvent

object (LostModeLocationEvent)

紛失モードのデバイスの位置情報の更新。

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

デバイスの登録が完了しました。AMAPI_LOGS の一部。

KeyguardDismissedEvent

このタイプにはフィールドがありません。

キーガードが閉じられました。意図的に空にする。

KeyguardDismissAuthAttemptEvent

デバイスのロック解除を試みた。

JSON 表現
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
フィールド
success

boolean

ロック解除に成功したかどうか。

strongAuthMethodUsed

boolean

デバイスのロック解除に強力な認証方法(パスワード、PIN、パターン)を使用したかどうか。

KeyguardSecuredEvent

このタイプにはフィールドがありません。

デバイスはユーザーまたはタイムアウトによりロックされました。意図的に空にする。

FilePulledEvent

デバイスからファイルがダウンロードされました。

JSON 表現
{
  "filePath": string
}
フィールド
filePath

string

pull されるファイルのパス。

FilePushedEvent

デバイスにファイルがアップロードされました。

JSON 表現
{
  "filePath": string
}
フィールド
filePath

string

push されるファイルのパス。

CertAuthorityInstalledEvent

新しいルート証明書がシステムの信頼できる認証情報ストレージにインストールされました。この機能は、完全管理対象デバイスでは、デバイス全体、または仕事用プロファイルが設定された組織所有デバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
フィールド
certificate

string

証明書のサブジェクト。

userId

integer

証明書のインストール イベントが発生したユーザー。Android 11 以降を搭載したデバイスでのみご利用いただけます。

success

boolean

インストール イベントが成功したかどうか。

CertAuthorityRemovedEvent

ルート証明書がシステムの信頼できる認証情報ストレージから削除されました。この機能は、完全管理対象デバイスでは、デバイス全体、または仕事用プロファイルが設定された組織所有デバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
フィールド
certificate

string

証明書のサブジェクト。

userId

integer

証明書削除イベントが発生したユーザー。Android 11 以降を搭載したデバイスでのみご利用いただけます。

success

boolean

削除が成功したかどうか。

CertValidationFailureEvent

X.509v3 証明書の検証で不合格になりました。現在、この検証は Wi-Fi アクセス ポイントで実行されており、サーバー証明書の検証の不一致が原因で失敗している可能性があります。ただし、将来的には X.509v3 証明書の他の検証イベントが含まれる可能性もあります。

JSON 表現
{
  "failureReason": string
}
フィールド
failureReason

string

認証の検証で不合格となった理由。

CryptoSelfTestCompletedEvent

Android の組み込み暗号ライブラリ(BoringSSL)が有効かどうかを検証します。デバイスの起動時に常に成功し、失敗した場合、デバイスは信頼できないデバイスと見なされます。

JSON 表現
{
  "success": boolean
}
フィールド
success

boolean

テストが成功したかどうか。

KeyDestructionEvent

ユーザーがインストールした暗号鍵、管理者がインストールした秘密鍵、システムが保持する秘密鍵が、ユーザーまたは管理者によってデバイスから削除されます。この機能は、完全管理対象デバイスでは、デバイス全体、または仕事用プロファイルが設定された組織所有デバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

鍵のエイリアス。

applicationUid

integer

鍵を所有するアプリの UID。

success

boolean

オペレーションが成功したかどうか。

KeyGeneratedEvent

暗号鍵(ユーザーがインストールしたもの、管理者がインストールしたもの、システムが保持する秘密鍵を含む)は、ユーザーまたは管理者によってデバイスにインストールされます。この暗号鍵は、完全管理対象デバイス上でデバイス全体で使用できるほか、仕事用プロファイルを使って組織所有のデバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

鍵のエイリアス。

applicationUid

integer

鍵を生成したアプリの UID。

success

boolean

オペレーションが成功したかどうか。

KeyImportEvent

ユーザーがインストールした暗号鍵、管理者がインストールした秘密鍵、システムが管理している秘密鍵が、ユーザーまたは管理者によってデバイスにインポートされます。この機能は、完全管理対象デバイスでは、デバイス全体、または仕事用プロファイルが設定された組織所有デバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
フィールド
keyAlias

string

鍵のエイリアス。

applicationUid

integer

鍵をインポートしたアプリケーションの UID

success

boolean

オペレーションが成功したかどうか。

KeyIntegrityViolationEvent

暗号鍵(ユーザーがインストールしたもの、管理者がインストールしたもの、システムが保持しているものを含む)が、ストレージの破損、ハードウェア障害、または OS に関するなんらかの問題により破損していると判断されました。この機能は、完全管理対象デバイスでは、デバイス全体、または仕事用プロファイルが設定された組織所有デバイスの仕事用プロファイル内で使用できます。

JSON 表現
{
  "keyAlias": string,
  "applicationUid": integer
}
フィールド
keyAlias

string

鍵のエイリアス。

applicationUid

integer

鍵を所有するアプリの UID

LoggingStartedEvent

このタイプにはフィールドがありません。

usageLog ポリシーが有効になりました。意図的に空にする。

LoggingStoppedEvent

このタイプにはフィールドがありません。

usageLog ポリシーを無効にしました。意図的に空にする。

LogBufferSizeCriticalEvent

このタイプにはフィールドがありません。

デバイスの usageLog バッファが容量の 90% に達したため、古いイベントは破棄される可能性があります。意図的に空にする。

MediaMountEvent

リムーバブル メディアがマウントされました。

JSON 表現
{
  "mountPoint": string,
  "volumeLabel": string
}
フィールド
mountPoint

string

マウント ポイント。

volumeLabel

string

ボリューム ラベル。組織所有の管理対象プロファイルのデバイスで空の文字列が削除されています。

MediaUnmountEvent

リムーバブル メディアのマウントが解除されました。

JSON 表現
{
  "mountPoint": string,
  "volumeLabel": string
}
フィールド
mountPoint

string

マウント ポイント。

volumeLabel

string

ボリューム ラベル。組織所有の管理対象プロファイルのデバイスで空の文字列が削除されています。

OsShutdownEvent

このタイプにはフィールドがありません。

デバイスがシャットダウンされました。意図的に空にする。

OsStartupEvent

デバイスが起動されました。

JSON 表現
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
フィールド
verifiedBootState

enum (VerifiedBootState)

確認付きブートの状態。

verityMode

enum (DmVerityMode)

dm-verity モードになります。

RemoteLockEvent

デバイスまたはプロファイルが LOCK コマンドでリモートでロックされています。

JSON 表現
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
フィールド
adminPackageName

string

変更をリクエストする管理アプリのパッケージ名。

adminUserId

integer

変更がリクエストされた管理アプリのユーザー ID。

targetUserId

integer

変更がリクエストされたユーザー ID。

WipeFailureEvent

このタイプにはフィールドがありません。

仕事用プロファイルまたは会社所有デバイスのリクエスト時にワイプできなかった。これは、ユーザーによって開始されたもの、または管理者によって開始されたものになります(例: delete を受け取った)。意図的に空にする。

ConnectEvent

標準のネットワーク スタックを介して TCP 接続イベントが開始されました。

JSON 表現
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
フィールド
destinationIpAddress

string

接続呼び出しの宛先 IP アドレス。

destinationPort

integer

connect 呼び出しの宛先ポート。

packageName

string

接続呼び出しを実行した UID のパッケージ名。

DnsEvent

標準のネットワーク スタックを介して DNS ルックアップ イベントが開始されました。

JSON 表現
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
フィールド
hostname

string

検索されたホスト名。

ipAddresses[]

string

DNS ルックアップで返された IP アドレスのリスト(切り捨てられる場合もあります)。(最大 10 個の IPv4 または IPv6 アドレス)。

totalIpAddressesReturned

string (int64 format)

DNS ルックアップ イベントから返された IP アドレスの数。ログに記録するアドレスが多すぎる場合は、ipAddresses の数より多いことがあります。

packageName

string

DNS ルックアップを実行した UID のパッケージ名。

StopLostModeUserAttemptEvent

ユーザーが紛失モードを停止しようとしたことを示す紛失モード イベント。

JSON 表現
{
  "status": enum (Status)
}
フィールド
status

enum (Status)

紛失モードを停止しようとしているステータス。

LostModeOutgoingPhoneCallEvent

このタイプにはフィールドがありません。

デバイスが紛失モードのときに電話の発信が発生したことを示すイベント。意図的に空にする。

LostModeLocationEvent

デバイスの位置情報とバッテリー残量をパーセンテージで含む紛失モードイベントです。

JSON 表現
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
フィールド
location

object (Location)

デバイスの位置情報

batteryLevel

integer

バッテリー残量(0 ~ 100 の数値)

ロケーション

緯度と経度を含むデバイスの位置情報。

JSON 表現
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

場所の緯度位置

longitude

number

場所の経度の位置

EnrollmentCompleteEvent

このタイプにはフィールドがありません。

デバイスの登録が完了したことを示します。この時点では、ユーザーはランチャーにいるはずです。この時点では、デバイスはポリシーに準拠しており、すべてのセットアップ手順は完了しています。意図的に空にする。