Change webserver to puma and adapt command line interface #677
Conversation
|
Awesome! Someone took a shot at this in #427 and I was going to find time to clean that up so it could be merged... but if you've got it going here that's great! I don't know that we want to start running the tests with JRuby though, I think the most common use case will still be to run dashing as a Ruby app. My understanding was that switching to Puma will allow us to run in a JVM as well as in a normal Ruby context -- is that correct? |
|
It's correct, puma works fine on all ruby VMs. Thanks for mentioning the work already done in #427. I will integrate it. |
qbrossard
force-pushed
the
puma_webserver
branch
2 times, most recently
from
30a5844 to
0afb283
Compare
qbrossard
changed the title
|
I integrated most of the work previously done to support puma. I also used pumactl for supporting daemon mode (-d) for backwards compatibility. There's still one small open point regarding the location of puma's pidfile (needed in daemon mode by pumactl to stop the server). Otherwise I think this would be ready. Can @tylermauthe or @pushmatrix have a look at this? |
|
At a glance, this looks great. I'll give it a more thorough look at lunch today and let you know if I find any issues. Also, any chance you've tried this on Windows? This is amazing! I've been putting off doing this for ages, thanks so much! |
|
Okay, I took a quick peak at this using the generated sample Dashing project -- it looks great. Exactly the behaviour I was hoping for. I thought it might be possible to specify the web server in the config.ru, but this is great! I'd like to do some testing to see what happens when you try to start Dashing as a daemon on Windows -- I suspect it fails because Windows doesn't implement fork(). I'd also like to make sure the changeset plays nicely with existing dashboards -- though I don't see how moving to Puma would affect them. I should be able to complete the rest of the testing tonight, so unless @pushmatrix finds any issues, we should be able to merge this sucker within the week. Thanks again!! 👍 |
|
Thanks for taking a look at this. I will also update the wiki with information on puma when this PR gets merged. |
qbrossard
force-pushed
the
puma_webserver
branch
2 times, most recently
from
10620cd to
ef19168
Compare
|
Yeah, I think the lack of Windows support for that is okay in this case. I believe that Thin didn't support it either: Windows does not have the concept of a daemon in this sense, so it's okay that the feature doesn't work. It looks like Puma handles this gracefully as well: I tried this on Heroku and it is working fine so far, though I can't tell if it's actually using Puma -- I don't have a I was also able to try this locally with two dashboard applications, they both worked well with The only issue I've found is that the EventSource is producing constant errors and is essentially being cut off directly after the SSE call returns the first datapoint. This seems to be a problem with Puma itself: The issue was identified a long time ago in Puma and was essentially closed as "won't fix": Sadly, I think that this may require changes to Sinatra to resolve the issue properly. However, I did find an interesting article wherein Aaron Patterson describes how he created a Server Sent Event class for use in Puma: It might be possible to use this technique to make it work for Dashing, since I am doubtful that Sinatra can be made to support this. The interface of the |
|
This is a problem for lots of people, not just us! I've pinged the Sinatra team to see if they're cool with adding in a Puma adapter: sinatra/sinatra#1035 (comment) |
|
I missed the SSE related errors when I tested, sorry for that. Then it seems we are blocked by missing sinatra support here. :-( Regarding the default port, I will change it so it uses the same as before (9292 is the default puma port). I think the best way would be to use a config/puma.rb file that would be autodetected (as rails does now). Not sure if that can be made backwards compatible with the old -d command line option but I'll try... |
|
Hey, no worries at all on the SSE stuff -- I am so thankful for your assistance. We can build in our own adapter until Sinatra fixes their Stream class. It could act as a proof of concept for the fix in Sinatra as well, as the adapter would essentially be a re-written copy of their Stream class which has support for EventMachine. This will require the creation of an adapter class which simply blocks the thread for the lifetime of the request. Puma's threading model should handle this gracefully, as proven by the Rails 4 implementation of SSE -- which doesn't rely on EventMachine since the switch to Puma. I'll see what I can whip up and try to submit a PR to somewhere. Thanks again for this work! 🍻 |
|
Okay, I was able to get this working without changes to Sinatra -- making use of the I'll submit a PR to your PR as soon as I get the test working with the new connection style. |
|
Cool. |
|
@qbrossard @tylermauthe this is looking real good :) |
|
I am not sure how I feel about the fact that we now create a queue of events to send to each connection, this increases the memory requirements by at least 2 * connections * total size of history. To be fair, though, this should really only be a couple megabytes. Also, when a connection is dropped we simply let this queue grow to 2 x the length of history and then remove it. I couldn't figure out how to actually respond to the disconnect event 👎. Again, there's waste and also a chance that poorly performing connections will lose data. I would argue that naturally throttling poor connections is a good idea anyway and that the waste is kept small by the max queue size. In any case, this is the best I've come up with. If it performs well, I am inclined to keep it. If anyone has improvements, especially in the above two areas, I greatly appreciate any and all feedback! Let's let this change stew for a while so we can test it thoroughly. |
|
As I feared, my dashboard running on an old-school Heroku-free instance is completely unstable with my latest changeset. It was working fine with your changes @qbrossard, though the SSE was failing behind the scenes. It should be noted that the dashboard worked fine, but the browser JS console was strewn with errors and SSE reconnection attempts. I see this in the logs: I haven't tested this theory, but my guess is that the need to keep track of events on a per-connection basis combined with the ad-hoc mechanism for removing dead connections has increased the memory requirements too much. Options I can think of:
Hopefully someone else can think of a better idea because I'm not in love with any of those! |
|
This memory usage problem looks strange. Make sure you use ruby 2.3.0, as there seem to be unverified memory problems with puma on older (2.2) rubies? |
|
That is very odd, I can't reproduce the SSE errors when running locally or on Heroku. I only left the connection open for a few minutes though, perhaps it dies after some time? I'm starting to think that the memory problem is unrelated to my changes, but I haven't spent much time investigating this further. A more worrying aspect of this change is that running in JRuby actually causes scary errors: This is happening because in one thread I'm appending objects to a data structure and in another thread I'm draining objects out of it. This page has a fairly good breakdown of what options there are to solve this: Hopefully there is a clever way to avoid the need to share mutable data across threads as I have implemented. Sharing mutable data across threads is typically the most naive way to implement concurrency -- so maybe if inspiration strikes we can figure a smarter solution. The trouble comes when we need to actually send events from the jobs. How can we ensure that the data acquired in the Rufus threads is shuttled out exactly once to all connections? |
|
It looks like JRuby actually checks synchronization on array access, cool. |
|
I took another stab at it: https://github.com/tylermauthe/dashing/tree/puma_webserver I'm going to let it run for a bit see how stable it is. So far, it's looking much better. I will submit another Pull Request as soon as I am done trying JRuby, Rubinius and MRI for a while. I would appreciate it if you could rebase the commits afterward to have a bit cleaner history. I'd do it myself, but I believe the owner of this Pull Request must do that. I realized that with EventMachine gone, Rufus was also free to spawn many threads -- |
|
Seems to be running quite stable. It's pretty fun to just crank up the |
|
Oh, I just realized that I forgot synchronize access to the I'll fix that up too. |
|
@tylermauthe Thanks a lot for taking the time to fix the threading issue. I'll squash my commits to make the history cleaner. This is looking really good now... |
- Keep track of events on per-client basis - Clients get a UUID - If a client's event queue grows too big it gets dropped - If a Puma thread tries to send the next batch of events to a client and it's event queue is dropped, the queue will be created - Updated tests to match above changes
- Realized that Rufus can also be multi-threaded now - Added a mutex for each connection, allowing safe access during send_event - Don't need to track a queue of events per connection - should lower memory footprint - Connection termination detected by catching Puma::ConnectionError exceptions during send_event conntion writing - Updated tests accordingly
- configure puma using config/puma.rb config file - add default puma.rb config file for new projects - adapt dashing cli to use the config file and correctly handle -d (daemonize) arg. - adapt cli_test.rb to the new setup - remove tmp dir from gitignore as we want to generate it in the project template - add tmp/pids/ dir in project template (for saving puma pid / state files.
qbrossard
force-pushed
the
puma_webserver
branch
from
3b6ffe5 to
ee64d7d
Compare
|
@tylermauthe I squashed all my commits together and left yours as they were. |
|
Oh, sorry my commits could be squashed too. Especially the two that are fix and actually fix - hehe. Oh well! I am curious if anyone else has run this for any length of time? My dashboards are running fine with it... @qbrossard - Thanks again for all your work on this! It's been super helpful and it gave me the kick in the pants I needed to get it done. I think we could probably merge this now if you've given it the Shopify seal of approval @pushmatrix |
|
Thanks for you work on this @qbrossard and @tylermauthe. Let's get this thing merged this week. I'll be reviewing it shortly. |
| out << latest_events | ||
| out.callback { settings.connections.delete(out) } | ||
| settings.connections << connection = {out: out, mutex: Mutex.new, terminated: false} |
There was a problem hiding this comment.
Each connection gets its own Mutex?
There was a problem hiding this comment.
Yes, it signifies the out resource which we are injecting events into inside send_event.
|
Hey @qbrossard and @tylermauthe. I've given a lot of thought into this, and unfortunately I have changed my mind on putting this into master. I initially thought that the switch to puma would be straightforward, but it seems like there are many gotchas in the way, and that it doesn't play very nice with Sinatra. As this project has now become no longer actively maintained, I fear that adding a bunch of complexity may introduce new issues that may not be addressed. I also don't want to break any existing dashboards out there. What I suggest we do is make a branch for it, with a wiki article on how to use it. That way people will be able to use JRuby if they want to, and they won't have to fear about missing out on features because....well....there probably won't be any new ones coming :\ Thanks guys for your help in diving into this! Hopefully it was a good learning process, and I hope it will be of use to other people looking to use Puma and Dashing. Cheers! |
|
+1 for the Puma branch -- makes sense to me. There are a lot of major changes and I know I don't have the time to deal with the fallout from the impact of those changes on thousands of dashboards in the wild. Good thing rubygems are easy to install from a branch :) https://github.com/gottfrois/dashing-rails - Runs on Rails 4, so that's another option for those looking to get Puma support from Dashing. |
|
It's now an official branch over here: https://github.com/Shopify/dashing/tree/puma_webserver If there any gotchas or specific things someone needs when running it, feel free to post them on this wiki: https://github.com/Shopify/dashing/wiki/How-To%3A-Run-Dashing-on-Puma |
The currently used thin webserver is not compatible with jruby.
The puma webserver is a good replacement as it's compatible with most ruby implementations. Moreover it's very fast.