Панель мониторинга Apps Script позволяет управлять проектами Apps Script и отслеживать их. Вы можете использовать панель мониторинга для выполнения любого из следующих действий:
- Просмотрите и найдите существующие проекты Apps Script, включая связанные сценарии, прикрепленные к документамGoogle Workspace .
- Создавайте новые проекты.
- Просмотр сведений о ваших проектах, например об используемых им областях OAuth .
- Отслеживайте работоспособность и использование ваших проектов сценариев.
- Просматривайте журналы выполнения своих и других проектов, которые выполняются с использованием учетных данных вашей учетной записи.
- Включите или отключите Apps Script API , чтобы разрешить или запретить приложениям использовать API для взаимодействия с вашими проектами сценариев.
Просмотр и поиск проектов
На панели инструментов Apps Script перечислены все проекты сценариев, которые вы можете просматривать или редактировать. Левая панель навигации делит эти проекты на следующие категории:
- Избранные проекты . Проекты, которые вы контролируете .
- Мои проекты . Проекты, владельцем которых вы являетесь.
- Все проекты . Проекты, которыми вы владеете или для которых у вас есть разрешения на просмотр или редактирование.
- Поделился со мной . Проекты, которыми вы не владеете, но которыми с вами поделились.
- Мусор . Проекты, которые вы удалили с Google Диска.
В списках проектов отображаются имя проекта, владелец и дата последнего изменения. Значки рядом с именем проекта указывают, является ли проект автономным или связанным проектом.
Посмотреть детали проекта
Каждый проект включает представление, позволяющее просмотреть сведения о проекте для разработчиков. Чтобы просмотреть подробную информацию о проекте, щелкните строку в списке проектов.
В представлении сведений о проекте отображаются данные о частоте ошибок , выполнениях и пользователях , а также графики проекта, а также области OAuth, запрошенные у любого конечного пользователя, использующего проект. Метрики данных определяются следующим образом:
- Уровень ошибок . Процент выполнения, которые не удалось выполнить из-за неперехваченных исключений. Он рассчитывается как количество неудачных выполнений, разделенное на общее количество выполнений за определенный период времени.
- Казни . Сколько раз проект был «запущен» или выполнен. Дополнительные сведения о том, как можно запустить проект, см. в разделе Типы выполнения .
- Пользователи . Количество уникальных пользователей (учетных записей), запустивших проект один или несколько раз за указанный период времени. Анонимные пользователи не отслеживаются и поэтому не отражаются в подсчете пользователей или графиках.
Каждое развертывание вашего проекта отображается в виде вкладки на странице сведений о проекте над данными и графиками; вы можете выбрать вкладку, чтобы просмотреть связанные данные для этого развертывания. При выборе «ВСЕ» отображаются совокупные данные для всех развертываний проекта и результатов выполнения, выполненных разработчиками, запускающими проект из редактора кода Apps Script.
Мониторинг проектов
У вас может быть доступ к значительно большему количеству проектов Apps Script, чем вы используете или управляете на регулярной основе. Чтобы добавить проекты в закладки для быстрого доступа, вы можете пометить их. Пометка главных проектов также позволяет отслеживать совокупную статистику использования и частоту ошибок, а также графики по этим проектам.
Чтобы пометить проект, справа от строки проекта нажмите Еще > Добавить пометку . Вы также можете пометить проект, нажав «Еще при просмотре сведений о проекте .
В левой панели навигации вы можете выбрать «Избранные проекты» , чтобы просмотреть проекты, добавленные в закладки. Нажмите на систему показателей «Доля ошибок », «Выполнения » или «Пользователи » в верхней части страницы, чтобы просмотреть соответствующие графики для всех отмеченных вами проектов за последние 7 дней.
Вы можете удалить звездочку из проекта, нажав «Еще в строке проекта и выбрав «Удалить звезду» .
Управление казнями
Вы можете использовать панель мониторинга Apps Script для просмотра и управления отдельными выполнениями функций проекта Apps Script. Вы можете найти полный журнал последних казней, выбрав пункт «Мои казни» в левой навигационной панели.
На панели «Мои выполнения» по умолчанию отображается журнал всех предыдущих и текущих выполнений проектов, владельцем, редактором или зрителем которых вы являетесь. Этот список также может включать выполнение функций в проектах, к которым у вас нет доступа, если они выполняются от вашего имени (например, надстройки, которые вы установили и запустили). В списке выполнения отображается только начальная функция, которая вызывается для начала выполнения. Он не показывает каждую функцию, которая была вызвана во время этого выполнения.
Вы можете контролировать, о каком типе выполнения сообщается в журнале, с помощью фильтров в верхней части представления. Каждая строка журнала представляет одно выполнение. В столбцах « Время начала », «Продолжительность » и «Состояние» отображается соответствующая информация об этом выполнении.
В столбце Функция отображается имя функции, инициировавшей выполнение. В этом столбце нет имени, если у вас нет доступа к соответствующему проекту сценария выполнения, но он выполнялся от вашего имени.
В столбце «Тип» показано, что инициировало выполнение. Ценности включают в себя:
- Добавить . Исполнение произошло из надстройки.
- API выполнения . Выполнение произошло в результате вызова Apps Script API.
- Управляемый временем . Казнь была вызвана временным событием.
- Курок . Выполнение произошло из источника триггера.
- Веб-приложение . Выполнение произошло из развернутого веб-приложения.
- Редактор . Выполнение произошло из редактора Apps Script.
Прекратить выполнение
Длительные выполнения, которые в данный момент выполняются, обозначаются статусом «Выполняется». Чтобы остановить эти выполнения, справа от строки проекта нажмите «Еще > «Завершить» .
Настройки
Вы можете настроить параметры панели управления, выбрав «Настройки» на левой панели навигации.
На панели «Настройки» находится переключатель Apps Script API . Это позволит вам предоставить доступ API к вашим проектам сценариев .
Чтобы получить доступ к этому переключателю, щелкните метку Google Apps Script API на панели «Настройки» . Откроется новая панель с текстом предупреждения и переключателем. Доступ к вашим проектам сценариев отключен по умолчанию в целях безопасности. После того как вы предоставите доступ, любое стороннее приложение, которое вы авторизуете, сможет использовать API для изменения ваших сценариев и развертываний. Вы можете в любое время отозвать этот доступ на панели «Настройки» .
Дополнительную информацию см. в руководстве по доступу к Apps Script API .