« 将 Synthetics 与流量过滤器一起使用 扩展和构建 Synthetics 部署 »
Elastic 文档 ›Elastic 可观测性 [8.16] ›应用程序和服务监控 ›合成监控

从 Elastic Synthetics 集成迁移

编辑

从 Elastic Synthetics 集成迁移

编辑

Elastic Synthetics 集成是创建合成监控的一种方法，现已不再推荐。

您不应使用 Elastic Synthetics 集成来设置新的监控，并且应制定计划将现有监控迁移到使用项目监控或Synthetics 应用程序。

  • 使用 Elastic 项目监控，您可以在外部版本控制的项目中编写测试，并使用 CLI 工具将监控推送到 Elastic Stack。
  • Synthetics 应用程序是 Kibana 中的一个应用程序，您可以使用它通过用户界面配置和创建监控。

比较方法

编辑

以下是您如何使用 Elastic Agent 集成创建监控以及您将如何使用 Synthetics 应用程序或项目创建监控的比较。

Elastic Agent 集成 项目或 Synthetics 应用程序

支持的监控

同时支持轻量级和浏览器监控

同时支持轻量级和浏览器监控

监控运行的位置 (阅读更多)

您必须在您的基础设施上运行监控。

您可以同时在以下位置运行监控

  • 使用私有位置 的您的基础设施
  • Elastic 的全球托管基础设施

您配置监控的位置

您可以使用以下方式配置监控

  • Kibana 中的用户界面（所有监控类型）
  • 外部版本控制项目中的代码（仅浏览器监控）

您可以使用以下方式配置监控

  • Kibana 中的用户界面（所有轻量级监控，通过内联脚本的浏览器监控）
  • 外部版本控制项目中的代码（所有监控类型）

如何使用项目 (阅读更多)
  1. 创建了一个使用@elastic/synthetics的项目。
  2. 在 JavaScript 或 TypeScript 文件中编写了旅程。
  3. 压缩了整个项目。
  4. 通过添加指向项目位置的 ZIP URL，在集成 UI 中配置并创建了监控。
  1. 创建一个使用@elastic/synthetics的项目。
  2. 在 YAML 文件中配置轻量级监控。
  3. 在 JavaScript 或 TypeScript 文件中编写旅程，并在旅程代码中使用monitor.use配置单个监控，或使用synthetics.config.ts文件配置所有监控。
  4. 使用elastic/synthetics push命令创建监控。

在使用项目监控中查找更多详细信息。

如何使用 UI (阅读更多)
  1. 转到 Kibana 中的集成页面。
  2. 搜索并添加Elastic Synthetics集成。
  3. 配置监控。
  4. 创建监控。
  1. 转到 Kibana 中的Synthetics。
  2. 转到管理。
  3. 点击创建监控。
  4. 配置监控。
  5. 创建监控。

在使用 Synthetics 应用程序中查找更多详细信息。

监控运行的位置

编辑

如果您希望继续在您的基础设施上托管，则需要在创建监控之前创建私有位置。如果您已经使用elastic-agent-complete运行了 Elastic Agent，则可以在 Synthetics 应用程序中将其添加为新的私有位置。要从头开始创建新的私有位置，请按照监控私有网络上的资源中的所有说明进行操作。

或者，您可以开始在 Elastic 的全球托管基础设施上托管。借助 Elastic 的全球托管测试基础设施，您可以在多个位置创建和运行监控，而无需管理自己的基础设施。Elastic 会为您处理软件更新和容量规划。

在 Elastic 的全球托管测试基础设施上执行合成测试会产生额外费用。测试根据监控类型在两个新的计费维度之一下收费。对于浏览器监控使用，每次测试运行都会收取费用。对于轻量级监控使用，无论测试运行次数多少，在您运行任何监控的每个区域都会收取费用。有关更多详细信息，请参阅完整详细信息和当前价格。

如何使用项目

编辑

如果您已经有一个通过 ZIP URL 添加的外部项目，则可以使用相同的项目，但您需要进行一些更改。

首先，升级现有项目以使用最新版本的@elastic/synthetics。

  1. 运行npm install -g @elastic/synthetics@latest以安装最新版本的 CLI。

  2. 升级现有项目以使用新的项目设置。

    1. 运行npm @elastic/synthetics init <path-to-existing-project>。

    2. 响应 CLI 提供的所有提示。

      为了确保您的项目能够与最新版本的 Elastic Synthetics 一起使用，CLI 将在init上创建一个新的配置文件，但您会看到一个提示，询问您是否希望在覆盖现有配置文件之前继续。

  3. 查看更新的文件和目录，包括

    1. journeys/将包含示例旅程代码。将现有旅程文件移动到此目录中。
    2. synthetics.config.ts将包含升级项目所需的更新的默认设置。

    3. package.json将包含项目的更新的 NPM 设置。

      如果您在运行init时目录中已经存在package.json文件，则 Synthetics 代理不会创建新的package.json文件。相反，它将修改现有的package.json文件以

      • 如果@elastic/synthetics库不存在，则将其添加到依赖项中。
      • 如果test和push脚本不存在，则添加它们。
    4. .github/将包含与 GitHub Actions 一起使用的示例工作流文件。

然后，您可以根据需要进一步配置监控。在升级的项目中，您将使用代码（而不是集成 UI）来定义设置，例如监控的名称以及它运行的频率。您可以使用代码配置监控的两种方法是

  • 对于单个监控，请直接在旅程代码中使用monitor.use。在配置单个监控中阅读更多内容。
  • 要一次配置所有监控，请使用 Synthetics 配置文件。在配置项目中阅读更多内容。

最后，您将使用push创建监控，而不是通过在集成 UI 中添加 ZIP URL 来创建。这需要 API 令牌。在@elastic/synthetics push中阅读更多内容。

或者，您还可以将轻量级监控添加到 YAML 文件中的项目中。在配置轻量级监控中阅读更多关于将轻量级监控添加到项目中的信息。

有关项目入门方面的更多信息，请参阅使用项目监控。

如何使用 UI

编辑

如果您仅通过 Elastic Synthetics 集成 UI 创建了监控，则可以在 Synthetics 应用程序中重新创建监控。

Synthetics 应用程序中的配置选项看起来与 Elastic Synthetics 集成 UI 非常相似，但有一些例外。在 Synthetics 应用程序中

  1. 您将为每个监控选择一个或多个位置。
  2. 您不能对浏览器监控使用 ZIP URL。请改用项目。
  3. 您可以在创建监控之前使用运行测试测试配置（包括浏览器监控的旅程）。

有关 Synthetics 应用程序入门方面的更多信息，请参阅使用 Synthetics 应用程序。

« 将 Synthetics 与流量过滤器一起使用 扩展和构建 Synthetics 部署 »