BatchUsageLogEvents

Logs de eventos em lote de events do dispositivo.

Representação JSON
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
Campos
device

string

O nome do dispositivo no formato "enterprise/{enterpriseId}/devices/{deviceId}"

user

string

O nome do recurso do usuário proprietário do dispositivo no formato "enterprise/{enterpriseId}/users/{userId}".

retrievalTime

string (Timestamp format)

O carimbo de data/hora do dispositivo quando o lote de eventos foi coletado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

usageLogEvents[]

object (UsageLogEvent)

A lista de UsageLogEvent que foram informados pelo dispositivo, classificada cronologicamente pelo horário do evento.

UsageLogEvent

Um evento registrado no dispositivo

Representação 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.
}
Campos
eventId

string (int64 format)

ID exclusivo do evento.

eventTime

string (Timestamp format)

Carimbo de data/hora do dispositivo em que o evento foi registrado.

Um carimbo de data/hora no formato UTC "Zulu" RFC3339, com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

eventType

enum (EventType)

O tipo de evento de registro de uso específico que foi relatado no dispositivo. Use isso para determinar qual campo do event será acessado.

Campo de união event. Tipos de eventos registrados no dispositivo. Consulte cada tipo de evento para mais detalhes sobre quando ele é enviado e restrições sobre quando o evento é registrado e quais campos são incluídos. event pode ser apenas de um dos tipos a seguir:
adbShellCommandEvent

object (AdbShellCommandEvent)

Um comando do shell foi emitido pelo ADB pelo "comando adb shell". Parte do SECURITY_LOGS.

adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Um shell interativo do adb foi aberto pelo "adb shell". Parte do SECURITY_LOGS.

appProcessStartEvent

object (AppProcessStartEvent)

Um processo de app foi iniciado. Parte do SECURITY_LOGS.

keyguardDismissedEvent

object (KeyguardDismissedEvent)

O bloqueio de teclado foi dispensado. Parte do SECURITY_LOGS.

keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

Houve uma tentativa de desbloquear o dispositivo. Parte do SECURITY_LOGS.

keyguardSecuredEvent

object (KeyguardSecuredEvent)

O dispositivo foi bloqueado pelo usuário ou pelo tempo limite. Parte do SECURITY_LOGS.

filePulledEvent

object (FilePulledEvent)

Foi feito o download de um arquivo do dispositivo. Parte do SECURITY_LOGS.

filePushedEvent

object (FilePushedEvent)

Um arquivo foi enviado para o dispositivo. Parte do SECURITY_LOGS.

certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Um novo certificado raiz foi instalado no armazenamento de credenciais confiáveis do sistema. Parte do SECURITY_LOGS.

certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Um certificado raiz foi removido do armazenamento de credenciais confiáveis do sistema. Parte do SECURITY_LOGS.

certValidationFailureEvent

object (CertValidationFailureEvent)

Um certificado X.509v3 não foi validado. Atualmente, essa validação é realizada no ponto de acesso Wi-Fi e a falha pode ser devido a uma incompatibilidade na validação do certificado do servidor. Mas ela pode incluir outros eventos de validação de um certificado X.509v3 no futuro. Parte do SECURITY_LOGS.

cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Valida se a biblioteca criptográfica integrada do Android (BoringSSL) é válida. Precisa ser sempre bem-sucedido na inicialização do dispositivo. Se falhar, o dispositivo deve ser considerado não confiável. Parte do SECURITY_LOGS.

keyDestructionEvent

object (KeyDestructionEvent)

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e a chave privada mantida pelo sistema, é removida do dispositivo pelo usuário ou pelo gerenciamento. Parte do SECURITY_LOGS.

keyGeneratedEvent

object (KeyGeneratedEvent)

Uma chave criptográfica, incluindo as instaladas pelo usuário, pelo administrador e mantida pelo sistema, é instalada no dispositivo, seja pelo usuário ou pelo gerenciamento. Parte do SECURITY_LOGS.

keyImportEvent

object (KeyImportEvent)

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e a chave privada mantida pelo sistema, é importada para o dispositivo pelo usuário ou pelo gerenciamento. Parte do SECURITY_LOGS.

keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e privada mantida pelo sistema, está corrompida devido a corrupção de armazenamento, falha de hardware ou problema no SO. Parte do SECURITY_LOGS.

loggingStartedEvent

object (LoggingStartedEvent)

A política usageLog foi ativada. Parte do SECURITY_LOGS.

loggingStoppedEvent

object (LoggingStoppedEvent)

A política usageLog foi desativada. Parte do SECURITY_LOGS.

logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

O buffer do registro de auditoria atingiu 90% da capacidade. Portanto, é possível que os eventos mais antigos sejam descartados. Parte do SECURITY_LOGS.

mediaMountEvent

object (MediaMountEvent)

A mídia removível foi instalada. Parte do SECURITY_LOGS.

mediaUnmountEvent

object (MediaUnmountEvent)

A mídia removível foi desconectada. Parte do SECURITY_LOGS.

osShutdownEvent

object (OsShutdownEvent)

O dispositivo foi desligado. Parte do SECURITY_LOGS.

osStartupEvent

object (OsStartupEvent)

O dispositivo foi iniciado. Parte do SECURITY_LOGS.

remoteLockEvent

object (RemoteLockEvent)

O dispositivo ou perfil foi bloqueado remotamente pelo comando LOCK. Parte do SECURITY_LOGS.

wipeFailureEvent

object (WipeFailureEvent)

Não era possível excluir permanentemente o perfil de trabalho ou o dispositivo da empresa quando solicitado. Essa ação pode ser iniciada pelo usuário ou pelo administrador, por exemplo, o e-mail delete foi recebido. Parte do SECURITY_LOGS.

connectEvent

object (ConnectEvent)

Um evento de conexão TCP foi iniciado pela pilha de rede padrão. Parte do NETWORK_ACTIVITY_LOGS.

dnsEvent

object (DnsEvent)

Um evento de busca DNS foi iniciado pela pilha de rede padrão. Parte do NETWORK_ACTIVITY_LOGS.

stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Tentativa de tirar um dispositivo do Modo perdido.

lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

Uma chamada telefônica foi efetuada quando um dispositivo estava no Modo perdido.

lostModeLocationEvent

object (LostModeLocationEvent)

Uma atualização de localização do Modo perdido quando um dispositivo está no Modo perdido.

enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

O registro do dispositivo foi concluído. Parte do AMAPI_LOGS.

KeyguardDismissedEvent

Esse tipo não tem campos.

O bloqueio de teclado foi dispensado. Intencionalmente vazio.

KeyguardDismissAuthAttemptEvent

Houve uma tentativa de desbloquear o dispositivo.

Representação JSON
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
Campos
success

boolean

Se a tentativa de desbloqueio foi bem-sucedida.

strongAuthMethodUsed

boolean

Se uma forma forte de autenticação (senha, PIN ou padrão) foi usada para desbloquear o dispositivo.

KeyguardSecuredEvent

Esse tipo não tem campos.

O dispositivo foi bloqueado pelo usuário ou pelo tempo limite. Intencionalmente vazio.

FilePulledEvent

Foi feito o download de um arquivo do dispositivo.

Representação JSON
{
  "filePath": string
}
Campos
filePath

string

O caminho do arquivo que está sendo extraído.

FilePushedEvent

Um arquivo foi enviado para o dispositivo.

Representação JSON
{
  "filePath": string
}
Campos
filePath

string

O caminho do arquivo que está sendo enviado por push.

CertAuthorityInstalledEvent

Um novo certificado raiz foi instalado no armazenamento de credenciais confiáveis do sistema. Esse recurso está disponível em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campos
certificate

string

Assunto do certificado.

userId

integer

O usuário em que o evento de instalação do certificado ocorreu. Disponível apenas para dispositivos com Android 11 e versões mais recentes.

success

boolean

Se o evento de instalação foi bem-sucedido.

CertAuthorityRemovedEvent

Um certificado raiz foi removido do armazenamento de credenciais confiáveis do sistema. Esse recurso está disponível em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campos
certificate

string

Assunto do certificado.

userId

integer

O usuário em que o evento de remoção do certificado ocorreu. Disponível apenas para dispositivos com Android 11 e versões mais recentes.

success

boolean

Indica se a remoção foi bem-sucedida.

CertValidationFailureEvent

Um certificado X.509v3 não foi validado. Atualmente, essa validação é realizada no ponto de acesso Wi-Fi e a falha pode ser devido a uma incompatibilidade na validação do certificado do servidor. Mas ela pode incluir outros eventos de validação de um certificado X.509v3 no futuro.

Representação JSON
{
  "failureReason": string
}
Campos
failureReason

string

O motivo da falha na validação da certificação.

CryptoSelfTestCompletedEvent

Valida se a biblioteca criptográfica integrada do Android (BoringSSL) é válida. Precisa ser sempre bem-sucedido na inicialização do dispositivo. Se falhar, o dispositivo deve ser considerado não confiável.

Representação JSON
{
  "success": boolean
}
Campos
success

boolean

Indica se o teste foi bem-sucedido.

KeyDestructionEvent

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e a chave privada mantida pelo sistema, é removida do dispositivo pelo usuário ou pelo gerenciamento. Esse recurso está disponível em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campos
keyAlias

string

Alias da chave.

applicationUid

integer

UID do aplicativo que tem a chave.

success

boolean

Se a operação foi bem-sucedida.

KeyGeneratedEvent

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e a chave privada mantida pelo sistema, é instalada no dispositivo pelo usuário ou pelo gerenciamento.Ela está disponível para todos os dispositivos em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campos
keyAlias

string

Alias da chave.

applicationUid

integer

UID do aplicativo que gerou a chave.

success

boolean

Se a operação foi bem-sucedida.

KeyImportEvent

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e a chave privada mantida pelo sistema, é importada para o dispositivo pelo usuário ou pelo gerenciamento. Esse recurso está disponível em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campos
keyAlias

string

Alias da chave.

applicationUid

integer

UID do aplicativo que importou a chave

success

boolean

Se a operação foi bem-sucedida.

KeyIntegrityViolationEvent

Uma chave criptográfica, incluindo a instalada, instalada pelo administrador e privada mantida pelo sistema, está corrompida devido a corrupção de armazenamento, falha de hardware ou problema no SO. Esse recurso está disponível em dispositivos totalmente gerenciados e no perfil de trabalho em dispositivos da organização com um perfil de trabalho.

Representação JSON
{
  "keyAlias": string,
  "applicationUid": integer
}
Campos
keyAlias

string

Alias da chave.

applicationUid

integer

UID do aplicativo que tem a chave

LoggingStartedEvent

Esse tipo não tem campos.

A política usageLog foi ativada. Intencionalmente vazio.

LoggingStoppedEvent

Esse tipo não tem campos.

A política usageLog foi desativada. Intencionalmente vazio.

LogBufferSizeCriticalEvent

Esse tipo não tem campos.

O buffer usageLog no dispositivo atingiu 90% da capacidade. Portanto, eventos mais antigos podem ser descartados. Intencionalmente vazio.

MediaMountEvent

A mídia removível foi instalada.

Representação JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Campos
mountPoint

string

Ponto de montagem.

volumeLabel

string

Marcador de volume. Editado para uma string vazia em dispositivos com perfil gerenciado da organização.

MediaUnmountEvent

A mídia removível foi desconectada.

Representação JSON
{
  "mountPoint": string,
  "volumeLabel": string
}
Campos
mountPoint

string

Ponto de montagem.

volumeLabel

string

Marcador de volume. Editado para uma string vazia em dispositivos com perfil gerenciado da organização.

OsShutdownEvent

Esse tipo não tem campos.

O dispositivo foi desligado. Intencionalmente vazio.

OsStartupEvent

O dispositivo foi iniciado.

Representação JSON
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
Campos
verifiedBootState

enum (VerifiedBootState)

Estado de inicialização verificada.

verityMode

enum (DmVerityMode)

modo dm-verity.

RemoteLockEvent

O dispositivo ou perfil foi bloqueado remotamente pelo comando LOCK.

Representação JSON
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Campos
adminPackageName

string

Nome do pacote do app de administrador que solicita a mudança.

adminUserId

integer

ID do usuário do app de administrador em que a mudança foi solicitada.

targetUserId

integer

ID do usuário em que a alteração foi solicitada.

WipeFailureEvent

Esse tipo não tem campos.

Não era possível excluir permanentemente o perfil de trabalho ou o dispositivo da empresa quando solicitado. Essa ação pode ser iniciada pelo usuário ou pelo administrador, por exemplo, o e-mail delete foi recebido. Intencionalmente vazio.

ConnectEvent

Um evento de conexão TCP foi iniciado pela pilha de rede padrão.

Representação JSON
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
Campos
destinationIpAddress

string

O endereço IP de destino da chamada de conexão.

destinationPort

integer

A porta de destino da chamada de conexão.

packageName

string

O nome do pacote do UID que executou a chamada de conexão.

DnsEvent

Um evento de busca DNS foi iniciado pela pilha de rede padrão.

Representação JSON
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Campos
hostname

string

O nome do host que foi pesquisado.

ipAddresses[]

string

A lista (possivelmente truncada) dos endereços IP retornados para busca DNS (máximo de 10 endereços IPv4 ou IPv6).

totalIpAddressesReturned

string (int64 format)

O número de endereços IP retornados do evento de busca DNS. Pode ser maior do que a quantidade de ipAddresses se houver muitos endereços para registrar.

packageName

string

O nome do pacote do UID que executou a busca DNS.

StopLostModeUserAttemptEvent

Um evento do modo perdido que indica que o usuário tentou parar o modo perdido.

Representação JSON
{
  "status": enum (Status)
}
Campos
status

enum (Status)

O status da tentativa de interromper o Modo perdido.

LostModeOutgoingPhoneCallEvent

Esse tipo não tem campos.

Um evento que indica que uma chamada telefônica foi realizada quando um dispositivo está no Modo perdido. Intencionalmente vazio.

LostModeLocationEvent

Um evento do Modo perdido que contém a localização do dispositivo e o nível da bateria como porcentagem.

Representação JSON
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
Campos
location

object (Location)

O local do dispositivo

batteryLevel

integer

O nível de bateria como um número entre 0 e 100

Local

A localização do dispositivo com a latitude e a longitude.

Representação JSON
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A posição de latitude do local

longitude

number

A posição de longitude do local

EnrollmentCompleteEvent

Esse tipo não tem campos.

Representa que o dispositivo concluiu o registro. O usuário deve estar na tela de início. Neste momento, o dispositivo estará em compliance e todas as etapas de configuração foram concluídas. Intencionalmente vazio.