Platform Analytics ヘルスチェックユーティリティー

Platform Analytics ヘルスチェックユーティリティーは、エンドツーエンドの稼働状況確認です。このユーティリティーは、プラットフォームのテレメトリーを生成、使用、レポートするのに必要な複数のコンポーネントにわたり、問題のトラブルシューティングを行います。このチェックは特に、いずれかのプロジェクトのレポートが Platform Analytics ウェアハウスにテレメトリーを提供していない場合に推奨されます。

Platform Analytics ヘルスチェックユーティリティーは起動時に行う稼働状態の確認処理で行う 3 種のチェックに加え、データが Intelligence Server によって生成可能で Platform Analytics Consumer (Telemetry Store) によって使用可能かどうかを確認するためのエンドツーエンドのテレメトリーチェックを実行します。

Linux を使用している場合、Platform Analytics Health Check ユーティリティは以下にあります。 /opt/MicroStrategy/PlatformAnalytics/bin。Windows を使用している場合、ファイルの場所は C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin。

Platform Analytics ヘルスチェックユーティリティーの実行方法

エンドツーエンドプラットフォームアナリティクスヘルスチェックを実行するには、 platform-analytics-health-check.(sh/bat) ユーティリティ。

Platform Analytics ヘルスチェックユーティリティーによって行われるエンドツーエンドのテレメトリーチェックには以下が含まれます。

ヘルスチェック
Redis の稼働状況
Kafka の稼働状況
変更履歴の稼働状況
統計の稼働状況

ヘルスチェック

ヘルスチェックについては次の 2 つの事項を確認します。

コンシューマー/プロバイダーは、インストール中に提供され、 PAConsumerConfig.yaml 構成ファイルですか?接続できない場合、問題の原因を診断するために追加のネットワーク接続テストが実行されます。
データベースユーザーが必要な権限を付与されているか。インストールに必要な前提条件については、Platform Analytics の前提条件を参照してください。

ヘルスチェックレポートには、必要な権限とその付与状況の一覧が載っています。すべてのチェックに成功すると、最終行は以下となります Warehouse health check result is healthy。

任意の行を読み取りましたか Failed、チェック PAConsumerConfig.yaml ファイルを作成し、データベースに正しい権限があることを確認します

ヘルスチェックに問題が見つかった場合の対処法

考えられる問題とその対処法を以下に示します。

権限の不足

データベースユーザーがに保存されている場合 PAConsumerConfig.yaml 構成ファイルに権限がありません。 INFO [privilege type] privilege: Failed。管理者が該当する権限を当該データベースユーザーに付与した後、コンシューマーを再起動してください。

権限を付与する手順を以下に示します。

Platform Analytics Consumer および Usher Metadata Producer をいったん停止します。
Platform Analytics Repository を収容するデータベースサーバーに接続します。次のコマンドを実行してください。ただし「someuser」と「somehost」は顧客が指定する情報で置き換えます。
コピー
```
GRANT DROP ON platform_analytics_wh.* TO ‘someuser’@‘somehost’;
```
Platform Analytics Consumer と Usher Metadata Producer を再起動します。

接続の失敗

コンシューマーまたは生産者が、で指定された構成を使用してデータベースに接続できない場合、 PAConsumerConfig.yaml 構成ファイルで次のエラーが表示される場合があります:

コピー

2018-11-21 21:43:28,793 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:45:31,797 INFO HealthCheck main - Failed to connect to the database. Retrying after waiting for 60 seconds.
2018-11-21 21:47:34,800 ERROR HealthCheck main - Failed to connect to the database using url:jdbc:mysql://XX.Y.Z.1:3306/platform_analytics_wh?rewriteBatchedStatements=true&useLegacyDatetimeCode=false&serverTimezone=UTC. Please double check your connection parameters.
Communications link failure

選択: PAConsumerConfig.yaml ファイルは、インストール中に指定されたデータベース情報に基づいて設定されます。このエラーを解決するには、Platform Analytics をホストしているマシンに接続し、 warehouseDbConnection ヘッダーは以下の中で正しいです PAConsumerConfig.yaml ファイル。

データベースユーザーのパスワードが不正

暗号化したウェアハウスのパスワードが正しくない場合、コンシューマー/プロデューサーはデータベースに接続できません。新しいパスワードに暗号化を施し、設定を更新する手順については、Platform Analytics Repository に設定した、データベースユーザーのパスワードの更新を参照してください。

SSL が有効な状態でデータベースユーザーを作成したことによるエラー

Platform Analytics は MySQL 5.6、5.7、8.0 の各版に対応しています。MySQL 8.0 の場合、SSL 接続がデフォルトで有効になっています。一方、Platform Analytics は現状、MySQL に対する SSL 接続に対応していません。Platform Analytics Consumer またはUsherメタデータプロバイダー用のデータベースユーザーを作成する際、SSL/TLS オプションを指定します。 REQUIRE 句。

SSL を無効にする手順:

Platform Analytics Repository に接続し、次のコマンドを実行します。
コピー
```
show variables like '%ssl%';
```
の結果が 'have_ssl' が 'YES' SSL が有効化されますでユーザーを作成 mysql_native_password および REQUIRE NONE SSL なしで接続するオプションもあります
コピー
```
CREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;
```

Redis の稼働状況

Redis については、コンシューマー/プロデューサーが Redis サーバーに接続できるか否かを確認します。レポートには、起動時に収集した、Redis に関する詳しい統計情報が載っています。すべてのチェックに成功すると、最終行は以下となります Redis server health check result is healthy。

チェックにエラーが表示された場合、Redis が実行されていること、およびの設定が正しいことを確認してください。 PAConsumerConfig.yaml ファイル。

Redis ヘルスチェックのトラブルシューティングの候補エラー

Redis で以下のエラーのいずれかを受信した場合ヘルスチェック。推奨回避策:

Redis が停止

コンシューマー/プロデューサーが Redis に接続できない原因として、Redis が停止していることが考えられます。その場合、MicroStrategy In-Memory Cache、Platform Analytics Consumer、Usher Metadata Producer を起動してください。

Redis への接続不可

コンシューマーまたは生産者が Redis に接続できない場合、構成が正しくないことが考えられます PAConsumerConfig.yaml ファイル。このエラーを解決するには、Platform Analytics をホストしているマシンに接続し、 redisConnection ヘッダーは以下の中で正しいです PAConsumerConfig.yaml ファイル。

Redis サーバーがディスクへのスナップショットの書き込みに失敗した可能性があります。その場合、Redis サーバーで RDP スナップショットプロセスを無効にすることができます。

の停止 platform-analytics-usher-lookup-producer 次のコマンドを使用します:
コピー
```
./platform-analytics-usher-lookup-producer.sh stop
```
の停止 platform-analytics-consumer 次のコマンドを使用します:
コピー
```
./platform-analytics-consumer.sh stop
```
Redis サーバーを停止します。
Redis.conf ファイルに以下の変更を適用します。
1. 次の 3 線をコメント化 ###SNAPSHOTTING### ヘッダー。
  コピー
```
#save 900 1
#save 300 10
#save 60 10000
```
2. 同じセクションで、以下の行を入力します。
  コピー
```
save ""
```
Redis サーバーを起動します。
開始 platform-analytics-consumer 次のコマンドを使用します:
コピー
```
./platform-analytics-consumer.sh start
```
開始 platform-analytics-usher-lookup-producer 次のコマンドを使用します:
コピー
```
./platform-analytics-usher-lookup-producer.sh start
```

パスワード認証を有効化エラー

コンシューマー/プロデューサーが Redis に接続できない原因として、パスワード認証が有効になっていることが考えられます。初期状態の Redis はパスワード認証が無効になっていますが、いつでも有効にすることができます。

Redis がパスワード認証で有効になっており、パスワードが PAConsumerConfig.yaml 構成ファイルであるため、コンシューマーまたは生産者は Redis に接続できなくなります。その場合、MicroStrategy Telemetry Cache に対するパスワード認証の有効化の手順に従って対処してください。

Kafka の稼働状況

Kafka については、Telemetry Manager (Apache Zookeeper) および Telemetry Server (Kafka Server) が稼働しており接続されているか否かを確認します。すべてのチェックに成功すると、最終行は以下となります Kafka cluster health check result is healthy。

Telemetry Server は Telemetry Manager に依存しているので、先に Telemetry Manager を起動する必要があります。

エラーが見つかった場合は、ZooKeeper および Kafka が稼働していることを確認してください。

Kafka に問題が見つかった場合の対処法

ZooKeeper サーバーがすべてのノードで実行されているかどうかを確認する方法

Linux では、次のコマンドを実行して PID を実行します。
コピー
```
ps ax | grep java | grep -i QuorumPeerMain | grep -v grep | awk '{print $1}'
```
Windows では、[サービス] ダイアログを開き、\"Apache ZooKeeper\" サービスが実行されているかどうか確認します。

Kafka サーバーがすべてのノードで実行されているかどうかを確認する方法

Linux では、次のコマンドを実行して PID を実行します。
コピー
```
ps ax | grep -i 'server.prop'| grep java | grep -v grep | awk '{print $1}'
```
Windows では、[サービス] ダイアログを開き、\"Apache Kafka\" サービスが実行されているかどうか確認します。

ZooKeeper と Kafka をすべてのノードで開始する方法

Linux では、Kafka ディレクトリで次のコマンドを実行します。

コピー

# Start Zookeeper on all nodes,
./zookeeper-server-start.sh -daemon ../config/zookeeper.properties
# Start Kafka on all nodes,
./kafka-server-start.sh -daemon ../config/server.properties

Windows では、[サービス] ダイアログを開き、Apache ZooKeeper と Apache Kafka を開始します。

ZooKeeper および Kafka の、複数のノードから成るクラスター化環境であれば、ZooKeeper の全ノードをまず起動してください。

変更履歴の稼働状況

変更履歴のヘルスチェックは、Platform Analytics Consumer が正常に稼働していることを確認します。このチェックでは、テスト対象のプロジェクト GUID とレポート GUID を提供する必要があります。レポートの説明を変更するようプロンプトが表示され、これにより変更履歴ログが生成されます。テストは、Intelligence Server プロバイダーが Mstr.PlatformAnalytics.変更ジャーニーキューブレポートダッシュボード Kafka トピックへのログを生成したかどうかを検証します。その後、ログが処理されて Platform Analytics ウェアハウステーブルの lu_object に書き込まれたかどうかをテストします。

記録が適切な Kafka トピックとウェアハウスの両方にある場合、最終行は読み取り Change Journal health check result is healthy。

チェックでエラーが見つかった場合、Intelligence Server で Messaging Service for Platform Analytics の機能フラグがオンであり、Intelligence Server で Telemetry Server のプロパティが True (有効) になっていることを確認します。

変更履歴の稼働状況に問題が見つかった場合の対処法

Intelligence Server が Kafka にテレメトリーを書き込むよう構成されているかの確認

Command Manager を使用して Intelligence Server に接続します。
次のコマンドを実行して、機能フラグのステータスを表示します。
コピー
```
LIST ALL FEATURE FLAGS;
```
結果で、以下を確認しますMessaging Service for Platform Analytics機能フラグはです有効。機能フラグが OFF の場合、次のコマンドを実行してオンにしてください。
コピー
```
ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;
```
のステータスを表示するにはTelemetry Server が有効化されていますプロパティ、コマンドを実行:
コピー
```
LIST PROPERTIES FOR SERVER CONFIGURATION;
```
結果で、以下を確認しますTelemetry Server が有効化されていますプロパティは以下に設定されています有効。プロパティが False に設定されている場合、次のコマンドを実行します。

置換 <kafka server IP> Kafka サーバーの IP アドレスに置き換えます
コピー
```
'ALTER SERVER CONFIGURATION ENABLEMESSAGINGSERVICES TRUE CONFIGUREMESSAGINGSERVICES "bootstrap.servers: <kafka server IP>:9092/batch.num.messages:5000/queue.buffering.max.ms:2000";
```
Intelligence Server を再起動します。

Platform Analytics Consumer が稼働中であることを確認します。

Linux の場合:

Platform Analytics がインストールされているフォルダーに移動します。
```
<インストール>/PlatformAnalytics/ビン
```
次のコマンドを実行します。
コピー
```
./platform-analytics-consumer.sh status
```
次のコマンドでサーバーを起動または再起動します。
コピー
```
./platform-analytics-consumer.sh start
```

サーバーの再起動でも問題が解決しない場合は、以下のログを確認してください。 <Install>/PlatformAnalytics/log/platform-analytics-consumer.log MicroStrategyテクニカルサポートにお問い合わせの上、フォルダーを添付 <Install>/PlatformAnalytics/log 次第です

Windows の場合:

Services.msc を使用して Windows の [サービス] ダイアログを開きます。
Telemetry Store を起動または再起動します。

統計の稼働状況

このヘルスチェックは、Platform Analytics Consumer がレポートの統計情報を処理できることを確認します。前の稼働状況確認のレポートを実行するようにプロンプトが表示されます。これにより、トピック Mstr.PlatformAnalytics.IsReportStats にログが生成されます。このヘルスチェックは、Intelligence Server Producer が Kafka にレコードを生成し、それが Platform Analytics ウェアハウスにあることを確認します。

記録が適切な Kafka トピックとウェアハウスの両方にある場合、最終行は読み取り Statistics health check result is healthy。

チェックでエラーが見つかった場合、プロジェクトで統計が有効になっており、メッセージサービスが正しく構成されていることを確認します。

統計の稼働状態に問題が見つかった場合の対処法

プロジェクトで統計が有効になっているかの確認

Command Manager を使用して Intelligence Server に接続します。
コマンドを実行:

<プロジェクト名> をプロジェクト名に置き換えます。
コピー
```
LIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";
```
結果で、Basic Statistics プロパティが True に設定されていることを確認します。False に設定されている場合、次のコマンドを実行します。

<プロジェクト名> をプロジェクト名に置き換えます。
コピー
```
ALTER PASTATISTICS BASICSTATS ENABLED DETAILEDREPJOBS TRUE DETAILEDDOCJOBS TRUE JOBSQL TRUE COLUMNSTABLES TRUE IN PROJECT "<Project Name>";
```
Intelligence Server を再起動します。

Platform Analytics Consumer が稼働中であることを確認します。

Linux の場合:

Platform Analytics がインストールされているフォルダーに移動します。
```
<インストール>/PlatformAnalytics/ビン
```
次のコマンドを実行します。
コピー
```
./platform-analytics-consumer.sh status
```
次のコマンドでサーバーを起動または再起動します。
コピー
```
./platform-analytics-consumer.sh start
```

Windows の場合:

Services.msc を使用して Windows の [サービス] ダイアログを開きます。
Telemetry Store を起動または再起動します。

Platform Analytics ヘルス チェック ユーティリティー