Groq デバッグバンドル

概要

Groq サポートチケット用に必要な診断情報をすべて収集します。

前提条件

• Groq SDK がインストール済み
• アプリケーションログへのアクセス
• 環境情報を収集する権限

手順

ステップ1: デバッグバンドルスクリプトの作成

#!/bin/bash
# groq-debug-bundle.sh

BUNDLE_DIR="groq-debug-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$BUNDLE_DIR"

echo "=== Groq Debug Bundle ===" > "$BUNDLE_DIR/summary.txt"
echo "Generated: $(date)" >> "$BUNDLE_DIR/summary.txt"

ステップ2: 環境情報の収集

# 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 "GROQ_API_KEY: ${GROQ_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"

ステップ3: SDK とログの収集

# SDK version
npm list @groq/sdk 2>/dev/null >> "$BUNDLE_DIR/summary.txt"

# Recent logs (redacted)
grep -i "groq" ~/.npm/_logs/*.log 2>/dev/null | tail -50 >> "$BUNDLE_DIR/logs.txt"

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

# 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.groq.com/health >> "$BUNDLE_DIR/summary.txt"
echo "" >> "$BUNDLE_DIR/summary.txt"

ステップ4: バンドルのパッケージ化

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

出力

• groq-debug-YYYYMMDD-HHMMSS.tar.gz アーカイブ（以下を含む）:
  • summary.txt - 環境情報と SDK 情報
  • logs.txt - 最近のマスク済みログ
  • config-redacted.txt - 設定情報（シークレット削除済み）

エラーハンドリング

項目	目的	含まれる
環境バージョン	互換性確認	✓
SDK バージョン	バージョン固有のバグ	✓
エラーログ（マスク済み）	根本原因の分析	✓
設定（マスク済み）	設定上の問題	✓
ネットワークテスト	接続問題	✓

例

機密データの処理

必ずマスクする:

• APIキーとトークン
• パスワードとシークレット
• PII（メール、名前、ID）

含めても安全:

• エラーメッセージ
• スタックトレース（マスク済み）
• SDK/ランタイムバージョン

サポートへの提出

1. バンドル作成: bash groq-debug-bundle.sh
2. 機密データがないか確認
3. Groq サポートポータルにアップロード

リソース

• Groq サポート
• Groq ステータス

次のステップ

レート制限の問題については groq-rate-limits をご覧ください。