MicroStrategy ONE

起動時に行う稼働状態の確認処理

MicroStrategy 2019 リリースでは、サービス名をいくつか変更しました。このガイドでは、サービスの基盤となるファイルを修正する必要があるので、従来のサービス名を使って説明します。

Telemetry Store (旧 Platform Analytics Consumer) および Identity Telemetry Producer (旧 Usher Metadata Producer) は、次の 3 つのコンポーネントに依存します。テレメトリー ログを処理するためには、この 3 つにアクセスできなければなりません。

  • Platform Analytics Repository (実体はデータベース サーバー)
  • Telemetry Cache (Redis)
  • Telemetry Server (Kafka)

3 つすべてが正常に稼働していなければ、Platform Analytics はテレメトリー ログを処理できません。ひとつでも障害があると、Telemetry Store (コンシューマー) や Identity Telemetry (プロデューサー) は停止してしまいます。そこで、コンシューマー/プロデューサーは起動時に、上記コンポーネントの稼働状況を確認し、結果を詳細なレポートとしてまとめます。

確認処理が始まった時点で、いずれかのコンポーネントが起動処理中で、完全に稼働していないこともありえます。その場合、60 秒ごとに 3 回繰り返して稼働状況を確認するようになっています。

Platform Analytics のアーキテクチャについて詳しくは、Platform Analytics のアーキテクチャとサービスを参照してください。

レポート名と出力先

稼働状況の確認は、Platform Analytics ConsumerUsher Metadata Producer の両方が、起動時に実施します。したがってレポートも、次に示す Platform Analytics の log フォルダーに、それぞれ生成されることになります。

  • Linux: /opt/MicroStrategy/PlatformAnalytics/log
  • Windows:C:\Program Files (x86)\MicroStrategy\Platform Analytics\log

どちらが生成したレポートかは、ファイル名で区別できます。

次に例を示します。

コピー
platform-analytics-consumer-health-check-yyyymmddhhmmss.out
platform-analytics-usher-lookup-producer-health-check-yyyymmddhhmmss.out

稼働状況の確認結果のレポート

各レポートは次の 4 つのセクションから成ります。

  1. ヘルス チェック
  2. Redis の稼働状況
  3. Kafka の稼働状況
  4. 要約

各セクションには、3 つのコンポーネントそれぞれの確認結果が載っています。

ヘルス チェック

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

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

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

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

Redis の稼働状況

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

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

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 が稼働していることを確認してください。

要約

すべてのヘルス チェックに成功した場合、結果は passing。いずれかのチェックに失敗した場合、 FAIL 対応するコンポーネントについてです上記の詳細レポートをもとに、考えられる原因を調べてください。