Synthetics 故障排除

对于本地调试合成测试，您可以设置一个环境变量 DEBUG=synthetics，在使用 Synthetics CLI 时捕获 Synthetics 代理日志。

如果您经历过以下工作流程，合成监控器将停止运行

发生这种情况的原因是，在 8.6.0 之前的版本中，单击 启用监控器管理 授予的权限在 8.8.0 及更高版本中不足。

要解决此问题，具有 管理员权限 的用户需要访问 Kibana 中的 Synthetics 应用程序。在 8.8.0 及更高版本中，当具有 管理员权限 的用户访问 Synthetics 应用程序时，会在后台自动完成“启用监控器管理”的等效操作。

如果 没有 管理员权限 的用户在管理员访问之前访问了 Synthetics 应用程序，则该用户将看到一条注释，指出“只有管理员可以启用此功能”。该注释将一直存在，直到管理员用户访问 Synthetics 应用程序。

如果您创建了一个私有位置，并配置了一个监控器在该私有位置上运行，但在 Synthetics 应用程序中没有看到该监控器的任何结果，请确保有一个代理配置为针对该代理策略运行。

在创建私有位置时，您必须

如果您没有完成第二项，则不会有任何代理配置为针对该代理策略运行，并且配置为在该私有位置上运行的任何监控器将无法运行，因此 Synthetics 应用程序中不会有任何结果。

要解决此问题，请确保有一个代理配置为针对该代理策略运行。

如果您已配置监控器，但在 Synthetics 应用程序中没有看到该监控器的任何结果，无论是从 Elastic 的全球托管测试基础设施运行还是从私有位置运行，请确保 Synthetics 与 Elasticsearch 有直接连接。

请勿配置任何摄取管道或通过 Logstash 输出，因为这将阻止 Synthetics 正常工作，并且不支持。

如果您有配置为在私有位置上运行的浏览器监控器，但注意到其中一个或多个未按计划运行，则可能是因为

您还可能会在日志中看到类似 2 个任务在过去 15 秒内错过了它们的计划截止时间超过 1 秒 的消息。这些将在 Agent 诊断 ZIP 文件中可见，并且您的日志中的数字和时间段可能有所不同。

首先确定问题的原因。首先，检查监控器运行所需的时间是否小于计划的频率

如果持续时间小于计划的频率，或者上述建议没有解决问题，则可能是因为有太多浏览器监控器尝试在私有位置上运行。由于运行浏览器监控器的额外硬件开销，我们将每个私有位置限制为只能同时运行两个浏览器监控器。根据您配置为在私有位置上运行的浏览器监控器的数量及其计划，私有位置可能无法运行所有监控器，因为它将需要同时运行两个以上的浏览器测试。

要解决此问题，您可以

使用 Elastic Cloud 时，如果您尝试在 Synthetics 应用程序中创建监控器时，位置下拉列表中没有可用的选项，或者当使用 location 命令时未列出任何位置，则可能是因为您没有使用 Elastic 托管位置的权限，并且还没有可用的 私有位置。

有几种方法可以解决此问题

如果您尝试创建或编辑托管在 Elastic 的全球托管基础设施上的监控器，但看到一条注释，指出您没有使用 Elastic 托管位置的权限，则管理员已限制使用公共位置。

要解决此问题，您可以

我们提供与众不同的支持体验。我们的专业团队讲人话和代码，并且喜欢让您的一天更美好。 了解有关订阅的更多信息。

对于其他问题和功能请求，请访问我们的讨论论坛。