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 command」を介して ADB でシェルコマンドが実行されました。SECURITY_LOGS の一部。

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

「adb shell」で ADB インタラクティブ シェルを開きました。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

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

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

connect 呼び出しの宛先 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

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

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