Granola Debug Bundle

Granola 调试包

Overview

概述

Collect comprehensive diagnostic information for Granola troubleshooting and support requests.

收集用于Granola故障排查和支持请求的全面诊断信息。

Prerequisites

前提条件

Administrator access on your computer
Granola installed (even if malfunctioning)
Terminal/Command Prompt access

电脑的管理员权限
已安装Granola（即使功能异常）
可访问终端/命令提示符

Instructions

操作步骤

Step 1: System Information

步骤1：系统信息

macOS

bash

undefined

bash

undefined

Create debug directory

mkdir -p ~/Desktop/granola-debug cd ~/Desktop/granola-debug

System info

sw_vers > system-info.txt system_profiler SPHardwareDataType >> system-info.txt system_profiler SPSoftwareDataType >> system-info.txt

Audio configuration

system_profiler SPAudioDataType > audio-config.txt

Display info

system_profiler SPDisplaysDataType > display-info.txt

undefined

system_profiler SPDisplaysDataType > display-info.txt

undefined

Windows

powershell

undefined

powershell

undefined

Create debug directory

mkdir $env:USERPROFILE\Desktop\granola-debug cd $env:USERPROFILE\Desktop\granola-debug

System info

systeminfo > system-info.txt

Audio devices

Get-WmiObject Win32_SoundDevice | Out-File audio-devices.txt

undefined

Get-WmiObject Win32_SoundDevice | Out-File audio-devices.txt

undefined

Step 2: Granola Logs

步骤2：Granola 日志

macOS

bash

undefined

bash

undefined

Granola application logs

cp -r ~/Library/Logs/Granola ./granola-logs 2>/dev/null

Application support data (no sensitive data)

ls -la ~/Library/Application\ Support/Granola/ > app-support-listing.txt

System logs related to Granola

log show --predicate 'process == "Granola"' --last 1h > system-logs.txt 2>/dev/null

undefined

log show --predicate 'process == "Granola"' --last 1h > system-logs.txt 2>/dev/null

undefined

Windows

powershell

undefined

powershell

undefined

Granola logs

Copy-Item "$env:LOCALAPPDATA\Granola\logs" -Destination ".\granola-logs" -Recurse

Application event logs

Get-EventLog -LogName Application -Source "Granola" -Newest 100 | Out-File app-events.txt

undefined

Get-EventLog -LogName Application -Source "Granola" -Newest 100 | Out-File app-events.txt

undefined

Step 3: Network Diagnostics

步骤3：网络诊断

bash

undefined

bash

undefined

Test Granola connectivity

curl -s -o /dev/null -w "%{http_code}" https://api.granola.ai/health > network-test.txt curl -s -o /dev/null -w "%{http_code}" https://granola.ai >> network-test.txt

DNS resolution

nslookup api.granola.ai >> network-test.txt 2>&1

Trace route (optional, may take time)

traceroute -m 10 api.granola.ai >> network-test.txt 2>&1

undefined

traceroute -m 10 api.granola.ai >> network-test.txt 2>&1

undefined

Step 4: Calendar Integration Status

步骤4：日历集成状态

bash

undefined

bash

undefined

Create calendar status report

cat > calendar-status.txt << 'EOF' Calendar Integration Checklist:

Calendar Provider: [Google/Outlook/Other]
Last Successful Sync: [Date/Time]
Connected Calendars: [List]
OAuth Token Status: [Valid/Expired/Unknown]
Permissions Granted: [Yes/No/Partial]

Recent Calendar Errors: [Copy any errors from Granola settings] EOF

undefined

cat > calendar-status.txt << 'EOF' Calendar Integration Checklist:

Calendar Provider: [Google/Outlook/Other]
Last Successful Sync: [Date/Time]
Connected Calendars: [List]
OAuth Token Status: [Valid/Expired/Unknown]
Permissions Granted: [Yes/No/Partial]

Recent Calendar Errors: [Copy any errors from Granola settings] EOF

undefined

Step 5: Audio Configuration Check

步骤5：音频配置检查

bash

undefined

bash

undefined

macOS audio test

cat > audio-check.txt << 'EOF' Audio Configuration Report

Default Input Device: $(system_profiler SPAudioDataType | grep "Default Input" | head -1)

Input Devices Available: $(system_profiler SPAudioDataType | grep -A5 "Input Source")

Audio Permissions:

Granola has microphone access: [Yes/No]
Other apps using microphone: [List]

Virtual Audio Software:

Loopback: [Installed/Not Installed]
BlackHole: [Installed/Not Installed]
Other: [Specify] EOF

undefined

cat > audio-check.txt << 'EOF' Audio Configuration Report

Default Input Device: $(system_profiler SPAudioDataType | grep "Default Input" | head -1)

Input Devices Available: $(system_profiler SPAudioDataType | grep -A5 "Input Source")

Audio Permissions:

Granola has microphone access: [Yes/No]
Other apps using microphone: [List]

Virtual Audio Software:

Loopback: [Installed/Not Installed]
BlackHole: [Installed/Not Installed]
Other: [Specify] EOF

undefined

Step 6: Create Debug Bundle

步骤6：创建调试包

bash

undefined

bash

undefined

Package all diagnostics

cd ~/Desktop zip -r granola-debug-$(date +%Y%m%d-%H%M%S).zip granola-debug/

echo "Debug bundle created: granola-debug-$(date +%Y%m%d-%H%M%S).zip" echo "Send this file to help@granola.ai"

undefined

cd ~/Desktop zip -r granola-debug-$(date +%Y%m%d-%H%M%S).zip granola-debug/

echo "Debug bundle created: granola-debug-$(date +%Y%m%d-%H%M%S).zip" echo "Send this file to help@granola.ai"

undefined

Debug Bundle Contents

调试包内容

File	Purpose
system-info.txt	OS and hardware details
audio-config.txt	Audio device configuration
granola-logs/	Application log files
network-test.txt	Connectivity diagnostics
calendar-status.txt	Calendar integration state
audio-check.txt	Microphone configuration

文件	用途
system-info.txt	操作系统和硬件详情
audio-config.txt	音频设备配置
granola-logs/	应用程序日志文件
network-test.txt	连接性诊断结果
calendar-status.txt	日历集成状态
audio-check.txt	麦克风配置

Output

输出结果

Comprehensive debug bundle zip file
Ready for submission to Granola support
Excludes sensitive data (transcripts, notes)

完整的调试包压缩文件
可直接提交给Granola支持团队
不包含敏感数据（如转录内容、笔记）

Privacy Considerations

隐私说明

The debug bundle does NOT include:

Meeting transcripts or notes
Personal calendar event details
API keys or tokens
Audio recordings

调试包不包含以下内容：

会议转录内容或笔记
个人日历事件详情
API密钥或令牌
音频录制文件

Submitting to Support

提交给支持团队

Email debug bundle to: help@granola.ai
Include:
- Description of issue
- Steps to reproduce
- When issue started
- Your Granola version
Reference any error codes displayed

将调试包发送至：help@granola.ai
附上：
- 问题描述
- 复现步骤
- 问题开始出现的时间
- 你的Granola版本
提及显示的任何错误代码

Self-Diagnosis Tips

自我诊断提示

Before contacting support, check:

markdown

undefined

联系支持团队前，请检查：

markdown

undefined

Quick Checks

快速检查

Granola is updated to latest version
Internet connection is stable
Microphone permissions granted
Calendar is connected
Sufficient disk space (> 1GB)
Antivirus not blocking Granola

undefined

Resources

Next Steps

下一步

Proceed to

granola-rate-limits

to understand usage limits.

可查看

granola-rate-limits

了解使用限制。

granola-debug-bundle

Original

Translation

Granola Debug Bundle

Granola 调试包

Overview

概述

Prerequisites

前提条件

Instructions

操作步骤

Step 1: System Information

步骤1：系统信息

macOS

macOS

Create debug directory

Create debug directory

System info

System info

Audio configuration

Audio configuration

Display info

Display info

Windows

Windows

Create debug directory

Create debug directory

System info

System info

Audio devices

Audio devices

Step 2: Granola Logs

步骤2：Granola 日志

macOS

macOS

Granola application logs

Granola application logs

Application support data (no sensitive data)

Application support data (no sensitive data)

System logs related to Granola

System logs related to Granola

Windows

Windows

Granola logs

Granola logs

Application event logs

Application event logs

Step 3: Network Diagnostics

步骤3：网络诊断

Test Granola connectivity

Test Granola connectivity

DNS resolution

DNS resolution

Trace route (optional, may take time)

Trace route (optional, may take time)

Step 4: Calendar Integration Status

步骤4：日历集成状态

Create calendar status report

Create calendar status report

Step 5: Audio Configuration Check

步骤5：音频配置检查

macOS audio test

macOS audio test

cat > audio-check.txt << 'EOF' Audio Configuration Report

cat > audio-check.txt << 'EOF' Audio Configuration Report

Step 6: Create Debug Bundle

步骤6：创建调试包

Package all diagnostics

Package all diagnostics

Debug Bundle Contents

调试包内容

Output

输出结果

Privacy Considerations

隐私说明

Submitting to Support

提交给支持团队

Self-Diagnosis Tips

自我诊断提示

Quick Checks