{"id":19108185,"url":"https://github.com/perfana/test-events-loadrunner-cloud","last_synced_at":"2026-06-17T12:32:10.091Z","repository":{"id":96613835,"uuid":"309719689","full_name":"perfana/test-events-loadrunner-cloud","owner":"perfana","description":null,"archived":false,"fork":false,"pushed_at":"2024-04-06T12:41:21.000Z","size":154,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-22T10:41:53.462Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/perfana.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-11-03T14:55:39.000Z","updated_at":"2022-01-28T20:30:18.000Z","dependencies_parsed_at":"2025-02-22T10:41:35.134Z","dependency_job_id":"ad3f7e28-fd0b-47df-8b86-c528f192924b","html_url":"https://github.com/perfana/test-events-loadrunner-cloud","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/perfana/test-events-loadrunner-cloud","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perfana%2Ftest-events-loadrunner-cloud","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perfana%2Ftest-events-loadrunner-cloud/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perfana%2Ftest-events-loadrunner-cloud/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perfana%2Ftest-events-loadrunner-cloud/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/perfana","download_url":"https://codeload.github.com/perfana/test-events-loadrunner-cloud/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/perfana%2Ftest-events-loadrunner-cloud/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34449277,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T04:15:23.906Z","updated_at":"2026-06-17T12:32:10.072Z","avatar_url":"https://github.com/perfana.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# test-events-loadrunner-cloud\n\nEvents to start and stop for LoadRunner Cloud tests.\n\nThis event plugin start a LoadRunner Cloud test for the given LoadTest id.\n\n## events\nThe `beforeTest` and `abortTest` event are implemented.\n\nThe `beforeTest` starts the load test and polls the LoadRunner Cloud server to see if\nthe test changes from `INITIALIZING` state to `RUNNING` state. \n\n## messages\nThis is a `readyForStartParticipant`, so only when this event plugin sends a `Go!` message\non the `eventMessageBus` the event scheduler can progress to the `startTest` event. \nWhen the LoadRunner Cloud test reaches the `RUNNING` state, the `Go!` message is sent.\n\n## properties for LoadRunner Cloud:\n* `loadRunnerUser` the user \n* `loadRunnerPassword` the password \n* `loadRunnerTenantId` the tenantId \n* `loadRunnerProjectId` the projectId\n* `loadRunnerLoadTestId` the loadTestId\n* `loadRunnerUseTracingHeader` send tracing header via the run-time-settings (rts) (optional, default false)\n* `pollingPeriodInSeconds` seconds between check if test is in RUNNING state (optional, default 10)\n* `pollingMaxDurationInSeconds` max duration to check if test gets to RUNNING state (optional, default 300)\n* `useProxy` activate proxy, for example to use with [mitmproxy](https://mitmproxy.org/) \n* `proxyPort` port to use for proxy, uses localhost (optional, default 8888) \n\n### notes\n* tenantId: look up in browser url of LoadRunner Cloud: `TENANTID=X`\n* projectId: look up in browser url of LoadRunner Cloud: `projectId=Y`\n* loadTestId: look up in UI for defined test: LOAD TESTS \u003e select test \u003e look at `ID: Z` in Summary\n\n## variables\n\nThe LoadRunner Cloud plugin sends the following variables with a message on the `EventMessageBus`:\n* perfana-lrc-tenantId\n* perfana-lrc-projectId\n* perfana-lrc-runId\n\n## tracing header\n\nWhen `loadRunnerUseTracingHeader` is `true`, the tracing header is sent to the script run-time-settings.\nThe tracing header is the test run id. \nIn the scripts the tracing header can be injected as web header via `web_add_header` and `lr_get_attrib_string`:\n\n    web_add_header(\"perfana-test-run-id\", lr_get_attrib_string(\"perfanaTestRunId\"))\n\n## use with events-*-maven-plugin\n\nYou can use the `test-events-loadrunner-cloud` as a plugin of the `events-*-maven-plugin`\nby putting the `test-events-loadrunner-cloud` jar on the classpath of the plugin.\n\nUse the `dependencies` element inside the `plugin` element as in the XML snippet below.\n\nFor example, with `perfana-test-client` plugin (from [example-pom.xml](src/test/resources/example-pom.xml)):\n\n```xml\n\u003cplugins\u003e\n    \u003cplugin\u003e\n        \u003cgroupId\u003eio.perfana\u003c/groupId\u003e\n        \u003cartifactId\u003eevent-scheduler-maven-plugin\u003c/artifactId\u003e\n        \u003cconfiguration\u003e\n            \u003ceventSchedulerConfig\u003e\n                \u003cdebugEnabled\u003etrue\u003c/debugEnabled\u003e\n                \u003cschedulerEnabled\u003etrue\u003c/schedulerEnabled\u003e\n                \u003cfailOnError\u003etrue\u003c/failOnError\u003e\n                \u003ccontinueOnEventCheckFailure\u003etrue\u003c/continueOnEventCheckFailure\u003e\n                \u003ctestConfig\u003e\n                    \u003csystemUnderTest\u003e${systemUnderTest}\u003c/systemUnderTest\u003e\n                    \u003cversion\u003e${version}\u003c/version\u003e\n                    \u003cworkload\u003e${workload}\u003c/workload\u003e\n                    \u003ctestEnvironment\u003e${testEnvironment}\u003c/testEnvironment\u003e\n                    \u003ctestRunId\u003e${testRunId}\u003c/testRunId\u003e\n                    \u003cbuildResultsUrl\u003e${buildResultsUrl}\u003c/buildResultsUrl\u003e\n                    \u003crampupTimeInSeconds\u003e${rampupTimeInSeconds}\u003c/rampupTimeInSeconds\u003e\n                    \u003cconstantLoadTimeInSeconds\u003e${constantLoadTimeInSeconds}\u003c/constantLoadTimeInSeconds\u003e\n                    \u003cannotations\u003e${annotations}\u003c/annotations\u003e\n                    \u003ctags\u003e${tags}\u003c/tags\u003e\n                \u003c/testConfig\u003e\n                \u003ceventConfigs\u003e\n                    \u003ceventConfig implementation=\"io.perfana.event.loadrunner.LoadRunnerCloudEventConfig\"\u003e\n                        \u003cname\u003eLoadRunnerCloudEvent1\u003c/name\u003e\n                        \u003cloadRunnerUser\u003euser\u003c/loadRunnerUser\u003e\n                        \u003cloadRunnerPassword\u003epassword\u003c/loadRunnerPassword\u003e\n                        \u003cloadRunnerTenantId\u003etenantId\u003c/loadRunnerTenantId\u003e\n                        \u003cloadRunnerProjectId\u003e1\u003c/loadRunnerProjectId\u003e\n                        \u003cloadRunnerLoadTestId\u003e2\u003c/loadRunnerLoadTestId\u003e\n                        \u003cuseProxy\u003etrue\u003c/useProxy\u003e\n                    \u003c/eventConfig\u003e\n                    \u003ceventConfig implementation=\"io.perfana.event.PerfanaEventConfig\"\u003e\n                        \u003cname\u003ePerfanaEvent1\u003c/name\u003e\n                        \u003cperfanaUrl\u003ehttp://localhost:8888\u003c/perfanaUrl\u003e\n                        \u003cassertResultsEnabled\u003efalse\u003c/assertResultsEnabled\u003e\n                        \u003cvariables\u003e\n                            \u003c_var1\u003emy_value\u003c/_var1\u003e\n                        \u003c/variables\u003e\n                    \u003c/eventConfig\u003e\n                \u003c/eventConfigs\u003e\n            \u003c/eventSchedulerConfig\u003e\n        \u003c/configuration\u003e\n        \u003cdependencies\u003e\n            \u003cdependency\u003e\n                \u003cgroupId\u003eio.perfana\u003c/groupId\u003e\n                \u003cartifactId\u003etest-events-loadrunner-cloud\u003c/artifactId\u003e\n                \u003cversion\u003e${test-events-loadrunner-cloud.version}\u003c/version\u003e\n            \u003c/dependency\u003e\n            \u003cdependency\u003e\n                \u003cgroupId\u003eio.perfana\u003c/groupId\u003e\n                \u003cartifactId\u003eperfana-java-client\u003c/artifactId\u003e\n                \u003cversion\u003e${perfana-java-client.version}\u003c/version\u003e\n            \u003c/dependency\u003e\n        \u003c/dependencies\u003e\n    \u003c/plugin\u003e\n\u003c/plugins\u003e\n```\n\nTry this by calling:\n\n    mvn -f src/test/resources/example-pom.xml event-scheduler:test\n\n## Todo\n\n* create lookups for the project and test ids based on names\n\n## References\n\nWorks with the Perfana event-scheduler framework: \n* https://github.com/perfana/event-scheduler\n* https://github.com/perfana/event-Scheduler-maven-plugin\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperfana%2Ftest-events-loadrunner-cloud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fperfana%2Ftest-events-loadrunner-cloud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fperfana%2Ftest-events-loadrunner-cloud/lists"}