BatchUsageLogEvents

Log eventi in batch di events dal dispositivo.

Rappresentazione JSON 
{
  "device": string,
  "user": string,
  "retrievalTime": string,
  "usageLogEvents": [
    {
      object (UsageLogEvent)
    }
  ]
}
Campi
device

string

Il nome del dispositivo nel formato "enterprises/{enterpriseId}/devices/{deviceId}".
user

string

Il nome della risorsa dell'utente proprietario del dispositivo nel formato "enterprises/{enterpriseId}/users/{userId}".
retrievalTime

string (Timestamp format)

Il timestamp del dispositivo relativo al momento in cui il gruppo di eventi è stato raccolto dal dispositivo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
usageLogEvents[]

object (UsageLogEvent)

L'elenco di UsageLogEvent segnalati dal dispositivo, in ordine cronologico in base all'ora dell'evento.

UsageLogEvent

Un evento registrato sul dispositivo.

Rappresentazione 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.
}
Campi
eventId

string (int64 format)

ID univoco dell'evento.
eventTime

string (Timestamp format)

Timestamp del dispositivo nel momento in cui l'evento è stato registrato.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
eventType

enum (EventType)

Il tipo di evento del log di utilizzo specifico segnalato sul dispositivo. Utilizzalo per determinare a quale campo event accedere.
Campo di unione event. Tipi di eventi registrati sul dispositivo. Controlla ogni tipo di evento per maggiori dettagli su quando viene inviato, sulle limitazioni relative a quando viene registrato e sui campi inclusi. event può essere solo uno dei seguenti:
adbShellCommandEvent

object (AdbShellCommandEvent)

È stato inviato un comando della shell su ADB tramite "comando adb shell". Parte di SECURITY_LOGS.
adbShellInteractiveEvent

object (AdbShellInteractiveEvent)

Una shell interattiva ADB è stata aperta tramite "adb shell". Parte di SECURITY_LOGS.
appProcessStartEvent

object (AppProcessStartEvent)

È stato avviato un processo dell'app. Parte di SECURITY_LOGS.
keyguardDismissedEvent

object (KeyguardDismissedEvent)

Il blocco tastiera è stato ignorato. Parte di SECURITY_LOGS.
keyguardDismissAuthAttemptEvent

object (KeyguardDismissAuthAttemptEvent)

È stato eseguito un tentativo di sblocco del dispositivo. Parte di SECURITY_LOGS.
keyguardSecuredEvent

object (KeyguardSecuredEvent)

Il dispositivo è stato bloccato per utente o timeout. Parte di SECURITY_LOGS.
filePulledEvent

object (FilePulledEvent)

È stato scaricato un file dal dispositivo. Parte di SECURITY_LOGS.
filePushedEvent

object (FilePushedEvent)

Sul dispositivo è stato caricato un file. Parte di SECURITY_LOGS.
certAuthorityInstalledEvent

object (CertAuthorityInstalledEvent)

Un nuovo certificato radice è stato installato nell'archivio credenziali attendibili del sistema. Parte di SECURITY_LOGS.
certAuthorityRemovedEvent

object (CertAuthorityRemovedEvent)

Un certificato radice è stato rimosso dall'archivio credenziali attendibili del sistema. Parte di SECURITY_LOGS.
certValidationFailureEvent

object (CertValidationFailureEvent)

Impossibile convalidare un certificato X.509v3. Attualmente questa convalida viene eseguita nel punto di accesso Wi-Fi e l'errore potrebbe essere dovuto a una mancata corrispondenza nella convalida del certificato del server. Tuttavia, in futuro potrebbero includere altri eventi di convalida di un certificato X.509v3. Parte di SECURITY_LOGS.
cryptoSelfTestCompletedEvent

object (CryptoSelfTestCompletedEvent)

Verifica se la libreria crittografica integrata di Android (BoringSSL) è valida. Se l'operazione non va a buon fine, il dispositivo deve essere considerato non attendibile all'avvio del dispositivo. Parte di SECURITY_LOGS.
keyDestructionEvent

object (KeyDestructionEvent)

Una chiave di crittografia che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema viene rimossa dal dispositivo dall'utente o dal gestore. Parte di SECURITY_LOGS.
keyGeneratedEvent

object (KeyGeneratedEvent)

Sul dispositivo viene installata sul dispositivo una chiave di crittografia che include la chiave installata dall'utente, installata dall'amministratore e gestita dal sistema. Parte di SECURITY_LOGS.
keyImportEvent

object (KeyImportEvent)

Una chiave di crittografia che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema viene importata sul dispositivo dall'utente o dal gestore. Parte di SECURITY_LOGS.
keyIntegrityViolationEvent

object (KeyIntegrityViolationEvent)

Una chiave di crittografia, inclusa la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, risulta danneggiata a causa di problemi di archiviazione, guasti hardware o problemi del sistema operativo. Parte di SECURITY_LOGS.
loggingStartedEvent

object (LoggingStartedEvent)

Il criterio usageLog è stato attivato. Parte di SECURITY_LOGS.
loggingStoppedEvent

object (LoggingStoppedEvent)

Il criterio usageLog è stato disattivato. Parte di SECURITY_LOGS.
logBufferSizeCriticalEvent

object (LogBufferSizeCriticalEvent)

Il buffer degli audit log ha raggiunto il 90% della sua capacità, pertanto gli eventi meno recenti potrebbero essere eliminati. Parte di SECURITY_LOGS.
mediaMountEvent

object (MediaMountEvent)

Il supporto rimovibile è stato montato. Parte di SECURITY_LOGS.
mediaUnmountEvent

object (MediaUnmountEvent)

Il supporto rimovibile è stato smontato. Parte di SECURITY_LOGS.
osShutdownEvent

object (OsShutdownEvent)

Il dispositivo è stato spento. Parte di SECURITY_LOGS.
osStartupEvent

object (OsStartupEvent)

Il dispositivo è stato avviato. Parte di SECURITY_LOGS.
remoteLockEvent

object (RemoteLockEvent)

Il dispositivo o il profilo è stato bloccato da remoto tramite il comando LOCK. Parte di SECURITY_LOGS.
wipeFailureEvent

object (WipeFailureEvent)

La cancellazione dei dati del profilo di lavoro o del dispositivo di proprietà dell'azienda non è riuscita quando è stato richiesto. Potrebbe essere avviato dall'utente o dall'amministratore, ad esempio la ricezione di delete. Parte di SECURITY_LOGS.
connectEvent

object (ConnectEvent)

È stato avviato un evento di connessione TCP tramite lo stack di rete standard. Parte di NETWORK_ACTIVITY_LOGS.
dnsEvent

object (DnsEvent)

È stato avviato un evento di ricerca DNS tramite lo stack di rete standard. Parte di NETWORK_ACTIVITY_LOGS.
stopLostModeUserAttemptEvent

object (StopLostModeUserAttemptEvent)

Tentativo di disattivare la modalità Dispositivo smarrito di un dispositivo.
lostModeOutgoingPhoneCallEvent

object (LostModeOutgoingPhoneCallEvent)

È stata effettuata una chiamata in uscita quando un dispositivo si trova in modalità Dispositivo smarrito.
lostModeLocationEvent

object (LostModeLocationEvent)

Un aggiornamento della posizione in modalità Dispositivo smarrito quando un dispositivo si trova in modalità Dispositivo smarrito.
enrollmentCompleteEvent

object (EnrollmentCompleteEvent)

Registrazione del dispositivo completata. Parte di AMAPI_LOGS.

KeyguardDismissedEvent

Questo tipo non contiene campi.

Il blocco tastiera è stato ignorato. Vuoto deliberatamente.

KeyguardDismissAuthAttemptEvent

È stato eseguito un tentativo di sblocco del dispositivo.

Rappresentazione JSON 
{
  "success": boolean,
  "strongAuthMethodUsed": boolean
}
Campi
success

boolean

Indica se il tentativo di sblocco è riuscito.
strongAuthMethodUsed

boolean

Indica se è stata utilizzata una forma di autenticazione avanzata (password, PIN o sequenza) per sbloccare il dispositivo.

KeyguardSecuredEvent

Questo tipo non contiene campi.

Il dispositivo è stato bloccato per utente o timeout. Vuoto deliberatamente.

FilePulledEvent

È stato scaricato un file dal dispositivo.

Rappresentazione JSON 
{
  "filePath": string
}
Campi
filePath

string

Il percorso del file di cui viene eseguito il pull.

FilePushedEvent

Sul dispositivo è stato caricato un file.

Rappresentazione JSON 
{
  "filePath": string
}
Campi
filePath

string

Il percorso del file di cui viene eseguito il push.

CertAuthorityInstalledEvent

Un nuovo certificato radice è stato installato nell'archivio credenziali attendibili del sistema. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campi
certificate

string

Oggetto del certificato.
userId

integer

L'utente in cui si è verificato l'evento di installazione del certificato. Disponibile solo per dispositivi con Android 11 e versioni successive.
success

boolean

Indica se l'evento di installazione è riuscito.

CertAuthorityRemovedEvent

Un certificato radice è stato rimosso dall'archivio credenziali attendibili del sistema. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "certificate": string,
  "userId": integer,
  "success": boolean
}
Campi
certificate

string

Oggetto del certificato.
userId

integer

L'utente in cui si è verificato l'evento di rimozione del certificato. Disponibile solo per dispositivi con Android 11 e versioni successive.
success

boolean

Se la rimozione è riuscita.

CertValidationFailureEvent

Impossibile convalidare un certificato X.509v3. Attualmente questa convalida viene eseguita nel punto di accesso Wi-Fi e l'errore potrebbe essere dovuto a una mancata corrispondenza nella convalida del certificato del server. Tuttavia, in futuro potrebbero includere altri eventi di convalida di un certificato X.509v3.

Rappresentazione JSON 
{
  "failureReason": string
}
Campi
failureReason

string

Il motivo per cui la convalida della certificazione non è riuscita.

CryptoSelfTestCompletedEvent

Verifica se la libreria crittografica integrata di Android (BoringSSL) è valida. Se l'operazione non va a buon fine, il dispositivo deve essere considerato non attendibile all'avvio del dispositivo.

Rappresentazione JSON 
{
  "success": boolean
}
Campi
success

boolean

Se il test è riuscito.

KeyDestructionEvent

Una chiave di crittografia che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema viene rimossa dal dispositivo dall'utente o dal gestore. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.
applicationUid

integer

UID dell'applicazione proprietaria della chiave.
success

boolean

Se l'operazione è riuscita.

KeyGeneratedEvent

Sul dispositivo viene installata sul dispositivo una chiave di crittografia che include le chiavi installate dall'utente, quelle installate dall'amministratore e quelle gestite dal sistema.Questa chiave è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.
applicationUid

integer

UID dell'applicazione che ha generato la chiave.
success

boolean

Se l'operazione è riuscita.

KeyImportEvent

Una chiave di crittografia che include la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema viene importata sul dispositivo dall'utente o dal gestore. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "keyAlias": string,
  "applicationUid": integer,
  "success": boolean
}
Campi
keyAlias

string

Alias della chiave.
applicationUid

integer

UID dell'applicazione che ha importato la chiave
success

boolean

Se l'operazione è riuscita.

KeyIntegrityViolationEvent

Una chiave di crittografia, inclusa la chiave privata installata dall'utente, installata dall'amministratore e gestita dal sistema, risulta danneggiata a causa di problemi di archiviazione, guasti hardware o problemi del sistema operativo. Questa funzionalità è disponibile a livello di dispositivo sui dispositivi completamente gestiti e all'interno del profilo di lavoro sui dispositivi di proprietà dell'organizzazione con un profilo di lavoro.

Rappresentazione JSON 
{
  "keyAlias": string,
  "applicationUid": integer
}
Campi
keyAlias

string

Alias della chiave.
applicationUid

integer

UID dell'applicazione proprietaria della chiave

LoggingStartedEvent

Questo tipo non contiene campi.

Il criterio usageLog è stato attivato. Vuoto deliberatamente.

LoggingStoppedEvent

Questo tipo non contiene campi.

Il criterio usageLog è stato disattivato. Vuoto deliberatamente.

LogBufferSizeCriticalEvent

Questo tipo non contiene campi.

Il buffer usageLog sul dispositivo ha raggiunto il 90% della sua capacità, pertanto è possibile che vengano eliminati eventi meno recenti. Vuoto deliberatamente.

MediaMountEvent

Il supporto rimovibile è stato montato.

Rappresentazione JSON 
{
  "mountPoint": string,
  "volumeLabel": string
}
Campi
mountPoint

string

Punto di montaggio.
volumeLabel

string

Etichetta del volume. Oscurato in stringa vuota sui dispositivi con profili gestiti di proprietà dell'organizzazione.

MediaUnmountEvent

Il supporto rimovibile è stato smontato.

Rappresentazione JSON 
{
  "mountPoint": string,
  "volumeLabel": string
}
Campi
mountPoint

string

Punto di montaggio.
volumeLabel

string

Etichetta del volume. Oscurato in stringa vuota sui dispositivi con profili gestiti di proprietà dell'organizzazione.

OsShutdownEvent

Questo tipo non contiene campi.

Il dispositivo è stato spento. Vuoto deliberatamente.

OsStartupEvent

Il dispositivo è stato avviato.

Rappresentazione JSON 
{
  "verifiedBootState": enum (VerifiedBootState),
  "verityMode": enum (DmVerityMode)
}
Campi
verifiedBootState

enum (VerifiedBootState)

Stato di avvio verificato.
verityMode

enum (DmVerityMode)

modalità dm-verity.

RemoteLockEvent

Il dispositivo o il profilo è stato bloccato da remoto tramite il comando LOCK.

Rappresentazione JSON 
{
  "adminPackageName": string,
  "adminUserId": integer,
  "targetUserId": integer
}
Campi
adminPackageName

string

Nome del pacchetto dell'app di amministrazione che richiede la modifica.
adminUserId

integer

ID utente dell'app di amministrazione da cui è stata richiesta la modifica.
targetUserId

integer

ID utente in cui è stata richiesta la modifica.

WipeFailureEvent

Questo tipo non contiene campi.

La cancellazione dei dati del profilo di lavoro o del dispositivo di proprietà dell'azienda non è riuscita quando è stato richiesto. Potrebbe essere avviato dall'utente o dall'amministratore, ad esempio la ricezione di delete. Vuoto deliberatamente.

ConnectEvent

È stato avviato un evento di connessione TCP tramite lo stack di rete standard.

Rappresentazione JSON 
{
  "destinationIpAddress": string,
  "destinationPort": integer,
  "packageName": string
}
Campi
destinationIpAddress

string

L'indirizzo IP di destinazione della chiamata Connect.
destinationPort

integer

La porta di destinazione della chiamata Connect.
packageName

string

Il nome del pacchetto dell'UID che ha eseguito la chiamata di connessione.

DnsEvent

È stato avviato un evento di ricerca DNS tramite lo stack di rete standard.

Rappresentazione JSON 
{
  "hostname": string,
  "ipAddresses": [
    string
  ],
  "totalIpAddressesReturned": string,
  "packageName": string
}
Campi
hostname

string

Il nome host che è stato cercato.
ipAddresses[]

string

L'elenco (possibilmente troncato) degli indirizzi IP restituiti per la ricerca DNS (massimo 10 indirizzi IPv4 o IPv6).
totalIpAddressesReturned

string (int64 format)

Il numero di indirizzi IP restituiti dall'evento di ricerca DNS. Può essere superiore al numero di ipAddress se sono presenti troppi indirizzi da registrare.
packageName

string

Il nome del pacchetto dell'UID che ha eseguito la ricerca DNS.

StopLostModeUserAttemptEvent

Un evento relativo alla modalità Dispositivo smarrito che indica che l'utente ha tentato di interrompere tale modalità.

Rappresentazione JSON 
{
  "status": enum (Status)
}
Campi
status

enum (Status)

Lo stato del tentativo di interrompere la modalità Dispositivo smarrito.

LostModeOutgoingPhoneCallEvent

Questo tipo non contiene campi.

Un evento che indica che è stata effettuata una telefonata in uscita quando un dispositivo è in modalità Dispositivo smarrito. Vuoto deliberatamente.

LostModeLocationEvent

Un evento relativo alla modalità Dispositivo smarrito contenente la posizione del dispositivo e il livello della batteria in percentuale.

Rappresentazione JSON 
{
  "location": {
    object (Location)
  },
  "batteryLevel": integer
}
Campi
location

object (Location)

La posizione del dispositivo
batteryLevel

integer

Il livello della batteria espresso in un numero compreso tra 0 e 100 inclusi.

Località

La posizione del dispositivo contenente la latitudine e la longitudine.

Rappresentazione JSON 
{
  "latitude": number,
  "longitude": number
}
Campi
latitude

number

La posizione della latitudine della località
longitude

number

La posizione della longitudine della località

EnrollmentCompleteEvent

Questo tipo non contiene campi.

Rappresenta che il dispositivo ha completato la registrazione. A questo punto l'utente dovrebbe essere in Avvio app, il dispositivo sarà conforme e tutti i passaggi di configurazione sono stati completati. Vuoto deliberatamente.