设备监视

您可以将 Prometheus 与 Grafana 结合使用来监视中的设备 Digital Lab，并在问题出现时立即识别问题。您的角色不允许使用权限执行开源组件分析。要启动当前可用于监视的扫描度量标准包括设备连接状态、热状态、Android 电池运行状况、可用磁盘空间、设备 WiFi 连接状态和信号强度以及设备温度。

安装 Prometheus

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

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

后退到顶部

配置为 Digital Lab 与 Prometheus 集成

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

UFT Digital Lab: 

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

ValueEdgeDigital Lab:

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

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

  1. 在连接器上启用 Prometheus。

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


    操作系统 默认位置
    Windows C:\Program Files\UFT Digital Lab 连接器 \connector\conf\metrics-config.properties
    Linux  /opt/UFTDigitalLab/connector/conf/metrics-config.properties

  2. 设置环境变量。

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

  3. 重新启动连接器。

    操作系统 详细信息
    Windows

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

    服务 DL 重新启动

后退到顶部

配置 Prometheus

  1. 开启 thePrometheus server ,open theprometheus.ymlfile for editing.
  2. 添加要收集度量的作业。

    Digital Lab 许可证详细信息
    UFT Digital Lab

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

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

    ValueEdgeDigital Lab

     

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


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

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

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

  4. 验证 Prometheus 集成。
    1. 打开 the Prometheus web interface.默认端口为 9090。
    2. 选择状态 > 目标，并确保已添加 Digital Lab 目标且状态为启动。

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

后退到顶部

Prometheus Digital Lab 度量

下表描述了 Digital Lab 由 Prometheus 监视的度量:

名称 公制 值
设备连接

mc_console_tenant_< >_device_< >_connectedGauge

当监视服务器级别的规格时，仅适用于 UFT Digital Lab。

服务器上的设备连接状态。此规格指示设备是否已打开并已连接到 UFT Digital Lab 服务器。

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

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

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

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

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

设备电池运行状况

mc_connector_device_< >_batteryHealthGauge gauge

Androidonly。

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 并连接到 Digital Lab

以下步骤介绍如何安装和配置 Grafana 以使用 Digital 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. 导入预配置的 Digital Lab 仪表板。
    1. 下载 Dashboard
      UFT Digital Lab 24.2: Grafana 控制面板。
      UFT Digital Lab 23.4: Digital Lab Grafana 控制面板。
    2. 要将文件导入 Grafana，请选择创建 > 导入 > 上载 .json 文件。上载 the UFTDigitalLab json.file，然后单击导入.

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

现在，可以从 Grafana 监视 UFT Digital Lab 度量。