Clay デバッグバンドル

概要

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

前提条件

• Clay SDK がインストール済み
• アプリケーションログへのアクセス権
• 環境情報の収集が可能な権限

手順

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

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

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

echo "=== Clay 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 "CLAY_API_KEY: ${CLAY_API_KEY:+[SET]}" >> "$BUNDLE_DIR/summary.txt"

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

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

# Recent logs (redacted)
grep -i "clay" ~/.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.clay.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"

出力

• clay-debug-YYYYMMDD-HHMMSS.tar.gz アーカイブに含まれるもの:
  • summary.txt - 環境情報と SDK の情報
  • logs.txt - 最近のマスク済みログ
  • config-redacted.txt - 設定（機密情報は削除済み）

エラーハンドリング

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

例

機密データの取り扱い

必ずマスクすること:

• API キーとトークン
• パスワードと機密情報
• PII（メールアドレス、名前、ID）

含めても安全:

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

サポートへの提出

1. バンドルを作成: bash clay-debug-bundle.sh
2. 機密データの有無を確認
3. Clay サポートポータルにアップロード

リソース

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

次のステップ

レート制限の問題については、clay-rate-limits を参照してください。