Merge branch 'bcarranza-master-patch-41399' into 'master'

Add notes on which services are managed by logrotate, svlogd, both or neither

See merge request gitlab-org/gitlab!63899

doc/administration/logs.md

@@ -21,6 +21,42 @@ including adjusting log retention, log forwarding,
 switching logs from JSON to plain text logging, and more.
 - [How to parse and analyze JSON logs](troubleshooting/log_parsing.md).
 
+## Log Rotation
+
+The logs for a given service may be managed and rotated by:
+
+- `logrotate`
+- `svlogd` (`runit`'s service logging daemon)
+- `logrotate` and `svlogd`
+- Or not at all
+
+The table below includes information about what is responsible for managing and rotating logs for
+the included services. Logs
+[managed by `svlogd`](https://docs.gitlab.com/omnibus/settings/logs.html#runit-logs)
+are written to a file called `current`. The `logrotate` service built into GitLab
+[manages all logs](https://docs.gitlab.com/omnibus/settings/logs.html#logrotate)
+except those captured by `runit`.
+
+| Log Type                                        | Managed by logrotate | Managed by svlogd/runit |
+| ----------------------------------------------- | -------------------- | ----------------------- |
+| [Alertmanager Logs](#alertmanager-logs)         | N                    | Y                       |
+| [Crond Logs](#crond-logs)                       | N                    | Y                       |
+| [Gitaly](#gitaly-logs)                          | Y                    | Y                       |
+| [GitLab Exporter For Omnibus](#gitlab-exporter) | N                    | Y                       |
+| [GitLab Pages Logs](#pages-logs)                | Y                    | Y                       |
+| GitLab Rails                                    | Y                    | N                       |
+| [GitLab Shell Logs](#gitlab-shelllog)           | Y                    | N                       |
+| [Grafana Logs](#grafana-logs)                   | N                    | Y                       |
+| [LogRotate Logs](#logrotate-logs)               | N                    | Y                       |
+| [Mailroom](#mail_room_jsonlog-default)          | Y                    | Y                       |
+| [NGINX](#nginx-logs)                            | Y                    | Y                       |
+| [PostgreSQL Logs](#postgresql-logs)             | N                    | Y                       |
+| [Prometheus Logs](#prometheus-logs)             | N                    | Y                       |
+| [Puma](#puma-logs)                              | Y                    | Y                       |
+| [Redis Logs](#redis-logs)                       | N                    | Y                       |
+| [Registry Logs](#registry-logs)                 | N                    | Y                       |
+| [Workhorse Logs](#workhorse-logs)               | Y                    | Y                       |
+
 ## `production_json.log`
 
 This file lives in `/var/log/gitlab/gitlab-rails/production_json.log` for