Back to Details

posthog-debug-bundle

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PostHog Debug Bundle

PostHog调试包

Overview

概述

Collect all necessary diagnostic information for PostHog support tickets.
收集PostHog支持工单所需的全部诊断信息。

Prerequisites

前提条件

  • PostHog SDK installed
  • Access to application logs
  • Permission to collect environment info
  • 已安装PostHog SDK
  • 可访问应用日志
  • 拥有收集环境信息的权限

Instructions

操作步骤

Step 1: Create Debug Bundle Script

Step 1: 创建调试包脚本

bash
#!/bin/bash
bash
#!/bin/bash

posthog-debug-bundle.sh

posthog-debug-bundle.sh

BUNDLE_DIR="posthog-debug-$(date +%Y%m%d-%H%M%S)" mkdir -p "$BUNDLE_DIR"
echo "=== PostHog Debug Bundle ===" > "$BUNDLE_DIR/summary.txt" echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"
undefined
BUNDLE_DIR="posthog-debug-$(date +%Y%m%d-%H%M%S)" mkdir -p "$BUNDLE_DIR"
echo "=== PostHog Debug Bundle ===" > "$BUNDLE_DIR/summary.txt" echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"
undefined

Step 2: Collect Environment Info

Step 2: 收集环境信息

bash
undefined
bash
undefined

Environment info

Environment info

echo "--- Environment ---" >> "$BUNDLE_DIR/summary.txt" node --version >> "$BUNDLE_DIR/summary.txt" 2>&1 npm --version >> "$BUNDLE_DIR/summary.txt" 2>&1 echo "POSTHOG_API_KEY: ${POSTHOG_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"
undefined
echo "--- Environment ---" >> "$BUNDLE_DIR/summary.txt" node --version >> "$BUNDLE_DIR/summary.txt" 2>&1 npm --version >> "$BUNDLE_DIR/summary.txt" 2>&1 echo "POSTHOG_API_KEY: ${POSTHOG_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"
undefined

Step 3: Gather SDK and Logs

Step 3: 收集SDK与日志

bash
undefined
bash
undefined

SDK version

SDK version

npm list @posthog/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"
npm list @posthog/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"

Recent logs (redacted)

Recent logs (redacted)

grep -i "posthog" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"
grep -i "posthog" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"

Configuration (redacted - secrets masked)

Configuration (redacted - secrets masked)

echo "--- Config (redacted) ---" >> "$BUNDLE_DIR/summary.txt" cat .env 2>/dev/null | sed 's/=.*/=REDACTED/' >> "$BUNDLE_DIR/config-redacted.txt"
echo "--- Config (redacted) ---" >> "$BUNDLE_DIR/summary.txt" cat .env 2>/dev/null | sed 's/=.*/=REDACTED/' >> "$BUNDLE_DIR/config-redacted.txt"

Network connectivity test

Network connectivity test

echo "--- Network Test ---" >> "$BUNDLE_DIR/summary.txt" echo -n "API Health: " >> "$BUNDLE_DIR/summary.txt" curl -s -o /dev/null -w "%{http_code}" https://api.posthog.com/health >> "$BUNDLE_DIR/summary.txt" echo "" >> "$BUNDLE_DIR/summary.txt"
undefined
echo "--- Network Test ---" >> "$BUNDLE_DIR/summary.txt" echo -n "API Health: " >> "$BUNDLE_DIR/summary.txt" curl -s -o /dev/null -w "%{http_code}" https://api.posthog.com/health >> "$BUNDLE_DIR/summary.txt" echo "" >> "$BUNDLE_DIR/summary.txt"
undefined

Step 4: Package Bundle

Step 4: 打包调试包

bash
tar -czf "$BUNDLE_DIR.tar.gz" "$BUNDLE_DIR"
echo "Bundle created: $BUNDLE_DIR.tar.gz"
bash
tar -czf "$BUNDLE_DIR.tar.gz" "$BUNDLE_DIR"
echo "Bundle created: $BUNDLE_DIR.tar.gz"

Output

输出

  • posthog-debug-YYYYMMDD-HHMMSS.tar.gz
    archive containing: 
    • summary.txt
      - Environment and SDK info
    • logs.txt
      - Recent redacted logs
    • config-redacted.txt
      - Configuration (secrets removed)
  • posthog-debug-YYYYMMDD-HHMMSS.tar.gz
    归档文件包含： 
    • summary.txt
      - 环境与SDK信息
    • logs.txt
      - 近期脱敏日志
    • config-redacted.txt
      - 配置信息（已移除敏感内容）

Error Handling

错误处理

ItemPurposeIncluded
Environment versionsCompatibility check✓
SDK versionVersion-specific bugs✓
Error logs (redacted)Root cause analysis✓
Config (redacted)Configuration issues✓
Network testConnectivity issues✓
项用途是否包含
环境版本兼容性检查✓
SDK版本特定版本bug排查✓
脱敏错误日志根因分析✓
脱敏配置配置问题排查✓
网络测试连通性问题排查✓

Examples

示例

Sensitive Data Handling

敏感数据处理

ALWAYS REDACT:
  • API keys and tokens
  • Passwords and secrets
  • PII (emails, names, IDs)
Safe to Include:
  • Error messages
  • Stack traces (redacted)
  • SDK/runtime versions
必须脱敏的内容：
  • API密钥与令牌
  • 密码与机密信息
  • 个人身份信息（邮箱、姓名、ID）
可安全包含的内容：
  • 错误信息
  • 脱敏后的堆栈跟踪
  • SDK/运行时版本

Submit to Support

提交给支持团队

  1. Create bundle: 
    bash posthog-debug-bundle.sh
  2. Review for sensitive data
  3. Upload to PostHog support portal
  1. 创建调试包：
    bash posthog-debug-bundle.sh
  2. 检查是否包含敏感数据
  3. 上传至PostHog支持门户

Resources

相关资源

Next Steps

后续步骤

For rate limit issues, see 
posthog-rate-limits
.
若遇到速率限制问题，请查看
posthog-rate-limits
。