オンプレミス診断

[アーティクル]
06/19/2024

Microsoft Dynamics 365 は、最新式の Azure Diagnostic Tool を使用して、クラウドベースの顧客の機能を提供する Azure Services の正常性およびパフォーマンスを監視します。 Finance + Operations (オンプレミス) で実装し、オンプレミスソリューションの正常性とパフォーマンスを監視できるようにするには、いくつかのサードパーティ製品が利用可能です。

この記事では、Elastic スタックの設定とコンフィギュレーション、サードパーティ製品、およびオンプレミスソリューションの診断モニタリングを提供できる多くの選択肢の 1 つについて説明します。

診断ソリューションを検討する際、次の実装の基礎を検討してください。

診断システムは、30 日分に相当する診断情報を収集し、格納できる必要があります。
診断リポジトリは、多くのクライアントコンピューターで共有できるように中心的な場所に設定する必要があります。
イベントタイプ、分類、およびデータを含む構造化診断イベントを作成します。
未加工のテキスト (逆シリアル化) に格納されているイベントを簡単に照会および検索します。
イベントに機密情報や個人データを格納しないでください。

メモ

既定では、Elastic Stack クラスター内の通信は HTTPS 経由で送信されません。リスクを考慮し、それらのリスクの軽減策を準備または実装していない限り、Elastic スタックを設定しないでください。 X-Pack の支払済バージョンは、Elastic Stack のコミュニケーションを暗号化するために使用されます。設定の詳細については、クラスタでの TLS の設定を参照してください。オープンソース Elasticsearch プラグインもあります。ドキュメントによると、Microsoft はこのプラグインをテストしていませんが、HTTPS を有効にすることができます。 Microsoft では、HTTPs、VPN、または別のセキュリティで保護された、暗号化されたプロトコルを使用して、暗号化された通信を常に使用することをお勧めします。コンテンツにエンドユーザー、顧客、個人または機密データが含まれている場合、多くの業界認定および法律では、暗号化された送信を使用する必要があります。

診断データのガイドライン

Finance + Operations (オンプレミス) の配置と実行を診断するためには、診断データへのアクセスが必要です。クラウドの配置では、マイクロソフトは、サービスの診断データを保存して監視し、環境を健全に保ちます。オンプレミス配置に関しては、顧客がこのタスクを担当します。

使用したい診断データストアおよびクエリツールを選択することができます。ただし、最低限、ツールは、次のタスクを実行する必要があります。

ストアは、30 日間分の診断データを格納できます。
イベントが集約される場所に格納されると、サポートエンジニアは問題に関連するイベントを検索する複数のマシン間を切り替える必要がありません。
イベントは、イベントタイプおよびイベントデータに基づいて、発見が可能です。
イベントデータ (XML 形式) では、逆シリアル化すると、イベントデータを照会および移動が可能です。

Elastic スタックの例

前のセクションに表示されている診断データのガイドラインを満たすため、Microsoft は Elastic スタックの設定をテストしました。この設定には次のコンポーネントが含まれています。

Elasticsearch – ストレージ、イベントインデックス作成、およびイベントクエリの実行。 Elasticsearch の詳細については、Elastic Web サイトを参照してください。
Logstash – 負荷分散およびイベントデータ変換用。
Winlogbeat – 診断データ収集用。
Kibana – Elasticsearch に格納されているデータを照会するためのインタフェース。

メモ

既定では、Elastic Stack クラスター内の通信は HTTPS 経由で送信されないようになっています。リスクを考慮し、それらのリスクの軽減策を準備または実装していない限り、Elastic スタックを設定しないでください。 X-Pack の支払済バージョンは、Elastic Stack のコミュニケーションを暗号化するために使用されます。設定の詳細については、クラスタでの TLS の設定を参照してください。オープンソース Elasticsearch プラグインもあります。ドキュメントによると、Microsoft はこのプラグインをテストしていませんが、HTTPS を有効にすることができます。

Elastic スタックを展開する場合、この記事で説明されている手順を実行するなら異なる経験になるかもしれません。テストでは、Microsoft は、Elastic Stack コンポーネントのバージョン 6.2.3 と、Microsoft Dynamics 365 Finance 7.3 およびプラットフォーム更新プログラム 12 を使用しました。

この記事では、オンプレミス配置の動作のために Elastic スタックが必要な設定およびコンフィギュレーションの手順を、Microsoft がどのように処理したかについて説明します。 Finance + Operations (オンプレミス) に関連していないガイダンスについては、Elastic.co のドキュメントを参照してください。

Elastic スタックのインストールと構成

Winlogbeat を除くすべての Elastic スタックのホストされているコンポーネントはすべて Java 上で動作します。テストシナリオでは、Microsoft は最初に Elasticsearch、Logstash、または Kibana (つまり、すべてのオーケストレータノード) を実行する各ノードに、Java ランタイム環境 (JRE) 8 (64 ビット) の最新バージョンをダウンロードしてインストールしました。 https://www.oracle.com/technetwork/java/javase/downloads/index.html から Java 8 を取得することができます。

2018 年 6 月現在、Elastic スタックは Java 8 で実行します。 Java の新しいバージョンで実行しようとすると、すべてが動作しない可能性があります。

メモ

Linux では、Winlogbeat を除く、全体の Elastic Stack をホストできます。テストでは、Microsoft が Microsoft Windows サーバー 2016 の仮想マシン (Vm) のスタックをホストしました。

各ノード上のさまざまなコンポーネントのファイアウォールで、ポートを開くことを忘れないようにしてください。

設定中に行き詰まった場合、Elastic.co には Elastic スタックのインストールとコンフィギュレーションについての広範かつ適切なドキュメントがあります。特定のタイプのエラーについては、Web 検索で Elastic.co フォーラムと StackOverflow の両方から信頼性の高い結果が得られます。

コンポーネントのマトリックス

テストでは、Microsoft は小規模から中規模の配置用の次の設定を使用しました。

ノード	Elasticsearch	Logstash	Kibana	Winlogbeat
オーケストレータ #1	X			X
オーケストレータ #2	X	X		X
オーケストレータ #3		X	X	X
AOS #1...n				X

重要

Microsoft は、テスト目的で、ELK インストールのためにオーケストレータ機械を使用しました。オーケストレーションサービスから重要なリソースを奪う可能性があるため、運用環境または重要なサンドボックス環境で ELK のインストールにオーケストレータマシンを使用しないでください。代わりに、別のマシンを使用して ELK サービスをホストします。

Elasticsearch

Elasticsearch のインストールは、非常に簡単です。テストでは、Microsoft が、「Microsoft Windows インストーラー (MSI) ファイル」をオーケストレータ #1 およびオーケストレータ #2 ノードにダウンロードしました。インストーラの既定の設定のほとんどはそのままにしておくことができます。このセクションでは、Microsoft が変更した設定について説明します。

オペレーティングシステム (OS) が再起動された場合に、Elasticsearch がもう一度実行を開始するのを容易にするために、Microsoft は、それを Windows 上でサービスとしてインストールしました。インストーラーを使用して、サービスを設定できます。

インストーラーのコンフィギュレーションで、Microsoft は、各 Elasticsearch ノードをクラスターにインストールするときに、同じクラスター名を使用しました。

Microsoft はすべての Elasticsearch ノードを Data、Master、Ingest という 3 つの役割をすべて実行するように設定しました。

Kibana と Elasticsearch の使用量に応じて、メモリ増設を検討してください。 C:\ProgramData\Elastic\Elasticsearch\config\jvm.options ファイルの -Xm オプションを後で変更し、Elasticsearch を再起動することによって、この設定を変更することができます。

設定した Elasticsearch ノードの数に応じて、検出の最小マスターノードを適切に設定できます。わからない場合は、マスターノードを空にしておくことができます。探索および Node の詳細については、Node を参照してください。

発見可能性に関しては、ネットワークの設定で、Microsoft は、各ノードのネットワークホスト値をノードの IP アドレスに設定し、すべての Elasticsearch ノードの IP アドレスを、各ノードの Unicast Hosts リストに追加します。たとえば、IP アドレスが 10.0.0.12 のオーケストレータ #1 の場合、Microsoft は Network host の値を 10.0.0.12 に設定し、次の IP アドレスを Unicast Hosts リストに追加しました。10.0.0.12 および 10.0.0.13 (10.0.0.13 はオーケストレータ #2)

Elasticsearch 6.3 以降のバージョンをインストールする場合、この段落は無視できます。 今または後で、X-Pack をインストールすることができます。設定および X-Pack をインストールする必要があるかどうかに関する詳細については、この記事の "X-Pack" セクションを参照してください。ここでは、X-Pack がどういうものか理解していない限り、インストールしないでください。

重要

ファイアウォールの HTTP ポート (既定では、ポート 9200) と、ノード通信ポート (既定では、ポート 9300) を開きます。

インストールが成功したことを確認するには、ブラウザーを起動し、アプリケーションのアドレスを開きます。いくつかの JavaScript Object Notation (JSON) 出力が表示されます。

Logstash

テストの設定では、Microsoft は、Winlogbeat のいくつかのイベントで調整が必要なことがわかりました。 Logstash は、その機能を提供します。

Microsoft は Logstash をオーケストレータ #2 およびオーケストレータ #3 ノードで C:\ELK\Logstash にダウンロードしました。

Logstash が起動時に実行されることを確認するために、Non-Sucking サービスマネージャー (NSSM) を使用して、Logstash バッチスクリプトのサービスを設定しました。

Nssm.exe を Logstash の bin フォルダーにコピーする (たとえば、C:\ELK\Logstash\6.2.4\bin\) 。
bin フォルダーから Windows PowerShell を開き、次のコマンドを実行します。
```
.\nssm.exe install Logstash
```
アプリケーションタブで、次のフィールドを設定して、保存をクリックします。
- パス: C:\ELK\Logstash\6.2.4\bin\logstash.bat
- 起動ディレクトリ: C:\ELK\Logstash\6.2.4
- 引数: -f C:\ELK\Logstash\config\logstash-dyn365finops.conf
(他にも設定できる項目はあります。ただし、今はこの設定で十分です。)
次のコマンドを実行します。
```
.\nssm.exe start Logstash
```

Microsoft が実行したテストでは、NSSM には、インストールされたサービスの再起動に問題がありました。 Logstash と Kibana に対し NSSM は 100% の信頼性がなかったため、サービスは OS 起動サービスとして扱われました。

Microsoft は、logstash-dyn365finops.conf という Logstash の構成ファイルを作成しました。このファイルは、LCS 共有アセットライブラリの「LBD 診断構成」と呼ばれる zip ファイルのモデルアセットタイプで使用できます。 LCS 共有アセットライブラリに移動して、このファイルをダウンロードします。抽出した後 C:\ELK\Logstash\6.2.4\config に配置する必要があります。このファイルは、診断で有用な変換を実行します。

設定のためコンフィギュレーションを行うには、クラスターの Elasticsearch ノードを指すように、出力セクションのホストフィールドを変更する必要があります。たとえば、ホストを ["ORCH1:9200", "ORCH2:9200"] に変更します。

構成は、次のセクションから Winlogbeat 構成を使用してテストされました。

ビートが Logstash にデータを送信できるように、Logstash をホストしているコンピューターのファイアウォールで、Winlogbeat ポート (既定では、ポート 5044) を開くことを忘れないでください。

Winlogbeat

Microsoft は Winlogbeat を C:\ELK\Winlogbeat の各 Application Object Server (AOS) およびオーケストレータノードにダウンロードし、winlogbeat.yml file を構成しました。 Winlogbeat のサンプル構成ファイルは、LCS 共有アセットライブラリの「LBD 診断構成」と呼ばれる zip ファイルのモデルアセットタイプで使用できます。 LCS 共有アセットライブラリに移動して、このファイルをダウンロードします。

設定のためコンフィギュレーションを行うには、すべての Logstash ノードを指すように output.logstash.hosts フィールドを変更する必要があります。 Winlogbeat は、負荷分散を処理します。

Winlogbeat が Orchestrator ノード上で実行されている場合、Tags フィールドは AOS から ORCH もしくはそれに類する値に変更できます。 Microsoft は fields.env フィールドを使用して、配置環境 (サンドボックス、サンドボックス -n、または運用) を設定します。このようにして、複数の環境およびノードタイプからのデータが照会されると、より明確な分離が行われます。

Winlogbeat には、サービスインストーラーが含まれています。 Microsoft は、このインストーラーを使用して、各ノード上のサービスとして Winlogbeat を設定しました。 Windows ロゴキーと R キーを同時に押して、ツールの実行を開始し、次のコマンドを実行します。

powershell.exe -ExecutionPolicy Bypass -File C:\ELK\Winlogbeat\install-service-winlogbeat.ps1

Kibana

Kibana は、Elasticsearch の診断データをクエリするインターフェイスを提供します。

Microsoft は Kibana を C:\ELK\Kibana にダウンロードし、次の方法で kibana.yml ファイルを構成しました。

server.host: "10.0.0.14"
server.name: "Dyn365FinOps On-Premises Diagnostics"
elasticsearch.url: "http://ORCH1:9200"

Kibana から、Microsoft は管理タブでインデックスパターンを定義しなければなりませんでした。インデックスパターンは名前でインデックスをグループ化するため、1 つのインデックスパターンが作成された 2 つのインデックス: 配置-* およびランタイム-* を必要とするためです。インデックス名は、大文字と小文字が区別されます。

Microsoft は、既定のパターンとしてランタイム-* インデックスパターンを設定しました。管理タブのインデックスパターンを確認するときは、アスタリスク (*) をクリックします。インデックスパターンが、Discover タブに表示されます。

Microsoft は Kibana を Logstash と同じ方法でサービスとして実行し、Kibana が OS の起動時に起動されるようにしました。 Logstash とは異なり、kibana.bat は、コンフィギュレーションファイルのパスは必要ありません。したがって、C:\ELK\Kibana\6.2.4\bin\kibana.bat を参照する NSSM サービスをインストールできます。

ネットワーク上で Kibana を参照したいなら、Kibana 用のポートを開くことに注意してください。既定のポートは 5601 です。

Kibana の検出タブでのクエリの例

次のサンプルクエリでは、診断データの調査を開始できます。例に示されているもの以上のものが必要な場合、次のクエリのいずれかをお試しください。

低速データベースクエリの検索: 検索フィールドに低速と入力して、イベントデータのどこかに「低速」という単語が含まれているイベントを検索します。より正確にするには、AosDatabaseSlowQuery のタスク名を持つイベントを検索し、検索フィールドに TaskName:AosDatabaseSlowQuery と入力します。
最新の例外を見つける:例外を検索フィールドに入力して、例外をスローしたイベント、または例外を処理してログに記録したイベントを探します。 Kibana の右上隅で、検索を制限する必要がある期間を選択します。そこで設定したタイムフレームは、タブの間で保持されます。したがって、視覚化タブ上のデータは選択されているタイムフレームに反映されます。
AOS ノードからイベントを検索: ノードからすべてのイベントを検索するために、検索フィールドに host:AOS1 と入力します。
他のイベントと最も近い、特定のイベントを見つける: 興味のあるイベントが見つかったら、そのイベントのヘッダーの横にある関連するドキュメントを表示しますをクリックして、同時に発生したイベントを見つけます。同時に発生した、異なる Application Object Server (AOS) ノードからのイベントが表示されている場合、追加のフィルターを追加して、必要なノードからのイベントのみを表示できます。

30 日間のデータの保持

古いデータからハードディスクを保持するために、Microsoft は Curator v5.5 を使用して 30 日以上経過したインデックスをクリーンアップしました。

Microsoft はキュレーターを C:\ELK\Curator でオーケストレータノードのいずれかにダウンロードします。 zip ファイル「LBD診断構成」のモデルアセットタイプのLCS 共有アセットライブラリで使用可能なサンプル構成ファイル curator.yml は、次に、C:\ELK\Curator に配置して、キュレーターを Elasticsearch クラスターに接続します。特定のサーバーを参照するにはファイルを編集する必要があります。

キュレーターはアクションを実行し、Microsoft は「30day_data_retention_actions.yml」というアクション構成ファイルを作成して、C:\ELK\Curator 内の 30 日経過したインデックスをクリーンアップします。留保構成ファイルは、LCS 共有アセットライブラリの「LBD 診断構成」と呼ばれる zip ファイルのモデルアセットタイプで使用できます。 LCS 共有アセットライブラリに移動して、このファイルをダウンロードします。

Microsoft は、Windows タスクスケジューラの基本的なタスクを作成します。このタスクは、土曜日と日曜日に毎週トリガーを持ち、トリガーにはプログラムを開始するための次の設定があります。

プログラム/スクリプト: C:\ELK\Curator\curator.exe
引数を追加: --curator.yml .\30day_data_retention_actions.yml のコンフィグレーション
開始: C:\ELK\Curator

X-Pack

重要

2018 年 6 月現在、バージョン 6.3 以降の Elastic スタックコンポーネントがリリースされています。この更新されたバージョンでは、X-Pack の無料機能を毎年ライセンスを更新することなくデフォルトで有効にすること、また、後で有料機能にオプトインすることで、X-Pack をより上手く処理します。 6.3 よりも前の Elastic スタックバージョンをインストールしている場合、このセクションの内容は設定に部分的にのみ適用されます。

Elasticsearch のインストール時に X-Pack をインストールするように選択できます。代わりに、インストールをすることができます。。

X-Pack には無料の基本ライセンスがあり、毎年更新する必要があります。

Microsoft では、Kibana からコンマ区切り値 (CSV) 形式でエクスポートするデータのクエリを有効にするために無料版がインストールされています。 X-Pack ではその他の便利な機能がありますが、いくつかは有料サブスクリプションでのみ使用可能です。

無料の機能だけを有効にし、他の X-Pack の試用版の機能を使用しないように、Microsoft は、elasticsearch.yml および kibana.yml のコンフィギュレーションファイルに次の設定を追加しました。

xpack.graph.enabled: false
xpack.ml.enabled: false
xpack.security.enabled: false
xpack.watcher.enabled: false

これらの設定は、セキュリティモジュールが有効ではないため、Kibana と Elasticsearch が資格情報を求めることも停止します。

X-Pack を動作させるには、logstash.yml 構成ファイルも次のように構成する必要があります。

xpack.monitoring.elasticsearch.url: "http://orch1:9200"

X-Pack の支払済バージョンには、クラスター、パスワードで保護されたデータアクセスなどの接続に使用するための HTTPS 暗号化が含まれています。 X-Pack の詳細については、Elastic Web サイトを参照してください。

CSV ファイルへのクエリのエクスポート

Kibana では、検出タブで、クエリを作成し、保存します。クエリを保存した後、検出ページの上部にあるレポート タブの CSV を生成をクリックします。

トラブルシューティング

Kibana 内のデータを受信しません

Kibana で、何もデータを受け取っていない場合、Winlogbeat から Logstash、Elasticsearch、および Kibana のログを確認してください。 Winlogbeat のインストールでは、C:\ProgramData\winlogbeat\Logs にログが記録されますが、他の Elastic スタックコンポーネントはログをインストールパスに近づけることに注意してください (例: C:\ELK\Elasticsearch\logs)。

次の方法で共有