错误记录器

        OTP系统自带一个可定制的错误记录器。可以从三个角度看待错误记录器：程序员视角关心 程序员为了记录错误而在代码里中做的函数调用；配置视角关心错误记录器在何处以及如何保存 数据；报告视角关心对已发生错误的分析。

记录错误

        对程序员来说，这个错误记录器的API很简单。以下是一个简单的API子集：

-spec error_logger:error_msg(String) -> ok.

-spec error_logger:error_msg(Format, String) -> ok.

-spec error_logger:error_report(Report) -> ok.

配置错误记录器

        有多种方式可用来配置错误记录器。可以让Erlang shell显示所有错误（如果没有特别设置的 话就是默认值），也可以把shell里报告的所有错误写入一个格式化文本文件。最后，还可以创建 一个滚动日志（rotating log）。可以把滚动日志看作是一个大型循环缓冲区，内含错误记录器生成 的消息。新消息进来后会被附加到日志的末尾，如果日志满了，最早的条目就会被删除。 滚动日志极其有用。你决定日志应当占据多少个文件，以及每个日志文件能有多大，然后系 统负责在一个大型循环缓冲区里删除旧日志文件和创建新文件。可以调整日志的大小来保存最近 几天的操作记录，这通常足以应付大多数用途了

        1.标准错误记录器

        在启动Erlang时可以给系统提供一个启动参数

erl -boot start_clean

        它会创建一个适合进行程序开发的环境，只提供一种简单的错误记录形式。（不带启动参 数的erl命令就等于erl -boot start_clean。

erl -boot start_sasl

        它会创建一个适合运行生产系统的环境。系统架构支持库（System Architecture Support Libraries，简称SASL）将负责错误记录和过载保护等工作。 日志文件的配置最好通过配置文件实现，因为没人能记住记录器的全部参数。

        2.无配置SASL

        我们不带配置文件启动SASL：

        现在调用error_logger里的某个方法来报告一个错误

       请注意，错误是在Erlang shell里报告的。错误的报告位置由错误记录器配置决定。

3. 控制记录内容

        在配置错误记 录器时可以选择只保存错误，丢弃其他所有类型的条目。现在，编写配置文件elog1.config来 配置错误记录器。

[{sasl, [
  {sasl_error_logger, false}
]}].

        如果用这个配置文件启动系统，就只会得到错误报告，不会有进度和其他报告。所有这些错 误报告只会出现在shell里。

4. 文本文件和shell

        接下来的配置文件会在shell里列出错误报告，所有的进度报告则会保存在一个文件里。

[{sasl, [
  {sasl_error_logger, {file, "/User/ydq/error_logs/THELOG"}}
]}].

5. 滚动日志和shell

        下面的配置既能提供shell输出，又能把写入shell的所有信息复制到一个滚动日志文件里。

[{sasl, [
  {sasl_error_logger, false},
%%  定义滚动日志条目
  %%日志文件目录
  {error_logger_mf_dif, "/Users/joe/error_logs"},
%%  每个日志文件字节数
  {error_logger_mf_maxbytes,10485760},
%%  日志文件的最大数量
  {error_logger_mf_maxfiles, 10}
]}].

        这个日志的最大文件大小是10MB，达到10MB时会回绕或者“滚动”。可想而知，这是一个 非常有用的配置。 运行系统时，所有的错误都会写入一个滚动错误日志。我们会在本章后面看 到如何从日志里提取错误。