From 19215664d55ba9df7def9f076b8928532b8c62ec Mon Sep 17 00:00:00 2001 From: Xe Iaso Date: Fri, 21 Nov 2025 11:08:14 -0500 Subject: [PATCH] docs: update CHANGELOG Signed-off-by: Xe Iaso --- docs/docs/CHANGELOG.md | 22 +++++++++++++++++++++- docs/docs/admin/policies.mdx | 2 +- 2 files changed, 22 insertions(+), 2 deletions(-) diff --git a/docs/docs/CHANGELOG.md b/docs/docs/CHANGELOG.md index 66e09ea2..873f78d2 100644 --- a/docs/docs/CHANGELOG.md +++ b/docs/docs/CHANGELOG.md @@ -21,9 +21,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 - Allow Renovate as an OCI registry client. - Properly handle 4in6 addresses so that IP matching works with those addresses. - Add support to simple Valkey/Redis cluster mode -- Open Graph passthrough now reuses the configured target Host/SNI/TLS settings, so metadata fetches succeed when the upstream certificate differs from the public domain. ([1283](https://github.com/TecharoHQ/anubis/pull/1283)) +- Open Graph passthrough now reuses the configured target Host/SNI/TLS settings, so metadata fetches succeed when the upstream certificate differs from the public domain. ([1283](https://github.com/TecharoHQ/anubis/pull/1283)) - Stabilize the CVE-2025-24369 regression test by always submitting an invalid proof instead of relying on random POW failures. +### Logging customization + +Anubis now supports the ability to log to multiple backends ("sinks"). This allows you to have Anubis [log to a file](./admin/policies.mdx#file-sink) instead of just logging to standard out. You can also customize the [logging level](./admin/policies.mdx#log-levels) in the policy file: + +```yaml +logging: + level: "warn" # much less verbose logging + sink: file # log to a file + parameters: + file: "./var/anubis.log" + maxBackups: 3 # keep at least 3 old copies + maxBytes: 67108864 # each file can have up to 64 Mi of logs + maxAge: 7 # rotate files out every n days + oldFileTimeFormat: 2006-01-02T15-04-05 # RFC 3339-ish + compress: true # gzip-compress old log files + useLocalTime: false # timezone for rotated files is UTC +``` + +Additionally, information about [how Anubis uses each logging level](./admin/policies.mdx#log-levels) has been added to the documentation. + ## v1.23.1: Lyse Hext - Echo 1 - Fix `SERVE_ROBOTS_TXT` setting after the double slash fix broke it. diff --git a/docs/docs/admin/policies.mdx b/docs/docs/admin/policies.mdx index db6ff106..044bd628 100644 --- a/docs/docs/admin/policies.mdx +++ b/docs/docs/admin/policies.mdx @@ -355,7 +355,7 @@ Anubis uses Go's [standard library `log/slog` package](https://pkg.go.dev/log/sl | :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- | | `DEBUG` | The raw unfiltered torrent of doom. Only use this if you are actively working on Anubis or have very good reasons to use it. | | `INFO` | The default logging level, fairly verbose in order to make it easier for automation to parse. | -| `WARM` | A "more silent" logging level. Much less verbose. Some things that are now at the `info` level need to be moved up to the `warn` level in future patches. | +| `WARN` | A "more silent" logging level. Much less verbose. Some things that are now at the `info` level need to be moved up to the `warn` level in future patches. | | `ERROR` | Only log error messages. | Additionally, you can set a "slightly higher" log level if you need to, such as: