x -- 数值表达式。
• base -- 可选，底数，默认为 e。

返回 x 的自然对数，x>0。

提供模块级别的函数纪录日志
• 包括四大组件

  日志相关概念

日志的级别（level）

不同用户关注不同的程序信息

[code]              级别    何时使用
DEBUG    详细信息，典型地调试问题时会感兴趣。 详细的debug信息。
INFO    证明事情按预期工作。 关键事件。
WARNING    表明发生了一些意外，或者不久的将来会发生问题（如‘磁盘满了’）。软件还是在正常工作。
ERROR    由于更严重的问题，软件已不能执行一些功能了。 一般错误消息。
CRITICAL    严重错误，表明软件已不能继续运行了。
NOTICE    不是错误，但是可能需要处理。普通但是重要的事件。
ALERT    需要立即修复，例如系统数据库损坏。
EMERGENCY    紧急情况，系统不可用（例如系统崩溃），一般会通知所有用户。

调试
• 了解软件的运行情况
• 分析定位问题

time
• 地点
• level
• 内容

log4j
• log4php
• logging

  logging模块

级别自定义
• DEBUG
• INFO
• NOTICE
• WARNING
• ERROR
• CRITICAL

直接使用logging（封装了其他组件）
• logging四大组件直接定制

  logging模块级别日志

使用以下几个函数

[code]                  logging.debug(msg, *args, **kwargs)       创建一条严重级别为DEBUG的日志记录
logging.info(msg, *args, **kwargs)        创建一条严重级别为INFO的日志记录
logging.warning(msg, *args, **kwargs)    创建一条严重级别为WARNING的日志记录
logging.error(msg, *args, **kwargs)        创建一条严重级别为ERROR的日志记录
logging.critical(msg, *args, **kwargs)    创建一条严重级别为CRITICAL的日志记录
logging.log(level, *args, **kwargs)        创建一条严重级别为level的日志记录
logging.basicConfig(**kwargs)            对root logger进行一次性配置
- 其中logging.basicConfig(**kwargs)函数用于指定“要记录的日志级别”、“日志格式”、“日志输出位置”、“日志文件的打开模式”等信息，其他几个都是用于记录各个级别日志的函数。

logging.basicConfig(**kwargs) 对root logger进行一次性配置 只在第一次调用时起作用
• logging.basicConfig()函数包含参数说明

  [code]          参数名称                    描述
  filename    指定日志输出目标文件的文件名（可以写文件名也可以写文件的完整的绝对路径，写文件名日志放执行文件目录下，写完整路径按照完整路径生成日志文件），指定该设置项后日志信心就不会被输出到控制台了
  filemode    指定日志文件的打开模式，默认为'a'。需要注意的是，该选项要在filename指定时才有效
  format    指定日志格式字符串，即指定日志输出时所包含的字段信息以及它们的顺序。logging模块定义的格式字段下面会列出。
  datefmt    指定日期/时间格式。需要注意的是，该选项要在format中包含时间字段%(asctime)s时才有效
  level    指定日志器的日志级别
  stream    指定日志输出目标stream，如sys.stdout、sys.stderr以及网络stream。需要说明的是，stream和filename不能同时提供，否则会引发 ValueError异常
  style    Python 3.2中新添加的配置项。指定format格式字符串的风格，可取值为'%'、'{'和'$'，默认为'%'
  handlers    Python 3.3中新添加的配置项。该选项如果被指定，它应该是一个创建了多个Handler的可迭代对象，这些handler将会被添加到root logger。需要说明的是：filename、stream和handlers这三个配置项只能有一个存在，不能同时出现2个或3个，否则会引发ValueError异常。

• logging模块中定义好的可以用于format格式字符串说明

  [code]          字段/属性名称    使用格式    描述
  asctime    %(asctime)s    将日志的时间构造成可读的形式，默认情况下是‘2016-02-08 12:00:00,123’精确到毫秒
  name    %(name)s    所使用的日志器名称，默认是'root'，因为默认使用的是 rootLogger
  filename    %(filename)s    调用日志输出函数的模块的文件名； pathname的文件名部分，包含文件后缀
  funcName    %(funcName)s    由哪个function发出的log， 调用日志输出函数的函数名
  levelname    %(levelname)s    日志的最终等级（被filter修改后的）
  message    %(message)s    日志信息， 日志记录的文本内容
  lineno    %(lineno)d    当前日志的行号， 调用日志输出函数的语句所在的代码行
  levelno    %(levelno)s    该日志记录的数字形式的日志级别（10, 20, 30, 40, 50）
  pathname    %(pathname)s    完整路径 ，调用日志输出函数的模块的完整路径名，可能没有
  process    %(process)s    当前进程， 进程ID。可能没有
  processName    %(processName)s    进程名称，Python 3.1新增
  thread    %(thread)s    当前线程， 线程ID。可能没有
  threadName    %(thread)s    线程名称
  module    %(module)s    调用日志输出函数的模块名， filename的名称部分，不包含后缀即不包含文件后缀的文件名
  created    %(created)f    当前时间，用UNIX标准的表示时间的浮点数表示； 日志事件发生的时间--时间戳，就是当时调用time.time()函数返回的值
  relativeCreated    %(relativeCreated)d    输出日志信息时的，自Logger创建以 来的毫秒数； 日志事件发生的时间相对于logging模块加载时间的相对毫秒数
  msecs    %(msecs)d    日志事件发生事件的毫秒部分。logging.basicConfig()中用了参数datefmt，将会去掉asctime中产生的毫秒部分，可以用这个加上

• 不配用logger则使用默认值 输出：sys.stderr
• 级别：WARNING
• 格式：lever:log_name:content

In [20]:

import logging

logging.debug("this is a debug log")

logging.info("this is a info log")

logging.warning("this is a warning log")

logging.error("this is a error log")

logging.critical("this is a critical log")

#另一种写法

logging.log(logging.DEBUG,"this is a debug log")

logging.log(logging.INFO,"this is a info log")

logging.log(logging.WARNING,"this is a warning log")

logging.log(logging.ERROR,"this is a error log")

logging.log(logging.CRITICAL,"this is a critical log")

#当不用logging.basicConfig指定级别时默认低于warning级别的不显示输出

​

WARNING:root:this is a warning log
ERROR:root:this is a error log
CRITICAL:root:this is a critical log
WARNING:root:this is a warning log
ERROR:root:this is a error log
CRITICAL:root:this is a critical log

logging模块的处理流程

• 四大组件 日志器（logger）:产生日志的一个接口
• 处理器（Handler）：把产生的日志发送到相应的目的地
• 过滤器（Filter）：更精细的控制那些日志的输出
• 格式器（Formatter）：对输出的信息进行格式化

产生一个日志
• 操作

  [code]      logger.setLevel(logging.ERROR) # 设置日志级别为ERROR，即只有日志级别大于等于ERROR的日志才会输出
  logger.addHandler(handler_name) # 为Logger实例增加一个处理器
  logger.removeHandler(handler_name) # 为Logger实例删除一个处理器
  logger.addFilter()和logger.removeFilter()# 为Logger添加或者移除一个Filter
  logger.debug()#产生一条debug级别的日志，同理info,error等
  logger.exception()#创建类似于logger.error的日志消息
  logger.log()#获取一个明确的日志level参数类创建一个日志记录

• 如何得到一个logger对象 实例化
• logging.getLogger()

Handler

把log发送到指定位置
• 方法 setLevel
• setFormat
• addFilter，removeFilter

下面是一些常用的Handler：

[code]              Handler                   描述
logging.StreamHandler    将日志消息发送到输出到Stream，如std.out, std.err或任何file-like对象。
logging.FileHandler        将日志消息发送到磁盘文件，默认情况下文件大小会无限增长
logging.handlers.RotatingFileHandler    将日志消息发送到磁盘文件，并支持日志文件按大小切割
logging.hanlders.TimedRotatingFileHandler    将日志消息发送到磁盘文件，并支持日志文件按时间切割
logging.handlers.HTTPHandler    将日志消息以GET或POST的方式发送给一个HTTP服务器
logging.handlers.SMTPHandler    将日志消息发送给一个指定的email地址
logging.NullHandler     该Handler实例会忽略error messages，通常被想使用logging的library开发者使用来避免’No handlers could be found for logger XXX’信息的出现。

直接实例化使用
• 可以继承Format添加特殊内容
• 三个参数

  [code]              fmt：指定消息格式化字符串，如果不指定该参数则默认使用message的原始值
  datefmt：指定日期格式字符串，如果不指定该参数则默认使用”%Y-%m-%d %H:%M:%S”
  style：Python 3.2新增的参数，可取值为 ‘%’, ‘{‘和 ‘$’，如果不指定该参数则默认使用’%’

可以被Handler和Logger使用
• 控制传递过来的信息的具体内容