Home

Awesome

Client java

DISCLAIMER: We use Google Analytics for sending anonymous usage information such as agent's and client's names, and their versions after a successful launch start. This information might help us to improve both ReportPortal backend and client sides. It is used by the ReportPortal team only and is not supposed for sharing with 3rd parties.

Maven Central CI Build codecov Join Slack chat! stackoverflow Build with Love License

The latest version: 5.2.18. Please use Maven Central link above to get the client.

JVM-based clients configuration

How to provide parameters

There are several ways to load parameters. Be aware that higher sources override lower ones. For example, properties from file can be overridden by JVM variables.

OrderSource
1JVM arguments
2Environment variables
3Properties file

JVM arguments

ReportPortal client does not necessarily need properties file to be configured. One of the option is to use JVM arguments which have the highest priority among configuration ways. To use them you need to specify them in command line after Java executable using -D flag. Example:

$ java -Drp.endpoint=https://rp.epam.com/ -jar my-tests.jar

Environment variables

In case of bypassing parameters through environment variables they should be specified in UPPERCASE separated by underscores (_). E.G.:

Property file

The most common way to start using an agent is to copy your configuration from UI of ReportPortal at User Profile section or configure property file reportportal.properties in the following format:

rp.endpoint=https://rp.epam.com/
rp.api.key=8967de3b-fec7-47bb-9dbc-2aa4ceab8b1e
rp.launch=launch-name
rp.project=project-name
## OPTIONAL PARAMETERS
rp.reporting.callback=true
rp.enable=true
rp.description=My awesome launch
rp.attributes=key:value;value
rp.rerun=true
rp.rerun.of=ae586912-841c-48de-9391-50720c35dd5a
rp.convertimage=true
rp.mode=DEFAULT
rp.skipped.issue=true
rp.batch.size.logs=20
rp.keystore.resource=<PATH_TO_YOUR_KEYSTORE>
rp.keystore.password=<PASSWORD_OF_YOUR_KEYSTORE>

For detailed parameter description see below sections.

Default properties file should have reportportal.properties name. It can be situated in the class path (in the project directory) and if client can’t find the file it logs a warning. But you can also use your custom property file specifying file's path in rp.properties.path system property or RP_PROPERTIES_PATH environment variable. The first option has priority, so if you specify the path in both system properties and environment variables then system property value will be used.

Parameters

Common parameters

Property nameTypeDescriptionRequired
rp.endpointStringURL of web service, where requests should be sendYes
rp.api.keyStringApi token of userYes
rp.launchStringA unique name of Launch (Run). Based on that name a history of runs will be created for particular nameYes
rp.projectStringProject name to identify scopeYes
rp.launch.uuidStringA unique Launch UUID to which the whole test execution will be uploaded. No new launch will be created if the property specified.No
rp.launch.uuid.printBooleanEnables printing Launch UUID on test run start. Default False.No
rp.launch.uuid.print.outputEnumLaunch UUID print output. Default stdout. Possible values: stderr, stdout.No
rp.enableBooleanEnable/Disable logging to ReportPortal: rp.enable=true - enable log to RP server. Any other value means 'false': rp.enable=false - disable log to RP server. If parameter is absent in properties file then automation project results will be posted on RP.No
rp.descriptionStringLaunch descriptionNo
rp.attributesStringSet of attributes for specifying additional meta information for current launch. Format: key:value;value;build:12345-6. Attributes should be separated by “;”, keys and values - “:”.No
rp.reporting.asyncBooleanEnables asynchronous reporting. Available values - true (by default) or false. Supported only in 5+ version.No
rp.reporting.callbackBooleanEnables callback reporting. Available values - true or false(by default). Supported only in 5+ vesionNo
rp.rerunBooleanEnables rerun mode. Available values - true or false(by default). Supported only in 5+ versionNo
rp.rerun.ofStringSpecifies UUID of launch that has to be rerun.No
rp.convertimageBooleanColored log images can be converted to grayscale for reducing image size. Values: ‘true’ – will be converted. Any other value means ‘false’.No
rp.modeEnumReportPortal provides possibility to specify visibility of executing launch. Currently two modes are supported: DEFAULT - all users from project can see this launch; DEBUG - all users except of Customer role can see this launch (in debug sub tab). Note: for all java based clients (TestNG, Junit) mode will be set automatically to "DEFAULT" if it is not specified.No
rp.skipped.issueBooleanReportPortal provides feature to mark skipped tests as not 'To Investigate' items on WS side. Parameter could be equal boolean values: <li>true - skipped tests considered as issues and will be marked as 'To Investigate' on ReportPortal. <li>false - skipped tests will not be marked as 'To Investigate' on application.No
rp.batch.size.logsIntegerPut logs into batches of specified size in order to rise up performance and reduce number of requests to server. Default = 10No
rp.batch.payload.limitLongLimit batches by payload size to avoid request rejection due to server limitations.No
rp.rx.buffer.sizeIntegerInternal queue size for log processing, increase this value along with log batch size if you see not all your logs passing to server. Default = 128No
rp.keystore.resourceStringPut your JKS file into resources and specify path to itNo
rp.keystore.passwordStringAccess password for JKS (certificate storage) package, mentioned above<br/>No

Launch name sets once before first execution, because in common launch parts are fixed for a long time. By keeping the same launch name we will know a fixed list of suites behind it. That will allow us to have a history trend. On Report Portal UI different launch iterations will be saved with postfix "#number", like "Test Launch #1", "Test Launch #2" etc.

If mandatory parameters are missed client will log a warning and will be initialized in inactive state.

Multi-process join parameters

Property nameTypeDescription
rp.client.joinBooleanDefault: true<br /> Enable / Disable multi-process launch join mode
rp.client.join.modeEnum[FILE, SOCKET], Default: FILE<br/> Which mechanism will be used to join multi-process launches:<br/> <li>FILE - the client will create a locking file<li>SOCKET - the client will open a socket
rp.client.join.portIntegerDefault: 25464<br>If client join mode set to SOCKET, this property controls port number of the socket
rp.client.join.timeout.valueIntegerDefault: 1.8M milliseconds (30 minutes)<br> Timeout value for secondary launches. Primary launch will wait that amount of time after test execution for secondary launch finish.
rp.client.join.timeout.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class
rp.client.join.file.lock.nameStringDefault: reportportal.lock<br>A name of a main lock file, can be an absolute path. A client which managed to obtain that lock count itself as a primary launch process. It rewrites synchronization file with its launch ID.
rp.client.join.file.sync.nameStringDefault: reportportal.sync<br>A name of a launch ID synchronization file, can be an absolute path. Each client waits for a lock on that file to get a launch ID (first line) and write its own ID to the end of the file.
rp.client.join.lock.timeout.valueIntegerDefault: 1 minute<br> Files lock / connection timeout for launches.
rp.client.join.lock.timeout.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class

HTTP parameters

Property nameTypeDescription
rp.http.proxyStringA URL of a HTTP proxy to connect to the endpoint.
rp.http.proxy.usernameStringA username for used proxy, works only if Proxy URL is set.
rp.http.proxy.passwordStringPassword for proxy, works only if Proxy URL and Proxy Username are set.
rp.http.loggingBooleanDefault: false<br> Enable / Disable HTTP logging.
rp.http.timeout.call.valueIntegerDefault: Infinitive<br> Timeout value for the entire call: resolving DNS, connecting, writing the request body, server processing, and reading the response body. If the call requires redirects or retries all must complete within one timeout period.
rp.http.timeout.call.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class
rp.http.timeout.connect.valueIntegerDefault: 10 seconds<br> Connect timeout for new HTTP connections.
rp.http.timeout.connect.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class
rp.http.timeout.read.valueIntegerDefault: 10 seconds<br> Data read timeout for new HTTP connections.
rp.http.timeout.read.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class
rp.http.timeout.write.valueIntegerDefault: 10 seconds<br> Data write timeout for new HTTP connections.
rp.http.timeout.write.unitEnumDefault: MILLISECONDS<br> Timeout value time unit. Should be one of values from java.util.concurrent.TimeUnit class

Truncation parameters

Property nameTypeDescription
rp.truncation.fieldBooleanDefault: true<br> Enable / disable certain field truncation to avoid API failures.
rp.truncation.replacementStringDefault: ...<br> Replacement pattern for truncated fields
rp.truncation.item.name.limitIntegerDefault: 1024<br> Maximum item names length before truncation.
rp.truncation.attribute.limitIntegerDefault: 128<br> Maximum attribute key and value limit (counts separately)

Proxy configuration

ReportPortal supports 2 options for setting Proxy configuration:

JVM arguments

ReportPortal uses OkHttp as HTTP client, which can pick up JVM proxy settings. This is the most flexible and preferable way to configure proxies, since it supports different proxy types. You can find out more about JVM proxies on Java networking and proxies page.

Properties file

If you need to set up just a simple HTTP proxy you can use reportportal.properties file. rp.http.proxy parameter accepts HTTP proxy URL. This parameter can override JVM proxy arguments, so watch your back.