资讯 社区 文档
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术

鉴权问题快速排查工具

工具介绍

鉴权超时、指纹失效、鉴权服务进程异常的排查定位,鉴权过期、产品未授权、实例超限、系统时间篡改等问题的快速检测

  • 鉴权问题快速检测:适用于算子鉴权失败后快速定位失败原因,或者算子遇到问题快速检测是否鉴权问题。可通过算子容器日志、鉴权服务日志等快速检测鉴权相关问题,并提供FAQ说明帮助解决问题。目前覆盖了鉴权过期、产品未授权、实例超限、系统时间篡改等常见问题
  • 鉴权超时一键定位:快速检测并定位算子访问鉴权超时的原因,如防火墙拦截、docker配置、鉴权IP配置、鉴权服务异常等
  • 指纹失效一键定位:支持物理机/虚拟机场景,可定位到指纹变化的硬件机器变化前后信息
  • 鉴权服务异常一键定位:鉴权服务异常时快速定位原因,如端口占用、缓存异常、进程异常等

使用流程

1. 下载排查工具至部署环境

  • 当前工具版本:v1.4
  • 环境依赖:Python3.6
  • 快速排查工具已内置于部署包目录中:original/package/EasyTroubleShoot
  • 您也可以点击下载快速排查工具包,并上传至服务器后解压

2. 执行排查任务

2.1 快速排查流程

python3 easyts.py check #执行此命令会进行鉴权快速排查

image.png

2.2 指纹对比功能

python3 easyts.py fg #执行此命令可以执行指纹对比功能
  • 依赖原指纹文件,物理机要求指纹工具版本 > 2.2.1 ,详见指纹提取工具
  • 可查看/etc/private_cloud/finger/文件夹下是否存在指纹文件,单机情况下指纹文件命名为finger,集群情况下指纹压缩包命名为finger.tar.gz 。当前部署包更新及部署鉴权时已自动放置指纹文件,无需手动操作
  • 如果对应目录下没有对应指纹文件,可以将变化前指纹手动迁移至对应目录修改命名,然后使用此功能

执行报告示例如下:
image (1).png

3. 查看任务报告

执行快速排查工具后可根据命中case列表及命中case详情对问题进行定位与解决。也可以查看返回中的关联FAQ信息,进入快速排查工具目录下faqs/Deployment-FAQ.pdf,进行问题的排查解决

TASK aa [bb]开始/结束
检查项检测/排查详细输出
[ERROR]检测到异常[cc],详情请查看FAQ:《dd》Qee
bb的原始输出是ff
以下容器命中了该case:
gg
共匹配到hh条日志,前10条匹配的日志如下:
[ii]jj kk行
ll
本次流程执行完成
开始时间:xx,结束时间xx,共计耗时xx
本次执行日志存放与目录
本次执行
共执行检查项xx个,命中casexx个
命中的case列表如下:
mm

4.工具排查范围

查询已安装模块docker容器状态

检查项 检查内容
模型docker容器日志检测是否存在鉴权相关报错 错误码509:指纹变化
错误码508:没有对应授权
501:实例超限
503:授权过期
504:异步鉴权未开启
505:qps超限
502:指纹变化或者产品未授权
timeout:超时
connect_error:无法连接鉴权
docker容器日志出现超时问题进行后续检测 宿主机连通性及容器内连通性
鉴权服务安装检测 检测前机器是否安装鉴权
鉴权服务三天内日志收集 收集鉴权日志
检测鉴权服务health健康状态检测 检测鉴权health接口
检测鉴权服务进程及端口信息 鉴权进程及端口信息
鉴权服务auth_server.log日志检测 系统时间变化问题
环境不安全机器是虚拟机问题
出现指纹变化后进行变化原因检测 输出变化原因(依赖最新版本部署包)
鉴权服务aipe_info日志检测 指纹变化
没有对应授权
授权超有效期
算子实例超限
缓存连接失败
ip地址传入数量不对
上一篇
常见部署问题说明