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

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

プラットフォームアナリティクスヘルスチェックユーティリティは、以下の3つのヘルスチェックをすべて実行します。起動時に行う稼働状態の確認処理エンドツーエンドのテレメトリチェックにより、データが Intelligence Server によって生成され、Platform Analytics Consumer (Telemetry Store) によって消費されることを確認します。

Linuxを使用している場合、Platform Analytics Health Check Utilityは次の場所にあります。 /opt/MicroStrategy/PlatformAnalytics/bin。Windowsをお使いの場合は、次の場所にあります。 C:\Program Files (x86)\MicroStrategy\Platform Analytics\bin。

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

エンドツーエンドのプラットフォーム分析ヘルスチェックを実行するには、プラットフォーム分析ヘルスチェック。(sh/bat)ユーティリティ。

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

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

ヘルスチェック

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

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

ヘルスチェックレポートには、必要な権限とその付与状況の一覧が載っています。すべてのチェックが成功した場合、最終行には次のように表示されます。倉庫のヘルスチェックの結果は正常です。

いずれかの行に失敗した、確認してくださいPAコンシューマ構成.yamlファイルを確認し、データベースに適切な権限があることを確認します。

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

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

権限の不足

データベースユーザーがPAコンシューマ構成.yaml設定ファイルに権限がない場合、 INFO [権限の種類] 権限: 失敗。管理者が該当する権限を当該データベースユーザーに付与した後、コンシューマーを再起動してください。

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

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 を再起動します。

接続の失敗

コンシューマまたはプロデューサが、 PAコンシューマ構成.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

のPAコンシューマ構成.yamlファイルは、インストール時に提供されたデータベース情報に基づいて作成されます。このエラーを解決するには、Platform Analyticsをホストしているマシンに接続し、ウェアハウスデータベース接続見出しは正しいPAコンシューマ構成.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 Metadata Producerのデータベースユーザーを作成するときは、必要とする句。

SSL を無効にする手順:

Platform Analytics Repository に接続し、次のコマンドを実行します。
コピー
```
show variables like '%ssl%';
```
結果が'SSL あり'は'はい' SSL が有効になります。ユーザーを作成するにはmysql_ネイティブパスワードそして何も要求しない SSL なしで接続するオプション。
コピー
```
CREATE USER 'test'@'%' IDENTIFIED WITH mysql_native_password BY 'password' REQUIRE NONE;
```

Redis の稼働状況

Redis については、コンシューマー/プロデューサーが Redis サーバーに接続できるか否かを確認します。レポートには、起動時に収集した、Redis に関する詳しい統計情報が載っています。すべてのチェックが成功した場合、最終行には次のように表示されます。 Redis サーバーのヘルスチェックの結果は正常です。

チェックでエラーが表示された場合は、Redisが実行中であることと、 PAコンシューマ構成.yamlファイル。

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

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

Redis が停止

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

Redis への接続不可

コンシューマーまたはプロデューサーがRedisに接続できない場合は、 PAコンシューマ構成.yamlファイル。このエラーを解決するには、Platform Analyticsをホストしているマシンに接続し、 redis接続見出しは正しいPAコンシューマ構成.yamlファイル。

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

停止するプラットフォーム分析アッシャールックアッププロデューサー次のコマンドを使用します。
コピー
```
./platform-analytics-usher-lookup-producer.sh stop
```
停止するプラットフォーム分析消費者次のコマンドを使用します。
コピー
```
./platform-analytics-consumer.sh stop
```
Redis サーバーを停止します。
redis.conf ファイルに次の変更を適用します。
1. 以下の3行をコメントアウトします。 ###スナップショット###見出し。
  コピー
```
#save 900 1
#save 300 10
#save 60 10000
```
2. 同じセクションで、次の行を入力します。
  コピー
```
save ""
```
Redis サーバーを起動します。
開始するプラットフォーム分析消費者次のコマンドを使用します。
コピー
```
./platform-analytics-consumer.sh start
```
開始するプラットフォーム分析アッシャールックアッププロデューサー次のコマンドを使用します。
コピー
```
./platform-analytics-usher-lookup-producer.sh start
```

Redis のパスワード認証が有効

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

Redisがパスワード認証で有効になっており、パスワードがPAコンシューマ構成.yaml構成ファイルが正しくない場合、コンシューマーまたはプロデューサーは Redis に接続できなくなります。このエラーを解決するには、以下の手順に従ってください。MicroStrategy Telemetry Cache に対するパスワード認証の有効化。

Kafka の稼働状況

Kafka については、Telemetry Manager (Apache Zookeeper) および Telemetry Server (Kafka Server) が稼働しており接続されているか否かを確認します。すべてのチェックが成功した場合、最終行には次のように表示されます。 Kafka クラスターのヘルスチェックの結果は正常です。

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 Producer が Mstr.PlatformAnalytics.ChangeJournal.CubesReportsDashboard Kafka トピックにログを生成したかどうかを確認します。その後、ログが処理されて Platform Analytics ウェアハウステーブルの lu_object に書き込まれたかどうかをテストします。

レコードが適切なKafkaトピックとウェアハウスの両方に見つかった場合、最終行は次のようになります。変更ジャーナルのヘルスチェックの結果は正常です。

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

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

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

Command Manager を使用して Intelligence Server に接続します。
次のコマンドを実行して、機能フラグのステータスを表示します。
コピー
```
LIST ALL FEATURE FLAGS;
```
結果では、プラットフォーム分析のためのメッセージングサービス機能フラグはの上。機能フラグがオフ次のコマンドを実行してオンにします。
コピー
```
ALTER FEATURE FLAG "Messaging Service for Platform Analytics" ON;
```
ステータスを表示するにはテレメトリサーバーが有効プロパティで、次のコマンドを実行します。
コピー
```
LIST PROPERTIES FOR SERVER CONFIGURATION;
```
結果では、テレメトリサーバーが有効プロパティは次のように設定されています真実。プロパティが間違い以下のコマンドを実行します。

交換する<kafka サーバー 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 がインストールされているフォルダーに移動します。
```
<Install>/PlatformAnalytics/bin
```
次のコマンドを実行します。
コピー
```
./platform-analytics-consumer.sh status
```
次のコマンドでサーバーを起動または再起動します。
コピー
```
./platform-analytics-consumer.sh start
```

サーバーを再起動しても問題が解決しない場合は、以下のログを確認してください。<インストール>/PlatformAnalytics/log/platform-analytics-consumer.logまたは、MicroStrategyテクニカルサポートに連絡してフォルダを添付してください。<インストール>/プラットフォーム分析/ログあなたのケースに。

Windows の場合:

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

統計の稼働状況

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

レコードが適切なKafkaトピックとウェアハウスの両方に見つかった場合、最終行は次のようになります。統計ヘルスチェックの結果は正常です。

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

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

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

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

<Project Name> はお使いのプロジェクトの名前に置き換えてください。
コピー
```
LIST ALL PROPERTIES FOR PASTATISTICS IN PROJECT "<Project Name>";
```
結果で、プロパティ「基本統計」が次のように設定されていることを確認します。真実。設定されている場合間違い以下のコマンドを実行します。

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

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

Linux の場合:

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

Windows の場合:

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

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