Salesforce

When are PAS logs written to disk?

« Go Back

Information

 
TitleWhen are PAS logs written to disk?
URL Namewhen-are-pas-logs-written-to-disk
Article Number000178003
EnvironmentProduct: OpenEdge
Version: 11.7.x, 12.x
OS: All supported platforms
Question/Problem Description
When are PAS logs written to disk?

When are logs produced by the Progress Application Server for OpenEdge (PAS or PASOE) flushed to disk?

Why do I not see expected entries in the PAS agent log until PAS has been shut down?
Steps to Reproduce
Clarifying Information
CATALINA_BASE is an environment variable representing the path to a PAS instance directory eg: oepas1
DLC is an environment variable representing the path to the OpenEdge installation directory.
Error Message
Defect Number
Enhancement Number
Cause
Resolution
Progress Application Server for OpenEdge uses three distinct and independent logging subsystems to record events.

1.   Generic Tomcat Logs (catalina*, localhost*, manager*, host-manager*)
  • Tomcat logs are configured in <CATALINA_BASE>/conf/logging.properties.
  • By default this logging subsystem uses the Operating System default buffering. Delays in writing to these logs are usually not noticeable.
  • Immediate writes can be forced by adding a bufferSize property with a value less than zero to whichever file handler needs to be forced. For example in the logging.properties file:
2localhost.org.apache.juli.FileHandler.level = INFO
2localhost.org.apache.juli.FileHandler.directory = ${catalina.base}/logs
2localhost.org.apache.juli.FileHandler.prefix = localhost.
2localhost.org.apache.juli.FileHandler.bufferSize = -1

2.   PASOE Web App Log (<PAS instance name>.<date>.log)
  • Web App Logs are configured in <CATALINA_BASE>/webapps/<Web app name>/WEB-INF/logging.xml.
  • By default these logs are not buffered. There is no need to add "<immediateFlush>true</immediateFlush>" to force writes because this is the default
  • Buffering may be added for increased performance by adding an immediateFlush property in the encoder node of logging.xml. For example:
         <encoder>
          <!-- add the timestamp as milliseconds to facilitate logfile post processing     -->
          <!--                                                                             -->
          <!-- <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern> -->
          <pattern>%d{HH:mm:ss.SSS}/%r [%thread] %-5level %logger{36} - %msg%n</pattern>
          <immediateFlush>false</immediateFlush>         
          <!--                                                                             -->
        </encoder>

3.   PASOE Agent Log (<PAS instance name>.agent.log)
  • PASOE Agent logs are configured in <CATALINA_BASE>/conf/openedge.properties.
  • By default these logs are buffered, but the buffering is not configurable.
  • Delay in writing entries to the Agent log may be noticed when events are infrequent. If this is inconvenient in a testing situation, stopping the PAS server will flush all entries to disk so that the log can be examined.
Workaround
Notes
References to Other Documentation:

openedge.properties.README
(Available in <DLC>/servers/pasoe/conf, <CATALINA_BASE>/conf, or in the OpenEdge documentation set.)

Apache Tomcat: Logging in Tomcat
https://tomcat.apache.org/tomcat-7.0-doc/logging.html

LogBack Chapter 5: Encoders
http://logback.qos.ch/manual/encoders.html#PatternLayoutEncoder
Keyword Phrase
Last Modified Date12/12/2024 4:19 PM

Powered by