ヘルスモニター

Parent page: メンテナンス

Enterprise Server には包括的なヘルス監視システムが含まれており、管理者は Enterprise Server の状態（「ヘルス」）を迅速に把握して分析できます。ヘルスモニターは、Workspace のブラウザーインターフェースの Admin セクション（Server Health ページ）から利用できるほか、Enterprise Server をホストしている PC の Enterprise Server インストールに含まれるスタンドアロンの実行ツール（Server Health Monitor ツール）としても利用できます。

ヘルス機能は、Enterprise Server の構成とサービスの状態を視覚的に要約して表示し、ホストマシンのシステムリソース情報も提供します。また、ステータスレポートやログファイルへのアクセスも可能です。これにより Enterprise Server の状態を即座に概観でき、Workspace ユーザーに影響し得る問題を管理者が事前に検知して解決できるようになります。

Enterprise Server のヘルスとステータスを監視する各アプローチには、それぞれ固有の利点があります。

• Server Health page – Enterprise Server Workspace のブラウザーインターフェースの一部として、Server Health ページはローカルネットワーク経由で管理者が利用でき、リモートアクセスの利便性があります。
• Server Health Monitor tool – スタンドアロンの Health Monitor 実行ファイル（avhealth.exe）は Enterprise Server の状態に依存せずにアクセスできるため、万一 Enterprise Server が完全に動作していない場合でも重要なデータと情報を提供します。

Server Health ページ

Workspace のブラウザーインターフェース内でメインメニューから Admin – Health を選択すると、Server Health レポーターページにアクセスできます。ここでは、ページ上部の Status セクション（Updated at: <timestamp>）に表示されるタイムスタンプ時点での Enterprise Server インストール全体のステータスが示されます。

Server Health ページでは、Enterprise Server とそのサポートインフラのステータスを即座に確認できます。

Server Health ページの情報は定期的に更新されます（ステータスのタイムスタンプで示されます）が、関連する refresh status リンクで必要に応じて更新をトリガーすることもできます。

更新リンクをクリックして Enterprise Server のヘルス情報を更新します。

エラーと警告

Enterprise Server ステータスの強調表示された概要として、Server Health ページでは、注意が必要なステータス項目に対して明確な警告/エラーアイコンと説明が表示されます。一般的なアラートには、期限超過のデータバックアップ、ライセンス期限切れの予告、admin/admin ユーザーアカウントの有効化、ログファイル内で検出されたエラーエントリなどがあります。

• OK  – 検出されたメトリクスが許容範囲または許容状態にあります。
• Warning  – Enterprise Server とそのサポートインフラは正しく機能していますが、潜在的または将来的な問題を解消するために変更が推奨されます。
• Error  – Enterprise Server またはそのサポートインフラの一部が正しく機能していない、または正しく構成されておらず、直ちに対処が必要です。

一般的な問題の修正

パフォーマンスおよびシステムの問題は、Enterprise Server ホスト PC の利用可能なリソースとインフラを改善することで対処される可能性が高い一方、Server Health ページの Environment and configuration セクションにある問題は、通常 Workspace 管理者が利用できる機能とツールで解決できます。

• Admin password – まだ実施していない場合は、Users page で 1 つ以上の専用管理者アカウントを作成し、既定の admin アカウントのパスワード（できればユーザー名も）を変更します。
• Log level – 必要に応じて、ホスト PC 上の Enterprise Server インストールフォルダーにある LocalVault.ini ファイルの General セクション内の LogLevel= エントリを編集して、Enterprise Server のログレベルを変更します。許可されるレベルは Info（既定）と Warn です。後者を選択すると、一般的なステータス情報（API 呼び出し、サービスの開始/停止など）はログファイルに含まれません。なお、エラーは常に含まれます。
• Licenses – Enterprise Server ライセンスの期限切れ予告エラーは、ブラウザーインターフェースの Licenses page（Admin – Licenses）で対処します。すでに期限切れのライセンスは、Enterprise Server ホストマシン上でブラウザーインターフェースにアクセスして解決できます。
• Backups – Workspace backup は、ホスト PC 上の Enterprise Server インストール内の Tools\BackupTool フォルダーにある avbackup.exe ツールで実行できます。

• Project Sharing（Health Monitor tool に報告されます） – 既存の Workspace メンバーのパスワードエラーは、SVN repositories が有効化されている、または追加されている場合にここで報告されることがあります（see example）。この場合、これらのユーザープロファイルに対する更新追加の実行も妨げられます。既存ユーザーを SVN リポジトリと同期するには、edit each member profile で各メンバーのプロファイルを編集し、パスワードを再入力して Update ボタンで確定します。資格情報はシステムの SVN passwd ファイル（通常は C:\ProgramData\Altium\Altium365Data\Repository フォルダーにあります）で更新され、これらのユーザーが SVN リポジトリに登録されます。

レポートとログ

Enterprise Server とホスト PC の両方のパフォーマンスがテストされ、（Performance および System セクションで）要約されます。また、レポートログは生成およびダウンロードできるように提供されます。

• Logs – Enterprise Server Logs は zip アーカイブとしてブラウザーの既定のダウンロード先（Download all logs）にダウンロードされます。これには Enterprise Server がホストするすべてのサービスのプレーンテキストログが含まれ、各サービスのログファイルには Enterprise Server のインストール以降、またはログがクリアされて以降の時系列イベント（およびエラー）が含まれます（Clear logs）。
• Reports – Enterprise Server Status Report は zip アーカイブとしてブラウザーの既定のダウンロード先にダウンロードされます（ページ上部の Status セクションにある Generate リンクで実行）。これは、Enterprise Server のすべてのコア要素の状態ステータスとセットアップを報告します。Altium サポートチーム向けの重要情報として意図されており、レポートにはホスト PC のサポートインフラに関するステータスおよびパフォーマンス情報も含まれます。

Health Monitor tool

Enterprise Server のインストールには、管理者がローカルレベルで Enterprise Server の状態（「ヘルス」）を迅速に把握して分析できる包括的な On-Prem Enterprise Server Health Monitor ツールが含まれています。Enterprise Server のインストールに付属するスタンドアロンの独立アプリケーションとして提供される Health Monitor は、ホストマシンの状態、および Enterprise Server の構成とサービスの状態を視覚的に要約して表示します。インターフェースには、状況に応じたヒントに加え、重要な場所やログファイルへの情報およびパスも含まれます。

Health Monitor は、シンプルな GUI を通じて Enterprise Server のステータス情報を提示し、一般に次の重要領域をカバーします。

• Enterprise Server Environment – ハードディスク、メモリ、CPU、およびパフォーマンスの十分性など、ホスト PC のハードウェアの状態。
• Enterprise Server Backend – Enterprise Server を支えるデータベース、ファイルストレージ、リポジトリの状態。
• Enterprise Server Services – Identity、Authorization、License Manager、Network Installation サービスなど、IIS Application Pools としてホストされる Enterprise Server の各種サービスの状態。

ツールへのアクセス

Enterprise Server の既定インストールでは、Health Monitor ツールは \Program Files (x86)\Altium\Altium365\Tools\HealthMonitor フォルダー内の avhealth.exe 実行ファイルとして見つかります。なお、このフォルダーには簡易コマンドラインツール avConsoleHealth.exe も含まれています。

GUI の Health Monitor ツール（avhealth.exe）を実行すると、プログラムは直ちに Enterprise Server とそのホスティングシステムを照会し、上部タブで（既定で）選択されているメインの Health Monitor Dashboard 画面に情報を反映します。Refresh ボタン（）をクリックすると、このプロセスを再トリガーして画面を更新できます。

Health Monitor Dashboard GUI は、Enterprise Server とそのサポートインフラのステータスを即座に表示し、さらに詳細情報へのリンクも提供します。

エラーと警告

Dashboard 内の各項目のステータスは、メッセージと対応するアイコンで示されます。

• OK  – 検出されたメトリクスが許容範囲または許容状態にあります。
• Warning  – Enterprise Server とそのサポートインフラは正しく機能していますが、潜在的または将来的な問題を解消するために変更が推奨されます。
• Error  – Enterprise Server またはそのサポートインフラの一部が正しく機能しておらず、直ちに対処が必要です。

項目のステータスにマウスカーソルを合わせると、詳細情報が表示されます。Dashboard に表示されるエラーまたは警告については、（ほとんどの場合）その項目のステータスエントリをクリックすることで、さらに詳細を確認できます。

ステータスエントリにカーソルを合わせて、より詳細な情報にアクセスします。

応答リンク

Health Monitor が検出する多くのエラー/警告状態には、状況の解決に役立つリンクが用意されています。これらは、ステータスエントリをクリックしたときに表示される項目の詳細情報に含まれます。

    
一般的なイベント問題が発生した場合、関連情報には、懸念される状態を解決するための詳細とリンクが提供されます。

上の左側の例画面では、Health Monitor が Enterprise Server のバックアップが実行されていないことを検出しています。関連情報には、この状況を解決するのに役立つドキュメントへのリンクが提供されます。

（上の）右側の例画面は、Enterprise Server の既定の admin/admin サインイン資格情報がまだ存在していることを示しており、重大なセキュリティリスクとなります。関連情報内の Fix It リンクから、ブラウザーインターフェースを通じて Enterprise Server のサインインページに直接アクセスでき、管理者ユーザープロファイルを修正できます。

Log Browser

Health Monitor の Log Browser 画面は Log Browser タブからアクセスでき、Enterprise Server で利用可能なすべてのログファイル（通常は C:\ProgramData\Altium\Altium365Data\logs フォルダーにあります）からエラーおよび警告エントリを表示します。イベントエントリを含むログファイルを表示するには、関連する Open file リンクを選択するか、エントリ自体をダブルクリックします。

リスト内の累積イベントエントリは日付ごとに区分され、すべてのログファイルから取得可能なすべてのエラー/警告イベントが含まれます。特定のイベントを見つけるには、Show logs ドロップダウンメニューから期間を選択し、さらに動的フィルターフィールド（）を使用して Subsystem および Message 列内のキーワードを検索します。

Log Browserインターフェースでは、選択可能な期間とキーワードフィルタリングを使って、関心のあるイベントに絞り込むことができます。

ボタンを選択すると、Log Browserリストに蓄積されたログエントリが削除されます。これにより、既存のログファイルはすべてアーカイブされた後に削除されます。

ステータスレポート

Health Monitorのステータスレポート画面は、Status Reportタブからアクセスでき、Enterprise Serverのステータスレポートファイルを作成・表示するために使用します。生成されたレポートは、すべてのイベントデバッグ情報を単一のZipアーカイブ（*.zip）にまとめ、必要に応じてAltium Developersへ送付できます。

レポートを作成するには、Include Logsドロップダウンメニューから適切なイベント期間を選択し、連絡先情報を入力して共有同意を選択したうえで、ボタンで処理を開始します。

Status Report画面を使用して、デバッグ目的の集約ログレポートファイルを生成します。