flash_rollbar

Atención:

A partir de mayo de 2024, Rollbar no actualizará activamente este repositorio y planea archivarlo en enero de 2025. Alentamos a nuestra comunidad a bifurcar este repositorio si desea continuar su desarrollo. Si bien Rollbar ya no participará en el desarrollo activo, seguimos comprometidos a revisar y fusionar solicitudes de extracción relacionadas con las actualizaciones de seguridad. Si surge una bifurcación mantenida activamente, comuníquese con nuestro equipo de soporte y lo vincularemos desde nuestra documentación.

Notificador de barra de rollo para flash (AS3)

Flash (ActionScript 3) Biblioteca para informar excepciones, errores y registro de mensajes para rollo.

Comienzo rápido

1. Descargue el código Flash_rollbar o simplemente el archivo rollbar.swc.
2. Coloque el directorio flash_rollbar/src en su ruta fuente o coloque el archivo Rollbar.swc en la ruta de la biblioteca de su proyecto.
3. Llamar Rollbar.init(this, accessToken, environment); Desde su DisplayObject de nivel superior.

 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() instaló un controlador de errores global, por lo que no necesita hacer nada más.

Asegúrese de reemplazar POST_CLIENT_ITEM_ACCESS_TOKEN con el token de acceso post_client_item de su proyecto, que puede encontrar en la interfaz Rollbar.com.

Requisitos

• Flash Player 10.1+
  • Puede funcionar en 9, pero no probado.
• mxmlc/compc si planea construir desde la línea de comandos
• Una cuenta de barra de rollo

Informes de errores capturados

Si desea instrumentar partes específicas de su código, llame Rollbar.handleError(err) :

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

Avanzado: para anular las partes de la carga útil antes de que se envíe a la API Rollbar, pasándolas en el segundo argumento para handleError() . Por ejemplo, para controlar cómo se agruparán sus datos, puede pasar una fingerprint personalizada:

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

El segundo argumento, extraData , debería ser un objeto. Cada clave en extraData sobrescribirá el contenido anterior de la carga útil. Para todas las opciones, consulte la documentación de la API.

Configuración

En el nivel más alto de su lista de visualización, instancíe el singleton Rollbar.

Rollbar . init ( this , accessToken, environment) ;

Aquí está la lista completa de parámetros del constructor (en orden):

padre

El contenedor de objeto de visualización principal; Por lo general, debería ser `` `esto ''. El notificador informará todos los errores para los SWF que se cargan con `` `parent.loaderInfo```.

accesstoken

Token de acceso desde su proyecto Rollbar

ambiente

Nombre del medio ambiente. Cualquier cadena de hasta 255 caracteres está bien. Para obtener los mejores resultados, use `` `" Producción "` `` para su entorno de producción.

Valor predeterminado: "production"

persona

Opcional pero puede ser uno de:

• Un identificador de cadena para la persona/usuario actual.
• Un objeto que describe a la persona/usuario actual, que contiene
  • Requerido - ID, UserId, User_ID, usuario
  • Opcional: correo electrónico, correo electrónico, user_email, correo electrónicoaddress, correo electrónico_address
  • Opcional: nombre de usuario, nombre de usuario, user_name, nombre
• Una función que devuelve un objeto como el descrito anteriormente

pata

Si compiló el SWC/SWF utilizando los indicadores de rastreo de depuración o pila verbosa, querrá que sea la ruta absoluta a la raíz de su código fuente de ActionScript, sin incluir el `` `/` `` `` `` `` `` `` `` `` `` `` `` `` `` `` `` `` `` `` ``/``/``/`.

De lo contrario, configure esto en la ruta de origen en relación con la raíz de su repositorio. Por ejemplo, si su árbol de origen se ve así:

 /myApp/src/com/myApp

Establezca esto en "src"

rango de código

Nombre de la rama utilizado para compilar su película Flash.

Valor predeterminado: "master"

tonos de servidor

Un objeto que contiene cualquier datos que le gustaría pasar junto con este elemento para almacenar.

Maxitemcount

El número máximo de elementos para enviar a Rollbar para la vida útil de la instancia de notificador. Esto es útil para limitar la velocidad el número de artículos enviados a la barra rol.

punto final

Los artículos de URL se publican.

Valor predeterminado: "https://api.rollbar.com/api/1/item/"