@@ -77,32 +77,6 @@ logger.formatter = config.log_formatter
7777config.logger = ActiveSupport::TaggedLogging.new(logger)` }
7878 </ CodeBlock >
7979
80- < HeadingWithAnchor id = "dotenv-rails" level = { 2 } >
81- Dotenv‑Rails and Early Boot Logs
82- </ HeadingWithAnchor >
83- < p className = "text-neutral-600 dark:text-neutral-400" >
84- Some libraries (e.g., < code > dotenv-rails</ code > ) log very early during
85- boot. LogStruct subscribes to those notifications immediately and
86- buffers structured logs. After your initializers run, LogStruct decides
87- which set to emit:
88- </ p >
89- < ul className = "list-disc list-inside space-y-2 text-neutral-600 dark:text-neutral-400" >
90- < li >
91- < b > Enabled:</ b > Emit structured JSON logs (for example, a dotenv{ ' ' }
92- < em > update</ em > event) and suppress original replay.
93- </ li >
94- < li >
95- < b > Disabled:</ b > Emit original < code > [dotenv]</ code > lines and discard
96- the structured buffer.
97- </ li >
98- </ ul >
99- < Callout type = "warning" className = "mt-2" >
100- When you run a < code > rails runner</ code > inside your test suite, it
101- inherits < code > RAILS_ENV=test</ code > . Dotenv may have already loaded{ ' ' }
102- < code > .env.test</ code > , so nested runs might only show a single “Loaded
103- …” line (no “Set …” update).
104- </ Callout >
105-
10680 < HeadingWithAnchor id = "production-recommendations" level = { 2 } >
10781 Production Recommendations
10882 </ HeadingWithAnchor >
@@ -121,19 +95,6 @@ config.logger = ActiveSupport::TaggedLogging.new(logger)`}
12195 </ li >
12296 </ ul >
12397
124- < HeadingWithAnchor id = "quick-diagnostics" level = { 2 } >
125- Quick Diagnostics
126- </ HeadingWithAnchor >
127- < CodeBlock language = "bash" >
128- { `# Verify structured boot logs (dotenv) in test env
129- LOGSTRUCT_ENABLED=true RAILS_LOG_TO_STDOUT=1 DISABLE_SPRING=1 RAILS_ENV=test \
130- rails runner 'puts LogStruct.enabled?'
131-
132- # Verify original dotenv lines when disabled
133- LOGSTRUCT_ENABLED=false RAILS_LOG_TO_STDOUT=1 DISABLE_SPRING=1 RAILS_ENV=development \
134- rails runner 'puts LogStruct.enabled?'` }
135- </ CodeBlock >
136-
13798 < EditPageLink />
13899 </ div >
139100 ) ;
0 commit comments