インストール

インストールの前提条件

1. Ensure that you meet the Hardware and Software Requirements for Insights.

2. Install Orchestrator or modify an existing installation enabling the Insights feature.

3. Ensure that you have followed the Orchestrator instructions. This certificate must have both public and private keys and must be installed in the Trusted Root of the Insights machine.

4. Insights の証明書が Orchestrator マシンの信頼されたルートに配置されていることを確認します。

5. Insights のホスト名を指定する際は、DNS 内で解決できるホスト名であることを確認してください。

6. Insights をインストールするサーバーが、Orchestrator がインストールされているサーバーと通信可能で、その逆も同様であることを確認してください。

   重要:

   自己署名証明書ではなく、認証機関に提出された SAN SSL 証明書の使用をお勧めします。

   自己署名証明書 (および自身の証明機関の証明書) は、Insights マシンの信頼されたルートと個人証明書ストアの両方にインストールする必要があります。また、証明書はエクスポート可能としてマークする必要があります。

   自己署名証明書を使用する際に、Firefox、Internet Explorer、または Edge から Insights にアクセスすると問題が発生する可能性があります。

Insights を使用するために Orchestrator のインストールを変更する

1. Windows の [コントロール パネル] で [プログラムの追加と削除] を選択します。

2. リストから Orchestrator を選択し、[変更] をクリックします。

3. 画面上のインストーラーに従い、[Insights との連携] 機能を選択します。

   

   注:

   After installation is complete, you must also update your Host license to ensure the Insights feature is activated.

Insights のインストール

1. UiPathInsightsInstaller.exe インストーラーを管理者として実行します。UiPath Insights インストーラーウィザードが表示されます。

2. [ライセンス契約に同意するにはここをクリックしてください] チェック ボックスをオンにして、契約の条項に同意し、[次へ] をクリックします。[Insights サーバーの構成] が表示されます。

   

3. 必要に応じて Server 構成を変更します。

   • Web サイトのホスト名 - Insights がインストールされているデバイスを識別するために使用します。既定では、マシンのホスト名に設定されますが、編集可能です。この名前は、外部サーバーから解決可能である必要があります。

   • Web サイト ポート - Insights の通信に使用するポート。既定では 443 に設定され、HTTPS の使用が有効化されています。

   • このポートに対するファイアウォール ルールを追加 - 選択した場合、このポートに対するファイアウォール ルールが自動的に追加され、お使いのマシンのセキュリティが確保されます。

     重要:

     Insights では、さまざまなサービス間の通信にループバック IP アドレスを使用します。これらのポートでは HTTPS を使用していません。したがって、これらのポートに他のマシンがアクセスできないように、外部ソース (127.0.0.1 以外の IP アドレス) からの接続の受信に対しては必ずポート 443 のみを開いておくようにします。

   • Insights ビルド ディレクトリ - 定義すると、Insights のデータがインポートされシステム内に構築された後に、データの保存先となるディレクトリを設定します。

     重要:

     このフィールドは必須ではありません。空白のままにすると、インストーラーによって既定ディレクトリが使用されます。フォルダー パスをドライブのルート (D:\) にしたり、パスの末尾にスラッシュを付けたりすることはできません。

     選択したインストール パスをダブルチェックします。インストール後に、ある場所から別の場所にインストールを移動することはできません。

   • SSL 証明書のサブジェクト - Insights との接続をセキュリティ保護するために使用する SSL 証明書のサブジェクト名です。既定では、コンピューターのフル ネームが入力されますが、編集可能です。

注:

The SSL certificate subject must match the Website host name provided above. If using an existing certificate, it must be marked as exportable and be installed under the Local Machine Personal Certificate Store.

• Create Self Signed Cert - if selected, automatically creates a self-signed certificate with subject name specified above. For using Edge or Internet Explorer with self-signed certificates, see here.

  重要:

  [自己署名証明書を作成] オプションを有効化することはお勧めしません。認証機関に提出された SAN SSL 証明書を使用する方が望ましいためです。

  Orchestrator マシンでも自己署名証明書を使用する場合は、Orchestrator と Insights の証明書を両方のマシンの信頼されたルートに追加する必要があります。

• メール アドレス - ローカルの Insights 管理者ユーザーのメール アドレスです。

注:

This must not match the email address of any user defined in Orchestrator.

• パスワード - ローカルの Insights の管理者ユーザーのパスワード。8 ～ 20 文字の文字列で、少なくとも大文字を 1 文字、小文字を 1 文字、数字を 1 文字、特殊文字 (!、@、#、$、%、^、&、*) を 1 文字含む必要があります。

  1. [次へ] をクリックします。[Insights データべースの設定] が表示されます。

     

  2. 次のように、データベースの詳細を入力します。

• ホスト サーバー名 - Insights データベースが配置されている SQL Server マシンの名前です。また、sql.uipath.com:1733 のようにコロンを使用することで、ここでカスタム ポート番号を指定できます。
• Database Name - the name of the Insights database specified when installing Orchestrator.
• Windows 認証 - 選択した場合、ドメイン アカウントを使用して Insights に接続されます。追加の構成手順については以下をご覧ください。
• SQL 認証 - 選択した場合、SQL 認証を使用して Insights への接続が行われます。このオプションを使用する場合には、[ユーザー名] および [パスワード] フィールドが編集可能になるので、データベースへの接続に使用する SQL ユーザー名とパスワードを入力する必要があります。

  1. [次へ] をクリックします。Orchestrator の構成が表示されます。

     

  2. Orchestrator インスタンスの接続詳細を、次のように設定します。

• Orchestrator エンドポイント - Orchestrator の URL。
• ユーザー名 - ホストテナントのユーザー名。既定では admin に設定され、編集できません。
• パスワード - ホストの管理者アカウントのパスワード。

  1. [次へ] をクリックします。[Orchestrator データべース設定] が表示されます。

     

  2. 次のように、Orchestrator データベースの詳細を入力します。

• ホスト サーバー名 - Orchestrator データベースが配置されている SQL Server 端末の名前です。また、sql.uipath.com:1733 のようにコロンを使用することで、ここでカスタム ポート番号を指定できます。
• Database Name - the name of the Orchestrator database specified when installing Orchestrator.
• Windows 認証 - 選択した場合、ドメイン アカウントを使用して接続が行われます。
• SQL 認証 - 選択した場合、SQL 認証を使用して接続が行われます。このオプションを使用する場合には、[ユーザー名] および [パスワード] フィールドが編集可能になるので、データベースへの接続に使用する SQL ユーザー名とパスワードを入力する必要があります。

  1. [次へ] をクリックします。[メール サーバーの構成] が表示されます。

     

     注:

     メール サーバーを構成しない場合、Insights のメール アラートや通知は送信されません。ただし、Windows のプログラムの追加と削除機能の [変更] 機能を使用することで、インストール後にメール サーバー構成を追加することができます。

  2. 必要に応じて、Insights 通知のメール サーバーを次のように設定します。

• SMTP ホスト - SMTP ホストを入力します。
• SMTP ポート - SMTP ポートを入力します。既定では 25 に設定されますが、編集可能です。
• TLS 構成 - メール サーバーのセキュリティ設定を行うために使用されます。次のオプションがあります。
  • セキュリティ保護 - オンにした場合、接続に TLS が使用されます。
  • TLS を無視 - 選択した場合 ([セキュリティ保護] を選択しない場合)、TLS は使用されません。セキュリティで保護されていない SMTP サーバーに接続するときに、このオプションを選択します。
  • TLS を要求 - 選択した場合 (**[セキュリティ保護]** を選択しない場合)、メール サーバーのサポートに関係なく、接続を TLS にアップグレードする必要があります。
• SMTP ユーザー名 - メール メッセージの送信元となるメール アドレス。
• SMTP パスワード - 上記で使用されるメール アドレスに対するパスワード。
• 送信元アドレス - メール メッセージの送信元となるメール アドレス。これは上記の [SMTP ユーザー名] で指定した値と一致させる必要があります。
• 送信元表示名 - メール アドレスの表示名。
• メール サーバーの詳細構成 - 次のオプションがあります。
  • デバッグ - 選択した場合、Insights はすべての SMTP トラフィックをログ記録します。使用するのはトラブルシューティング時のみです。
  • ロガー - 選択した場合、Insights はすべてのイベント (サーバー接続など) をログ記録します。
  • 接続のタイムアウト - 接続の確立を待機する時間 (ミリ秒)。
  • 応答メッセージのタイムアウト - 接続の確立後、応答メッセージを待機する時間 (ミリ秒)。
  • ソケットのタイムアウト - 非アクティブであることが許可される時間 (ミリ秒)。

    1. [インストール] をクリックします。インストール プロセスが開始されます。完了後、[閉じる] をクリックしてインストーラーを終了します。

       重要:

       Insights のインストール完了後は以下の手順を実行する必要があります。

       • Ensure the .NET Trust Level) of the Sisense app is set to Full.
       • ディレクトリ C:\Program Files\Sisense\app\query-proxy-service\src\common に存在する consts.js ファイルを開き、HEALTH_CHECK_TIMEOUT パラメーターを 100000 に設定します。

Windows 認証の構成

Windows 認証を使用して Insights データベースに接続する (上記のステップ 4 を参照) 場合、Sisense.CLRConnectorsContainer および Sisense.JVMConnectorsContainer サービスのログオン プロパティを次のように変更する必要があります。

注:

このプロセスを実行するアカウントと Insights インストーラーの実行時に使用したアカウントが異なる場合は、このアカウントがローカルの Administrator グループに含まれていることを確認してください。

1. Windows サービスマネージャーを開きます。
2. Sisense.CLRConnectorsContainer を右クリックして、[プロパティ] を選択します。
3. [ログオン] タブで、[アカウント] ラジオ ボタンを選択します。
4. Insights SQL データベースへの接続に使用するアカウントのユーザー名とパスワードを入力し、[OK] をクリックします。
5. Sisense.JVMConnectorsContainer サービスに対してこのプロセスを繰り返します。
6. 両方のサービスを再起動します。

テナントのセットアップ

Insights をインストールした後は、UiPath.InsightsAdminTool.exe ユーティリティを使用して、目的のテナントに対して Insights を有効化する必要があります。

重要:

有効化された各テナントは、「ウォーム スタート」プロセスをトリガーします。このプロセスでは、設定した日数分のバックフィルが行われ、データが Insights データベースに取り込まれます。

データのボリュームやハードウェアの性能によっては、すべてのテナントのデータが処理され Insights に表示されるようになるまでに数時間かかることがあります。

1. Insights がインストールされたマシンで、\Orchestrator\Tools ディレクトリに移動します。たとえば、cd C:\Program Files (x86)\UiPath\Orchestrator\Tools です。

2. UiPath.InsightsAdminTool.exe ユーティリティを実行します。

   

3. [ユーザー] フィールドに、Orchestrator host テナントの管理者ユーザーを入力します。これは既定では admin で、変更できません。

4. Orchestrator host テナントのパスワードを入力し、ログインをクリックします。[機能を選択] ウィンドウが表示されます。

   重要:

   Insights 20.10.0 has a minor known issue on the ROI Dashboard. Please visit the linked release notes for instructions on how to remedy this issue using Tenant Setup.

   

5. [Insights をテナントに対して有効化] を選択します。すべてのテナントのリストが表示されます。

   

6. 各テナントに対して次のオプションを選択します。

   • Insights が有効 - 選択したテナントに対して Insights を有効化するには、このチェック ボックスをオンにします。

   • ダッシュボードの言語 - ダッシュボードで使用する言語です。

   • Replace Resources - Select Cube to delete and rebuild the Insights data cube, and Dashboards if you want to replace all OOTB included dashboards with new OOTB dashboards.

   • ダッシュボードのアクセス権 - Insights の既定のダッシュボードへのアクセス権を付与する、ユーザー ロールまたはグループを選択します。

     利用可能なオプションは以下のとおりです。

すべて - 既定のダッシュボードはすべての Insights ユーザーと共有されます。

コンシューマー - 既定のダッシュボードは Insights の表示権限を持つユーザーのみと共有されます。

エディター - 既定のダッシュボードは Insights の編集権限を持つユーザーのみと共有されます。

Insights 管理者 - 既定のダッシュボードは Insights ユーザーと自動では共有されず、代わりに Insights の管理者ユーザーが手動で Insights ポータルから共有します。

• バックフィル - 履歴データのバックフィルを有効化するにはチェックボックスをオンにし、入力フィールドに必要な日数を入力します。

  1. [次へ] をクリックします。警告ウィンドウが表示されるので、[OK] をクリックして続行します。

  2. テナントは有効化され、インストールが完了します。

     重要:

     By default, no custom tables will be created starting with this release. You must add processes and queues to an allowlist via the Manage Custom Tables option in the Admin Tool. The Manage Custom Tables page allows you to select which processes and queue tables you would like to add to the Insights Cube.

     For deployments where the desired number of process and queue tables exceeds the maximum number of 75 per tenant, enabling table grouping will allow the combination of multiple processes or queues into a single group table.

英語以外のデプロイにおけるログの取り込み

英語以外のデータを使用するデプロイ (英語以外の言語での Robot または Studio の実行を含む) では、すべてのログが正しく取り込まれるようにするために、次の変更を行う必要があります。

ウォーム スタート時にバックフィルする履歴ログ:

1. C:\Program Files (x86)\UiPath\Orchestrator\Tools ディレクトリの UiPath.InsightsAdminTool.exe.config ファイルを開きます。
2. キー "Insights.RobotLogsWarmStartupQueryCondition" を検索し、値内の "execution ended" を、お使いのデプロイで使用している言語の適切な翻訳で置換します。

進行中のログの取り込み:

1. C:\Program Files (x86)\UiPath\Orchestrator にある UiPath.Orchestrator.dll.config ファイルを開きます。
2. level の when condition を検索し、値内の execution ended を、お使いのデプロイで使用している言語の適切な翻訳で置換します。

• de > Ausführung beendet
• fr > Exécution terminée
• es-ES > Ejecución finalizada
• es-MX > Ejecución terminada
• ja > の実行が終了しました。
• ko > 실행이 종료되었습니다.
• zh-CN > 执行结束
• pt-pt > Execução terminada
• pt-BR > A execução terminou
• tr > Yürütme işlemi bitti
• ru > Выполнение завершено

例

• 英語

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" /></filters></logger>
  

• ポルトガル語 (ブラジル)

  <logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="false" minlevel="Info" writeTo="insightsRobotLogs"><filters defaultAction="Ignore"><when condition="level >= LogLevel.Error or ends-with('${message}',' A execução terminou')" action="Log" /></filters></logger>
  

Please note that any other string changes to thiswhen condition are not supported and may require a full product reinstall if implemented.

log4j の脆弱性に対処する

Log4j の脆弱性に対応するために修正プログラムを実行してください。この修正プログラムでは依存関係を更新して、Apache Log4j を脆弱性のない最新バージョンに変更できます。

For more information, see the UiPath Insights Advisory (Prior to version 2021.10) section in UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 & CVE-2021-45105j.