ext_sensors.conf(5)

✨ ext_sensors.conf(5) ✨

okay so this is section 5 of the manual, and it's the Slurm Configuration File for the external sensors plugin. Sit down, grab a boba, we're doing this together 🧋

---

🎀 NAME 🎀

ext_sensors.conf — the Slurm configuration file for the external sensors plugin. That's it, that's the name, iconic behavior honestly 💅

---

🌸 DESCRIPTION 🌸

So ext_sensors.conf is an ASCII file that defines the parameters used by Slurm's external sensors plugins. No cap. And here's the thing — this file is always going to be chilling in the same directory as your slurm.conf. They're roommates. They don't get separated. 🫶

Some ground rules, bestie, and these are non-negotiable:

• Parameter names are case insensitive. Type them however your heart desires, the plugin is not judging.
• Any text following a # in the configuration file is treated as a comment all the way through the end of that line. Yapping rights unlocked 💬
• The size of each line in the file is limited to 1024 characters. Yes, one thousand twenty-four. Do not test it. 😭
• Changes to the configuration file take effect upon restart of Slurm daemons, daemon receipt of the SIGHUP signal, or execution of the command scontrol reconfigure — unless otherwise noted. So edit your file, then poke a daemon. That's the flow ✨

Now, the following ext_sensors.conf parameters are defined to control data collection by the ext_sensors plugins. And here's the vibe check: all of these parameters are optional. Every single one. If a parameter is omitted, data collection of the omitted type is disabled. Omitted = off. That's the rule, fr fr.

---

🦋 THE PARAMETERS 🦋

• JobData=energy — specify the data types to be collected by the plugin for jobs/steps.
• NodeData=[energy|temp][,temp|energy] — specify the data types to be collected by the plugin for nodes. Look at that syntax, she's giving options 💅
• SwitchData=energy — specify the data types to be collected by the plugin for switches.
• ColdDoorData=temp — specify the data types to be collected by the plugin for cold doors. Cold doors. Keeping the servers chilly, main character energy 🧊
• MinWatt=<number> — the minimum recorded power consumption, in watts.
• MaxWatt=<number> — the maximum recorded power consumption, in watts.
• MinTemp=<number> — the minimum recorded temperature, in Celsius.
• MaxTemp=<number> — the maximum recorded temperature, in Celsius.
• EnergyRRA=<name> — the energy RRA name.
• TempRRA=<name> — the temperature RRA name.
• EnergyPathRRD=<path> — the pathname of the energy RRD file.
• TempPathRRD=<patch> — the pathname of the temperature RRD file.

not me noticing that TempPathRRD takes <patch> and not <path> — yes, that's exactly how it's written in the original, bestie, I'm not fixing it, I'm just reporting the news 🙈

---

🌈 EXAMPLE 🌈

Here's what a real one looks like, copied exactly so you can just steal it:

###
# Slurm external sensors plugin configuration file
###
JobData=energy
NodeData=energy,temp
SwitchData=energy
ColdDoorData=temp
#

Look at her. Clean. Organized. Commented with ###. We love a self-aware config file 🎀

---

👑 COPYING 👑

Legal corner, but make it cute. Copyright (C) 2013 Bull Copyright (C) 2013-2022 SchedMD LLC. Produced at Bull (cf, DISCLAIMER).

This file is part of Slurm, a resource management program. For details, see <https://slurm.schedmd.com/>.

Slurm is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Slurm is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

---

💜 SEE ALSO 💜

• slurm.conf(5) — the other half of this duo, the roommate, the bestie 🫶

---

k bye — this was the Slurm Configuration File page, dated January 2022, and yes the footer says ext_sensors.conf(5) on both sides because symmetry is slay ✨💖 periodt 💅