+1 My initial thought was to have the two logs be named diags.log and access.log, but Bryan pointed out to me that error.log is the more "industry standard" name for diagnostic logging for proxies. So error.log (and access.log for transactions) is fine with me.
On Tue, Nov 10, 2026 at 11:05 PM Bryan Call via dev < [email protected]> wrote: > > > For 11.0.0 I'd like to cut ATS down to two log files by default: > error.log and access.log. Today a problem can land in any of three places: > diags.log (status, notes, warnings and errors from the diagnostics system), > traffic.out (debug output and anything else written to stdout or stderr) > and error.log (errors from the logging system), and the access log is > squid.log. Each has its own format and timestamp, and new users often don't > know which one to look in. > > > > The proposal: > > > > 1. Everything that goes to diags.log and traffic.out today goes to > error.log instead, in one line format with a level and tag on every line > (#14010 does the format part). > > 2. squid.log is renamed access.log. > > 3. If someone wants a different split, such as some kinds of messages in > their own file, or sent to syslog or a pipe, that's a configuration option. > error.log and access.log stay the default. > > > > This is the same split httpd and nginx use, and it's what most operators > expect to find. Since diags.log, traffic.out and squid.log go away, it will > need an upgrading note for anyone whose log shipping, alerts or scripts > read them. > > > > Discussion so far is on > https://github.com/apache/trafficserver/issues/12944, including > Masakazu's points about different readers and retention, and we talked > about it at Monday's PR and Issue Scrub. If there are no objections in 72 > hours, I'll take it as lazy consensus and start on it. > > > > -Bryan > -- "Come to Me, all who are weary and heavy-laden, and I will give you rest. Take My yoke upon you and learn from Me, for I am gentle and humble in heart, and you will find rest for your souls. For My yoke is easy and My burden is light." ~ Matthew 11:28-30
