We do this to prevent foot guns. The default config uses a MemoryFilter, but users are free to change to logging to files directly. If they do then they have to ensure to set the `filters: [context]` on the right handler, otherwise records get written with the wrong context. Instead we move the logic to happen when we generate a record, which is when we *log* rather than *handle*. (It's possible to add filters to loggers in the config, however they don't apply to descendant loggers and so they have to be manually set on *every* logger used in the code base) |
||
|---|---|---|
| .. | ||
| admin_api | ||
| dev | ||
| privacy_policy_templates/en | ||
| sphinx | ||
| systemd-with-workers | ||
| .sample_config_header.yaml | ||
| ACME.md | ||
| CAPTCHA_SETUP.md | ||
| MSC1711_certificates_FAQ.md | ||
| README.md | ||
| ancient_architecture_notes.md | ||
| application_services.md | ||
| architecture.md | ||
| code_style.md | ||
| consent_tracking.md | ||
| delegate.md | ||
| federate.md | ||
| jwt.md | ||
| log_contexts.md | ||
| manhole.md | ||
| media_repository.md | ||
| message_retention_policies.md | ||
| metrics-howto.md | ||
| openid.md | ||
| opentracing.md | ||
| password_auth_providers.md | ||
| postgres.md | ||
| replication.md | ||
| reverse_proxy.md | ||
| room_and_user_statistics.md | ||
| sample_config.yaml | ||
| sample_log_config.yaml | ||
| server_notices.md | ||
| spam_checker.md | ||
| sso_mapping_providers.md | ||
| structured_logging.md | ||
| synctl_workers.md | ||
| tcp_replication.md | ||
| turn-howto.md | ||
| url_previews.md | ||
| user_directory.md | ||
| workers.md | ||
README.md
Synapse Documentation
This directory contains documentation specific to the synapse homeserver.
All matrix-generic documentation now lives in its own project, located at matrix-org/matrix-doc
(Note: some items here may be moved to matrix-org/matrix-doc at some point in the future.)