キャプチャすべき公開識別子
プロバイダーのタスク ID、プロバイダー URL、プロバイダー識別子、Redis キー、または機密性の高い実行メタデータを顧客向け記録として保存しないでください。
ログに記録する内容
秘密を漏らさずにリクエストを診断するために十分な情報をログに記録してください：- エンドポイント、HTTPメソッド、モデル、ステータスコード、タイムスタンプ、レイテンシ。
- 公開識別子：
request_id、task_id、poll_url、およびbilling_transaction_idが存在する場合。 - サニタイズされたリクエスト形状：どのフィールドが存在したか、完全なプロンプトやプライベートメディアコンテンツではなく。
- ターミナル非同期ステータス応答、公開エラーフィールドを含む。
- クライアントの再試行回数と、再試行が新しいタスクを作成したか、既存のタスクを再開したか。
Authorization、APIキー、管理トークン、署名付きURL、プライベートメディアURL、完全なプロンプト、およびユーザーの個人データを常に削除してください。
トラブルシューティングマトリックス
使用の調整
サーバーサイドの調整にはManagement APIを使用してください：GET /v1/management/api-keys/{keyId}/usageはscene、model、modelVendor、startDate、およびendDateでフィルタリングできます。ダッシュボードページをスクレイピングしたり、上流プロバイダーのタスクIDに依存する代わりに、これらの記録を使用してください。
ストリーミング応答はストリームが送信された後に決済される場合があるため、使用が後で記録される場合でも請求ヘッダーが存在しないことがあります。非同期メディアタスクはターミナルポーリングの後に決済される場合があります。
サポートパケットテンプレート
サポートに連絡する際は、以下を含めてください：request_id。- 非同期作業のための
task_idとpoll_url。 - 存在する場合は
billing_transaction_id。 - エンドポイント、メソッド、モデル、タイムスタンプ、ステータスコード。
- サニタイズされたリクエスト形状と公開エラーボディ。
- あなたの期待する結果とユーザーが実際に見たもの。
操作チェック
- 繰り返しの
401、402、429、および5xx応答にアラートを出す；通常、異なるオーナーがいます。 - 製品SLAよりも長く非ターミナルのままの非同期ジョブを追跡します。
- 同じユーザージョブIDの重複作成試行を追跡します。
- 完了したジョブをサンプリングし、ユーザーが見えるアセット、使用記録、および保存されたタスク記録が一致することを確認します。