| Name | slurm-job-resource-monitor JSON |
| Version |
2.7.1
JSON |
| download |
| home_page | |
| Summary | Command line tool for monitoring slurm jobs on a linux system. |
| upload_time | 2024-01-23 17:49:37 |
| maintainer | |
| docs_url | None |
| author | |
| requires_python | >=3.9 |
| license | |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
pandas
paramiko
rich
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Slurm Job Resource Monitor
A python command line tool to monitor the resources of your slurm jobs in form of a regularly updated table.

## Installation
Install via pip:
```bash
pip install slurm-job-resource-monitor
```
## Usage
On a slurm managed cluster, run the following command to monitor your jobs:
```bash
slurm_job_monitor
```
To get all the possible options run:
```bash
slurm_job_monitor --help
```
The preferred way to use the tool is with the group-by-cmd option to not spam the table when running multi-cpu jobs:
```bash
slurm_job_monitor --group-by-cmd "sum"
```
## Assumptions / Preliminary
The tool assumes that:
- you are running on a slurm managed cluster.
- The tool assumes that you have a slurm account.
- You can ssh in all allocated notes.
- For ssh within the cluster no password is needed (only ssh key).
- You need nvidia-smi to display GPU info of nodes (optional).
- You can run "ps auxfww" to display CPU info of nodes.
## Some Further Info
Only processes are displayed that have a CPU load > 0.0 $ as shown by "ps auxfww". This is to avoid
the spamming of the table with processes that are not doing anything.
The table is grouped by jobs. So if one job runs on multiple GPUs and nodes they will all be displayed
in the same "section" of row. Sections are separated by a horizontal line.
There is a minimal width that the terminal needs to have to display the table correctly. The only column that
allows wrapping is the "Command" column.
Raw data
{
"_id": null,
"home_page": "",
"name": "slurm-job-resource-monitor",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": "",
"keywords": "",
"author": "",
"author_email": "Tobias Schanz <tobias.machnitzki@hereon.de>",
"download_url": "https://files.pythonhosted.org/packages/6d/43/e6f73dfc5d7ab9242b917a70b2b8c612c7115935e17aff266e8055049c73/slurm-job-resource-monitor-2.7.1.tar.gz",
"platform": null,
"description": "# Slurm Job Resource Monitor\r\n\r\nA python command line tool to monitor the resources of your slurm jobs in form of a regularly updated table.\r\n\r\n\r\n\r\n## Installation\r\n\r\nInstall via pip:\r\n\r\n```bash\r\npip install slurm-job-resource-monitor\r\n```\r\n\r\n## Usage\r\n\r\nOn a slurm managed cluster, run the following command to monitor your jobs:\r\n\r\n```bash\r\nslurm_job_monitor\r\n```\r\n\r\nTo get all the possible options run:\r\n\r\n```bash\r\nslurm_job_monitor --help\r\n```\r\n\r\nThe preferred way to use the tool is with the group-by-cmd option to not spam the table when running multi-cpu jobs:\r\n\r\n```bash\r\nslurm_job_monitor --group-by-cmd \"sum\"\r\n```\r\n\r\n## Assumptions / Preliminary\r\n\r\nThe tool assumes that:\r\n\r\n- you are running on a slurm managed cluster.\r\n- The tool assumes that you have a slurm account.\r\n- You can ssh in all allocated notes.\r\n- For ssh within the cluster no password is needed (only ssh key).\r\n- You need nvidia-smi to display GPU info of nodes (optional).\r\n- You can run \"ps auxfww\" to display CPU info of nodes.\r\n\r\n## Some Further Info\r\n\r\nOnly processes are displayed that have a CPU load > 0.0 $ as shown by \"ps auxfww\". This is to avoid\r\nthe spamming of the table with processes that are not doing anything.\r\n\r\nThe table is grouped by jobs. So if one job runs on multiple GPUs and nodes they will all be displayed\r\nin the same \"section\" of row. Sections are separated by a horizontal line.\r\n\r\nThere is a minimal width that the terminal needs to have to display the table correctly. The only column that\r\nallows wrapping is the \"Command\" column.\r\n",
"bugtrack_url": null,
"license": "",
"summary": "Command line tool for monitoring slurm jobs on a linux system.",
"version": "2.7.1",
"project_urls": {
"Bug Tracker": "https://github.com/tmachnitzki/slurm_job_resource_monitor/issues",
"Homepage": "https://github.com/tmachnitzki/slurm_job_resource_monitor"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "50d3da8946e2de5a728ff07ae03cd920700bfb509d61a4c5fa7ce6b8b3518536",
"md5": "3d928d21d16e9d85a657e9e9656c32ae",
"sha256": "e909f5fac314b4698751c283597596a223f72c46c1da8e5bb73354fc735eb4e5"
},
"downloads": -1,
"filename": "slurm_job_resource_monitor-2.7.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3d928d21d16e9d85a657e9e9656c32ae",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 9735,
"upload_time": "2024-01-23T17:49:34",
"upload_time_iso_8601": "2024-01-23T17:49:34.709435Z",
"url": "https://files.pythonhosted.org/packages/50/d3/da8946e2de5a728ff07ae03cd920700bfb509d61a4c5fa7ce6b8b3518536/slurm_job_resource_monitor-2.7.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6d43e6f73dfc5d7ab9242b917a70b2b8c612c7115935e17aff266e8055049c73",
"md5": "e2e94658a1a09aa39db0438c03eef9d8",
"sha256": "ff0dd484d08f83ff96507a8fc2a3ce56fa88ce8a7e9754507f1acf11c8b9b287"
},
"downloads": -1,
"filename": "slurm-job-resource-monitor-2.7.1.tar.gz",
"has_sig": false,
"md5_digest": "e2e94658a1a09aa39db0438c03eef9d8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 114172,
"upload_time": "2024-01-23T17:49:37",
"upload_time_iso_8601": "2024-01-23T17:49:37.109870Z",
"url": "https://files.pythonhosted.org/packages/6d/43/e6f73dfc5d7ab9242b917a70b2b8c612c7115935e17aff266e8055049c73/slurm-job-resource-monitor-2.7.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-23 17:49:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tmachnitzki",
"github_project": "slurm_job_resource_monitor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "pandas",
"specs": []
},
{
"name": "paramiko",
"specs": []
},
{
"name": "rich",
"specs": []
}
],
"lcname": "slurm-job-resource-monitor"
}