要捕获的公共标识符
请勿将供应商任务 ID、供应商 URL、供应商标识符、Redis 键或敏感执行元数据存储为面向客户的记录。
记录内容
记录足够的信息以诊断请求而不泄露机密：- 端点、HTTP 方法、模型、状态码、时间戳和延迟。
- 公共标识符：
request_id、task_id、poll_url和billing_transaction_id（如存在）。 - 清理后的请求形状：哪些字段存在，而不是完整的提示或私有媒体内容。
- 终端异步状态响应，包括公共错误字段。
- 客户端重试计数以及重试是否创建了新任务或恢复了现有任务。
Authorization、API 密钥、管理令牌、签名 URL、私有媒体 URL、完整提示和用户个人数据。
故障排除矩阵
使用对账
使用管理 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 的重复创建尝试。
- 采样已完成的作业，并验证用户可见资产、使用记录和存储的任务记录是否一致。