The Logs Tab monitors activity when users interact with the app. It shows the overall usage statistics, allowing you to keep an eye on your plan limits. It also allows to you view individual server-side workflow runs, so you can see when users modify data or take other server actions, such as sending an email. Finally, you can view and manually cancel scheduled future workflow runs.
This sub-tab shows you various data around your app's capacity usage. In other words, it shows the general activity of users on your app and the computing resources used by your app. If you suspect that your app is slower than expected because you are capacity-constrained (since each app plan comes with a certain level of capacity), this is where you can investigate that.
By default, Bubble will send you certain emails when we detect that capacity has hit certain thresholds. One option you have is "Do not send daily emails when the application hits its maximum capacity usage over the previous 24 hours" - this will suppress the corresponding email.
In addition, you can choose to "Only send emails when the maxed-out period exceeds this duration (minutes)".
This section of the page shows you a breakdown of what parts of your app are using capacity in a given time period. Note that you can click on sections of the chart to go into deeper levels of detail. Also note that the chart represents the % breakdown of what capacity was used on - so the chart will total 100% in periods of high and low capacity usage.
This section shows summary stats on how many workflows have run this month as well as how much file storage your app is using.
For workflow runs, note that the number does not include workflows that have run solely on the end-user's browser (on the client).
This section shows various metrics relating to pages of your app being loaded, including data that shows how much data is being loaded on those pages.
These charts show metrics about your pages loading time. This data is gathered over the latest page loads by all your users over the last 60 minutes.
You can choose to show averages over the best X percents. The best 1% will show the best performance, while 99% will show all situations.
The Server Logs section in the Logs Tab allows searches of the log of server-side actions, such as send email or change data, executed when users interacted with the app. Search for a particular user by email or ID, within certain dates, or specific keywords. Scroll down to automatically load older events in the results view.
You can filter your application's logs with the following options:
- From date - Choose the earliest date for which you want to see events. Searches start at midnight of that day. If empty, the search continues until the day the app was created. Results are currently limited to the previous two weeks.
- To date - Choose the latest date for which you want to see events. Searches end at 11:59 pm of that day. If empty, the current date is used.
- User - Filter actions by a specific user by typing in the user's email or unique ID. If this field is empty, the data for all users is returned.
- Contains - Enter some text to search for. For example, to search for the word: mountain, type: mountain, without quotes. To search for the exact phrase: tallest mountain, type: tallest mountain with single quotes, 'tallest mountain.' To search for log entries containing either: tall or mountain, type: tall OR mountain, without quotes. OR must be in all caps. If this field is empty, all log entries are returned.
Click "Show advanced" to toggle additional search criteria, such as:
- Started running workflow - This marks the beginning of a workflow executing
- Event condition passed - The event condition evaluated to true (or wasn't set), so Bubble is going to run the workflow
- Event condition not passed - The event condition evaluated to false, so Bubble is going to end the workflow
- Running action - Bubble is beginning to run a specific workflow action
- Action condition failed - Bubble is ending the execution of a workflow action because the condition evaluation to false
- Workflow error - The workflow stopped running because of an error
- Autobinding operation - A user modified data by editing an input that uses autobinding
- Plugin server side output - A server-side plugin action ran; this is the raw output, for use in debugging
- Plugin server side error - A server-side plugin action failed with an error; this is the error, for use in debugging
- Scheduled task to run - Bubble scheduled a task to be executed at a future point in time
- Scheduled task completed - A scheduled task that was running finished execution
- HTTP request - The app made an outbound HTTP request to an external API
- HTTP response - An outbound HTTP request the app made completed with the given response
- Request for API workflow - An API endpoint in our workflow API was called
- Sending email failed - Bubble was unable to send an email because of an error
For each log entry, you will see a number of fields:
- Name: the name of the item relevant to the log, which sometimes is what kind of log it is or the name of a specific workflow action, for example
- Email: the email of the user associated with this log running, often the end-user causing the workflow / action to happen
- ID: the unique ID of the user with the email above
- Timestamp: when the log happened, in your local time
- Message / properties: the body of the log, which gives information about that particular entry; the information available will depend on what kind of log it is
One feature of Bubble is the ability to set a workflow to run later at a certain time or on a recurring basis going into the future. You can see any such scheduled future workflows on this sub-tab.
Each result from the search represents a scheduled workflow that will run in the future. For each result, you see the following information:
- Scheduled time: when the workflow will run, represented in your local time
- ID: the ID of this scheduled workflow, which you can use, for example, to cancel that scheduled workflow from another workflow
- API event: the workflow that will run
- Current user: generally signifies which user caused this workflow to be scheduled (may not map to the user whose permissions will be applied when the workflow runs, as that can be configured in the definition of the workflow itself)
- Parameters: any parameters that workflow will run with, as expected in the definition of the workflow