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)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

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)
  },
  "backupServiceToggledEvent": {
    object (BackupServiceToggledEvent)
  }
  // End of list of possible types for union field event.
}
フィールド
eventId

string (int64 format)

イベントの一意の ID。

eventTime

string (Timestamp format)

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

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z""2014-10-02T15:01:23+05:30"

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 の一部。

backupServiceToggledEvent

object (BackupServiceToggledEvent)

管理者がバックアップ サービスを有効または無効にしました。SECURITY_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

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

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

接続呼び出しの宛先ポート。

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

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

デバイスの登録が完了したことを表します。この時点でユーザーはランチャーに移動し、デバイスは準拠状態になり、すべてのセットアップ手順が完了しています。意図的に空にしています。