- 产品与解决方案
- 行业解决方案
- 服务
- 支持
- 合作伙伴
- 关于我们
10-日志管理
本章节下载： 10-日志管理 (423.92 KB)
目 录
日志采集功能主要用于设备的操作记录、状态检测和故障的诊断定位，主要提供以下功能：
· 根据具体的用户需求，对业务层流程类信息、数据类信息进行记录，支持按照模块、子模块和日志等级等多种规则记录日志。
· 支持按日志开关、日志等级等特定需求配置日志。
· 支持模块配置信息的查询。
· 支持日志信息通过FTP方式导出。
日志管理特性作为一种定位手段提供，主要服务对象为开发和技服人员。主要作用对象包含L1，L2 ，L3三个业务层和OAM模块等，各个模块处理方式不尽相同，具体如表1-1所示。
|
采集对象 |
采集方式 |
解析方式 |
上传方式 |
备注 |
|
L1 |
· L1数据面日志由L1模块自身记录，以.bin文件方式保存在操作系统中 · L1模块流程类日志调用日志接口写入共享内存，由日志模块读取采集，以.bin文件方式保存在操作系统中 |
使用专用的解析软件解析产生的.bin文件 |
实时上传和一键上传 |
L1模块日志产生速度较快，峰值速度可达到20Mbps以上 |
|
L2 |
· L2模块除FAPI外其他消息，调用日志接口写入共享内存，由日志模块读取采集，以.bin文件方式保存在操作系统中 · L2模块FAPI消息，调用日志接口写入共享内存，由日志模块读取采集，以.pcap文件方式保存在操作系统中 |
使用日志采集的解析软件logl2parser解析.bin文件,使用wireshark解析.pcap文件 |
实时上传和一键上传 |
· L2模块日志产生速度较快，单个进程峰值速度可达到20Mbps · 在多小区环境中，最多可同时存在3个L2日志进程 |
|
L3（RRC、RRM） |
L3模块调用日志接口写入共享内存，由日志模块读取采集，并在线解析，以.log文件方式保存在操作系统中 |
L3模块日志在被从共享内存读取时在线解析 |
一键上传 |
L3模块日志产生速度相较于L1，L2日志慢很多，单个进程峰值速度约为2Mbps |
|
OAM |
OAM模块调用日志接口直接写入.log文件方式，保存在操作系统中 |
OAM模块无需解析 |
一键上传 |
无 |
|
其他日志（DRV、DIAGNOSE、SYSLOG、RDM、PHY_ERROR) |
不由产品日志模块产生 |
不由产品日志模块解析 |
一键上传 |
无 |
业务层调用了日志的接口，但这条日志是否写入日志文件中，还需要满足两个条件：
· 此条日志所属子模块或者模块的日志开关开启。
· 此条日志的日志等级高于所属子模块或者模块所设置的日志等级。
· 通过基站管理页面，可以构造和下发MML（Man-Machine Language，人机语言）命令，完成基站功能的配置。
· 日志开关及日志等级的设置会影响设备的性能。开启日志功能的模块或子模块越多、日志等级设置越低，系统就会产生越多的日志文件，从而对设备性能影响越大。为保证系统高效运转，当设备重启后，模块或子模块的开关状态和日志等级会恢复为系统设置的缺省值。
基站MML命令是指以ADD、SET、MOD、RMV、DSP、LST等关键字开头的基站功能命令。构造基站MML命令是在指定基站管理配置任务执行区中进行的。进入指定配置任务执行区、构造基站MML命令的具体操作步骤为：
(1) 进入基站管理页面
登录基站BBU Web后，点击页面左侧导航栏中的[基站管理]菜单项，进入基站管理页面。
(2) 进入指定基站管理配置任务执行区
在基站管理页面中，用户可以通过以下两种方式进入指定基站管理配置任务执行区：
¡ 点击基站管理导航栏中的<
>按钮，展开基站管理导航栏，然后点击对应菜单项中的配置任务进入指定基站管理配置任务执行区，例如，需要添加小区时，用户可以依次点击图1-1中的[eNodeB功能管理/小区管理/小区配置]前的<
>按钮展开导航栏，然后点击小区配置菜单项内的[添加小区]进入添加小区配置任务执行区。
图1-1 通过命令树进入指定配置任务执行区示意图
¡ 在基站管理任意页面命令检索框中输入命令关键字进入指定配置任务执行区，如图1-2所示，需要执行添加小区操作时，在命令检索框中输入“ADD CELL”，然后点击联想出的“ADD CELL（添加小区）”即可进入添加小区配置任务执行区。
(3) 构造基站MML命令
进入指定配置任务执行区后，用户可以在图1-3中②所示的参数区点选或输入参数的值辅助构造基站功能命令。点选或输入参数后，会在图1-3中①所示的命令输入框中生成对应的基站MML命令。
图1-3 构造基站MML命令示意图
构造好基站MML命令后，点击命令输入框下的<执行>按钮，可以完成基站MML命令的下发。
为方便配置基站，基站管理页面支持批量下发MML命令，需要注意的是：
· 在基站管理中，任意基站功能页面的命令输入框均支持执行MML命令，用户可以将一条或多条MML命令拷贝到命令输入框中下发。
· 当前设备最多支持批量处理500条MML命令。
· 命令输入框中，使用#可对MML命令进行单行注释，即#后的本行内容为注释内容，将不被系统执行。使用时，需注意：
¡ #需要放在每行最开始位置（除空格外）；否则#将被系统认定为无效的命令。
¡ 在命令输入框中，由于输入命令或注释内容过长时，系统会自动换行，此种情况下自动换行后的内容仍将被认定为本行命令或本行注释内容。
不同基站版本的基站管理操作界面可能略有不同。
日志管理配置任务如下：
(1) 设置日志
(2) （可选）显示日志状态
(3) 上传日志
¡ 一键上传日志
¡ 实时上传日志
设置日志主要用于配置各个模块的日志开关和日志等级。
各个模块可设置的管理对象各不相同，如L2的各个日志条目是按照线程划分，而L1是按照进程划分，OAM则只存在日志等级设置而不存在开关等。具体模块的管理对象和限制如表1-2所示。
|
模块名 |
日志管理对象 |
小区标识 |
缺省日志等级 |
|
L1 |
L1进程下各子模块 |
不需要设置小区标识 |
WARNING/SYS/TRACE |
|
L2 |
L2进程下各子模块 |
不需要设置小区标识 |
WARNING |
|
OAM |
OAM进程 |
不需要设置小区标识 |
WARNING |
|
RRC |
RRC进程 |
不需要设置小区标识 |
INFO |
|
RRM |
RRM进程 |
不需要设置小区标识 |
INFO |
(1) 在“基站管理”执行区中检索命令SET LOG，切换到对应执行区；
(2) 在执行区中点选、输入参数的值或者在命令输入框中输入完整的SET LOG命令；
(3) 点击页面中的“执行”。
(1) 在“基站管理”执行区中检索命令DSP LOG，切换到对应执行区；
(2) 在执行区中点选、输入参数的值或者在命令输入框中输入完整的DSP LOG命令；
(3) 点击页面中的“执行”。
上传日志包括一键上传日志和实时上传日志。
上传日志是从后台通过FTP将选择的模块日志信息传递到用户配置的FTP服务器上，各个模块上传方式和配置限制都不同，具体情况如表1-3所示。上传日志时，需注意：
· 上传日志时，要精确到模块和子模块级别，尽量避免全选操作，否则会因为FTP上传速度和磁盘写入速度限制造成日志文件丢失；
· 实时上传日志时，要在采集完日志信息后及时关闭任务，否则长期上传数据会占用大量FTP服务器的磁盘资源。
· 当存在实时日志正在上传时，请勿强行关闭本地FTP传输工具，否则可能导致FTP工具进程异常，无法开启新的实时上传任务。如果出现FTP传输工具与设备异常断开的情况，建议先通过执行ULD LOG_R命令，关闭当前实时日志上传任务，再重新开启新的实时上传任务。
|
模块名 |
上传方式 |
是否需配置小区标识 |
上传旧日志 |
|
L1 |
实时上传和一键上传 |
不需配置小区标识 |
可选择 |
|
L2 |
实时上传和一键上传 |
需配置小区标识 |
可选择 |
|
L3（RRC、RRM） |
一键上传 |
不需配置小区标识 |
默认上传当前文件 |
|
OAM |
一键上传 |
不需配置小区标识 |
默认上传当前文件 |
|
其他日志（DRV、DIAGNOSE、SYSLOG、RDM、PHY_ERROR) |
一键上传 |
不需配置小区标识 |
默认上传当前文件 |
(1) 在“基站管理”执行区中检索命令ULD LOG，切换到对应执行区；
(2) 在执行区中点选、输入参数的值或者在命令输入框中输入完整的ULD LOG命令；
(3) 点击页面中的“执行”。
(1) 在“基站管理”执行区中检索命令DSP LOGSTAT，切换到对应执行区。
(2) 点击页面中的“执行”，可查看当前一键上传任务状态。一键上传状态包括：
¡ 空闲：表示当前无一键上传任务。
¡ 上传中：表示当前一键上传任务正在执行。
¡ 最近一次上传任务失败：表示最近一次上传任务执行失败。
实时上传日志时，请在上传完毕后，将开关置为关闭，避免造成大量日志信息上传到FTP服务器。
(1) 在“基站管理”执行区中检索命令ULD LOG_R，切换到对应执行区；
(2) 在执行区中点选、输入参数的值或者在命令输入框中输入完整的ULD LOG_R命令；
(3) 点击页面中的“执行”。
采集OAM模块的日志信息，并通过一键上传功能将日志信息上传到PC本地。
(1) 设置日志，将参数配置成对应“取值样例”的值，执行MML命令：
SET LOG:MoID=OAM,OAMLevel=WARNING;
|
参数名称 |
参数 |
取值样例 |
|
模块标识 |
MoID |
OAM |
|
OAM日志等级 |
OAMLevel |
WARNING |
(2) 一键上传日志，将参数配置成对应“取值样例”的值，执行MML命令：
ULD LOG:IP=188.188.65.2,Path=test,User=abc,Password=admin,ULDLogType=OAM;
|
参数名称 |
参数 |
取值样例 |
|
IP |
IP |
188.188.65.2 |
|
目标路径 |
Path |
test |
|
用户名 |
User |
abc |
|
密码 |
Password |
admin |
|
上传文件类型 |
ULDLogType |
OAM |
用户在PC本地的FTP文件夹下可以看到名为“test”的文件夹，文件夹中包含有上传的OAM日志。
采集DL_MDAB_CONTROL子模块（L1）的日志信息，并通过实时上传功能将日志信息上传到PC本地。
(1) 设置日志，将参数配置成对应“取值样例”的值，执行MML命令：
SET LOG:MoID=L1,SubMoID=DL_MDAB_CONTROL,L1Level=WARNING;
|
参数名称 |
参数 |
取值样例 |
|
模块标识 |
MoID |
L1 |
|
子模块标识 |
SubMoID |
DL_MDAB_CONTROL |
|
L1日志等级 |
L1Level |
WARN |
(2) 实时上传日志，将参数配置成对应“取值样例”的值，执行MML命令：
ULD LOG_R:LogType=L1LOG,Switch=ENABLE,IP=188.188.65.2,Path=test,User=abc,Password=admin,DelPastLog=ENABLE,L1LogType=PHY&ERR&PSM;
|
参数名称 |
参数 |
取值样例 |
|
上传文件类型 |
LogType |
L1LOG |
|
开关 |
Switch |
ENABLE |
|
IP |
IP |
188.188.65.2 |
|
目标地址 |
Path |
test |
|
用户名 |
User |
abc |
|
密码 |
Password |
admin |
|
删除旧日志 |
DelPastLog |
ENABLE（是） |
|
L1上传文件类型 |
L1LogType |
PHY&ERR&PSM |
用户在PC本地的FTP文件夹下可以看到名为“test”的文件夹，文件夹中包含有实时上传的日志。
不同款型规格的资料略有差异, 详细信息请向具体销售和400咨询。H3C保留在没有任何通知或提示的情况下对资料内容进行修改的权利!
支持
