РЕШЕНО:

Несколько месяцев назад я заинтересовался ведением логов в оболочке скриптов.

Первой идеей была ручная функция ведения логов, такая как эта:

add2log() {
    printf "$(date)\tINFO\t%s\t%s\n" "$1" "$2" >>"$logPATH"
}

Но я хотел автоматизировать это, чтобы STDERR автоматически записывался в журнал.

Прошло довольно времени, прежде чем я нашел удовлетворительный ответ, и, наконец, нашел время, чтобы поделиться им.

Для каждого моего оболочного скрипта я теперь использую “main.sh”, который содержит функции для ведения логов, а также настройки (настройка файлов логов и конфигурации).
Вот как это выглядит:

#!/bin/bash

###################################################################
# МОИ ЗАГОЛОВКИ
###################################################################


#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~~~~~~~~~~~~~~~~~~Глобальные переменные

mainScriptNAME=$(basename "$0")
mainScriptNAME="${mainScriptNAME%.*}"
mainScriptDIR=$(dirname "$0")
version="v0.0"
scriptsDIR="$mainScriptDIR/SCRIPTS"
addonsDIR="$mainScriptDIR/ADDONS"


#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~~~~~~~~~~~~~~~~~~ФУНКЦИИ ДЛЯ ВЕДЕНИЯ ЛОГОВ

manualLogger() {

    # $1=ПРИОРИТЕТ $2=ИМЯ ФУНКЦИИ $3=сообщение
    printf "$(date)\t%s\t%s()\t%s\n" "$1" "$2" "$3" >>"$logFilePATH"
}

stdoutLogger() {

    # $1=сообщение
    printf "$(date)\tSTDOUT\t%s\n" "$1" >>"$logFilePATH"
}

stderrLogger() {

    # $1=сообщение
    printf "$(date)\tSTDERR\t%s\n" "$1" >>"$logFilePATH"
}


#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~~~~~~~~~~~~~~~~~~ЛОГИ И КОНФИГ

createLog() {
    # код для настройки и создания logFilePATH & confFilePATH
    manualLogger "INFO" "${FUNCNAME[0]}" "Log файл создан."
}


#~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
#~~~~~~~~~~~~~~~~~~ОСНОВНОЕ

#
createLog

#запуск скриптов
{

    #
    source "$scriptsDIR/file1.sh"
    doSomthing1
    doSomthing2

    #
    source "$scriptsDIR/file2.sh"
    anotherFunction1
    anotherFunction2

    ...


} 2> >(while read -r line; do stderrLogger "$line"; done) \
1> >(while read -r line; do stdoutLogger "$line"; done) 

Другими словами:

• все скрипты/функции, которые я хочу запустить, находятся в отдельных файлах в папке ./SCRIPTS (поэтому мой main.sh почти всегда одинаковый)
• я вызываю все эти скрипты в группе { … }, чтобы перехватить их STDOUT и STDERR
• их STDOUT и STDERR перенаправляются в соответствующие функции ведения логов

Файл логов выглядит так (примеры одного ручного логгера, одного логгера STDOUT, одного логгера STDERR):

Пн 23 мая 2022 12:20:42 CEST   INFO    createLog() Log файл создан.
Пн 23 мая 2022 12:20:42 CEST   STDOUT  Некоторый стандартный вывод
Пн 23 мая 2022 12:20:42 CEST   STDERR  ls: sadsdasd: Нет такого файла или каталога

Группа позволяет собрать весь вывод в журнал.
Вместо этого вы, очевидно, могли бы использовать перенаправление 2> >(while read ... и 1> >(while read ... по своему усмотрению для каждой функции.
Например, doSomthing1 будет иметь свой STDOUT и STDERR в журнале, но doSomthing2 будет иметь только перенаправление своего STDERR.

Судя по всему, похоже, что вы просто добавляете отладочные операторы. Что вы имеете в виду под “тяжелым” здесь? В Bash-скрипте (или, скорее, в любом языке программирования по этому поводу), если вам нужно что-то вывести, вам нужно иметь оператор, который сообщает интерпретатору выполнить echo содержимое, которое вы передали.

Не существует замены для написания команды, если вы хотите, чтобы действие произошло в определенной точке в вашем скрипте (или любом участке кода).

Вы можете использовать различные трюки с перенаправлением ввода-вывода, но вам нужно иметь два оператора – один в начале и один в конце, чтобы достичь желаемого результата.

Если вы хотите тщательного ведения логов вашего скрипта, обратите внимание на set -x. Если вы хотите записывать только некоторые функции вашего скрипта, используйте set -x с этими функциями в подсчетах.

(set -x; func1)

Я использую файлы-флаги в специальном каталоге:

foo.bash:
  
#!/bin/bash
[[ -f $HOME/.local/debug/foo.debug ]] && \
  source $HOME/.local/debug/foo.debug
...

Я могу помещать все, что мне нравится, в файл foo.debug, включая такие вещи, как debug_foofunction=1, а затем в foo‘s foofunction я могу использовать debug_foofunction (осторожно – это может быть неопределенным), чтобы вызывать (или не вызывать) код отладки.
Если я просто rm $HOME/.local/debug/foo.debug, весь код отладки отключается. Если я изменю его на debug_foofunction=0, я могу отключить отладку foofunction, оставляя другие настройки отладки (например, debug_foootherfunction=1).

Читать man bash, о встроенной команде “trap“.

Реальное решение – не писать сложные скрипты. Используйте язык программирования, который соответствует вашей проблеме.

Всегда вставляйте свой скрипт в https://shellcheck.net, проверщик синтаксиса, или устанавливайте shellcheck локально. Сделайте использование shellcheck частью вашего процесса разработки.