arc-blahp-logger(8)

💖 arc-blahp-logger(8) 💖

okay bestie, welcome to the NorduGrid Toolkit corner of the manual, this one's arc-blahp-logger and she is serving accounting realness 💅

---

✨ NAME ✨

arc-blahp-logger — an ARC authplugin that stores BLAH accounting logs about jobs that have FINISHED 🎀

---

🌸 DESCRIPTION 🌸

so basically: ARC BLAH logger is an authplugin whose whole job is to stash info about FINISHED jobs into log files, the kind that the BLAH parser eats for breakfast 🍓. Once those logs exist, APEL/DGAS client tools can pick them up and yeet your accounting info wherever it needs to go. it's giving "quietly doing the most important background work" energy fr fr 👑

---

🦋 SYNOPSIS 🦋

arc-blahp-logger -I <jobID> -U <user> -P <proxy file> -L <job status file> [-c <ceid prefix>] [-p <log prefix> ] [-d <log level>] [-i]

---

💜 OPTIONS 💜

• -I jobID — the A-REX job identifier. the name tag of the job, if you will 🏷️
• -U user — the local account that owns the job's files and processes
• -P user proxy — path to the user's proxy certificate file, so we can pull the VOMS membership info out of it 🔐
• -L job status file — the A-REX jobstatus .local file, which is holding extra lore about the job (like the LRMS id) 📄
• -c ceid prefix — the prefix used to generate the CE ID, in accordance with GLUE1.3 publishing
• -p log prefix — where the logs live and what their filename prefix is. default is /var/log/arc/accounting/blahp.log 🗂️
• -d loglevel — the logging level, and it runs from 0 (ERROR) all the way up to 5 (DEBUG)
• -i — ignore failed jobs. heads up tho: the default is to publish them, so if you don't pass this, the failed ones go in the log too 💀

---

🧚 ENABLING PLUGIN IN A-REX CONFIGURATION 🧚

to make this whole thing pop off, you need to add the BLAH logger plugin as a handler for the FINISHED state, like this:

authplugin="FINISHED timeout=10,onfailure=pass /usr/libexec/arc/arc-blahp-logger -I %I -U %u -L %C/job.%I.local -P %C/job.%I.proxy"

that's the whole vibe check. add it, and you're in business ✨

---

🌈 CONFIGURATION 🌈

ngl there's no special plugin configuration happening here — it's literally just "pass the correct options" and you're done. no secret handshake, no hidden config file. periodt 💅

by default the BLAH log gets written to /var/log/arc/accounting/blahp.log-YYYYMMDD. the log prefix (that's the part without the -YYYYMMDD) can be redefined with the optional -p option 🎀

the CE ID is generated automatically and its format is host.fqdn:2811/nordugrid-torque-queue, in accordance with GLUE1.3 publishing. the queue gets added at runtime anyway, but the prefix can be redefined with the -c option. and yes, you should add this option in case of LRMS 👀

and if you wanna debug the logger's execution, just add the -d 5 option and you'll see all the ARC logger output from all the subsystems it uses. it's a lot. it's iconic. it's a firehose 🔥

---

👑 AUTHOR 👑

Andrii Salnikov <manf at grid dot org dot ua>

---

and that's the whole page bestie, no cap 💖

this was brought to you by the NorduGrid 7.2.0 girlies, dated 2014-02-20 — yeah she's a classic, she's been slaying since 2014 and she's not stopping 🦋💅✨