Webinject manual

Output directory where all logfiles will go to. Defaults to current directory. Can be 'yes' or 'onfail'. Will log the http request and response to a http. Provides credentials for webserver authentications. The format is:. Default is off. Create gnuplot graphs when enabled. Defaults to 'lines'.

Defines the path to your gnuplot binary. Path to a directory from which all relative test case postbody directives. If not supplied, the directory containing the current test case file is. Add additional cookies to the cookie jar if specified. Nagios plugin compatibility. MRTG plugin compatibility. External plugin. To use it, add something like that in the config file:. Getopt::Long::Configure ' bundling ' ;. When added to a test case, this adds a cookie to the cookie jar prior to the test case request being sent i.

This is useful for cases where a cookie is set outside of a Set-Cookie directive in the response header. As well, multiple cookies can be defined by separating with a ' ' character as with the addheader parameter. The comma-delimited list of fields are as follows. Notifications System Configuration Upgrade Instructions 8. User Management Visualizations Template Introduction.

Installation Troubleshooting NCPA NDOUtils 4. NRDP NRDS 9. NRPE NSCA NSTI 4. Support Options Table of Contents 1 - Software Architecture 1.

If this setting is not used, the default User-Agent string sent is "WebInject". A User-Agent string is how each request identifies itself to the web server. HTTP provides a simple challenge-response authentication mechanism which may be used by a server to challenge a client request and by a client to provide authentication information.

This works in the same way as the 'baseurl' example above. Also, output logging is suppressed when running in a Plugin Mode reporttype. Anything contained within comment tags will not be processed. I know it is braindead that we don't allow regular XML-style comments here.. If the response in any test case takes longer than this threshold, the HTTP request times out and the case is marked as failed. The default timeout if you do not specify one is seconds.

The available values you can set this to are: nagios - Output of WebInject in console mode will be compatible for use as a plugin for the Nagios monitoring program. You may write a Perl module that will be called after WebInject is finished running. Your module may access any of WebInject's global variables. This can be used to integrate with other external programs or to do any type of data processing at the end of your test run.

The value [given in seconds] will be compared to the global time elapsed to run all the tests. If the tests have all been successful, but have taken more time than the 'globaltimeout' value, a warning message is sent back to Nagios. This is only necessary to set if would like to have WebInject use gnuplot to create response time graphs and you have gnuplot installed somewhere on your system that is not on your PATH.

A PNG image plot. This defaults to "get" if the parameter is omitted. This string will be evaluated by the Perl interpreter using "eval". Verification fails if this string does not exist in the HTTP response. This is matched as a Perl regular expression, so you can do some complex verification patterns if you are familar with using regex matching. This works the same as 'verifypositive'.

Verification fails if this string exists in the HTTP response. This works the same as 'verifynegative'. Verification fails if this string does not exist in the HTTP response of the next test case that is executed. Verification fails if this string exists in the HTTP response of the next test case that is executed. Logging disabled if this parameter is omitted or not equal to "yes". This is mostly used for passing Session ID's, but can be applied to any case where you need to pass a dynamically generated value.

It takes the arguments in the format "leftboundary rightboundary", and an optional third argument "leftboundary rightboundary escape" when you want to force escaping of all non-alphanumeric characters.

Note: You may need to prepend a backslash before certain reserved characters when parsing sorry that is rather vague. This used to add spacing between cases in order to throttle the rate it sends requests.

Therefore, the GUI will not be responsive during the time it is "sleeping". This may be useful to give a bit more information on what a failed test means, like "couldn't connect to the application" or "couldn't access the login page". Posted by: rspielman on Tue, Mar 16, at AM. This article has been viewed times. Filed Under: Monitoring Configuration. Related Articles. Subscribe to knowledge base Get notified when new articles are added to the knowledge base.

Usage: webinject. This is used to specify an alternate configuration file besides the default config. To specify a config file in a different directory, you must use the relative path to it. Note: relative path from the webinject directory. This is used to specify the location for writing output files http.

If a directory name is supplied use either an absolute or relative path and make sure to add the trailing slash , all output files are written to this directory. If the trailing slash is ommitted, it is assumed to a prefix and this will be prepended to the output files. You may also use a combination of a directory and prefix. Note: You must still have write access to the directory where WebInject resides, even when writing output elsewhere.

Passing a Test Case Filename When you launch WebInject in console mode, you can optionally supply an argument for a testcase file to run. As an example, you have your test case file and config file are located in a subdirectory named 'myfiles': perl webinject. Status Bar The status bar shows visual progress of the current iteration of the test case file being processed. Status Light The status light is the small box next to the status bar.

Disable Monitor This checkbox is used to completely disable the Monitor Window and all of it's underlying real-time monitoring functionality including graph generation. Response Timer Output Selecting this option before you run your test cases will display the server response time for each case as it runs.

The x-axis represents response time in seconds The y-axis represents the time of day. The scale of the axes adjusts automatically to fit the data being displayed. Runtime Counts This shows counter values for the current execution. Parse a string from the HTTP response for use in subsequent requests. This is mostly used for passing Session ID's, but can be applied to any case where you need to pass a dynamically generated value.

Note: You may need to prepend a backslash before certain reserved characters when parsing sorry that is rather vague. For more information on module installation, please visit the detailed CPAN module installation guide. Timeout starts again for every testcase. Default is 'Webinject'. Default is 0. Defaults to current directory. Default is off.