{"id":20826652,"url":"https://github.com/includeos/cortisol","last_synced_at":"2025-08-24T13:35:18.177Z","repository":{"id":82454782,"uuid":"110228385","full_name":"includeos/cortisol","owner":"includeos","description":"Cortisol is a tool to run arbitrary performance benchmarks and log data to a google sheet","archived":false,"fork":false,"pushed_at":"2017-11-10T09:39:47.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-18T17:49:22.088Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/includeos.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":"2017-11-10T09:26:04.000Z","updated_at":"2017-11-10T09:28:02.000Z","dependencies_parsed_at":"2023-06-15T18:30:25.303Z","dependency_job_id":null,"html_url":"https://github.com/includeos/cortisol","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/includeos%2Fcortisol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeos%2Fcortisol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeos%2Fcortisol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/includeos%2Fcortisol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/includeos","download_url":"https://codeload.github.com/includeos/cortisol/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243173870,"owners_count":20248189,"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-11-17T23:09:41.573Z","updated_at":"2025-03-12T07:23:30.172Z","avatar_url":"https://github.com/includeos.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cortisol\nCortisol is a tool to run arbitrary performance benchmarks and log data to a google sheet\n\nIncludeOS uses this internally to track performance over time. Tests can be written in any language.\n\nCortisol uses [gspread] to log data to Google Sheets.\n\n\n## Tests\n\nThe test is given a parameter, typically test host to run against. The first line of output is the primary metric delivered by the test. Any following output will be added to the sheet as unprocessed text.\n\n\n## Authentication and authorization\n\nWe use a Google API Service Account to auth/authz against the Google Sheet API. Each service account has a client_email which you'll find in the JSON file describing the service account.  Share your sheet with this email. It'll look something like this: cortisol@random-string-238237.iam.gserviceaccount.com\n\n\nHow to set up:\n * Set up the Service Account\n * Place the JSON file in the directory, naming it cortisol-service-acct.json\n * Create a sheet\n * Make sure the cell A1 contains the magic string ('This sheet is machine generated') so cortisol will allow itself to write to the sheet\n * Place tests in the tests/ folder\n * Set up tests.json and enter your tests and your targets\n * Do a test run, fix any errors\n * place cortisol in a cron job\n\n\n\n[gspread]: https://github.com/burnash/gspread","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincludeos%2Fcortisol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fincludeos%2Fcortisol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincludeos%2Fcortisol/lists"}