设备监视

您可以结合 Grafana 和 Prometheus 监控实验室的设备，第一时间发现问题。您的角色不允许使用权限执行开源组件分析。要启动当前可用于监视的扫描度量标准包括设备连接状态、热状态、Android 电池运行状况、可用磁盘空间、设备 WiFi 连接状态和信号强度以及设备温度。

安装 Prometheus

以下步骤介绍如何在 Windows 上安装和配置 Prometheus 以使用OpenText Functional Testing Lab。有关安装、配置和使用 Prometheus 的完整详细信息，请参阅 Prometheus 文档。

  1. 从 Prometheus 网站下载适用于 Windows 的 Prometheus。
  2. 运行 prometheus.exe 文件。
    要确保 Prometheus 始终自动启动，请按如下方式将其作为 Windows 服务运行:
    1. 下载并解压缩最新的 NSSM 内部版本。NSSM 允许将常规可执行文件创建为 Windows 服务。
    2. 添加服务通过运行以下命令:
      nssm.exe install Prometheus <prometheus.exe 的路径>
      备注服务在启动时使用 nsm.exe 文件，因此请确保在添加服务后不移动或删除该文件。

后退到顶部

配置实验室与 Prometheus 的集成

可以在服务器级别集中收集规格，也可以为特定的连接器集中收集规格。

OpenText Functional Testing Lab: 

建议在服务器级别监视设备。要在服务器级别集中管理所有连接连接器的规格，请在“管理设置”&gt;“常规” 中启用与 Prometheus 的集成。

OpenText Core Software Delivery Platform Functional Testing Lab:

可以收集内部部署的连接器的规格。

要从连接器收集规格，请执行下列操作:

  1. 在连接器上启用 Prometheus。

    2. 开启OpenText Functional Testing Lab 连接器上，打开 metric - config .properties 文件进行编辑。将 METRICS_PROMETHEUS_ENABLE 的值设为 true 并保存。


    OS 默认位置
    Windows C:\Program Files\Functional Testing Lab for Mobile and Web Connector\connector\conf\metrics-config.properties
    Linux  /opt/FunctionalTestingLabForMobileAndWeb/connector/conf/metrics-config.properties

  2. 设置环境变量。

    OS 详细信息
    Windows 添加一个名为 METRICS_PROMETHEUS_ENABLE 的系统变量，并将该值设置为 true。
    Linux 打开<路到安装文件夹 >/server/conf/setenv_common.sh 编辑 (默认 /opt/FunctionalTestingLabForMobileAndWeb/server/conf/setenv_common.sh) 并添加下列行:
    export METRICS_PROMETHEUS_ENABLE = true

  3. 重新启动连接器。

    OS 详细信息
    Windows

    使用桌面上OpenText Functional Testing Lab 文件夹中的快捷方式。
    Linux

    service FTLab restart

后退到顶部

配置 Prometheus

  1. 在 Prometheus 服务器上，打开 prometheus.yml 文件进行编辑。
  2. 添加要收集度量的作业。

    许可证详细信息
    OpenText Functional Testing Lab

    建议在服务器级别集中管理度量。

    要收集服务器规格，请添加以下作业，其中包括来自所有远程连接器的规格:
    - job_name: ' FunctionalTestingLabForMobileAndWeb_metric_central_management '
    scrapper _ interval: 5 秒
    metrics _ path: /rest/prometheus
    方案: < http/https >
    static _ configs:
    - 目标: [' <FunctionalTestingLabForMobileAndWeb_server_address>: <FunctionalTestingLabForMobileAndWeb_server_port> ']

    OpenText Functional Testing Lab

     

    OpenText Core Software Delivery Platform

     

    要收集连接器的规格，请将以下作业添加到 scrap_configs 部分:
    - job_name: ' FunctionalTestingLabForMobileAndWeb_remote_connector_metrics''
    scrapper _ interval: 5 秒
    metrics _ path: /hp4m-connector/rest/prometheus
    方案: < http/https >
    static _ configs:
    - 目标: [' <FunctionalTestingLabForMobileAndWeb_remote_connector_address>: <FunctionalTestingLabForMobileAndWeb_remote_connector_port> ']


  3. 仅 SSL 连接。使用具有自签名证书的OpenText Functional Testing Lab 安全连接时，需要将证书导入到您的 Windows 计算机，以便 Prometheus 信任它:
    1. 导出 OpenText Functional Testing Lab 证书。
      例如，使用 Chrome，进入“实验室”控制台。单击不安全或地址栏中的锁图标，然后选择查看证书。了解详情复制到详细信息选项卡，然后选择复制到 file (使用默认值)。

    2. 开启的 Prometheus 计算机，选择安装证书文件的本地计算机和受信任的根证书颁发机构。

    3. 打开 Windows 服务控制台，然后重新启动 Prometheus 服务。如果服务无法启动，则从命令行运行 prometheus.exe 文件以查看错误。

  4. 验证 Prometheus 集成。
    1. 打开 Prometheus 网页界面。默认端口为 9090。
    2. 选择状态 > 目标，并确保已添加OpenText Functional Testing Lab 目标且状态为启动。

    3. 选择 Graph > scraid_samples_scraid 度量并执行。确保目标公开示例，并且OpenText Functional Testing Lab 作业元素的值大于 0。

后退到顶部

指标说明

下表描述了OpenText Functional Testing Lab 由 Prometheus 监视的度量:

名称 公制 值
设备连接

mc_console_tenant_< >_device_< >_connectedGauge

当在服务器级别监控指标时，仅适用于 OpenText Functional Testing Lab。

服务器上的设备连接状态。该指标表示设备是否打开，是否连接至 OpenText Functional Testing Lab 服务器。

1 = 已连接;0 = 已断开连接。

返回值 0 时，没有可用于其他设备规格的数据。
设备连接 mc_connector_device_< >_connectedGauge

来自连接器的设备连接状态。此规格指示设备是否已打开且可由连接器识别。

1 = 已连接;0 = 已断开连接。

返回值 0 时，没有可用于其他设备规格的数据。

设备电池运行状况

mc_connector_device_< >_batteryHealthGauge gauge

仅 Android。

1 = 未知;2 = 良好;3 = 过热;4 = 死;5 = 过电压;6 = 未指定的故障;7 = 冷。
设备可用磁盘空间

mc_connector_device_< >_freeDiskSpaceGauge 

以 GB 为单位测量。
设备 WiFi 连接

mc_connector_device_< >_wifiConnectedGauge

1 = 已连接;0 = 已断开连接。
设备 WiFi 强度

mc_connector_device_< >_wifiSignalStrengthGauge gauge

 整数 1 - 5。
5 表示最强信号。
设备热状态

mc_connector_device_< >_thermalStateGauge

iOS: 1 = 公称;2 = 公平;3 = 严重;4 = 严重。

Android: 0 = 无;1 = 灯光;2 = 中等;3 = 严重;4 = 严重，5 = 紧急;6 = 关闭。
设备温度

mc_connector_device_< >_temperatureGauge 

测量单位为摄氏度。

后退到顶部

配置 Grafana 服务并接入实验室

以下步骤介绍如何安装和配置 Grafana 以使用OpenText Functional Testing Lab。有关安装、配置和使用 Grafana 的完整详细信息，请参阅 Grafana 文档。

  1. 下载并从 Grafana 网站安装 Grafana for Windows。

  2. 在 Grafanaconf 文件夹中，复制 sample.ini 配置文件并将新文件重命名为 custom.ini。预留者默认值， conf 文件位于: C:\Program Files\GravenaLabs\grafana\。

  3. 添加作为数据源的 Prometheus。
    1. 打开 Grafana Web 界面。默认端口为 3000。
    2. 登录，用户名: admin 和密码: admin。
    3. 选择 Configuration > Data Sources > 添加 data source > Prometheus 并提供 URL (例如 http: //localhost: 如果在同一台计算机上运行 Prometheus 和 Grafana，则为 9090)。
    4. 单击保存和测试。

  4. Grafana 支持不同类型的通知。要接收电子邮件通知，请将 SMTP (邮件) 服务器添加到 custom.ini 文件。

    示例: [smtp]

    enabled = true

    host = smtp.swinfrag.net: 25

    from_address = grafana@opentext.com

    from _ name = Grafana

  5. 添加到 Grafana 的通知通道。如果在 custom.ini 文件中定义了 SMTP，则可以使用电子邮件通知。
    1. 选择警报 > 通知通道。单击添加 channel。
    2. 在“通知频道”屏幕中提供名称 (例如电子邮件)，为类型选择“电子邮件”，然后将其他选项设置为首选选项。输入电子邮件地址并单击保存。
  6. 导入预配置的仪表板。
    1. 下载Grafana Dashboard。
    2. 要将文件导入 Grafana，请选择创建 > 导入 > 上载 .json 文件。上载实验室 .fjson 文件并单击导入。

  7. 如果已配置通知通道并希望接收警报通知，则对于导入的仪表板中的每个图，选择编辑 > 警报 > 通知 > 发送到。选择通道并保存面板。

现在可以监控 Grafana 的测量标准了。