デバイスの監視

PrometheusとGrafanaを併用すると、OpenText Functional Testing Labのデバイスを監視し、問題が発生したらすぐに特定できます。現在監視に使用できる指標は、デバイスの接続ステータス、i熱状態、Androidのバッテリーの状態、ディスクの空き容量、デバイスのWiFi接続のステータスと信号強度、デバイスの温度です。

Prometheusをインストールする

次の手順では、WindowsにPrometheusをインストールして構成し、OpenText Functional Testing Labで動作するようにする方法について説明します。Prometheusのインストール、構成、および使用の詳細については、Prometheusのドキュメントを参照してください。

PrometheusのWebサイトからWindowsのPrometheusをダウンロードします。
prometheus.exeファイルを実行します。
Prometheusが常に自動的に起動するようにするには、次のようにWindowsサービスとして実行します。
1. 最新のNSSMビルドをダウンロードして解凍します。NSSMを使用すると、通常の実行可能ファイルをWindowsサービスとして作成できます。
2. 次のコマンドを実行して、サービスを追加します。
  nssm.exe install Prometheus <path to prometheus.exe>
  なお、本サービスは起動時にnssm.exeファイルを使用しますので、サービス追加後にファイルを移動したり削除したりしないでください。

トップに戻る

ラボとPrometheusの統合を構成する

メトリクスは、サーバーレベルで、または特定のコネクターに対して一元的に収集できます。

OpenText Functional Testing Lab:

サーバーレベルでデバイスを監視することをお勧めします。接続されているすべてのコネクターのメトリクスをサーバーレベルで一元管理するには、[管理設定] > [一般] でPrometheusとの統合を有効にします。

OpenText Core Software Delivery Platform OpenText Functional Testing Lab:

オンプレミスコネクターのメトリクスを収集できます。

コネクターからメトリクスを収集するには:

コネクターでPrometheusを有効にします。

OpenText Functional Testing Labコネクターでmetrics-config.propertiesファイルを開いて編集します。METRICS_PROMETHEUS_ENABLEの値をtrueに設定して保存します。

OS	デフォルトの場所
Windows	C:\Program Files\Functional Testing Lab for Mobile and Web Server Connector\connector\conf\metrics-config.properties
Linux	/opt/FunctionalTestingLabForMobileAndWeb/connector/conf/metrics-config.properties

環境変数を設定します。

OS	詳細
Windows	METRICS_PROMETHEUS_ENABLEという名前のシステム変数を追加し、値をtrueに設定します。
Linux	<path to installation folder>/server/conf/setenv_common.sh (デフォルトは/opt/FunctionalTestingLabForMobileAndWeb/server/conf/setenv_common.sh) を開いて編集し、次の行を追加します。 `export METRICS_PROMETHEUS_ENABLE=true`

コネクターを再起動します。

OS	詳細
Windows	デスクトップのOpenText Functional Testing Labフォルダーにあるショートカットを使用します。
Linux	service DL restart

トップに戻る

Prometheusを構成する

Prometheusサーバーで、prometheus.ymlファイルを開いて編集します。

メトリクスを収集するジョブを追加します。

ライセンス	詳細
OpenText Functional Testing Lab	メトリクスをサーバーレベルで一元管理することをお勧めします。サーバーメトリクスを収集するには、すべてのリモートコネクターからのメトリクスを含む次のジョブを追加します。 - job_name: 'FunctionalTestingLabForMobileAndWeb _metrics_central_management' scrape_interval: 5s metrics_path: /rest/prometheus scheme: <http/https> static_configs: - targets: ['<FunctionalTestingLabForMobileAndWeb_server_address>:<FunctionalTestingLabForMobileAndWeb_server_port>']
OpenText Functional Testing Lab OpenText Core Software Delivery Platform	コネクターのメトリクスを収集するには、次のジョブをscrape_configsセクションに追加します。 - job_name: 'FunctionalTestingLabForMobileAndWeb_remote_connector_metrics'' scrape_interval: 5s metrics_path: /hp4m-connector/rest/prometheus scheme: <http/https> static_configs: - targets: ['<FunctionalTestingLabForMobileAndWeb_remote_connector_address>:<FunctionalTestingLabForMobileAndWeb_remote_connector_port>']

ライセンス

詳細

OpenText Functional Testing Lab

メトリクスをサーバーレベルで一元管理することをお勧めします。

サーバーメトリクスを収集するには、すべてのリモートコネクターからのメトリクスを含む次のジョブを追加します。
- job_name: 'FunctionalTestingLabForMobileAndWeb _metrics_central_management'
scrape_interval: 5s
metrics_path: /rest/prometheus
scheme: <http/https>
static_configs:
- targets: ['<FunctionalTestingLabForMobileAndWeb_server_address>:<FunctionalTestingLabForMobileAndWeb_server_port>']

OpenText Functional Testing Lab

OpenText Core Software Delivery Platform

コネクターのメトリクスを収集するには、次のジョブをscrape_configsセクションに追加します。
- job_name: 'FunctionalTestingLabForMobileAndWeb_remote_connector_metrics''
scrape_interval: 5s
metrics_path: /hp4m-connector/rest/prometheus
scheme: <http/https>
static_configs:
- targets: ['<FunctionalTestingLabForMobileAndWeb_remote_connector_address>:<FunctionalTestingLabForMobileAndWeb_remote_connector_port>']

SSL接続のみ。自己署名証明書を使用してOpenText Functional Testing Labへの安全な接続を使用する場合、Prometheusが信頼できるように、証明書をWindowsマシンにインポートする必要があります。
1. OpenText Functional Testing Lab証明書をエクスポートします。
  たとえばChromeを使用して、ラボコンソールに移動します。[保護されていない通信] またはアドレスバーの鍵のアイコンをクリックし、証明書を表示することを選択します。詳細タブに移動し、ファイルにコピーを選択します (デフォルトを使用)。
2. Prometheusマシンで、ローカルマシンと信頼されたルート証明機関の証明書ファイルをインストールすることを選択します。
3. Windowsサービスコンソールを開き、Prometheusサービスを再起動します。サービスの起動に失敗した場合は、コマンドラインからprometheus.exeファイルを実行してエラーを確認してください。
Prometheusの統合を確認します。
1. Prometheus Webインターフェイスを開きます。デフォルトのポートは9090です。
2. Status > Targetsを選択し、OpenText Functional Testing Labターゲットが追加され、状態がUpであることを確認してください。
3. Graph > scrape_samples_scrapedメトリクスを選択して実行します。ターゲットがサンプルを公開していること、およびOpenText Functional Testing Labジョブの要素の値が0より大きいことを確認してください。

トップに戻る

Prometheusのメトリクス

次の表では、Prometheusによって監視されるOpenText Functional Testing Labのメトリクスについて説明します。

名前	メトリクス	値
デバイスの接続	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を設定してラボに接続する

次の手順では、OpenText Functional Testing Labで動作するようにGrafanaをインストールして構成する方法について説明します。Grafanaのインストール、構成、および使用の詳細については、Grafanaのドキュメントを参照してください。

GrafanaのWebサイトからWindowsのGrafanaをダウンロードしてインストールします。
Grafana confフォルダーで、sample.ini構成ファイルをコピーし、新しいファイルの名前をcustom.iniに変更します。デフォルトでは、confファイルは次の場所にあります。C:\Program Files\GrafanaLabs\grafana\
Prometheusをデータソースとして追加します。
1. Grafana Webインターフェイスを開きます。デフォルトのポートは3000です。
2. ユーザー名: adminおよびパスワード: adminでログインします。
3. [Configuration] > [Data Sources] > [Add data source] > [Prometheus]を選択し、URLを入力します (例: http://localhost: 9090 (PrometheusとGrafanaを同じマシンで実行している場合))。
4. Save & Testをクリックします。
Grafanaは、さまざまなタイプの通知をサポートしています。メール通知を受信するには、SMTP (メール) サーバーをcustom.iniファイルに追加します。

例: [smtp]

enabled = true

host = smtp.swinfra.net:25

from_address = grafana@opentext.com

from_name = Grafana
Grafanaに通知チャネルを追加します。custom.iniファイルでSMTPを定義した場合、通知にメールを使用できます。
1. [Alerting] > [Notification channels] を選択します。[Add channel] をクリックします。
2. [Notification Channel] 画面で、名前 (Emailなど) を入力し、[Type] で [Email] を選択し、その他のオプションを優先として設定します。メールアドレスを入力し、[Save] をクリックします。
事前設定されたダッシュボードをインポートします。
1. Grafanaダッシュボードをダウンロードします。
2. ファイルをGrafanaにインポートするには、[Create] > [Import] > [Upload .json file] を選択します。lab json.ファイルをアップロードし、[Import] をクリックします。
通知チャネルを設定してアラート通知を受信したい場合は、インポートしたダッシュボードのグラフごとに、[Edit] > [Alert] > [Notifications] > [Send to] を選択します。チャネルを選択し、ダッシュボードを保存します。

GrafanaからOpenText Functional Testing Labメトリクスを監視できるようになりました。