flash_rollbar

注意：

2024年5月の時点で、Rollbarはこのリポジトリを積極的に更新せず、2025年1月にアーカイブする予定です。開発を続けたい場合は、コミュニティにこのリポジトリをフォークすることをお勧めします。 Rollbarは積極的な開発に関与しなくなりますが、セキュリティの更新に関連するプル要求のレビューとマージに引き続きコミットしています。積極的に維持されているフォークが出現した場合は、サポートチームに連絡してください。ドキュメントからリンクします。

フラッシュ用のロールバー通知者（AS3）

Flash（ActionScript 3）ロールバーへの例外、エラー、ログメッセージを報告するためのライブラリ。

クイックスタート

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アクセストークンに置き換えてください。これはlollbar.comインターフェイスで見つけることができます。

要件

• フラッシュプレーヤー10.1+
  • 9で動作する場合がありますが、テストされていません。
• mxmlc/compcコマンドラインから構築する予定がある場合
• ロールバーアカウント

キャッチされたエラーの報告

コードの特定の部品を機器に計算したい場合は、 Rollbar.handleError(err)に電話してください。

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

Advanced： PayloadがRollbar APIに送信される前にペイロードの一部をオーバーライドするには、2番目の引数でhandleError()に渡します。たとえば、データのグループ化方法を制御するには、カスタムfingerprintを渡すことができます。

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

2番目の引数であるextraData 、オブジェクトでなければなりません。 extraDataの各キーは、ペイロードの以前のコンテンツを上書きします。すべてのオプションについては、APIドキュメントを参照してください。

構成

ディスプレイリストの最上位レベルで、ロールバーシングルトンをインスタンス化します。

Rollbar . init ( this , accessToken, environment) ;

コンストラクターパラメーターの完全なリスト（順序）は次のとおりです。

親

親はオブジェクトコンテナを表示します。通常、「This」であるはずです。 Notifierは、「parent.loaderinfo``」でロードされたSWFのすべてのエラーを報告します。

AccessToken

ロールバープロジェクトからトークンにアクセスします

環境

環境名。最大255枚の文字列は大丈夫です。最良の結果を得るには、生産環境に「生産」を使用してください。

デフォルト： "production"

人

オプションですが、次のうちの1つになります。

• 現在の人/ユーザーの文字列識別子。
• 現在の人/ユーザーを記述するオブジェクト、
  • 必須 - id、userid、user_id、user
  • オプション - 電子メール、useremail、user_email、emailaddress、email_address
  • オプション - ユーザー名、ユーザー名、user_name、name
• 上記のようなオブジェクトを返す関数

ルートパス

If you compiled the SWC/SWF using the debug or verbose stack trace flags, you'll want this to be the absolute path to the root of your Actionscript source code, not including the final ```/```.

それ以外の場合は、これをリポジトリのルートに比べてソースパスに設定します。たとえば、ソースツリーが次のようになる場合：

 /myApp/src/com/myApp

これを"src"に設定します

CodeBranch

フラッシュムービーをコンパイルするために使用されるブランチの名前。

デフォルト： "master"

serverData

このアイテムと一緒に渡したいデータを含むオブジェクトを保存します。

maxitemcount

Notifierインスタンスの寿命のためにRollBarに送信するアイテムの最大数。これは、Rollbarに送信されるアイテムの数をレート制限するのに役立ちます。

endpointurl

URLアイテムが投稿されます。

デフォルト： "https://api.rollbar.com/api/1/item/"