> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# バックエンドで詳細ログを表示してトラブルシューティングできますか？

> 管理者がトラブルシューティングを支援するために詳細ログを有効にする方法を学びます

## デフォルトのプライバシー保護ポリシー

プライバシーとセキュリティ上の理由から、APIYI はデフォルトではお客様の入力および出力コンテンツを**保存しません**。私たちは、リクエストを転送するための透明なプロキシとしてのみ動作します。

これは次のことを意味します:

* ✅ お客様のデータプライバシーが最大限に保護されます
* ✅ データ保存コストが削減されます
* ✅ データセキュリティのベストプラクティスに準拠しています
* ❌ 管理者バックエンドでは特定の会話内容を確認できません

## バッチ処理シナリオにおける課題

多くのお客様は、バッチ処理を実行する際に次のような不満を感じています:

<Warning>
  **典型的な問題シナリオ**

  「バックエンドにユーザー入力を含められますか？ そうでないと、バッチ処理中に、どの呼び出しがどのタスクに対応しているのか判別できません！」

  バッチ処理では、詳細な入出力記録がなければ、どの特定のタスクで問題が発生したのかを追跡するのは確かに困難です。
</Warning>

## 管理者支援によるトラブルシューティング

技術サポートの支援が必要な問題が発生した場合、管理者向けに詳細ログを**一時的に有効化**して、問題の診断に役立てることができます。

<Info>
  **重要なお知らせ**

  * この機能は**管理者バックエンド**でのみ有効化され、顧客側では制御できません
  * 詳細ログの内容は**管理者にのみ表示**され、顧客には公開されません
  * これは通常利用向けではなく、トラブルシューティング用の支援機能です
</Info>

### 有効化を依頼する方法

<Steps>
  <Step title="問題の詳細を添えてサポートへ連絡">
    カスタマーサービスのチャネル（Telegram、メールなど）を通じて問題の詳細を説明し、トラブルシューティングの支援を依頼してください
  </Step>

  <Step title="管理者による評価">
    技術サポート担当者が、問題の診断に詳細ログが必要かどうかを評価します
  </Step>

  <Step title="一時的な有効化">
    管理者がバックエンドで、お客様のアカウントのログ詳細記録を一時的に有効化します
  </Step>

  <Step title="支援付きトラブルシューティング">
    管理者が詳細ログを確認し、問題の特定と解決を支援します
  </Step>

  <Step title="機能の無効化">
    問題解決後、管理者が速やかに詳細ログを無効化します
  </Step>
</Steps>

### 管理者バックエンドのインターフェース

これは、管理者バックエンドのログ詳細制御インターフェースです（顧客はアクセスできません）:

<img className="block dark:hidden" src="https://mintcdn.com/apiyillc/yl72wP6yNQxQvIte/images/user-logs-control.png?fit=max&auto=format&n=yl72wP6yNQxQvIte&q=85&s=77b33464164d5bb3ea193e19f82cd402" alt="管理者バックエンドのログ詳細制御" width="1572" height="740" data-path="images/user-logs-control.png" />

<img className="hidden dark:block" src="https://mintcdn.com/apiyillc/yl72wP6yNQxQvIte/images/user-logs-control.png?fit=max&auto=format&n=yl72wP6yNQxQvIte&q=85&s=77b33464164d5bb3ea193e19f82cd402" alt="管理者バックエンドのログ詳細制御" width="1572" height="740" data-path="images/user-logs-control.png" />

## 詳細ログに含まれる内容

管理者が詳細ログを有効にすると、システムは追加で次を記録します:

<CardGroup cols={2}>
  <Card title="入力内容" icon="log-in">
    * ユーザーの完全なprompt
    * システムメッセージ
    * 会話履歴のコンテキスト
    * 関数呼び出しパラメータ
  </Card>

  <Card title="出力内容" icon="log-out">
    * AIモデルの完全な応答
    * 関数呼び出し結果
    * ストリーミング出力の全内容
    * 返されたメタデータ
  </Card>
</CardGroup>

<Warning>
  **プライバシーに関するお知らせ**

  これらの詳細ログは、技術的なトラブルシューティングを支援するために**管理者のみが閲覧可能**です。私たちは以下をお約束します:

  * この機能は必要な場合にのみ有効にする
  * 技術サポート目的にのみ使用する
  * 問題解決後は速やかに無効化する
  * お客様のデータプライバシーを厳重に保護する
</Warning>

## 適用シナリオ

### 推奨される依頼シナリオ

以下の状況では、サポートに連絡して管理者の支援を依頼してください:

* 🔍 **API Errors**: 明確な原因なく頻繁にエラーが発生する場合
* 📊 **Batch Task Anomalies**: 一部のバッチタスクが失敗し、特定の問題のあるリクエストを追跡する必要がある場合
* 🧪 **Output Quality Issues**: モデル出力が異常で、特定の入力/出力内容を分析する必要がある場合
* 📈 **Performance Issues**: 呼び出しのレイテンシーが異常で、ボトルネックを分析するために詳細ログが必要な場合
* 🐛 **Suspected Bugs**: システムの問題が疑われ、技術チームに詳細情報を提供する必要がある場合

### 有効化が不要な場合

詳細ログは通常、以下の状況では不要です:

* ✅ **Normal Usage**: API 呼び出しが異常なく正常に動作している場合
* ✅ **Common Issues**: 基本ログ（token 統計、エラー種別）だけで診断に十分な場合
* ✅ **Privacy Sensitive**: 極めて機微なデータを処理しており、誰にも閲覧されないようにしたい場合

## データセキュリティに関するお知らせ

<Info>
  **重要なお知らせ**

  一時的に詳細ログを有効にしている場合でも、以下を実施します。

  * ✅ 暗号化ストレージを使用してデータを保護します
  * ✅ ログへのアクセス権限を厳格に制限します（認可された管理者のみ）
  * ✅ 問題解決後、直ちに機能を無効化します
  * ✅ 期限切れのログデータを定期的に自動削除します
  * ✅ 関連するデータ保護規制を順守します
  * ✅ 詳細ログは第三者に開示しません
</Info>

## FAQ

### この機能を自分でバックエンドで有効化できますか？

いいえ。この機能は管理者バックエンドでのみ有効化でき、顧客側では操作できません。問題の切り分けで支援が必要な場合は、サポートにご連絡ください。

### 有効化後に詳細ログを確認できますか？

いいえ。詳細なログ内容は、技術サポートの目的で管理者にのみ表示されます。顧客が確認できるのは、基本的な呼び出し記録（token 統計、エラー種別など）のみです。

### 詳細ログを有効化するとパフォーマンスに影響しますか？

影響は最小限です。主に少量のログ書き込み時間が追加されるだけで、通常の利用には影響しません（通常 \< 10ms）。

### ログはどのくらい保持されますか？

詳細ログは、デフォルトで 7〜30 日間保持されます。管理者は問題解決後、速やかに記録を無効化します。

### 管理者は私のすべてのリクエスト内容を見ることになりますか？

詳細ログ期間中のリクエストのみが記録されます。管理者は、トラブルシューティングを支援する際に関連するログのみを確認し、機密保持契約を厳守します。

### 特定の期間だけログを記録できますか？

はい。問題の再現時のみ一時的に有効化するなど、特定の有効化期間についてサポートと調整できます。

## お問い合わせ

管理者の対応が必要な技術的な問題が発生した場合は、以下からご連絡ください。

<CardGroup cols={3}>
  <Card title="メールサポート" icon="mail">
    [feedback@apiyi.com](mailto:feedback@apiyi.com)

    問題の内容と再現手順を詳しくご記入ください
  </Card>

  <Card title="企業向けWeChat" icon="message-circle" href="https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec">
    <img src="https://mintcdn.com/apiyillc/fpi567ydpk7adDt0/images/wecom-qrcode.png?fit=max&auto=format&n=fpi567ydpk7adDt0&q=85&s=7286b96e94110e3a48798b649df1b45b" alt="企業向けWeChatのQRコード" style={{maxWidth: "180px"}} width="400" height="400" data-path="images/wecom-qrcode.png" />

    QRコードをスキャンするか、[サポートに連絡するにはここをクリック](https://work.weixin.qq.com/kfid/kfc9adfd5810ece25ec)

    迅速な対応、リアルタイムのコミュニケーション
  </Card>

  <Card title="Telegram" icon="send">
    @apiyi001

    即時メッセージで効率的に解決
  </Card>
</CardGroup>

<Tip>
  **効率的なトラブルシューティングのヒント**

  サポートにご連絡の際は、以下をご提供ください。

  * 問題が発生した期間
  * 影響を受けた API 呼び出しの件数
  * エラーメッセージまたは異常の説明
  * 再現可否と再現手順

  この情報があると、管理者が問題をより早く特定し、解決できます。
</Tip>