[logs] missing cookbook about logrotate

[brikou]

Configuring logrotate is maybe an off topic but it could be great to add a cookbook on how to configure logrotate to deal with logs (sometimes it can become huge)... Symfony needs more real cookbook about productions topics ;)

Cheer

[klaussilveira]

Well, this depends on the focus that the documentation wants. If we document logrotate, we'll have to document other technologies involved with web applications in production.

Since there's already a cookbook about setting up Varnish, i don't think this is an issue. +1!

[Sgoettschkes]

Any official comment for this one? I would write it, but of course only if there is a change it gets merged.

[weaverryan]

Actually documenting something like logrotate I think is out of the scope of the documentation, though I'm not against mentioning something when it's useful.

However, monolog does have a RotatingFileHandler - talking about how to use this in a short article would be great. In fact, we really under-appreciate the monolog handlers I think - not that we should document them individually, but at least mentioning them - and the keys to use for each (with a link to the monolog docs) - would be a big step.

Thanks!

[ricardclau]

+1 to this kind of documentation

[weaverryan]

To be clear, the deliverable on this - in my opinion - would be to create a new cookbook article under "Logging" called "How to leverage Monolog handlers". In this document, we would mention every (or at least most) of the handlers in Monolog with a short description about what they do and a short quick example on how to use them.

[wouterj]

@weaverryan that looks more like a reference, doesn't it? I think I prefer to put that in our references documentation.

[dbu]

it would not hurt to mention somewhere early in the doc that one needs to rotate the logs in app/logs/ - if people are not aware of that, they fill up their disk with logs... i don't think we need to document logrotate, but just mention it in the right place so people who have a clue notice the hint, and those who don't go look it up.

[javiereguiluz]

As suggested by @weaverryan, there are two things to do:

• Mention logrotate and the problem of the log file size: done in Added a note about log file sizes and the use of logrotate #5006 I've added this tip in the Cookbook because the Book doesn't really explain the log files anywhere, so it felt more natural to add it the cookbook.
• We should decide if it's worth it to create a new Reference for Monolog Handlers. Opinions?

[wouterj]

We should decide if it's worth it to create a new Reference for Monolog Handlers. Opinions?

This is now alreadyd ocumented in the API docs of Monolog. Besides this, we might want to move everything to the bundle docs: #4983

[javiereguiluz]

@wouterj great! So after #5006 gets merged, this issue can be closed. Thanks.

[weaverryan]

This can be closed technically.... though I'd love to see a note about rotating_file added in addition to #5006.