Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

安装宽带边缘事件收集和可视化

总结 本节介绍宽带边缘事件收集和可视化的安装过程和系统要求。

宽带边缘 (BBE) 事件收集和可视化是一款事件收集应用程序,旨在与瞻博网络的 BBE 云应用程序(如瞻博网络 BNG CUPS 控制器和地址池管理器 (APM))配合使用。

BBE 事件收集和可视化收集系统日志事件并将其记录在时间序列数据库中。您可以通过 BBE 事件收集和可视化仪表板查看记录的事件。BBE 事件收集和可视化仪表板是一个基于 GUI 的可视化工具,使您能够根据定义的过滤器(可以在特定时间范围内)查看记录的事件。仪表板还提供了强大的搜索和可视化工具,您可以通过这些工具关联来自多个来源(例如,来自 APM 或 Kubernetes 集群)的重新编码事件。

.

开始之前

在开始安装和运行 BBE 事件收集和可视化之前,请确保您具有以下各项:

  • 有权下载 BBE 事件收集和可视化软件包的 juniper.net 用户帐户。

  • 运行 Ubuntu 22.04 LTS(需要或更高版本)以运行 ecav 安装的 Linux 主机(跳转主机)。跳转主机必须具有以下内容:

    • CPU 核心数 - 2

    • 内存 - 8 GB

    • 磁盘空间 - 128 GB 可用磁盘存储空间

    • 已安装 Python 3 虚拟环境

    • 有权访问 Kubernetes 群集的用户登录名

    • 对 Docker Hub (docker.io) 的外部访问,用于提取部署 BBE 事件收集和可视化所需的开源容器映像。

  • 群集必须至少具有三个工作器节点(虚拟机或物理机)。节点是运行 Ubuntu 22.04 LTS(或更高版本)的 Linux 系统,具有管理地址和域名。节点必须满足以下系统要求:

    • CPU 内核 - 8(首选超线程)

    • 内存 - 64 GB

    • 磁盘空间 - 根分区中 512 GB 的可用磁盘存储空间

安装宽带边缘事件收集和可视化

总结 使用此过程安装 BBE 事件收集和可视化。

在开始之前,请确认您满足 BBE 事件收集和可视化安装的要求。

注意:

请参阅 BBE Cloudsetup 安装指南,了解有关安装 BBE Cloudsetup 设施和构建 Kubernetes 集群的说明。如果在 期间ecav setup [--bbecloudsetup]使用该选项,bbecloudsetup则所有默认值都与 BBE 云设置一致。如果不将bbecloudsetup选项与 一起使用setup,则在启动 BBE 事件收集和可视化安装时需要具有以下信息:

  • Kubernetes 注册表位置
  • 注册表名称
  • 注册表端口

安装 BBE 事件收集和可视化应用程序

  1. 从瞻博网络软件下载页面下载 BBE 事件收集和可视化软件包,并将其保存到跳转主机。

    BBE 事件收集和可视化以压缩压缩包映像 (.tgz) 的形式提供。文件名包含版本号作为名称的一部分。版本号的格式为:<主要>.<次要>.<维护>

    • major 是产品的主要版本号。
    • minor 是产品的次要版本号。
    • maintenance 是修订号。
  2. 通过输入以下内容,解压缩跳转主机上的 BBE 事件收集和可视化压缩包 (.tgz) 文件:
    注意:

    BBE 事件收集和可视化文件解压缩到 bbe-ecav 目录中。

  3. 解压缩包后运行加载程序脚本。
  4. 使用sudo -E ecav link --context context-name --version ecav-version命令链接到群集。该link命令将加载的 BBE 事件收集和可视化软件包关联到群集,以准备设置。
    • context-name— Kubernetes 上下文名称(群集名称)。

    • ecav-version—BBE 事件收集和可视化软件版本。

  5. 如果您使用的是安全注册表(例如,由 BBE Cloudsetup 创建的群集),请以系统用户身份(BBE Cloudsetup 群集配置文件中提供的系统和用户信息)向群集的注册表传输地址(在 BBE Cloudsetup 群集配置文件中作为系统地址提供的 FQDN)颁发 docker 登录名,从而向注册表进行身份验证。
  6. 运行setup以配置安装。如果您使用 BBE Cloudsetup 构建集群,则可以将--bbecloudsetup选项添加到命令中setup,以接受注册表、logStash 服务和 OpenSearchDB 复制计数的默认值。在设置过程中,您需要输入以下信息:
    • 用于访问 BBE 事件收集和可视化仪表板的 URL。输入 BBE 云设置使用的系统地址的 DNS 名称。

    • 管理密码(长度必须至少为 8 个字符,并且必须至少包含一个大写字母、一个小写字母、一个数字和一个特殊字符)。

    • context-name— Kubernetes 上下文名称(群集名称)。

    • bbecloudsetup— 使用 BBE Cloudsetup 创建 Kubernetes 群集时使用的默认值。

    setup 命令收集有关群集环境的信息,例如容器注册表的位置、入口 URL、OpenSearch 复制计数等。

  7. 验证 BBE 事件收集和可视化安装 ecav version --context context-name --detail
    • context-name— Kubernetes 上下文名称(群集名称)。

启动宽带边缘事件收集和可视化

总结 使用此过程启动 BBE 事件收集和可视化。

  1. 输入rollout以启动 BBE 事件收集和可视化安装。BBE 事件收集和可视化实用程序允许您为 BBE 事件收集和可视化中的所有微服务推出不同的软件版本。您需要将rollout命令与 sudo 一起使用为根。该rollout命令还会验证新版本所需的所有值是否存在,并将新版本容器映像加载到注册表。用于sudo -E ecav rollout --context contextName [--version software-release] 启动 BBE 事件收集和可视化服务。例如:
    • context-name— Kubernetes 上下文(群集名称)。

  2. 输入ecav status --detail --context context-name 以验证 BBE 事件收集和可视化服务是否已启动并正在运行。例如:
    • context-name— Kubernetes 上下文(群集名称)。

    注意:

    收集服务的日志,并在发生以下任一情况时联系瞻博网络技术援助中心 (JTAC):

    • 服务未运行。

    • 与其他服务相比,该服务的正常运行时间表明它已重新启动。

使用宽带边缘事件收集和可视化仪表板

您可以使用 BBE 事件收集和可视化仪表板搜索日志或生成报告。这些报告对于生成问题报告和常规调试非常有用。

有关宽带边缘事件收集和可视化仪表板的详细信息,请参阅 OpenSearch 文档 https://opensearch.org/docs/2.9/dashboards/quickstart/

建立要显示的索引模式

若要开始使用 BBE 事件收集和可视化仪表板,必须首先建立仪表板要显示的索引模式。

要建立索引模式,请执行以下操作:

  1. 登录到您在 BBE 事件收集和可视化安装过程中设置的 BBE 事件收集和可视化仪表板访问权限的 URL。要登录,请使用您在 BBE 事件收集和可视化设置期间提供的管理用户名和密码。
  2. 建立仪表板要显示的索引模式。
    注意:

    我们建议您先安装并推出 BBE 应用程序,以便索引模式具有要匹配的事件。仅当至少有一个索引要匹配时,才能创建索引模式。

    1. 登录后,您将看到从添加数据开始页面出现。在“开始添加数据”页上,选择“自行浏览”。
    2. 在“选择租户”页中,选择“专用”单选按钮,然后单击“确认”。此时将显示“BBE 事件收集和可视化”仪表板。
    3. 从下拉菜单(仪表板窗口左上角的三条 3 条水平线)中,选择“管理”>“仪表板管理”。此时将显示“仪表板管理”页面。
    4. 在“仪表板管理”页上,选择“索引模式”。此时将显示“索引模式”页。
    5. 在索引模式页面上,单击位于页面右侧的创建索引模式按钮。
    6. “步骤 1:定义索引模式”页中,在“索引模式名称”框中输入字符串logstash-bbe-ecav*,然后单击“下一步”按钮。
      注意:

      星号 (*) 通配符使您能够匹配多天的索引模式。

    7. “步骤 2:配置设置”页中,选择@timestamp“时间字段”下拉框,然后单击“创建索引模式”按钮。
    8. 使用下拉菜单导航回“发现”页面。将显示为 BBE 应用程序生成的所有日志。
    注意:

    仅当至少有一个索引匹配时,才能创建索引模式。

如何更改时间范围

您可以更改要在“发现”页面中显示的信息的时间范围。“发现”页是显示日志信息的位置。
要更改显示的事件信息的时间范围:
  1. 在“BBE 事件收集和可视化”仪表板上,单击“发现”,将显示“发现”页。
  2. 在“发现”页面上,单击位于页面右上角的日历图标。此时将显示时间范围选择器框。
  3. 时间范围选择器框中,选择要显示信息的时间范围,然后单击应用。所选时间范围的信息将显示在“发现”页面中。

如何自定义事件输出

您可以自定义要在“发现”页面中显示的信息。“发现”页是显示日志信息的位置。
要自定义事件输出:
  1. 在“BBE 事件收集和可视化”仪表板上,单击“发现”,将显示“发现”页。
  2. 在“发现”页面的左侧,所有可用字段都列在“可用字段”字段下。
  3. 要在“发现”页面中显示信息,请单击要添加的字段旁边的加号图标。该字段将与该字段的相应信息一起添加到“发现”页面。
    注意:

    我们建议您从添加以下字段开始:

    • 时间

    • host.hostname

    • process.name

    • 消息

如何创建报告

您可以保存并下载“发现”页面中显示的信息。“发现”页是显示日志信息的位置。
要创建报告:
  1. 在“BBE 事件收集和可视化”仪表板上,单击“发现”,将显示“发现”页。
  2. 在“发现”页上,单击顶部菜单中的“保存”。将出现“保存搜索”对话框。
  3. 标题字段中,输入已保存搜索的名称,然后单击保存。保存的搜索的名称将显示在“发现”页面(左上角)中。
  4. 保存搜索后,在顶部菜单中,点击报告。此时将显示“生成和下载”对话框。
  5. 选择“生成 CSV”。报告将下载为 CSV 文件。

如何使用 DQL 搜索搜索事件

在 BBE 事件收集和可视化仪表板中,可以使用仪表板查询语言 (DQL) 搜索事件。您可以使用通配符并创建筛选器来搜索特定事件信息。

有关使用 DQL 的详细信息,请参阅 OpenSearch 文档 https://opensearch.org/docs/2.9/dashboards/discover/dql/

要使用 DQL 搜索搜索事件信息,请执行以下操作:
  1. 在“BBE 事件收集和可视化”仪表板上,单击“发现”,将显示“发现”页。
  2. 在“发现”页上,将要查找的信息输入到“DQL 搜索”字段(位于页面左上角)中。确保为搜索字段选择了 DQL
  3. 如果需要,您还可以创建筛选器以用于搜索要查找的信息。选择“添加筛选器”。将出现“编辑筛选器”对话框。
  4. 使用“编辑过滤器”对话框自定义过滤器,然后单击“保存”。“发现”页根据 DQL 搜索显示您的信息。