昇腾社区首页
中文
注册
开发者
下载
支持
积分兑换 NEW

msnpureport工具使用

工具介绍

msnpureport工具部署在Host侧，该工具有以下用途：
  • 导出Device侧的相关日志和文件，包括slog日志、syslog日志、黑匣子、Stackcore文件、事件调度模块的维测信息和模块日志。导出的日志和文件将存储到运行msnpureport工具的路径下以时间戳命名的子目录中，且slog日志、syslog日志、黑匣子、Stackcore文件、事件调度模块的维测信息和模块日志分别存储到slog、message、hisi_logs、stackcore、event_sched和module_info文件夹下。
  • 查询和设置Device侧slog系统类日志的级别。
  • msnpureport工具仅适用于Ascend EP场景。
  • 不支持多个用户同时运行msnpureport工具。
  • msnpureport工具不支持增量导出日志，如果用户想避免老旧日志的影响，提高问题定位的效率，可以定期通过msnpureport工具获取Device侧日志，并自行制作脚本实现日志去重处理。

导出Device侧的相关日志和文件

  1. 登录Host侧服务器。
  2. 获取msnpureport工具。

    msnpureport工具在驱动Driver的安装目录下，路径为“Driver安装目录/driver/tools/msnpureport”。

  3. 在某个有读、写、执行权限的目录（如“/var/log/npu/report”，下文以此路径为例）下执行如下命令，运行msnpureport工具。

    Driver安装目录/driver/tools/msnpureport [options]

    在加锁的目录下（使用lsattr命令查看目录属性，有“i”选项的为加锁目录），用户没有权限运行msnpureport工具。如果用户想在该目录下运行msnpureport工具，可以通过chattr -i <加锁的目录>命令，将目录的“i”选项撤销。工具运行完后建议通过chattr +i <加锁的目录>命令，将目录的“i”选项加上。为了安全起见，不建议在加锁目录中运行工具。

    其中[options]支持的参数及解释请参见表1。

    表1 参数说明

    参数

    说明

    举例

    不指定任何参数

    导出所有日志和文件，包括：

    • slog日志。
    • syslog日志。
    • Stackcore文件。
    • 黑匣子日志。
    • 事件调度模块的维测信息。
    • 模块日志。

    Driver安装目录/driver/tools/msnpureport

    -a或--all

    导出所有日志、文件以及黑匣子设备事件信息，包括：

    • slog日志。
    • syslog日志。
    • Stackcore文件。
    • 黑匣子日志、黑匣子设备事件信息。
    • 事件调度模块的维测信息。
    • 模块日志。

    Driver安装目录/driver/tools/msnpureport -a

    -f或--force

    导出所有日志、文件以及黑匣子相关信息，包括：

    • slog日志。
    • syslog日志。
    • Stackcore文件。
    • 黑匣子日志、黑匣子设备事件信息、黑匣子存储空间中的历史维测信息。
    • 事件调度模块的维测信息。
    • 模块日志。

    Driver安装目录/driver/tools/msnpureport -f

    -t或--type

    指定导出的日志类型，取值为：

    • 0：导出所有类型日志，包括slog日志、syslog日志、Stackcore文件、黑匣子日志、事件调度模块的维测信息、模块日志。
    • 1：slog日志、syslog日志和事件调度模块的维测信息、模块日志。
    • 2：黑匣子日志。
    • 3：Stackcore文件。

    Driver安装目录/driver/tools/msnpureport -t 1

    注：

    导出的日志和文件保存路径分别为：

    • slog日志：slog目录
    • syslog日志：message目录
    • Stackcore文件：stackcore目录
    • 黑匣子日志、黑匣子设备事件信息、黑匣子存储空间中的历史维测信息：hisi_logs目录
    • 事件调度模块的维测信息：event_sched目录
    • 模块日志：module_info目录

导出日志说明

msnpureport工具运行成功后，Device侧的相关日志和文件被导出到Host侧，并存储到当前目录（如“/var/log/npu/report”）下以时间戳命名的文件夹中，具体如下：
  • slog日志：“/var/log/npu/report/*/slog”，“*”为时间戳，其具体日志目录如下：

    存储目录

    说明

    dev-os-id/xxx/device-os/device-os_*.log

    Device侧Control CPU上的系统类日志。

    说明：

    路径中xxx表示以下目录：debug、run、security。

    dev-os-id/device-id/device-id_*.log

    Device侧非Control CPU上的系统类日志。

    dev-os-id/xxx/device-app-pid/device-app-pid_*.log

    Device侧应用类日志。仅当Device侧应用类日志回传到Host侧失败时，才会在Device侧存储该日志。

    说明：

    路径中xxx表示以下目录：debug、run、security。

    dev-os-id/slogd/slogdlog

    维测日志。记录日志工具自身的运行信息，用于日志工具自身问题定位。
  • syslog日志：“/var/log/npu/report/*/message”

    syslog日志表示调用syslog接口记录Device侧其他组件产生的日志，“*”为时间戳。

  • 黑匣子：“/var/log/npu/report/*/hisi_logs”

    导出的黑匣子日志、黑匣子的设备事件信息和黑匣子存储空间中的历史维测信息均保存在该目录下，“*”为时间戳。

  • Stackcore文件：“/var/log/npu/report/*/stackcore”

    “*”为时间戳。

  • 事件调度模块的维测信息：“/var/log/npu/report/*/event_sched”，“*”为时间戳。
  • 模块日志： “/var/log/npu/report/*/module_info”，“*”为时间戳。

查询和设置Device侧slog系统类日志级别

  1. 登录Host侧服务器。
  2. 获取msnpureport工具。

    msnpureport工具在驱动Driver的安装目录下，路径为“Driver安装目录/driver/tools/msnpureport”。

  3. 在某个有读、写、执行权限的目录（如“/var/log/npu/report”）下，执行如下命令查询和设置日志级别。

    Driver安装目录/driver/tools/msnpureport [options]

    Driver安装目录/driver/tools/msnpureport [options] -d <device-id>

    其中[options]为查询和设置日志级别的各个参数，[options]各个参数及其他参数的解释请参见表2。

    非算力切分容器场景下，执行命令行时，需增加--docker参数标识为容器内执行命令。例如：

    Driver安装目录/driver/tools/msnpureport --docker -r

    表2 参数说明

    参数

    说明

    举例

    -g <level>或

    --global <level>
    设置全局级的日志级别。
    • debug：表示DEBUG级别。
    • info：表示INFO级别。
    • warning：表示WARNING级别。
    • error：表示ERROR级别。
    • null：表示NULL级别，不输出日志。

    Driver安装目录/driver/tools/msnpureport -g info

    -r或--request

    查询Device侧slog系统类日志的级别，包括全局级、模块级和是否开启Event日志。如果不指定Device ID，默认查询Device 0的日志级别。

    Driver安装目录/driver/tools/msnpureport -r

    查询后显示的级别示例如下：

    The system log level of device_id:0 is as follows:
[global]
INFO
[event]
ENABLE
[module]
SLOG:INFO IDEDD:INFO DVPP:INFO CCE:INFO
HDC:INFO DRV:INFO MDCDEFAULT:INFO DEVMM:INFO
KERNEL:INFO LIBMEDIA:INFO ASCENDDK:INFO ROS:INFO
HCCP:INFO ROCE:INFO PROFILING:INFO APP:INFO
TDT:INFO MD:INFO MB:INFO ME:INFO
BBOX:INFO TS:INFO TSDUMP:INFO LP:INFO

    -m <module:level>或

    --module <module:level>

    设置模块级的日志级别。

    • module：模块名称。例如SLOG等。可使用-r参数查询模块。
    • level：模块级别。取值为：
      • debug：表示DEBUG级别。
      • info：表示INFO级别。
      • warning：表示WARNING级别。
      • error：表示ERROR级别。
      • null：表示NULL级别，不输出日志。

    Driver安装目录/driver/tools/msnpureport -m SLOG:error

    -e <level>或

    --event <level>
    设置是否开启Event日志。
    • enable：开启Event日志。
    • disable：不开启Event日志。

    Driver安装目录/driver/tools/msnpureport -e disable

    -d <device-id>或

    --device <device-id>

    设备ID，可通过npu-smi info命令查看“NPU”字段值。

    Driver安装目录/driver/tools/msnpureport -g warning -d 1

    -h或--help

    用于打印帮助信息。

    Driver安装目录/driver/tools/msnpureport -h
父主题： 附录