我在脚本中使用基本日志记录工具,来捕获脚本执行期间或者执行之后的故障信息。使用基本日志记录来检测脚本在运行时正在做什么,以及为什么它这么做。我记得有一个网络操作中心试图解决一个遗留批处理的问题,在这个过程中,系统管理员通常必须尝试读取一个控制台窗口的行,因为它们是滴流而过。当批处理机使用拨号调制解调器连接到远程资源时,在很长一段时间里这种技术工作得很好。然而,宽带的出现意味着批脚本的执行速度超过了任何人能够读取的速度。简单的日志文件将使这些系统管理员的故障排除工作更加容易。

日志函数


Part 7 – 函数中,示范了tee的简单版实现

@ECHO OFF
SETLOCAL ENABLEEXTENSIONS

:: script global variables
SET me=%~n0
SET log=%TEMP%\%me%.txt

:: The "main" logic of the script
IF EXIST "%log%" DELETE /Q %log% >NUL

:: do something cool, then log it
CALL :tee "%me%: Hello, world!"

:: force execution to quit at the end of the "main" logic
EXIT /B %ERRORLEVEL%

:: a function to write to a log file and write to stdout
:tee
ECHO %* >> "%log%"
ECHO %*
EXIT /B 0

这个tee函数将Console中的输出同时写入了一个日志文件。在这里,重用了相同的日志文件路径,保存在用户%TEMP%文件夹中。如果需要为每个执行保留日志,可以通过%DATE%或者%TIME%来创建一个唯一的日志文件。

REM create a log file named [script].YYYYMMDDHHMMSS.txt
SET log=%TEMP%\%me%.%DATE:~10,4%_%DATE:~4,2%_%DATE:~7,2%%TIME:~0,2%_%TIME:~3,2%_%TIME:~6,2%.txt

Note: %DATE:~10,4% 表示从%DATE%变量中,从第10个位置开始截取4位。 例如 ECHO %DATE:~0,4% 输出当前年份。

在消息的内容前加上一个前缀,例如script: some message。这个技巧可以在出错的情况下,快速发现是在哪个地方输出的异常消息。

显示启动参数


显示非交互式脚本的各种运行时条件,比如在构建服务器上运行的一些东西,然后重定向到构建日志。遗憾的是,我还不知道有什么DOS技巧(但是)可以区分非交互式会话和交互式会话。 C# 和.Net有个System.Environment.UserInteractive属性可以检测这种情况。Unix有一些带有tty文件描述符的技巧。你可能需要监测一个自定义的环境变量来破解实现,比如%MYSCRIPT_DEBUG%默认值是false。