> ## Documentation Index
> Fetch the complete documentation index at: https://opensre.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Slurm

> Monitor Slurm workloads with Tracer

Tracer integrates with Slurm, providing detailed observability for batch jobs and array tasks.
It works by running the Tracer agent on each compute node — no modification to job scripts required.

## Why use Tracer in combination with Slurm

Slurm gives job-level scheduling visibility, but not what happens inside the job.
Tracer adds that missing layer:

* Per-process telemetry inside each job allocation
* Job array correlation and node-level performance
* Resource and cost insights across users and queues
* Zero changes to job submission or scripts
* Real-time updates in the Tracer dashboard

## Getting Started

### Prerequisites

* Slurm cluster access with sudo or admin privileges for installation
* Tracer installed on [your operating system](/environments/overview)

### Just run your pipeline, Tracer will automatically attach

If Tracer is already installed on your operating system, you only need to enable the Tracer agent for pipelines that have not been run with Tracer before.<br />
In that case, run the following command:

```bash theme={null}
sudo tracer init --token <your-token>
```

<Info> Go to our [onboarding](https://app.tracer.cloud/dashboard) to get your own personal token</Info>

When running this command, you will be asked to name your pipeline for clear labeling in the dashboard.

## Examples

Run a Slurm pipeline under Tracer:

```bash theme={null}
#!/bin/bash
#SBATCH --job-name=test
#SBATCH --cpus-per-task=8
#SBATCH --time=01:00:00

module load python
python analysis.py
```

Submit this job as usual with:

```bashsbatch theme={null}
my_job.sh
```

or launch the Tracer demo workflow:

```bash theme={null}
sudo tracer demo
```

Once the pipeline starts, open the Tracer dashboard, and you’ll see each Slurm job as a timeline step updating in real time.

<Card href="https://app.tracer.cloud/">
  <img className="block dark:hidden" src="https://mintcdn.com/tracer/lwvLzCSZlgrNXB_D/images/logo/tracer/Tracer%20Full%20Body%20-%20Black.png?fit=max&auto=format&n=lwvLzCSZlgrNXB_D&q=85&s=3ba40411baa608f2cf09ea4372ad16b2" alt="Tracer Logo" style={{ width: '10%', height: 'auto', marginBottom: '1rem' }} width="311" height="84" data-path="images/logo/tracer/Tracer Full Body - Black.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/tracer/lwvLzCSZlgrNXB_D/images/logo/tracer/Tracer%20Full%20Body%20-%20Black.png?fit=max&auto=format&n=lwvLzCSZlgrNXB_D&q=85&s=3ba40411baa608f2cf09ea4372ad16b2" alt="Tracer Logo" style={{ width: '10%', height: 'auto', marginBottom: '1rem' }} width="311" height="84" data-path="images/logo/tracer/Tracer Full Body - Black.png" />

  <div style={{ fontSize: '1.3rem', fontWeight: '700', marginBottom: '1 rem', color: 'inherit' }}>
    Watch your pipeline run in the Tracer dashboard
  </div>

  <div style={{ color: 'inherit' }}>
    View real-time metrics, resource usage, and performance insights for your pipeline runs.
  </div>
</Card>
