FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

Bugsnag

v0.3.0 Public

Bugsnag Error Notification for Coldbox

Log your Coldbox errors using Bugsnag and the Bugsnag Notify API.

Configuration

At minimum, you will need a Bugsnag API key. You can get this from the Bugsnag Dashboard Settings page.

In /config/Coldbox.cfc's configure() method, add bugsnag.apiKey setting to the moduleSettings struct like so:

function configure(){
    moduleSettings = {
        bugsnag = {
            ApiKey: "PLEASE_SET_ME"
        }
    };
}

The following settings are available:

moduleSettings = {
    bugsnag = {
        "ApiKey": "REQUIRED",
        // is this app in development, staging, or production?
        "releaseStage": "development",
        // only notify for these environments
        "notifyReleaseStages": ["development","staging","production"], // NOT IMPLEMENTED
        // automatically log items using a Logbox appender
        "enableLogBoxAppender" = true,
        // Min/Max levels for appender
        "levelMin" = "FATAL",
        "levelMax" = "INFO",
        // automatically log exceptions via onException interception event
        "enableExceptionLogging" = true,
        // Data sanitization, scrub fields and headers, replaced with * at runtime
        "scrubFields" 	= [],
        "scrubHeaders" = []
    }
};

TODO

  • Follow Bugsnag integration guidelines
  • Allow apps to set user and context data per request, to be logged with any errors
  • Write tests for BugsnagService and BugsnagAppender

The Good News

For all have sinned, and come short of the glory of God (Romans 3:23)

But God commendeth his love toward us, in that, while we were yet sinners, Christ died for us. (Romans 5:8)

That if thou shalt confess with thy mouth the Lord Jesus, and shalt believe in thine heart that God hath raised him from the dead, thou shalt be saved. (Romans 10:9)

Repository

Copyright 2019 (and on) - Michael Born

Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.

Version Created Last Update Published By Stable Actions
Current
0.3.0 Apr 11 2019 07:49 PM Apr 11 2019 07:49 PM
Version History
0.2.3 Apr 11 2019 09:39 AM Apr 11 2019 09:39 AM

 

No collaborators yet.
     
  • Apr 10 2019 09:17 AM
  • Apr 11 2019 07:49 PM
  • 347
  • 175
  • 10