-
Type: Spec Change
-
Resolution: Unresolved
-
Priority: Major - P3
-
None
-
Component/s: Logging
-
None
Summary
What is the problem or use case, what are we trying to achieve?
There was extended discussion in the DRIVERS-1208 logging slack channel about some modifications to the logging specification. The slack discussion can be found [here|https://mongodb.slack.com/archives/G015EB3QHED/p1669665126177999].
The changes are summarized below:
- add rationale for the currently described behavior around “treating invalid values of env variables as if they were not specified at all”
- mention that programmatic configuration MUST win out over environment variables if a driver supports both and drivers SHOULD document how to have dynamic configuration via env var override programmatic config
- mention drivers MAY (SHOULD?) attempt to warn users about the misconfiguration via log messages or otherwise
- drivers MAY but are not required to directly support logging to an arbitrary file. if they do not support it, they MUST at least provide a straightforward, idiomatic way for users to programmatically consume messages for writing to a file and they MUST provide a basic documentation example showing how to do this.
Additionally, some minor changes should be made to the command logging and monitoring spec such that its representations of server addresses are consistent with decisions made in DRIVERS-1675.
Motivation
Who is the affected end user?
Drivers engineers implementing the logging spec.
How does this affect the end user?
Some drivers are
How likely is it that this problem or use case will occur?
n/a
If the problem does occur, what are the consequences and how severe are they?
n/a
Is this issue urgent?
Does this ticket have a required timeline? What is it?
Is this ticket required by a downstream team?
No.
Is this ticket only for tests?
No.
- split to
-
CDRIVER-4535 Misc Updates to Logging Spec
- Backlog
-
CXX-2626 Misc Updates to Logging Spec
- Backlog
-
CSHARP-4450 Misc Updates to Logging Spec
- Closed
-
GODRIVER-2688 Misc Updates to Logging Spec
- Closed
-
JAVA-4829 Misc Updates to Logging Spec
- Closed
-
MOTOR-1074 Misc Updates to Logging Spec
- Closed
-
NODE-4882 Misc Updates to Logging Spec
- Closed
-
PHPLIB-1050 Misc Updates to Logging Spec
- Closed
-
PYTHON-3537 Misc Updates to Logging Spec
- Closed
-
RUBY-3196 Misc Updates to Logging Spec
- Closed
-
RUST-1555 Misc Updates to Logging Spec
- Closed