Log a message or some data at the debug log level.
_This function accepts any number of arguments._
sails.log() is almost identical to that of
console.log() in Node core; including support for:
- an unlimited number of arguments
- printf-style parameterization (a la
- automatically inspecting non-string arguments (a la
var sum = +req.param('x') + +req.param('y'); sails.log(); sails.log('Hey %s, did you know that the sum of %d and %d is %d?', req.param('name'), +req.param('x'), +req.param('y'), sum); sails.log('Bet you didn\'t know robots could do math, huh?'); sails.log(); sails.log('Anyways, here is a dictionary containing all the parameters I received in this request:', req.allParams()); sails.log('Until next time!'); return res.ok();
- For a deeper conceptual exploration of logging in Sails, see concepts/logging.
- The built-in logger in Sails is called internally by the framework, but also exposed as an alternative to calling
console.log()directly. Keep in mind that the Sails logger can be configured, or completely overridden using built-in log configuration settings (
- Keep in mind that, like any part of Sails, using
sails.logis completely optional. Most Sails apps take advantage of the built-in logger; while some users prefer to stick with
console.log(), while still others
require()more feature-rich libraries like Winston. If you aren't sure what your app needs yet, start with the built-in logger and go from there.
Is something missing?
If you notice something we've missed or could be improved on, please follow this link and submit a pull request to the sails-docs repo. Once we merge it, the changes will be reflected on the website the next time it is deployed.
- Blueprint API
- Command Line Interface
- Response (`res`)
- Waterline (ORM)
- Resourceful PubSub
- Socket Client
We wrote a book!
Get early access to the book
with promotion code: mcneildoc