Как использовать уведомления Chrome Management Telemetry API

Эта статья предназначена для администраторов и внешних партнеров, использующих Chrome Management Telemetry API.

Chrome Management Telemetry API помогает администраторам Chrome отслеживать работу и состояние устройств с ChromeOS, анализировать основные причины неполадок и устранять их.

Вы можете включить уведомления Chrome Management Telemetry API и узнавать о событиях Telemetry API через Google Cloud Pub/Sub.

Подробнее о Chrome Management Telemetry API…

Google Cloud Pub/Sub

С помощью Google Cloud Pub/Sub вы можете создать систему организаторов и участников событий (издателей и подписчиков). Эта система обеспечивает потоковую аналитику и конвейер интеграции данных для получения и распространения данных.

Издатели взаимодействуют с подписчиками асинхронно через трансляцию событий. Они отправляют события в сервис Pub/Sub независимо от того, как и когда эти события обрабатываются. После этого Pub/Sub отправляет события во все сервисы, которым они требуются. Сервису не нужно ждать, пока подписчики получат данные, в результате чего повышается эффективность работы системы.

Подготовка

Перед тем как подключить уведомления Chrome Management Telemetry API к Google Cloud Pub/Sub, убедитесь, что соблюдены следующие условия:

• У вас есть права суперадминистратора и доступ к консоли администратора Google. Для этого требуется управляемый аккаунт Google и домен с подтвержденным правом собственности. Подробнее о том, как присоединиться к управляемой организации Chrome…
• Ваши устройства с ChromeOS зарегистрированы в домене, который используется для доступа к консоли администратора. Подробнее о том, как регистрировать устройства с ChromeOS…
• У вас есть проект Google Cloud, в котором можно включить Pub/Sub для уведомлений.

Шаг 1. Включите уведомления Chrome Management Telemetry

1. Войдите в консоль администратора Google.

   Войдите в аккаунт администратора (он не заканчивается на @gmail.com).

2. В консоли администратора нажмите на значок меню УстройстваChromeНастройкиНастройки устройств.
3. Чтобы применить настройки ко всем пользователям и зарегистрированным браузерам, выберите организационное подразделение верхнего уровня. В противном случае выберите дочернее подразделение.
4. Откройте раздел Отчеты о пользователях и устройствах.
5. Нажмите Отправка отчетов с данными телеметрии устройств.
6. Выберите Отправлять отчеты с данными телеметрии устройств.
7. Нажмите Сохранить.

Включив отчеты с данными телеметрии, вы сможете подписаться на различные типы событий, происходящих на устройствах с ChromeOS в вашей организации. Уведомления об этих событиях отправляются в настроенную для них тему Pub/Sub.

Шаг 2. Создайте тему Pub/Sub в проекте Google Cloud

Подробную информацию можно найти в статье Интеграция Google Cloud Pub/Sub с системой облачного управления браузером Chrome.

1. Войдите в аккаунт сервиса Google Cloud Platform.
2. В разделе Pub/Sub откройте страницу Темы.
3. Выберите существующую тему или нажмите Создать тему.
4. Введите идентификатор темы и нажмите Создать тему.
5. Выберите тему, которую вы создали, чтобы получить события из Chrome.
6. В разделе Разрешения нажмите Добавить участника.
7. В поле Новые субъекты введите [e-mail].
   Это аккаунт, который сервер Google использует для вызовов Publish API темы Pub/Sub. Тема должна предоставить доступ для публикации к этому аккаунту.
8. В разделе Роль выберите Издатель Pub/Sub.
9. Нажмите Сохранить.
10. Скопируйте полный путь к теме и сохраните его для выполнения следующих шагов в консоли администратора.

Шаг 3. Зарегистрируйте тему Pub/Sub и создайте конфигурации уведомлений

Чтобы создать конфигурации уведомлений, вам необходимо вызвать Chrome Management Telemetry API. Ниже указаны ссылки, пройдя по которым вы можете получить дополнительную информацию по теме.

• Чтобы узнать, как получить доступ к Chrome Management Telemetry API, ознакомьтесь с общими инструкциями.
• Чтобы узнать, как создать конфигурацию уведомлений, ознакомьтесь с инструкциями на этой странице. Вы можете вызвать API уведомлений телеметрии и создать конфигурации уведомлений, отправив запрос POST.
  • В тексте замените google_cloud_pubsub_topic на свою тему.
    Например, чтобы настроить уведомления о добавлении и удалении USB, задайте следующую конфигурацию:

{

"google_cloud_pubsub_topic": "projects/your-project/topics/your-topic",

"filter": {

"telemetry_event_notification_filter": {

"event_types": [

"USB_ADDED",

"USB_REMOVED"

]

}

}

}

Шаг 4. Начните получать уведомления Chrome Management Telemetry API

Для получения уведомлений вы можете:

• использовать консоль Google Cloud;
• использовать командную строку Google Cloud;
• написать кода для получения уведомлений с помощью библиотек Google.