(logging configuration) Expand the admin_audit section #10604
Conversation
Signed-off-by: Josh Richards <[email protected]>
| Use your Nextcloud log to review system status, or to help debug problems. You may adjust logging levels, and choose between using the Nextcloud log or your syslog. If additional audit information is required, you can optionally activate the **admin_audit** app, which by default generates a separate audit.log file in the data directory. | ||
| Use your Nextcloud log to review system status, or to help debug problems. You may adjust logging levels, and choose how and where log data is stored. If additional event logging is required, you can optionally activate the **admin_audit** app. | ||
|
|
||
| When ``file`` based logging is utilized, both the Nextcloud log and, optionally, the **admit_audit** app log can be viewed within the Nextcloud interface under *Administration settings -> Logging* (this functionality is provided by the **logreader** app). |
There was a problem hiding this comment.
It can? I thought this is a missung feature...
There was a problem hiding this comment.
Me too . I got sick of people asking and not knowing the answer. It had been on my to-do list for awhile so finally got around to digging into the code and testing earlier today. So, yes, it does exist as-is today in a form that is totally reasonable for many use cases.
| Integrating into the Web Interface | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| The built-in NC ``logreader`` app (which is what provides the *Administration settings->Logging* interface) only accesses the file-based ``nextcloud.log``. The **admin_audit** app log output, however, can be integrated into the web interface by configuring it to *also* log to the ``nextcloud.log``. |
There was a problem hiding this comment.
Ah I see. Better would be something like nextcloud/logreader#857 though
There was a problem hiding this comment.
That PR looks quite useful if one doesn't wish to combine their on-disk audit log with the normal Nextcloud log.
The confusing thing has been that screenshot from the logreader app repository README - (it's referenced in nextcloud/logreader#129 and occasionally on the forum). It shows everything merged together. :-)
So it turns out it's totally been possible all along.
|
/backport to stable27 |
|
/backport to stable26 |
|
/backport to stable25 |
admin_auditapp section to be more logical/readableconfig.phpexample that works with built-inlogreaderappPossibly future follow-up areas (outside the scope of this PR):
occsection in manuallogreaderapp via Administration settings->Logging☑️ Resolves
🖼️ Screenshots
logging overview:
admin_audit section: