ヘルスモニター

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 page

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

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

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

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

Errors and Warnings

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

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

Correcting Common Issues

パフォーマンスおよびシステムの問題は、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 ライセンスの期限切れ予告エラーは、ブラウザーインターフェース（Admin – Licenses）の Licenses page から対処します。すでに期限切れのライセンスは、Enterprise Server ホストマシン上でブラウザーインターフェースにアクセスして解決できます。
• Backups – Workspace backup は、ホスト PC 上の Enterprise Server インストール内の Tools\BackupTool フォルダーにある avbackup.exe ツールを使用して実行できます。

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

Reports and Logs

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 アプリケーションプールとしてホストされる Enterprise Server の各種サービスの状態。

Tool Access

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 のステータスとそのサポートインフラのステータスを即座に表示し、さらに詳細情報へのリンクも提供します。

Errors and Warnings

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

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

項目のステータスにマウスを重ねると、より多くの情報が表示されます。ダッシュボードに表示されるエラーまたは警告については、（ほとんどの場合）その項目のステータスエントリをクリックすると詳細を確認できます。

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

Responsive links

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 リストから蓄積されたログエントリが削除されます。これにより、既存のログファイルはすべてアーカイブされた後に削除されます。

Status Report

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

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

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