BLACKSHIELD

公开指南

故障排查与平台限制

快速解决常见的摄取、身份验证和吞吐量问题具有可重复的故障排除流程。 受众: 租户管理员、DevOps团队和扫描仪操作员. 典型配置时长: 10-15分钟.

开始之前

  • 收集失败的作业ID、时间戳、扫描仪类型和目标上下文。
  • 确认扫描器使用的 API 密钥状态和环境变量值。
  • 在重新运行摄取之前验证扫描仪输出格式。

分步说明

步骤 1

首先检查身份验证和访问

大多数摄取失败都是凭据或权限问题，因此首先验证这些问题。

  • 确认 API 密钥处于活动状态、范围正确且未过期。
  • 验证API URL、工作区上下文和环境变量
  • 确认用户对任何 UI 触发的操作的权限。

步骤 2

验证有效负载格式和元数据

格式错误的有效负载和丢失的元数据通常会导致摄取延迟或跳过记录。

  • 在提交之前验证扫描仪输出格式。
  • 包括用于定期扫描的稳定重复数据删除密钥。
  • 使用作业状态详细信息来识别解析、验证或处理错误。

步骤 3

调整吞吐量和升级

在已知限制内进行操作，并在问题持续存在时根据完整的上下文进行升级。

  • 随着时间的推移分散大量扫描，以避免摄取峰值。
  • 使用指数退避重试来处理短暂的网络故障。
  • E通过工作区 ID、作业 ID 和时间戳来升级重复出现的故障。

成功检查

  • 识别根本原因类别（身份验证、有效负载或吞吐量）。
  • E升级票证包括快速支持分类所需的所有诊断。
故障排查与平台限制 | BlackShield Docs