Loading
Расширение Salesforce посредством кода
Настройка флагов трассировки класса Apex и запуска

Вы находитесь здесь:

  1. Справка Salesforce
  2. Документы
  3. Расширение Salesforce посредством кода

Настройка флагов трассировки класса Apex и запуска

Класс Apex или флаг трассировки триггера можно настроить в настройках Salesforce, на консоли разработчика или создав объекты Tooling API командами Salesforce CLI. Эти флаги трассировки имеют тип журнала отладки CLASS_TRACING и переопределяют уровни журнала отладки флагов трассировки USER_DEBUG и Developer_LOG.

Требуемые версии

Доступно в версиях: Salesforce Classic (недоступно во всех организациях) и Lightning Experience.
Доступно в версиях: Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition и Database.com Edition.
Необходимые полномочия пользователя
Для использования консоли разработчика: «API включен» И «Просмотр всех данных»
Для просмотра, сохранения и удаления журналов отладки: Просмотр всех данных
Для выполнения анонимного Apex: Автор Apex
Для сохранения изменений в классах и триггерах Apex: Автор Apex
Для использования Salesforce CLI и выполнения запросов Tooling API: API включен
Совет
Совет Для получения примера использования флагов трассировки классов и триггеров Apex см. Фильтрация журнала отладки для классов Apex и триггеров Apex.

Создание флагов трассировки класса Apex и запуска в настройках

Примечание
Примечание Хотя вы можете настроить класс Apex или запустить флаг трассировки в настройках, эти флаги трассировки не отображаются в списке журналов на странице журналов отладки. Страница отображает только типы журналов USER_DEBUG и DEVELOPER_LOG, но не типы журналов CLASS_TRACING. Типы журналов CLASS_TRACING, созданные в настройках, можно открыть на странице настроек класса Apex или триггера, в консоли разработчика или посредством Tooling API.
  1. Введите строку «Журналы отладки» в поле «Быстрый поиск» в меню «Настройка» и нажмите «Журналы отладки».
  2. Щелкните «Создать».
  3. В поле «Тип отслеживаемого объекта» выберите Apex Class или Apex Trigger.
  4. В поле «Имя отслеживаемого объекта» введите имя класса или триггера Apex, к которому нужно добавить флаг трассировки.
  5. Чтобы определить период времени активности флага трассировки, введите дату начала и дату истечения срока действия.
  6. Чтобы задать профиль уровня отладки, введите имя нужного профиля уровня отладки или нажмите кнопку «Создать уровень отладки».

    При нажатии кнопки «Создать уровень отладки» откроется новое окно. Чтобы определить новый профиль уровня отладки, введите имя профиля уровня отладки в новом окне. Потом выберите уровень журнала отладки для каждой категории журнала отладки. Сохраните внесенные изменения.

  7. Сохраните флаг трассировки.

Просмотр, редактирование или удаление флагов трассировки класса Apex и запуска в настройках

  1. Перейдите на соответствующую страницу настройки класса Apex или триггера.
    1. В качестве флагов трассировки классов Apex введите строку «Классы Apex» в поле «Быстрый поиск» в меню «Настройка» и нажмите «Классы Apex».
    2. Для флагов трассировки триггеров Apex введите строку «Триггеры Apex» в поле «Быстрый поиск» в меню «Настройка» и нажмите «Триггеры Apex».
  2. Щелкните имя нужного класса или триггера Apex.
  3. Нажмите нужный параметр.
    1. Чтобы создать флаг трассировки, нажмите «Создать». Потом введите дату начала, дату истечения срока действия и профиль уровня отладки для флага трассировки.
    2. Чтобы удалить флаг трассировки, нажмите кнопку «Удалить» в столбце «Действие» флага трассировки.
    3. Чтобы изменить дату начала, дату истечения срока действия или профиль уровня отладки флага трассировки, нажмите «Правка».
    4. Чтобы изменить уровни отладки флага трассировки, нажмите «Фильтры». Потом выберите нужный уровень отладки для каждой категории.
    5. Чтобы удалить все флаги трассировки для класса или триггера Apex, нажмите «Удалить все».
  4. Сохраните внесенные изменения.

Создание флагов трассировки класса Apex и запуска в консоли разработчика

  1. На консоли разработчика нажмите «Отладка | Изменить уровни журнала...».
    Окно «Изменение уровней журнала» в Developer Console, где можно установить флаги трассировки отладки.
  2. В разделе «Переопределения трассировки классов и триггеров» нажмите «Добавить».
  3. Выберите класс или триггер для добавления флага трассировки.
  4. Чтобы определить период времени, в течение которого флаг трассировки активен, нажмите на ячейку даты начала для класса или триггера, а потом введите или выберите допустимое время начала. Потом нажмите на ячейку «Дата истечения срока действия» и введите или выберите допустимое время окончания.
  5. Чтобы задать профиль уровня отладки, нажмите «Добавить/изменить» в ячейке действий отладки для класса или триггера. Потом выполните одно из следующих действий.
    1. Чтобы задать уровень отладки определенному профилю уровня отладки, щелкните имя нужного профиля уровня отладки. Потом нажмите «Готово».
    2. Чтобы настроить уровни отладки заданного профиля уровня отладки, щелкните имя нужного профиля уровня отладки. Выберите новый уровень отладки в раскрывающемся списке для каждой категории журнала отладки, которую нужно скорректировать. Потом нажмите «Готово».
    3. Чтобы добавить новый профиль уровня отладки, нажмите «Добавить». В новом окне введите имя DebugLevel. Потом выберите уровень отладки в раскрывающемся списке для каждой категории журнала отладки. Нажмите «Добавить», а потом нажмите «Готово».
    4. Чтобы удалить профиль уровня отладки, щелкните имя нужного профиля уровня отладки и нажмите кнопку «Удалить». Потом нажмите «Готово».
      Предупреждение: Это действие удаляет профиль журнала отладки из всех назначенных флагов трассировки.
    Окно «Изменить уровень отладки» в Developer Console, где можно создавать и изменять профили уровня журнала отладки.

Создание флагов трассировки класса Apex и запуска с помощью команд Salesforce CLI

Примечание
Примечание Где возможно, мы изменили неинклюзивные термины, чтобы они соответствовали ценности равенства компании. Мы сохранили определенные термины, во избежание искажения внедрений клиентов.
  1. Если у вас нет нужного профиля уровня отладки, сперва создайте запись DebugLevel с Tooling API посредством команды sf data create record. Замените значения структурного нуля нужным именем профиля уровня отладки и нужным уровнем отладки для каждой категории журнала отладки. 
    sf data create record --use-tooling-api --sobject DebugLevel --values "DeveloperName='DEBUG_LEVEL_PROFILE_NAME' MasterLabel='DEBUG_LEVEL_PROFILE_NAME' Workflow='FINER' ApexCode='FINE' System='DEBUG' Validation='INFO' Database='INFO' Callout='INFO' Visualforce='INFO' ApexProfiling='INFO'"
  2. Получите код записи DebugLevel для профиля уровня отладки посредством команды sf data query. Замените значение структурного нуля DeveloperName профиля уровня отладки. 
    sf data query --query "SELECT Id FROM DebugLevel WHERE DeveloperName='DEBUG_LEVEL_PROFILE_NAME'"
  3. Получите код класса Apex или триггера, который нужно отследить посредством команды sf data query. Замените значение структурного нуля именем класса или триггера Apex. 
    sf data query --query "SELECT Id FROM ApexClass WHERE Name='APEX_CLASS_NAME'"
  4. Создайте запись TraceFlag посредством Tooling API. Замените значения структурного нуля. 
    sf data create record --use-tooling-api --sobject TraceFlag --values "TracedEntityId='APEX_CLASS_OR_TRIGGER_ID' DebugLevelId='DEBUG_LEVEL_ID' LogType='CLASS_TRACING' StartDate='START_TIME_UTC' ExpirationDate='END_TIME_UTC'"
  5. Если вы еще этого не сделали, создайте еще одну запись TraceFlag для пользователя, чьи действия вы хотите отследить. Флажки трассировки класса Apex или триггера не создают журналы отладки самостоятельно. 
    sf data create record --use-tooling-api --sobject TraceFlag --values "TracedEntityId='USER_ID' DebugLevelId='DEBUG_LEVEL_ID' LogType='USER_DEBUG' StartDate='START_TIME_UTC' ExpirationDate='END_TIME_UTC'"

Для работы с журналами отладки используйте следующие команды:

  • Чтобы извлечь указанный журнал или заданное количество последних журналов из организации, используйте команду apex get log.
  • Чтобы просмотреть список кодов и общие сведения о журналах отладки, воспользуйтесь командой apex list log.
  • Чтобы активировать журнал отладки для текущего пользователя и передать его на консоль, воспользуйтесь sf apex tail og command.

См. также:

 
Загрузка
Salesforce Help | Article