A tool to track your Roku application errors.

• NODE.js
• ROPM

Use following command to get the package to your application

ropm install roku-data-dog

The package should be stored in /components directory

• Create your RUM application in DataDog
• Create a try-catch block where you expect any error to occure

• Inside the CATCH:
• Create dataDogTracker component
• Create and set the DataDog configuration
• Send the error to DataDog
• In the following example you can observe how to set up what was explained above:

dataDogTracker = CreateObject("roSGNode", "TrackerComponent")
dataDogConfigurationObject = {applicationID: "[application_id]", clientToken: "[application_token]"}
dataDogTracker.callFunc("setConfiguration", ConfigurationObject)
dataDogTracker.callFunc("sendError", error)

• Inside the xml file of your component you have to include the scripts for the following components:

<script type="text/brightscript" uri="pkg:/[path_to_project]/dataDogTracker/viewSample.brs" />
<script type="text/brightscript" uri="pkg:/[path_to_project]/dataDogTracker/errorSample.brs" />
<script type="text/brightscript" uri="pkg:/[path_to_project]/dataDogTracker/dataDogConfig.brs" />
<script type="text/brightscript" uri="pkg:/[path_to_project]/dataDogTracker/dataDogConfiguration.brs" />
<script type="text/brightscript" uri="pkg:/[path_to_project]/dataDogTracker/dataDogTracker.brs" />

• Inside the CATCH:
• Set the DataDog configuration
• Send the error to DataDog
• In the following example you can observe how to set up what was explained above:

dataDogConfigurationObject = {applicationID: "[application_id]", clientToken: "[application_token]"}
dataDogTrackerConfiguration = Configuration(dataDogConfigurationObject)
dataDogTracker = Tracker(dataDogTrackerConfiguration)
dataDogTracker.sendError(error)

• Download test-project file to your machine
• Note that in the scene component there are 2 ways of the DataDog tracker implementation:
• BrightScript implementation (currently used)
• SceneGraph implementation (commented inside the code)
• Replace [application_id] with your application id
• Replace [application_token] with your application token
• Archive the project and run it on your device
• Look in DataDog RUM application to see the view with one error in it

Currently the application is sending a view event and one error event, both sharing same ids.

• date
• country
• application ID
• application version
• device model
• device OS version
• message
• backtrace

This library is licensed under the Apache 2.0 License. See the LICENSE for details.