flash_rollbar

Внимание:

По состоянию на май 2024 года Rollbar не будет активно обновлять этот репозиторий и планирует архивировать его в январе 2025 года. Мы призываем наше сообщество расколоть это репо, если вы хотите продолжить его развитие. В то время как Rollbar больше не будет участвовать в активной разработке, мы по -прежнему привержены рассмотрению и слиянию запросов на привлечение, связанных с обновлениями безопасности. Если появится активно поддерживаемая вилка, пожалуйста, обратитесь к нашей команде поддержки, и мы свяжемся с ней из нашей документации.

Уведомление о рулоне для Flash (AS3)

Flash (ActionScript 3) Библиотека для отчетности исключений, ошибок и сообщений журнала в Rollbar.

Быстрый старт

1. Загрузите код flash_rollbar или просто файл rollbar.swc.
2. Поместите каталог flash_rollbar/src в свой исходный путь или поместите файл Rollbar.swc в путь библиотеки вашего проекта.
3. Вызовать Rollbar.init(this, accessToken, environment); от вашего верхнего уровня DisplayObject .

 package {
  import com.rollbar.notifier.Rollbar ;

  public class MyApp extends Sprite {

    public static const ROLLBAR_ACCESS_TOKEN : String = "POST_CLIENT_ITEM_ACCESS_TOKEN" ;

    public function MyApp () {
      var environment : String = isDebug () ? "development" : "production" ;
      var person : Object = { id : getUserId(), email : getEmail(), name : getName()} ;  // optional
      Rollbar . init ( this , ROLLBAR_ACCESS_TOKEN , environment, person) ;
    }
  }
}

Rollbar.init() установил глобальный обработчик ошибок, поэтому вам не нужно делать ничего другого.

Обязательно замените POST_CLIENT_ITEM_ACCESS_TOKEN на токен доступа post_client_item вашему проекту, который вы можете найти в интерфейсе Rollbar.com.

Требования

• Flash Player 10.1+
  • Может работать на 9, но не протестировано.
• MXMLC/COMPC, если вы планируете построить из командной линии
• Учетная запись рулона

Отчетность поймала ошибки

Если вы хотите придумать конкретные части вашего кода, вызовите Rollbar.handleError(err) :

 private function onEnterFrame(event : Event ) {
    try {
      gameLoop(event) ;
    } catch (err:Error) {
      Rollbar . handleError(err) ;
    }
}

Advanced: Чтобы переопределить части полезной нагрузки до того, как она будет отправлена ​​в API рулона, передайте их во втором аргументе, чтобы handleError() . Например, чтобы контролировать, как будут сгруппированы ваши данные, вы можете передать пользовательский fingerprint :

Rollbar . handleError(err, {fingerprint: "a string to uniquely identify this error" }) ;

Второй аргумент, extraData , должен быть объектом. Каждый ключ в extraData будет перезаписать предыдущее содержимое полезной нагрузки. Для всех вариантов см. Документацию API.

Конфигурация

На самом верхнем уровне вашего списка дисплея создайте экземпляр Rollbar Singleton.

Rollbar . init ( this , accessToken, environment) ;

Вот полный список параметров конструктора (по порядку):

родительский

Родительский контейнер объекта отображения; Обычно должно быть `` `this```. Уведомление сообщит о все ошибки для SWF, которые загружены `` `parent.loaderinfo``.

accesstoken

Токен доступа от вашего проекта Rollbar

среда

Название среды. Любая строка до 255 chars в порядке. Для достижения наилучших результатов используйте `` `« Производство »` `` для вашей производственной среды.

По умолчанию: "production"

человек

Необязательно, но может быть одним из:

• Идентификатор строки для текущего человека/пользователя.
• Объект, описывающий текущего человека/пользователя, содержащий
  • Требуется - id, userid, user_id, пользователь
  • Необязательно - Электронная почта, пользователя, пользователь, user_email, emailaddress, email_address
  • Необязательно - имя пользователя, имя пользователя, user_name, имя
• Функция, возвращающая объект, подобный описанному выше

rootpath

Если вы собрали SWC/SWF, используя флаги трассировки отладки или словесного стека, вы захотите, чтобы это был абсолютным путем к корню вашего исходного кода ActionScript, не включая окончательный `` `/` ``.

В противном случае установите это на путь источника относительно корня вашего хранилища. например, если ваше исходное дерево выглядит так:

 /myApp/src/com/myApp

Установить это на "src"

CodeBranch

Название филиала, используемое для составления вашего фильма Flash.

По умолчанию: "master"

ServerData

Объект, содержащий любые данные, которые вы хотели бы пройти вместе с этим предметом для хранения.

maxitemcount

Максимальное количество предметов для отправки на рулон для срока службы экземпляра уведомления. Это полезно для ограничения скорости количества предметов, отправляемых на рулон.

Endpointurl

Предметы URL -адреса размещены.

По умолчанию: "https://api.rollbar.com/api/1/item/"