{"id":13802212,"url":"https://github.com/RetailMeNotSandbox/groundhar-day","last_synced_at":"2025-05-13T12:32:36.231Z","repository":{"id":73816505,"uuid":"81240435","full_name":"RetailMeNotSandbox/groundhar-day","owner":"RetailMeNotSandbox","description":"A platform for rapid and reproducible performance experiments","archived":false,"fork":false,"pushed_at":"2017-08-06T17:32:44.000Z","size":70,"stargazers_count":29,"open_issues_count":9,"forks_count":3,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-04-14T22:48:27.855Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RetailMeNotSandbox.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}},"created_at":"2017-02-07T18:31:53.000Z","updated_at":"2021-08-19T07:28:21.000Z","dependencies_parsed_at":"2024-01-13T10:42:03.837Z","dependency_job_id":"0cb008fb-0990-42a4-b541-d994551ee1c5","html_url":"https://github.com/RetailMeNotSandbox/groundhar-day","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RetailMeNotSandbox%2Fgroundhar-day","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RetailMeNotSandbox%2Fgroundhar-day/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RetailMeNotSandbox%2Fgroundhar-day/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RetailMeNotSandbox%2Fgroundhar-day/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RetailMeNotSandbox","download_url":"https://codeload.github.com/RetailMeNotSandbox/groundhar-day/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225218004,"owners_count":17439712,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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-08-04T00:01:39.161Z","updated_at":"2024-11-18T17:31:10.204Z","avatar_url":"https://github.com/RetailMeNotSandbox.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GroundHAR Day\n\nGroundHAR Day is a tool for doing rapid, reproducible performance experiments.\n\nGiven an HTTP Archive - or [HAR][] - GroundHAR Day simulates the observed\nnetwork environment inside a VirtualBox VM. This makes it possible to replay the\ncaptured page load under different network conditions. More interestingly, the\nHAR content can be edited directly to quickly and rigorously evaluate different\noptimization ideas.\n\n## Quick start\n\n### Prerequisites\n\n* [VirtualBox][]\n* [Vagrant][]\n\n1. Provision the VM\n\n  ```sh\n  vagrant up\n  ```\n\n2. Start the GroundHAR Day server\n\n  ```sh\n  vagrant ssh\n  # then, from the Vagrant ssh session:\n  cd /opt/groundhar-day/src\n  sudo su\n  ../bin/groundhar-day\n  ```\n\n3. Upload a HAR to replay\n\n  ```sh\n  curl -H \"Content-Type: application/json\" --data-binary @./examples/lawnsea.com.har -X PUT http://localhost:9000/har\n  ```\n\n4. Open [http://localhost:9222](http://localhost:9222) in your browser and click on \"about:blank\"\n5. Type `http://lawnsea.com` into the headless browser's URL bar\n6. Reset the simulation for another replay\n\n  ```sh\n  curl http://localhost:9000/reset\n  ```\n\n## Documentation\n\n### VM\n\nThe VirtualBox VM is configured via environment variables in the shell where\n`vagrant up` is run.\n\n#### `GROUNDHAR_CPUS`\n\nThe number of virtual CPUs the VM should have. Defaults to 4.\n\n#### `GROUNDHAR_DEVTOOLS_PORT`\n\nThe port on the host where the Chrome DevTools is exposed. Defaults to 9222.\n\n#### `GROUNDHAR_MEMORY`\n\nThe amount of memory in megabytes to reserve for the VM. Defaults to 2048.\n\n#### `GROUNDHAR_NETWORK_IP`\n\nThe IP address of the VM on the `groundhar-day` [VirtualBox internal network][].\nDefaults to 192.168.42.1.\n\n#### `GROUNDHAR_SERVER_PORT`\n\nThe port on the host where the GroundHAR Day server is exposed. Defaults to\n9000.\n\n[HAR]: http://www.softwareishard.com/blog/har-12-spec/\n[Vagrant]: https://www.vagrantup.com/downloads.html\n[VirtualBox]: https://www.virtualbox.org/wiki/Downloads\n[VirtualBox internal network]: https://www.virtualbox.org/manual/ch06.html#network_internal\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRetailMeNotSandbox%2Fgroundhar-day","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FRetailMeNotSandbox%2Fgroundhar-day","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FRetailMeNotSandbox%2Fgroundhar-day/lists"}