WebSphere:*,type=TraceService
MBean TraceService
Management interface for the live TraceService function running in a server.
Attribute Summary | |
---|---|
int | ringBufferSize the size of the trace output Ring Buffer. |
java.lang.String | traceSpecification A Trace specification which allows enabling/disabling tracing for components. |
java.lang.String | effectiveTraceSpecification A Trace specification like traceSpecification only with external factors such as PCI-DSS applied. |
java.lang.String | traceFileName the name of the file to which trace output will be written. |
java.lang.String | traceRuntimeConfig The current runtime configuration of the trace logger. |
boolean | rawTraceFilterEnabled Raw Trace Filter Enablement for legacy. |
Operation Summary | |
---|---|
void | appendTraceString( Add the specified trace string to the trace state already active in the process runtime, without first clearing the current state. |
void | dumpRingBuffer( Write the contents of the Ras services Ring Buffer to the specified file. |
void | clearRingBuffer() Discard the current contents of the Ring Buffer. |
java.lang.String[] | listAllRegisteredComponents() Return an array of Strings containing the fully qualified names of all individual components currently registered with Ras services. |
java.lang.String[] | listAllRegisteredGroups() Return an array of Strings containing the names of all Groups currently registered with Ras services. |
java.util.HashMap | listComponentsInGroup( For each specified group, return an array of Strings containing the fully qualified names of all components who have registered as members of the specified group. |
java.lang.String[] | listComponentsInGroup( Return an array of Strings containing the fully qualified names of all components who have registered as members of the specified group. |
TraceElementState[] | getTracedComponents() Return an array of TraceElementState objects containing information about the currently registered individual components for which some type of trace is currently enabled. |
TraceElementState[] | getTracedGroups() Return an array of TraceElementState objects containing information about the currently registered Groups for which some type of trace is currently enabled. |
java.lang.String | getTraceSpecification( Return the current trace specification for the specified component or group. |
void | processDumpString( Instruct dumpable components to write their current state. |
void | checkTraceString( Check the specified trace string to see if it conforms to the TraceString grammar. |
void | setTraceOutputToFile( Make the specified file the active trace destination to which trace is routed. |
void | setTraceOutputToRingBuffer( Make the ring buffer the active trace destination to which trace is routed. |
java.lang.String | rolloverLogFileImmediate( Immediately roll the log file for the specified stream and return the name of the archive file. |
Attribute Detail |
---|
public int ringBufferSize
the size of the trace output Ring Buffer.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
Setter:
administrator
operator
public java.lang.String traceSpecification
A Trace specification which allows enabling/disabling tracing for components.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
Setter:
administrator
operator
public java.lang.String effectiveTraceSpecification
A Trace specification like traceSpecification only with external factors such as PCI-DSS applied.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.lang.String traceFileName
the name of the file to which trace output will be written. This will be null if trace is configured to write output to the ring buffer.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.lang.String traceRuntimeConfig
The current runtime configuration of the trace logger.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public boolean rawTraceFilterEnabled
Raw Trace Filter Enablement for legacy.
Getter:
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
Setter:
administrator
operator
Operation Detail |
---|
public void appendTraceString(
java.lang.String traceString
)
Add the specified trace string to the trace state already active in the process runtime, without first clearing the current state.
traceString
-
a String that complies to the TraceString grammar and passes the checkTraceString() method.
administrator
operator
public void dumpRingBuffer(
java.lang.String fileToWriteTo
)
Write the contents of the Ras services Ring Buffer to the specified file.
fileToWriteTo
-
the name of the file to write to.
administrator
operator
public void clearRingBuffer()
Discard the current contents of the Ring Buffer.
administrator
operator
public java.lang.String[] listAllRegisteredComponents()
Return an array of Strings containing the fully qualified names of all individual components currently registered with Ras services.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.lang.String[] listAllRegisteredGroups()
Return an array of Strings containing the names of all Groups currently registered with Ras services.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.util.HashMap listComponentsInGroup(
java.lang.String[] groups
)
For each specified group, return an array of Strings containing the fully qualified names of all components who have registered as members of the specified group.
groups
-
the complete names of the groups.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.lang.String[] listComponentsInGroup(
java.lang.String group
)
Return an array of Strings containing the fully qualified names of all components who have registered as members of the specified group.
group
-
the complete name of the group.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public TraceElementState[] getTracedComponents()
Return an array of TraceElementState objects containing information about the currently registered individual components for which some type of trace is currently enabled.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public TraceElementState[] getTracedGroups()
Return an array of TraceElementState objects containing information about the currently registered Groups for which some type of trace is currently enabled.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public java.lang.String getTraceSpecification(
java.lang.String component
)
Return the current trace specification for the specified component or group.
component
-
the String containing the name of the component or group.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public void processDumpString(
java.lang.String dumpString
)
Instruct dumpable components to write their current state.
dumpString
-
a String in the specified format to process or null.
administrator
operator
public void checkTraceString(
java.lang.String traceString
)
Check the specified trace string to see if it conforms to the TraceString grammar.
traceString
-
a String that complies to the TraceString grammar.
administrator
operator
configurator
monitor
deployer
adminsecuritymanager
public void setTraceOutputToFile(
java.lang.String fileName,
int rolloverSize,
int numberBackups,
java.lang.String traceFormat
)
Make the specified file the active trace destination to which trace is routed. If trace is currently being routed to the ring buffer, the existing ring buffer is discarded. If trace is currently being routed to a file, the file will be closed and a new one opened. If the filename is the same as the name of the file currently in use, the results may be unpredictable.
fileName
-
a non-null String containing the fully-qualified name of a file. Ras must be able to create the directory if it does not exist and must have write access to the file. rolloverSize
-
an int indicating the number of Megabytes at which the trace file should roll over to a new file. Caller must guarantee this is positive. numberBackups
-
an integer indicating the number of backup files to maintain. The caller must guarantee this is positive. traceFormat
-
a String indicating the trace format desired by the user. The String must be 'basic', 'advanced' or 'loganalyzer'. If an invalid value is specified, basic will be used.
administrator
operator
public void setTraceOutputToRingBuffer(
int ringBufferSize,
java.lang.String traceFormat
)
Make the ring buffer the active trace destination to which trace is routed. If trace is currently being routed to the ring buffer, the existing ring buffer is simply resized. If trace is currently being routed to a file. the file will be closed and the listener that wraps it removed from the listener list.
ringBufferSize
-
an integer indicating the number of backup files to maintain. The caller must guarantee this is positive. traceFormat
-
a String indicating the trace format desired by the user. The String must be 'basic', 'advanced' or 'loganalyzer'. If an invalid value is specified, basic will be used.
administrator
operator
public java.lang.String rolloverLogFileImmediate(
java.lang.String streamName,
java.lang.String fileName
)
Immediately roll the log file for the specified stream and return the name of the archive file.
streamName
-
token that indicates which log file is to be rolled over. The caller must guarantee it is 'SystemOut' or 'SystemErr'. fileName
-
the name of the file used to archive the contents of the current stream. May be null. If null is specified, the system will generate a file name.
administrator
operator