Когда опубликованная надстройка Google Workspace возвращает ошибку, интерфейс надстройки возвращает общее сообщение «Что-то пошло не так при выполнении надстройки». Однако эти ошибки регистрируются в Cloud Logs Explorer .
В этом руководстве описывается, как запрашивать дополнительные журналы ошибок в Cloud Logs Explorer, чтобы вы могли:
- Узнайте, сталкиваются ли пользователи с ошибками.
- Посмотрите, как часто возникают ошибки и какие встречаются чаще всего.
- Прочтите описательные сообщения об ошибках, которые помогут вам их исправить.
Предварительные условия
Прежде чем запрашивать журналы ошибок надстроек:
- Включите «Cloud Logging API» в проекте Google Cloud надстройки. Чтобы включить API, см. раздел Создание облачного проекта и включение API .
- Опубликуйте дополнение в Google Workspace Marketplace. Чтобы опубликовать надстройку в Marketplace, см. Публикация приложения .
Запрос журналов ошибок надстроек
Чтобы получить логи для дополнения:
- Откройте консоль Google Cloud .
- Рядом с надписью «Google Cloud Platform» нажмите стрелку вниз и выберите проект надстройки.
- В левом верхнем углу нажмите > Ведение журнала . Откроется обозреватель журналов.
Для дополнительных журналов ошибок в построителе запросов введите следующий запрос:
severity>=ERROR protoPayload.serviceName="gsuiteaddons.googleapis.com"Чтобы просмотреть недавние ошибки, нажмите «Выполнить запрос» . Или, чтобы просмотреть ошибки по мере их возникновения, нажмите «Потоковые журналы» . Журналы ошибок надстроек отображаются на панели «Результаты запроса».
Дополнительную информацию об Cloud Logs Explorer и написании запросов см. в следующих разделах:
Включить или отключить ведение журнала ошибок
По умолчанию ведение журнала ошибок включено. Если ведение журнала ошибок включено, файл манифеста имеет следующее:
"exceptionLogging": "STACKDRIVER",
Чтобы отключить ведение журнала ошибок, замените "exceptionLogging": "STACKDRIVER", следующей строкой в файле манифеста:
// Disable error logging
"exceptionLogging": "NONE"
Чтобы снова включить ведение журнала ошибок, замените "exceptionLogging": "NONE" на "exceptionLogging": "STACKDRIVER", .
Соображения
Работая с дополнительными журналами ошибок в Cloud Logs Explorer, обратите внимание на следующие моменты:
- Надстройки регистрируют только ошибки в обозревателе журналов. Другие типы журналов не записываются.
- Сообщения об ошибках всегда пишутся на английском языке.
- Ведение облачных журналов требует затрат. Дополнительную информацию о ценах на ведение журналов в облаке см. в ценах на возможность наблюдения за облаком Google .