Questo articolo è destinato ad amministratori o partner di terze parti che utilizzano l'API Chrome Management Telemetry.
In qualità di amministratore di Chrome, puoi utilizzare l'API Chrome Management Telemetry per monitorare il funzionamento e l'integrità dei dispositivi ChromeOS, aiutandoti con l'analisi delle cause principali e la risoluzione dei problemi.
Utilizzando le notifiche dell'API Chrome Management Telemetry, puoi creare una sottoscrizione e ricevere notifiche degli eventi dell'API Telemetry utilizzando Google Cloud Pub/Sub.
Per maggiori dettagli, consulta API Chrome Management Telemetry.
Google Cloud Pub/Sub
Con Google Cloud Pub/Sub, puoi creare un sistema di produttori e consumer di eventi, denominati publisher e sottoscrittori. Questo sistema trasmette le pipeline di analisi e integrazione dei dati per ricevere e distribuire i dati.
I publisher comunicano con i sottoscrittori in modo asincrono trasmettendo eventi. Inviano eventi al servizio Pub/Sub, indipendentemente da come o quando questi vengano elaborati. Pub/Sub poi invia gli eventi a tutti i servizi che ne hanno bisogno. Pub/Sub non deve attendere che gli iscritti ricevano i dati, il che aumenta la flessibilità del sistema.
Prima di iniziare
Prima di poter collegare le notifiche dell'API Chrome Management Telemetry a Google Cloud Pub/Sub, verifica quanto segue:
- Disponi dell'accesso come super amministratore alla Console di amministrazione Google. Per questa operazione è necessario un Account Google gestito e un dominio verificato. Per maggiori dettagli, vedi Entrare a far parte della propria organizzazione Chrome gestita.
- I tuoi dispositivi ChromeOS sono registrati nel dominio utilizzato per accedere alla Console di amministrazione. Per maggiori dettagli, consulta l'articolo Registrare i dispositivi ChromeOS.
- Devi avere un progetto Google Cloud per attivare Pub/Sub per le notifiche.
Passaggio 1: attiva le notifiche di Chrome Management Telemetry
-
Accedi alla Console di amministrazione Google.
Accedi utilizzando l'account amministratore (che non termina con @gmail.com).
-
Nella Console di amministrazione, vai a Menu
Dispositivi
Chrome
- Per applicare l'impostazione a tutti gli utenti e ai browser registrati, lascia selezionata l'unità organizzativa principale. Altrimenti, seleziona un'unità organizzativa secondaria.
- Vai a Rapporti su dispositivi e utenti.
- Fai clic su Includi la telemetria del dispositivo nei report.
- Seleziona Attiva tutti i report sulla telemetria.
- Fai clic su Salva.
Dopo aver attivato i report sulla telemetria, puoi creare una sottoscrizione per vari tipi di eventi che si verificano sui dispositivi ChromeOS della tua organizzazione. Le notifiche di questi eventi vengono inviate al relativo argomento Pub/Sub configurato.
Passaggio 2: crea un argomento Pub/Sub in un progetto Google Cloud
Per maggiori dettagli, vedi Integrare Google Cloud Pub/Sub con Chrome Enterprise Core.
- Accedi alla piattaforma Google Cloud.
- Nella sezione Pub/Sub, vai alla pagina Argomenti.
- Seleziona un argomento esistente o fai clic su Crea argomento.
- Inserisci un ID argomento e fai clic su Crea argomento.
- Seleziona l'argomento che hai creato per ricevere gli eventi da Chrome.
- In Autorizzazioni, fai clic su Aggiungi membro.
- In Nuove entità, inserisci cloud-pub-sub-publisher@chrome-reporting.iam.gserviceaccount.com.
Questo è l'account utilizzato dal server di Google per effettuare chiamate all'API Publish per l'argomento Pub/Sub. L'argomento deve concedere l'accesso con diritti di pubblicazione a questo account. - In Ruolo, seleziona Pub/Sub Publisher.
- Fai clic su Salva.
- Copia il percorso completo dell'argomento e salvalo per i passaggi successivi nella Console di amministrazione.
Passaggio 3: registra l'argomento Pub/Sub e crea le configurazioni di notifica
Per creare configurazioni di notifica, devi chiamare l'API Telemetry di Chrome Management. I link riportati di seguito forniscono le informazioni aggiuntive di cui hai bisogno.
- Per scoprire come accedere all'API Chrome Management Telemetry, consulta questa guida generale.
- Per scoprire come creare una configurazione di notifica, consulta questa pagina. Puoi chiamare l'API con notifiche per Telemetry e creare configurazioni di notifica inviando una richiesta POST.
- Nel corpo, sostituisci google_cloud_pubsub_topic con il tuo argomento.
Ad esempio, per configurare le notifiche degli eventi per le notifiche di dispositivi USB aggiunti e rimossi, imposta:
- Nel corpo, sostituisci google_cloud_pubsub_topic con il tuo argomento.
{
"google_cloud_pubsub_topic": "projects/your-project/topics/your-topic",
"filter": {
"telemetry_event_notification_filter": {
"event_types": [
"USB_ADDED",
"USB_REMOVED"
]
}
}
}
Passaggio 4: inizia a ricevere le notifiche dell'API Chrome Management Telemetry
Puoi ricevere notifiche nei seguenti modi: