TraceService MBean

Partial ObjectName:
WebSphere:*,type=TraceService


MBean TraceService

Management interface for the live TraceService function running in a server.


Attribute Summary

intringBufferSize
           the size of the trace output Ring Buffer.
java.lang.StringtraceSpecification
           A Trace specification which allows enabling/disabling tracing for components.
java.lang.StringeffectiveTraceSpecification
           A Trace specification like traceSpecification only with external factors such as PCI-DSS applied.
java.lang.StringtraceFileName
           the name of the file to which trace output will be written.
java.lang.StringtraceRuntimeConfig
           The current runtime configuration of the trace logger.
booleanrawTraceFilterEnabled
           Raw Trace Filter Enablement for legacy.

Operation Summary

voidappendTraceString(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.
voiddumpRingBuffer(java.lang.String fileToWriteTo)
           Write the contents of the Ras services Ring Buffer to the specified file.
voidclearRingBuffer()
           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.HashMaplistComponentsInGroup(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.
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.
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.StringgetTraceSpecification(java.lang.String component)
           Return the current trace specification for the specified component or group.
voidprocessDumpString(java.lang.String dumpString)
           Instruct dumpable components to write their current state.
voidcheckTraceString(java.lang.String traceString)
           Check the specified trace string to see if it conforms to the TraceString grammar.
voidsetTraceOutputToFile(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.
voidsetTraceOutputToRingBuffer(int ringBufferSize, java.lang.String traceFormat)
           Make the ring buffer the active trace destination to which trace is routed.
java.lang.StringrolloverLogFileImmediate(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.

Attribute Detail

ringBufferSize

public int ringBufferSize

     the size of the trace output Ring Buffer.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager

     Setter:
     administrator
     operator


traceSpecification

public java.lang.String traceSpecification

     A Trace specification which allows enabling/disabling tracing for components.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager

     Setter:
     administrator
     operator


effectiveTraceSpecification

public java.lang.String effectiveTraceSpecification

     A Trace specification like traceSpecification only with external factors such as PCI-DSS applied.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


traceFileName

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.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


traceRuntimeConfig

public java.lang.String traceRuntimeConfig

     The current runtime configuration of the trace logger.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


rawTraceFilterEnabled

public boolean rawTraceFilterEnabled

     Raw Trace Filter Enablement for legacy.

     

Security Roles:

     Getter:
     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager

     Setter:
     administrator
     operator


Operation Detail

appendTraceString

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.

Parameters:

     traceString - a String that complies to the TraceString grammar and passes the checkTraceString() method.

Security Roles:

     administrator
     operator


dumpRingBuffer

public void dumpRingBuffer(java.lang.String fileToWriteTo)

     Write the contents of the Ras services Ring Buffer to the specified file.

Parameters:

     fileToWriteTo - the name of the file to write to.

Security Roles:

     administrator
     operator


clearRingBuffer

public void clearRingBuffer()

     Discard the current contents of the Ring Buffer.

Security Roles:

     administrator
     operator


listAllRegisteredComponents

public java.lang.String[] listAllRegisteredComponents()

     Return an array of Strings containing the fully qualified names of all individual components currently registered with Ras services.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


listAllRegisteredGroups

public java.lang.String[] listAllRegisteredGroups()

     Return an array of Strings containing the names of all Groups currently registered with Ras services.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


listComponentsInGroup

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.

Parameters:

     groups - the complete names of the groups.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


listComponentsInGroup

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.

Parameters:

     group - the complete name of the group.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


getTracedComponents

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.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


getTracedGroups

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.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


getTraceSpecification

public java.lang.String getTraceSpecification(java.lang.String component)

     Return the current trace specification for the specified component or group.

Parameters:

     component - the String containing the name of the component or group.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


processDumpString

public void processDumpString(java.lang.String dumpString)

     Instruct dumpable components to write their current state.

Parameters:

     dumpString - a String in the specified format to process or null.

Security Roles:

     administrator
     operator


checkTraceString

public void checkTraceString(java.lang.String traceString)

     Check the specified trace string to see if it conforms to the TraceString grammar.

Parameters:

     traceString - a String that complies to the TraceString grammar.

Security Roles:

     administrator
     operator
     configurator
     monitor
     deployer
     adminsecuritymanager


setTraceOutputToFile

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.

Parameters:

     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.

Security Roles:

     administrator
     operator


setTraceOutputToRingBuffer

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.

Parameters:

     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.

Security Roles:

     administrator
     operator


rolloverLogFileImmediate

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.

Parameters:

     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.

Security Roles:

     administrator
     operator


Copyright IBM Corporation 2002, 2012