9 changed files with 951 additions and 39 deletions
File diff suppressed because one or more lines are too long
@ -0,0 +1,289 @@ |
|||
#!/usr/bin/env bash |
|||
# |
|||
# BLE 通话翻译日志抓取 / 过滤工具 |
|||
# |
|||
# 用途：排查"通话中 BLE buff 溢出且不恢复"问题，把 Android / iOS / Dart 三处日志 |
|||
# 按同一套关键词过滤出来，边看边落盘，方便和设备端同事对时间轴。 |
|||
# |
|||
# 常用： |
|||
# ./tools/ble_log.sh android # 实时抓 Android BLE 日志（同时写文件） |
|||
# ./tools/ble_log.sh android -k # 只看通话翻译相关行（强过滤） |
|||
# ./tools/ble_log.sh ios # 实时抓 iOS 真机日志 |
|||
# ./tools/ble_log.sh pull-android # 拉 app 内的 Dart 日志文件 app_*.log |
|||
# ./tools/ble_log.sh pull-ios # 同上（iOS，需 devicectl） |
|||
# ./tools/ble_log.sh filter <日志文件> # 从已有日志里筛通话翻译相关行 |
|||
# ./tools/ble_log.sh stat <日志文件> # 快速统计：拥塞/休眠/发送节拍 |
|||
# |
|||
set -uo pipefail |
|||
|
|||
APP_ID="com.saitong.voitrans" |
|||
IOS_SUBSYSTEM="com.yunqiinnovation.ble_service" |
|||
|
|||
# Android 需要抓的 TAG（flutter 用于捞 Dart 侧 Logger 输出） |
|||
ANDROID_TAGS=( |
|||
BleService |
|||
BleCommandSender |
|||
BleServicePlugin |
|||
BleCompanionManager |
|||
OpusAudioManager |
|||
flutter |
|||
) |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
# 通话翻译相关关键词。 |
|||
# 前半段是代码里已有的日志标记，后半段 CT_* 是排查期建议补充的聚合日志标记 |
|||
# （每秒吞吐 CT_RATE / 设备流控 CT_FLOW / 写入背压 CT_TX / 心跳 CT_HB）。 |
|||
# 新增日志时统一用 [CT_xxx] 前缀，这里就不用再改。 |
|||
# --------------------------------------------------------------------------- |
|||
CT_PATTERN='CT_RATE|CT_FLOW|CT_TX|CT_HB|CALL_TRANS_CMD|CALL_TRANS_HB|CALL_TRANS_DEBUG' |
|||
CT_PATTERN="$CT_PATTERN"'|音频下行发送|下行写入拥塞|下行写入已恢复|音频发送队列已满|音频发送线程|声道积压缓存' |
|||
CT_PATTERN="$CT_PATTERN"'|休眠|补发积压|恢复左声道|恢复右声道|通话翻译|编解码|心跳' |
|||
CT_PATTERN="$CT_PATTERN"'|连接参数|连接优先级|onConnectionUpdated|MTU|mtu' |
|||
CT_PATTERN="$CT_PATTERN"'|已连接|已断开|连接断开|重连|GATT' |
|||
|
|||
OUT_DIR="${BLE_LOG_DIR:-./ble_logs}" |
|||
|
|||
usage() { |
|||
# 打印文件头部的注释块（到第一个非注释行为止） |
|||
awk 'NR==1 {next} /^#/ {sub(/^# ?/, ""); print; next} {exit}' "$0" |
|||
exit "${1:-0}" |
|||
} |
|||
|
|||
die() { echo "错误: $*" >&2; exit 1; } |
|||
|
|||
ts() { date +%Y%m%d_%H%M%S; } |
|||
|
|||
need() { command -v "$1" >/dev/null 2>&1 || die "未找到命令 $1，请先安装"; } |
|||
|
|||
# 生成输出文件路径 |
|||
out_file() { |
|||
mkdir -p "$OUT_DIR" |
|||
echo "$OUT_DIR/$1_$(ts).log" |
|||
} |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
# Android 实时抓取 |
|||
# --------------------------------------------------------------------------- |
|||
cmd_android() { |
|||
local keyword_only=0 all_history=0 outfile="" |
|||
while [[ $# -gt 0 ]]; do |
|||
case "$1" in |
|||
-k|--keyword) keyword_only=1; shift ;; |
|||
-a|--all) all_history=1; shift ;; |
|||
-o|--out) outfile="$2"; shift 2 ;; |
|||
*) die "未知参数 $1" ;; |
|||
esac |
|||
done |
|||
|
|||
need adb |
|||
adb get-state >/dev/null 2>&1 || die "adb 没有连接到设备（adb devices 检查一下）" |
|||
|
|||
[[ -z "$outfile" ]] && outfile="$(out_file android)" |
|||
|
|||
# 只保留关心的 TAG，其余全部静音（*:S） |
|||
local specs=() |
|||
for t in "${ANDROID_TAGS[@]}"; do specs+=("$t:V"); done |
|||
specs+=("AndroidRuntime:E" "*:S") |
|||
|
|||
echo "==> 抓取 Android 日志，落盘: $outfile" |
|||
echo " TAG: ${ANDROID_TAGS[*]}" |
|||
[[ $keyword_only -eq 1 ]] && echo " 模式: 仅通话翻译关键词" |
|||
echo " Ctrl+C 结束" |
|||
echo |
|||
|
|||
# -T 1 表示从当前时刻开始，避免历史日志刷屏；-a 则抓取缓冲区里的全部历史 |
|||
local head_args=(-v threadtime) |
|||
[[ $all_history -eq 0 ]] && head_args+=(-T 1) |
|||
|
|||
adb logcat -c 2>/dev/null || true |
|||
if [[ $keyword_only -eq 1 ]]; then |
|||
adb logcat "${head_args[@]}" "${specs[@]}" \ |
|||
| grep --line-buffered -E "$CT_PATTERN" \ |
|||
| tee "$outfile" |
|||
else |
|||
adb logcat "${head_args[@]}" "${specs[@]}" | tee "$outfile" |
|||
fi |
|||
} |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
# iOS 实时抓取 |
|||
# 真机优先用 idevicesyslog（libimobiledevice，brew install libimobiledevice） |
|||
# 模拟器 / 本机用 log stream |
|||
# --------------------------------------------------------------------------- |
|||
cmd_ios() { |
|||
local keyword_only=0 use_sim=0 outfile="" |
|||
while [[ $# -gt 0 ]]; do |
|||
case "$1" in |
|||
-k|--keyword) keyword_only=1; shift ;; |
|||
--sim) use_sim=1; shift ;; |
|||
-o|--out) outfile="$2"; shift 2 ;; |
|||
*) die "未知参数 $1" ;; |
|||
esac |
|||
done |
|||
|
|||
[[ -z "$outfile" ]] && outfile="$(out_file ios)" |
|||
echo "==> 抓取 iOS 日志，落盘: $outfile" |
|||
echo " Ctrl+C 结束" |
|||
echo |
|||
|
|||
local filter_cmd=(cat) |
|||
[[ $keyword_only -eq 1 ]] && filter_cmd=(grep --line-buffered -E "$CT_PATTERN") |
|||
|
|||
if [[ $use_sim -eq 1 ]]; then |
|||
# 模拟器 / 本机：按 subsystem + 进程名过滤 |
|||
log stream --style syslog --level debug \ |
|||
--predicate "subsystem == \"$IOS_SUBSYSTEM\" OR process == \"Runner\"" \ |
|||
| "${filter_cmd[@]}" | tee "$outfile" |
|||
elif command -v idevicesyslog >/dev/null 2>&1; then |
|||
# 真机：idevicesyslog 最稳，能同时拿到 os_log 和 Dart print |
|||
idevicesyslog -m "" 2>/dev/null \ |
|||
| grep --line-buffered -E "ble_service|BleService|Runner|flutter|$CT_PATTERN" \ |
|||
| "${filter_cmd[@]}" | tee "$outfile" |
|||
else |
|||
echo "提示: 未安装 idevicesyslog，真机日志建议 brew install libimobiledevice" >&2 |
|||
echo " 现在退回 log stream（新版 macOS 对真机支持受限，若无输出请用 Console.app）" >&2 |
|||
echo >&2 |
|||
log stream --style syslog --level debug \ |
|||
--predicate "subsystem == \"$IOS_SUBSYSTEM\" OR process == \"Runner\"" \ |
|||
| "${filter_cmd[@]}" | tee "$outfile" |
|||
fi |
|||
} |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
# 拉取 app 内的 Dart 日志文件（Logger 写的 app_YYYY-MM-DD*.log） |
|||
# --------------------------------------------------------------------------- |
|||
cmd_pull_android() { |
|||
need adb |
|||
adb get-state >/dev/null 2>&1 || die "adb 没有连接到设备" |
|||
|
|||
local dest="$OUT_DIR/dart_android_$(ts)" |
|||
mkdir -p "$dest" |
|||
|
|||
# getApplicationDocumentsDirectory() → /data/data/<pkg>/app_flutter |
|||
local remote_dir="app_flutter/logs" |
|||
echo "==> 从 $APP_ID 拉取 $remote_dir → $dest" |
|||
|
|||
local files |
|||
files="$(adb exec-out run-as "$APP_ID" ls "$remote_dir" 2>/dev/null)" || { |
|||
die "run-as 失败。release 包不可调试，请改用 debug/profile 包，或让 app 提供日志导出入口" |
|||
} |
|||
[[ -z "$files" ]] && die "设备上没有日志文件（app 可能还没初始化 Logger）" |
|||
|
|||
while IFS= read -r f; do |
|||
[[ -z "$f" ]] && continue |
|||
echo " - $f" |
|||
adb exec-out run-as "$APP_ID" cat "$remote_dir/$f" > "$dest/$f" |
|||
done <<< "$files" |
|||
|
|||
echo |
|||
echo "完成: $dest" |
|||
ls -lh "$dest" |
|||
} |
|||
|
|||
cmd_pull_ios() { |
|||
need xcrun |
|||
local dest="$OUT_DIR/dart_ios_$(ts)" |
|||
mkdir -p "$dest" |
|||
|
|||
local udid |
|||
udid="$(xcrun devicectl list devices 2>/dev/null | awk '/connected/ {print $(NF-1); exit}')" |
|||
[[ -z "$udid" ]] && die "未找到已连接的 iOS 设备（xcrun devicectl list devices 检查一下）" |
|||
|
|||
echo "==> 从设备 $udid 拉取 Documents/logs → $dest" |
|||
xcrun devicectl device copy from \ |
|||
--device "$udid" \ |
|||
--domain-type appDataContainer \ |
|||
--domain-identifier "$APP_ID" \ |
|||
--source "Documents/logs" \ |
|||
--destination "$dest" \ |
|||
|| die "拉取失败。备选方案：Xcode → Window → Devices and Simulators → 选中 app → Download Container" |
|||
|
|||
echo "完成: $dest" |
|||
ls -lh "$dest" |
|||
} |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
# 离线过滤 / 统计 |
|||
# --------------------------------------------------------------------------- |
|||
cmd_filter() { |
|||
local f="${1:-}" |
|||
[[ -f "$f" ]] || die "用法: $0 filter <日志文件>" |
|||
grep -E "$CT_PATTERN" "$f" |
|||
} |
|||
|
|||
cmd_stat() { |
|||
local f="${1:-}" |
|||
[[ -f "$f" ]] || die "用法: $0 stat <日志文件>" |
|||
|
|||
echo "=========== 通话翻译日志速览: $f ===========" |
|||
echo |
|||
echo "-- 关键事件计数 --" |
|||
local -a keys=( |
|||
'通话翻译指令下发' |
|||
'音频下行发送' |
|||
'下行写入拥塞' |
|||
'下行写入已恢复' |
|||
'音频发送队列已满' |
|||
'声道积压缓存超上限' |
|||
'收到左声道恢复指令' |
|||
'收到右声道恢复指令' |
|||
'心跳连续未发出' |
|||
'连接参数' |
|||
'连接断开' |
|||
) |
|||
for k in "${keys[@]}"; do |
|||
printf ' %-24s %s\n' "$k" "$(grep -c -- "$k" "$f" 2>/dev/null || true)" |
|||
done |
|||
|
|||
echo |
|||
echo "-- 设备流控（休眠/恢复配对）--" |
|||
local sleep_n resume_n |
|||
sleep_n="$(grep -cE '休眠|SLEEP_LEFT|SLEEP_RIGHT|0xF0|0xF1' "$f" 2>/dev/null || true)" |
|||
resume_n="$(grep -cE '恢复左声道|恢复右声道|0xF2|0xF3' "$f" 2>/dev/null || true)" |
|||
echo " 休眠(F0/F1) = $sleep_n 恢复(F2/F3) = $resume_n" |
|||
if [[ "$sleep_n" -gt "$resume_n" ]]; then |
|||
echo " ⚠️ 休眠多于恢复 $((sleep_n - resume_n)) 次 —— resume 指令可能在拥塞时丢了，" |
|||
echo " 声道会一直卡在休眠态，这正是「怎么都不恢复」的典型形态，重点看最后一次休眠的时刻。" |
|||
fi |
|||
|
|||
echo |
|||
echo "-- 下行发送节拍 Δ 分布（正常应贴近配置的发送间隔）--" |
|||
grep -o 'Δ=[0-9]\+ms' "$f" 2>/dev/null | grep -o '[0-9]\+' | awk ' |
|||
{ n++; s+=$1; if($1>max) max=$1; |
|||
if($1<=50) b1++; else if($1<=100) b2++; else if($1<=300) b3++; |
|||
else if($1<=1000) b4++; else b5++ } |
|||
END { |
|||
if (n==0) { print " （没有匹配到「音频下行发送」行，先确认日志已打开）"; exit } |
|||
printf " 样本=%d 均值=%.1fms 最大=%dms\n", n, s/n, max |
|||
printf " <=50ms: %d 51-100ms: %d 101-300ms: %d 301-1000ms: %d >1s: %d\n", |
|||
b1+0, b2+0, b3+0, b4+0, b5+0 |
|||
if (b4+b5 > 0) print " ⚠️ 存在 >300ms 的发送空档，对照同一时刻的拥塞/休眠日志看是哪一类原因" |
|||
}' |
|||
|
|||
echo |
|||
echo "-- 积压水位变化（hold(L=..,R=..)，持续上涨即为发不出去）--" |
|||
grep -o 'hold(L=[0-9]\+,R=[0-9]\+)' "$f" 2>/dev/null | tail -20 || true |
|||
|
|||
echo |
|||
echo "-- 最后 15 条拥塞/丢包告警 --" |
|||
grep -E '下行写入拥塞|音频发送队列已满|声道积压缓存超上限|心跳连续未发出' "$f" 2>/dev/null | tail -15 || true |
|||
echo |
|||
} |
|||
|
|||
# --------------------------------------------------------------------------- |
|||
main() { |
|||
local sub="${1:-}" |
|||
[[ $# -gt 0 ]] && shift |
|||
case "$sub" in |
|||
android) cmd_android "$@" ;; |
|||
ios) cmd_ios "$@" ;; |
|||
pull-android) cmd_pull_android "$@" ;; |
|||
pull-ios) cmd_pull_ios "$@" ;; |
|||
filter) cmd_filter "$@" ;; |
|||
stat) cmd_stat "$@" ;; |
|||
-h|--help|help|"") usage 0 ;; |
|||
*) echo "未知子命令: $sub" >&2; usage 1 ;; |
|||
esac |
|||
} |
|||
|
|||
main "$@" |
|||
Loading…
Reference in new issue