インフラストラクチャ監視を開始する
注
次の2つの手順は、Provisioning ServiceおよびStoreFrontコンポーネントの監視に対してのみ有効です。
手順1：Citrix Infrastructure Monitorのインストール
安全なデータ収集のための接続を確立するには、次の手順を実行して、ターゲットコンポーネントへのインストールを完了します。
手順1.1：対象コンポーネントを特定する
監視する必要があるProvisioning ServicesやStoreFrontサーバーなどの対象コンポーネントを特定します。
手順1.2 Citrix Infrastructure Monitorをダウンロードする
手順1.1で特定した対象サーバーのCitrixダウンロードページから、CitrixInfraMonitor.msiをダウンロードできます。
手順1.3： Citrix Infrastructure Monitorを実行する
インストールウィザードの指示に従って、対象コンポーネントでCitrixInfraMonitor.msiインストーラーを実行します。
注
管理者権限を持つユーザーは、Citrix Infrastructure Monitorをエンドポイントマシンにインストールして構成することができます。
インストールが成功すると、［サービス］ セクションでCitrix Infrastructure Monitorサービスを表示できます：
手順1.4：登録トークンを取得する
Citrix Infrastructure MonitorがインストールされているシステムでC:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txtのRegistrationToken.txtファイルで提供されているトークンを取得し、「手順2：Citrix Infrastructure Monitorを登録する」で使用できるようにしておきます。
ポート要件
CitrixInfraMonitor.msiを正常にインストールすると、インストーラーは9595ポートの例外を作成します。 サードパーティのファイアウォールを使用していると、Citrix Infrastructure Monitoringサービスを使用するために、このポートのTCP通信を手動で許可する必要がある場合があります。
次の表は、Provisioning ServicesとStoreFrontマシンの受信ポートの要件の詳細を示しています：
| ソース | ターゲット | 種類 | ポート | Protocol | 目的 |
|---|---|---|---|---|---|
| Cloud Connector | Provisioning ServicesまたはStoreFrontマシン | TCP | 9595 | HTTPまたはHTTPS | Provisioning ServicesまたはStoreFrontマシンからメトリックを収集するための呼び出し。 |
注
Provisioning ServicesとStoreFrontマシンは、Infrastructure Monitoring Serviceの発信呼び出しを行いません。
手順2：Citrix Infrastructure Monitorを登録する
以下を使用して、Infrastructure Monitoring Serviceを登録できます：
Monitor UIを使用する
次の手順を実行して、Monitor UI での登録を完了します。
手順2.1：［Citrixコンポーネントに接続する］ページに移動する
［設定］ > ［Citrixコンポーネントに接続する］ > ［管理］をクリックします。
Or,
［インフラストラクチャ］ > ［管理］をクリックします。
手順2.2：コンポーネントの詳細を入力する
［Citrixコンポーネントに接続する］画面で、［接続を作成する］をクリックします。 ［接続の作成する］ウィンドウが表示されます。
citrixinframonitor.msiがダウンロードされ、ターゲットにインストールされていることを確認します。 詳しくは、このドキュメントの手順1を参照してください。 画面の指示に従い、セキュアな接続を確立するために必要なコンポーネントの詳細を入力します。
- ドロップダウンリストから［コンポーネントの種類］を選択します。 これは、Provisioning ServicesでもStoreFrontでもかまいません。
- ホスト名を入力します。
- ドメイン名を入力します。
- Provisioning ServicesまたはStoreFrontマシンのユーザー名を入力します。
- Provisioning ServicesまたはStoreFrontマシンのパスワードを入力します。
- リソースの場所を選択します。
手順2.3：接続を許可する
Citrix Infrastructure Monitorトークンは、Citrix Infrastructure MonitorがインストールされているシステムのC:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txtにあるRegistrationToken.txtファイルから取得します。
取得したトークンの詳細をDirector UIに入力します。 これにより、サイトとコンポーネント間の接続が許可されます。
RegistrationToken.txtファイルにあるトークンテキストは、Citrix Infrastructure Monitor Serviceを再起動すると再生成されます。 登録が成功すると、トークンファイルはマシンから削除されます。 何らかの理由で新しいトークンファイルを再作成する必要がある場合は、Citrix Infrastructure Monitor Serviceを再起動してください。 セキュリティ上の理由から、無効なトークンによる登録の試行が3回失敗すると、トークンファイルは削除されます。
手順2.4：接続を作成する
詳細を入力したら、［作成］をクリックします。 作成された接続は、［Citrixコンポーネントを接続する］ページの接続一覧に表示されます。
Remote PowerShell SDKを使用する
注
PoshSDKの最小必要バージョンは、7.42.26154.48609以降です。
-
前提条件に記載されている前提条件が満たされていることを確認してください。
-
Citrix Infrastructure Monitorを登録するには、次のPowerShellコマンドを実行します：
Add-MonitorDirectorAgent -Fqdn <FQDN of component> -Component <component> -AdminAddress localhost:19097 -ResourceLocationId <resourceLocationID> -Domain <domain> -Username <username> -Password <password> -Token <token> <!--NeedCopy-->
注
ユーザー名とパスワードはオプションのパラメーターです。 ただし、これらのパラメーターを指定しないと、一部のメトリックは利用できなくなります。
上記のコマンドのパラメーターは次のとおりです：
| パラメーター | 説明 |
|---|---|
Fqdn |
Provisioning ServicesまたはStoreFrontサーバーのFQDN。 |
Component |
オンボーディングするコンポーネント。 例：Provisioning ServicesまたはSF。 Provisioning ServicesはCitrix Provisioningの略で、SFはStoreFrontの略です。 |
ResourceLocationId |
サイトのリソースの場所ID。 この値を取得するには、Citrix Cloudの ［リソースの場所］ページのリソースの場所の名前の下にある ［ID］ ボタンを選択します。 |
Domain |
すべてのコンポーネントが含まれるドメイン。 |
Username |
管理者ユーザーのユーザー名。 |
Password |
管理者ユーザーのパスワード。 |
Token |
Citrix Infrastructure Monitorトークンは、Citrix Infrastructure MonitorがインストールされているシステムのC:\ProgramData\Citrix\InfraMonitor\RegistrationToken.txtにあるRegistrationToken.txtファイルから取得します。 |
注
RegistrationToken.txtファイルにあるトークンテキストは、Citrix Infrastructure Monitor Serviceを再起動すると再生成されます。 登録が成功すると、トークンファイルはマシンから削除されます。 再登録が必要な場合は、Citrix Infrastructure Monitorサービスを再起動します。セキュリティ上の理由から、無効なトークンによる登録の試行が3回失敗すると、トークンファイルは削除されます。
Provisioning ServicesまたはStoreFrontマシンの登録に成功すると、マシン名の詳細が［Monitor］ > ［インフラストラクチャ］タブに表示されます。
Citrix Infrastructure Monitorに登録するためのサンプルコマンドは次のとおりです：
［オプション］Citrix Infrastructure MonitorのHTTPSを構成する手順
注
Citrix インフラストラクチャモニターサービスはHTTPモードでも機能するため、この場合、次の構成は不要です。 ただし、httpsモードでの使用をお勧めします。 Citrix Infrastructure Monitorにhttpsを構成する必要がある場合にのみ、次の手順を実行してください。
手順1：証明書をマシンにアップロードする
-
Citrix Infrastructure MonitorがインストールされているマシンのPFX証明書を取得します。 PFXファイルの生成について詳しくは、「How to create a PFX file」を参照してください。
注
パスワードで保護されたPFXファイルも使用できます。
-
証明書をマシンの任意の場所にアップロードします。
手順2：証明書をコンピューター証明書にインポートする
-
［スタート］ > ［ファイル名を指定して実行］に移動して「
mmc」と入力し、［OK］をクリックします。 ［コンソール1 -［コンソールルート］］ ウィンドウが開きます。 -
［ファイル］ メニューで、［スナップインの追加と削除］ をクリックします。 ［スナップインの追加と削除］ ウィンドウが表示されます。
-
［スナップイン］ の下にある ［証明書］ をダブルクリックします。 ［証明書スナップイン］ ウィンドウが表示されます。
-
［コンピューターアカウント］ を選択し、［次へ］ をクリックします。 ［コンピューターの選択］ ウィンドウが表示されます。
- ［ローカルコンピューター］ を選択します。
- ［完了］をクリックします。 新しいコンソールの選択されたスナップインの一覧に、［証明書（ローカルコンピューター）］ セクションが表示されます。
- ［OK］をクリックします。
-
［証明書］を展開し、［個人］を右クリックして［すべてのタスク］ > ［インポート］の順に選択します。 ［証明書のインポートウィザードの開始］ が表示されます。
-
［次へ］ > ［ファイルの参照］を選択します。 PFXファイルをアップロードした場所に移動し、ファイルの種類を ［すべてのファイル］ に変更して、対応するのPFX証明書を選択します。
- PFXパスワードを入力します。 パスワードがない場合は空白のままにしておきます。
- ［次へ］ をクリックします。
-
証明書ストアでは、［証明書をすべて次のストアに配置する］ オプションが選択され、［証明書ストア］ で ［個人］ が選択されていることを確認します。
- ［次へ］ をクリックします。
- 詳細を確認して、［完了］ をクリックします。
- 確認のため待機します。 インポートが成功したメッセージが表示されます。
- ［証明書］ > ［個人］に移動し、証明書があることを確認します。
- マシンからPFX証明書ファイルを削除します。
手順3：証明書への読み取りアクセスを提供する
- インポートした証明書を右クリックし、［すべてのタスク］ > ［秘密キーの管理］の順に選択します。
- 開いたダイアログで、［追加］ を選択し、ネットワークサービスを検索します。 ［OK］をクリックします。
- ［グループ］ または ［ユーザー名］ の下にあるNETWORK SERVICEを選択します。
- NETWORK SERVICEの権限で読み取りアクセスを許可します。
- ［OK］をクリックします。
手順4：拇印を取得する
- インポートした証明書をダブルクリックします。
- 開いたダイアログで、［詳細］ タブに移動し、一番下までスクロールします。
-
［拇印］ をクリックします。
- 値をコピーして、次の手順に備えます。
手順5：環境変数の設定
- ［コントロールパネル］を開きます。
- 環境を検索し、システム環境変数の編集を選択します。
-
［システム変数（すべてのユーザー）］ の下で、［新規］ をクリックします。
- 変数名をDIRECTOR_AGENT_HTTPS_CERTIFICATE_THUMBPRINTとして指定します。
- 変数値の下に、前の手順の拇印を指定します。
- ［OK］をクリックします。
手順6：CitrixInfraMonitorServiceを再起動する
-
PowerShellを開き、次のコマンドを実行します：
Restart-Service CitrixInfraMonitorService <!--NeedCopy--> -
CitrixInfraMonitorServiceモジュールをキャプチャし、ログ行「Start to listen on HTTPS…」を探して、HTTPSが有効になっていることを確認します。
手順7：Monitor構成でHTTPSを有効にする
Remote PowerShell SDKを使用して、Monitor ServiceでHTTPSを有効にすることができます。
注
PoshSDKの最小必要バージョンは、7.44.26401.2361以降です。
-
前提条件に記載されている前提条件が満たされていることを確認してください。
-
次のPowerShellコマンドを実行して、Monitorの構成でHTTPSを有効にします：
Set-DirectorAgentHttps -AdminAddress localhost:19097 -EnableHttps $true <!--NeedCopy-->
注
既存の設定値を確認するには、
Get-DirectorAgentHttps -AdminAddress localhost:19097コマンドを実行します。Monitorの構成でHTTPSを無効にする必要がある場合は、
Set-DirectorAgentHttps -AdminAddress localhost:19097 -EnableHttps $falseコマンドを実行します。