{"id":49079745,"url":"https://github.com/swiss-ai/alps-job-visualisation-tool","last_synced_at":"2026-04-20T12:19:19.776Z","repository":{"id":291126490,"uuid":"975400287","full_name":"swiss-ai/alps-job-visualisation-tool","owner":"swiss-ai","description":"A tool designed to record and visualize hardware metrics of nodes used in a SLURM job. It provides various graphs to help detect anomalies and identify potential issues in node performance.","archived":false,"fork":false,"pushed_at":"2025-05-24T16:49:20.000Z","size":140,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-05-24T17:34:26.844Z","etag":null,"topics":["hardware-information","hpc-clusters","performance-monitoring"],"latest_commit_sha":null,"homepage":"https://www.cscs.ch/computers/alps","language":"Python","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/swiss-ai.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,"zenodo":null}},"created_at":"2025-04-30T08:52:45.000Z","updated_at":"2025-05-24T16:49:24.000Z","dependencies_parsed_at":"2025-05-24T17:34:28.026Z","dependency_job_id":null,"html_url":"https://github.com/swiss-ai/alps-job-visualisation-tool","commit_stats":null,"previous_names":["swiss-ai/alps-job-reporting-tool","swiss-ai/alps-job-visualisation-tool"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/swiss-ai/alps-job-visualisation-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiss-ai%2Falps-job-visualisation-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiss-ai%2Falps-job-visualisation-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiss-ai%2Falps-job-visualisation-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiss-ai%2Falps-job-visualisation-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/swiss-ai","download_url":"https://codeload.github.com/swiss-ai/alps-job-visualisation-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/swiss-ai%2Falps-job-visualisation-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32046746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T11:35:06.609Z","status":"ssl_error","status_checked_at":"2026-04-20T11:34:48.899Z","response_time":94,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["hardware-information","hpc-clusters","performance-monitoring"],"created_at":"2026-04-20T12:19:18.767Z","updated_at":"2026-04-20T12:19:19.764Z","avatar_url":"https://github.com/swiss-ai.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Alps Job Visualization Tool\n\n## Overview\n\nThe Alps Job Visualization Tool is designed to record and visualize hardware metrics of nodes used in a SLURM job.\nIt provides various graphs to help detect anomalies and identify potential issues in node performance.\n\n## Features\n\n- Collects performance data from nodes in a running SLURM job.\n- Processes and organizes the data for easy analysis.\n- Generates visualizations to highlight anomalies and performance trends.\n\n## Setup\n\nFollow these steps to set up the tool:\n\n1. Clone the repository:\n   ```bash\n   git clone https://github.com/swiss-ai/alps-job-reporting-tool\n   cd alps-job-reporting-tool\n   ```\n\n2. Create a Python environment using the `requirements.txt` file:\n    - with [conda](https://docs.conda.io/):\n        ```\n        conda create --name myenv --file requirements.txt\n        conda activate myenv\n        ```\n    - with [pip](https://pypi.org/project/pip/):\n        ```\n        python -m venv myenv\n        source myenv/bin/activate  # On Windows, use myenv\\Scripts\\activate\n        pip install -r requirements.txt\n        ```\n\n\n## Usage\n\n### Collecting Data and Creating a Report\nTo collect and process data for a given SLURM job, follow these steps:\n\n1. Ensure the SLURM job is running.\n\n2. Run the following command from the main directory:\n\n   ```sh\n   ./metrics_downloader.sh \u003cjob_id\u003e [duration]\n   ```\n\n    - `\u003cjob_id\u003e`: The SLURM job ID for which data will be collected.\n    - `[duration]` (optional): The logging period in seconds for node data collection. The default is 300 seconds (5 minutes).\n3. The collected data and an HTML report will be saved in the `outputs/\u003cjob_id\u003e_\u003cdate\u003e` folder.\n\n### Comments\n\nBoth CSV and Parquet files are saved, allowing users to perform additional analysis and visualize the data using their preferred tools.\n\nIf there are any interesting metrics or visualization that you think could be useful, let us know such that we can add them.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiss-ai%2Falps-job-visualisation-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fswiss-ai%2Falps-job-visualisation-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fswiss-ai%2Falps-job-visualisation-tool/lists"}