Monitor your apps

The developer console lets you monitor the performance of your Forge apps and view logs in order to debug them. To do this, you need your users to enable continuous access to their logs.

To access the console:

1. From any page on developer.atlassian.com, select your profile icon in the top-right corner.

2. From the dropdown, select Developer console.

3. In the left menu, select Logs.

You see a page like this, showing logs for all sites that users have granted you continuous access to.

Log table

The table contains a list of your logs.

• Date/Time(UTC): Displays the time that the log was created in UTC.

• Details: Shows a concatenated preview of the log message. Select anywhere in a row to expand it and view the entire log message, along with all of the attributes from the state of the app, such as Invocation ID and Product.

• Level: Displays the log level. This can be chosen by your app, by inserting log statements such as console.log, console.warn or unhandled errors inside your app’s code.

Logs are shown for a single invocation. To see logs for another invocation, select Load logs for another invocation.

Filters

You can use these filters to refine your logs:

• Site: Lets you narrow down the logs based on the site that your app is installed onto, for example my-site.atlassian.net.

  • Note, you can’t filter by product. For example, you can’t narrow down logs just for Jira instances on a particular site.

• Environment: Lets you narrow down the logs for a specific app environment for your Forge app.

• Date: Lets you narrow down the logs based on your chosen time interval.

  • You can choose from a range of predefined values, such as the Last 24 hours, or choose a more specific time interval using the Custom option.

  • Note, logs are only available for the past 60 days and all dates are in UTC.

Limitations

The monitoring functionality in the developer console is an evolving feature. It lets you quickly find, understand, and fix issues with your app. We're exploring ways to improve the monitoring capabilities and overcome these limitations:

• Log filters don't allow for multi-select.

• Log filters don't include filtering by log level (warn or info).