org.apache.jmeter.protocol.http.sampler

Class AccessLogSampler

java.lang.Object

org.apache.jmeter.testelement.AbstractTestElement

org.apache.jmeter.samplers.AbstractSampler

org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase

org.apache.jmeter.protocol.http.sampler.HTTPSampler

org.apache.jmeter.protocol.http.sampler.AccessLogSampler

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, org.apache.jmeter.engine.util.ConfigMergabilityIndicator, org.apache.jmeter.gui.Replaceable, org.apache.jmeter.gui.Searchable, HTTPConstantsInterface, org.apache.jmeter.samplers.Interruptible, org.apache.jmeter.samplers.Sampler, org.apache.jmeter.testbeans.TestBean, org.apache.jmeter.testelement.TestElement, org.apache.jmeter.testelement.TestIterationListener, org.apache.jmeter.testelement.TestStateListener, org.apache.jmeter.testelement.ThreadListener

public class AccessLogSampler
extends HTTPSampler
implements org.apache.jmeter.testbeans.TestBean, org.apache.jmeter.testelement.ThreadListener

Description:

AccessLogSampler is responsible for a couple of things:

• creating instances of Generator
• creating instances of Parser
• triggering popup windows
• calling Generator.generateRequest()
• checking to make sure the classes are valid
• making sure a class can be instantiated

The intent of this sampler is it uses the generator and parser to create a HTTPSampler when it is needed. It does not contain logic about how to parse the logs. It also doesn't care how Generator is implemented, as long as it implements the interface. This means a person could simply implement a dummy parser to generate random parameters and the generator consumes the results. This wasn't the original intent of the sampler. I originally wanted to write this sampler, so that I can take production logs to simulate production traffic in a test environment. Doing so is desirable to study odd or unusual behavior. It's also good to compare a new system against an existing system to get near apples-to-apples comparison. I've been asked if benchmarks are really fair comparisons just about every single time, so this helps me accomplish that task.

Some bugs only appear under production traffic, so it is useful to generate traffic using production logs. This way, JMeter can record when problems occur and provide a way to match the server logs.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase

HTTPSamplerBase.SourceType

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_CLASS

Fields inherited from class org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase

ARGUMENTS, AUTH_MANAGER, AUTO_REDIRECTS, BROWSER_COMPATIBLE_MULTIPART, BROWSER_COMPATIBLE_MULTIPART_MODE_DEFAULT, CACHE_MANAGER, CONCURRENT_DWN, CONCURRENT_POOL, CONCURRENT_POOL_SIZE, CONNECT_TIMEOUT, CONTENT_ENCODING, CONTENT_TYPE, COOKIE_MANAGER, DEFAULT_METHOD, DNS_CACHE_MANAGER, DO_MULTIPART_POST, DOMAIN, EMBEDDED_URL_RE, FOLLOW_REDIRECTS, HEADER_MANAGER, IMAGE_PARSER, IMPLEMENTATION, IP_SOURCE, IP_SOURCE_TYPE, MAX_FRAME_DEPTH, MAX_REDIRECTS, MD5, METHOD, MONITOR, NON_HTTP_RESPONSE_CODE, NON_HTTP_RESPONSE_MESSAGE, PATH, PORT, POST_BODY_RAW, POST_BODY_RAW_DEFAULT, PROTOCOL, PROXYHOST, PROXYPASS, PROXYPORT, PROXYUSER, RESPONSE_TIMEOUT, SOURCE_TYPE_DEFAULT, UNSPECIFIED_PORT, UNSPECIFIED_PORT_AS_STRING, URL, URL_UNSPECIFIED_PORT, URL_UNSPECIFIED_PORT_AS_STRING, USE_KEEPALIVE

Fields inherited from interface org.apache.jmeter.protocol.http.util.HTTPConstantsInterface

APPLICATION_X_WWW_FORM_URLENCODED, CACHE_CONTROL, CONNECT, CONNECTION_CLOSE, COPY, DATE, DEFAULT_HTTP_PORT, DEFAULT_HTTP_PORT_STRING, DEFAULT_HTTPS_PORT, DEFAULT_HTTPS_PORT_STRING, DELETE, ENCODING_BROTLI, ENCODING_DEFLATE, ENCODING_GZIP, ETAG, EXPIRES, GET, HEAD, HEADER_AUTHORIZATION, HEADER_CONNECTION, HEADER_CONTENT_DISPOSITION, HEADER_CONTENT_ENCODING, HEADER_CONTENT_LENGTH, HEADER_CONTENT_TYPE, HEADER_COOKIE, HEADER_COOKIE_IN_REQUEST, HEADER_HOST, HEADER_LOCAL_ADDRESS, HEADER_LOCATION, HEADER_SET_COOKIE, HTTP_1_1, IF_MODIFIED_SINCE, IF_NONE_MATCH, KEEP_ALIVE, LAST_MODIFIED, LOCK, MKCALENDAR, MKCOL, MOVE, MULTIPART_FORM_DATA, OPTIONS, PATCH, POST, PROPFIND, PROPPATCH, PROTOCOL_HTTP, PROTOCOL_HTTPS, PUT, REPORT, SC_MOVED_PERMANENTLY, SC_MOVED_TEMPORARILY, SC_SEE_OTHER, SC_TEMPORARY_REDIRECT, SEARCH, TRACE, TRANSFER_ENCODING, UNLOCK, VARY

Fields inherited from interface org.apache.jmeter.testelement.TestElement

COMMENTS, ENABLED, GUI_CLASS, NAME, TEST_CLASS

Constructor Summary

Constructors

Constructor and Description
AccessLogSampler()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone()
java.lang.String	getDomain()
java.lang.String	getFilterClassName()
java.lang.String	getLogFile() Get the path where XML messages are stored. this is the directory where JMeter will randomly select a file.
java.lang.String	getParserClassName() Get the file location of the xml file.
java.lang.String	getPortString()
java.lang.String	getProtocol() Gets the protocol, with default.
protected void	initFilter()
void	instantiateParser() Method will instantiate the log parser based on the class in the text field.
boolean	isImageParsing()
org.apache.jmeter.samplers.SampleResult	sample(org.apache.jmeter.samplers.Entry e) sample(Entry e) simply calls sample().
org.apache.jmeter.samplers.SampleResult	sampleWithParser() sample gets a new HTTPSampler from the generator and calls it's sample() method.
void	setDomain(java.lang.String domain)
void	setFilterClassName(java.lang.String filterClassName)
void	setImageParsing(boolean imageParsing)
void	setLogFile(java.lang.String path) Set the path where XML messages are stored for random selection.
void	setParserClassName(java.lang.String classname) it's kinda obvious, but we state it anyways.
void	setPortString(java.lang.String port)
void	setProtocol(java.lang.String value) Sets the scheme, with default
void	testEnded()
void	testStarted()
void	threadFinished()

Methods inherited from class org.apache.jmeter.protocol.http.sampler.HTTPSampler

interrupt, sample

Methods inherited from class org.apache.jmeter.protocol.http.sampler.HTTPSamplerBase

addArgument, addArgument, addEncodedArgument, addEncodedArgument, addEncodedArgument, addNonEncodedArgument, addTestElement, applies, clearTestElementChildren, downloadPageResources, encodeBackSlashes, encodeSpaces, errorResult, followRedirects, getArguments, getAuthManager, getAutoRedirects, getCacheManager, getConcurrentPool, getConnectTimeout, getContentEncoding, getCookieManager, getDefaultPort, getDNSResolver, getDoBrowserCompatibleMultipart, getDoMultipart, getDoMultipartPost, getEmbeddedUrlRE, getFollowRedirects, getHeaderManager, getHTTPFileCount, getHTTPFiles, getImplementation, getIpSource, getIpSourceType, getMethod, getMonitor, getPath, getPort, getPortIfSpecified, getPostBodyRaw, getProxyHost, getProxyPass, getProxyPortInt, getProxyUser, getQueryString, getQueryString, getResponseTimeout, getSendFileAsPostBody, getSendParameterValuesAsPostBody, getSourceTypeList, getUrl, getUseKeepAlive, getUseMultipart, getUseMultipartForPost, getValidMethodsAsArray, hasArguments, isConcurrentDwn, isImageParser, isMonitor, isProtocolDefaultPort, isSecure, isSecure, isSuccessCode, parseArguments, parseArguments, readResponse, replace, resultProcessing, sample, setArguments, setAuthManager, setAutoRedirects, setCacheManager, setConcurrentDwn, setConcurrentPool, setConnectTimeout, setContentEncoding, setCookieManager, setDNSResolver, setDoBrowserCompatibleMultipart, setDoMultipart, setDoMultipartPost, setEmbeddedUrlRE, setFollowRedirects, setHeaderManager, setHTTPFiles, setImageParser, setImplementation, setIpSource, setIpSourceType, setMD5, setMethod, setMonitor, setMonitor, setPath, setPath, setPort, setPostBodyRaw, setResponseTimeout, setUseKeepAlive, testEnded, testIterationStart, testStarted, threadStarted, toString, useMD5

Methods inherited from class org.apache.jmeter.testelement.AbstractTestElement

addPropertiesValues, addProperty, addProperty, canRemove, clear, clearTemporary, emptyTemporary, equals, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getSearchableTokens, getThreadContext, getThreadName, hashCode, isEnabled, isRunningVersion, isTemporary, logProperties, mergeIn, propertyIterator, recoverRunningVersion, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse, traverseCollection, traverseMap, traverseProperty

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.jmeter.testelement.ThreadListener

threadStarted

Methods inherited from interface org.apache.jmeter.testelement.TestElement

canRemove, clear, getComment, getName, getProperty, getPropertyAsBoolean, getPropertyAsBoolean, getPropertyAsDouble, getPropertyAsFloat, getPropertyAsInt, getPropertyAsInt, getPropertyAsLong, getPropertyAsLong, getPropertyAsString, getPropertyAsString, getThreadContext, getThreadName, isEnabled, isRunningVersion, isTemporary, propertyIterator, recoverRunningVersion, removed, removeProperty, setComment, setEnabled, setName, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setProperty, setRunningVersion, setTemporary, setThreadContext, setThreadName, traverse

Field Detail

DEFAULT_CLASS

public static final java.lang.String DEFAULT_CLASS

See Also:

Constant Field Values

Constructor Detail

AccessLogSampler

public AccessLogSampler()

Method Detail

setLogFile

public void setLogFile(java.lang.String path)

Set the path where XML messages are stored for random selection.

Parameters:

path - path where to store XML messages

getLogFile

public java.lang.String getLogFile()

Get the path where XML messages are stored. this is the directory where JMeter will randomly select a file.

Returns:

path where XML messages are stored

setParserClassName

public void setParserClassName(java.lang.String classname)

it's kinda obvious, but we state it anyways. Set the xml file with a string path.

Parameters:

classname - - parser class name

getParserClassName

public java.lang.String getParserClassName()

Get the file location of the xml file.

Returns:

String file path.

sampleWithParser

public org.apache.jmeter.samplers.SampleResult sampleWithParser()

sample gets a new HTTPSampler from the generator and calls it's sample() method.

Returns:

newly generated and called sample

sample

public org.apache.jmeter.samplers.SampleResult sample(org.apache.jmeter.samplers.Entry e)

sample(Entry e) simply calls sample().

Specified by:

sample in interface org.apache.jmeter.samplers.Sampler

Overrides:

sample in class HTTPSamplerBase

Parameters:

e - - ignored

Returns:

the new sample

instantiateParser

public void instantiateParser()

Method will instantiate the log parser based on the class in the text field. This was done to make it easier for people to plugin their own log parser and use different log parser.

getFilterClassName

public java.lang.String getFilterClassName()

Returns:

Returns the filterClassName.

setFilterClassName

public void setFilterClassName(java.lang.String filterClassName)

Parameters:

filterClassName - The filterClassName to set.

getDomain

public java.lang.String getDomain()

Overrides:

getDomain in class HTTPSamplerBase

Returns:

Returns the domain.

setDomain

public void setDomain(java.lang.String domain)

Overrides:

setDomain in class HTTPSamplerBase

Parameters:

domain - The domain to set.

isImageParsing

public boolean isImageParsing()

Returns:

Returns the imageParsing.

setImageParsing

public void setImageParsing(boolean imageParsing)

Parameters:

imageParsing - The imageParsing to set.

getPortString

public java.lang.String getPortString()

Returns:

Returns the port.

setPortString

public void setPortString(java.lang.String port)

Parameters:

port - The port to set.

setProtocol

public void setProtocol(java.lang.String value)

Sets the scheme, with default

Overrides:

setProtocol in class HTTPSamplerBase

Parameters:

value - the protocol

getProtocol

public java.lang.String getProtocol()

Gets the protocol, with default.

Overrides:

getProtocol in class HTTPSamplerBase

Returns:

the protocol

initFilter

protected void initFilter()

clone

public java.lang.Object clone()

Specified by:

clone in interface org.apache.jmeter.testelement.TestElement

Overrides:

clone in class org.apache.jmeter.testelement.AbstractTestElement

testEnded

public void testEnded()

Specified by:

testEnded in interface org.apache.jmeter.testelement.TestStateListener

Overrides:

testEnded in class HTTPSamplerBase

testStarted

public void testStarted()

Specified by:

testStarted in interface org.apache.jmeter.testelement.TestStateListener

Overrides:

testStarted in class HTTPSamplerBase

threadFinished

public void threadFinished()

Specified by:

threadFinished in interface org.apache.jmeter.testelement.ThreadListener

Overrides:

threadFinished in class HTTPSamplerBase