RailsLiveDashboard
RailsLiveDashboard is a real-time debug dashboard for Rails applications. It provides insights into requests, queries, and exceptions, empowering developers to debug their applications effectively in development environments.
Modules Implemented
-
Dashboard: Show environment ruby and rails version, slowest requests and slowest queries.
-
Requests: Show requests data, like controller, action, status code, params and duration.
-
Exceptions: Show exception data, like traces and file.
-
Queries: Show queries data, like SQL and duration.
-
Jobs: Show jobs data, like name, job_id, paramers, history, status and duration.
Note: This gem is not recommended for production use, as it may potentially slow down your application and significantly increase your database size.
Installation
Add this line to your application's Gemfile:
gem 'rails_live_dashboard'
We recommend adding it within your development gem group.
Then execute:
$ bundle install
Install migrations into your project:
$ rails rails_live_dashboard:install:migrations
Then run the migration:
$ rails db:migrate
To mount the RailsLiveDashboard routes and access the dashboard, add the following to your routes file:
mount RailsLiveDashboard::Engine, at: '/live-dashboard' if Rails.env.development?
Configuration
After installing RailsLiveDashboard, a configuration file will be created at config/initializers/rails_live_dashboard.rb:
RailsLiveDashboard.configure do |config|
config.enabled = true
end
You can configure it by setting:
- enabled: A boolean value to enable or disable RailsLiveDashboard subscribers.
Contributing
We welcome contributions from the community to help enhance RailsLiveDashboard. Whether it's through bug fixes, feature enhancements, or documentation improvements, your contributions are invaluable in making RailsLiveDashboard even better!
To contribute, simply fork the repository, make your changes, and submit a pull request.
License
The gem is available as open source under the terms of the MIT License.