- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 7: DNS を構成する
- 手順 8: ディスクを構成する
- 手順 9: カーネルと OS レベルの設定を構成する
- 手順 10: ノード ポートを構成する
- 手順 11: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- Cluster_config.json のサンプル
- 全般的な構成
- プロファイル構成
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- ArgoCD の構成
- Kerberos 認証の構成
- 外部の OCI 準拠レジストリの設定
- Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブの構成
- High Availability Add-on の構成
- Orchestrator 固有の設定
- Insights 固有の構成
- Process Mining 固有の構成
- Document Understanding 固有の構成
- Automation Suite ロボット固有の構成
- 監視の構成
- 任意: プロキシ サーバーを構成する
- 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する
- 任意: カスタムの Resolv.con を渡す
- 任意: フォールト トレランスを向上させる
- GPU がサポートされた専用のエージェント ノードを追加する
- Automation Suite ロボット専用のエージェント ノードを追加する
- 手順 15: オフライン インストール用に一時的な Docker レジストリを設定する
- 手順 16: インストールの前提条件を検証する
- uipathc を実行する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 製品を管理する
- Cluster Administration ポータルの利用を開始する
- クラスター内の High Availability Add-on から外部の High Availability Add-on に Redis を移行する
- ObjectStore 間でデータを移行する
- クラスター内の ObjectStore から外部 ObjectStore に移行する
- クラスター内のレジストリから外部の OCI 準拠レジストリに移行する
- インストール後に FQDN を設定する
- Kerberos 認証を設定する
- 外部ツールへログを転送する
- Kubernetes ログを Elasticsearch に転送する
- シングルノード (評価) デプロイからマルチノード (HA) デプロイへのスケーリング
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- NFS バックアップ ディレクトリの権限を減らす方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- Ceph の読み取り専用モードから移行する
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- TLSのバージョンを確認する方法
- 証明書の操作方法
- Ceph のバックアップとデータの復元をスケジュールする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- FIPS が有効化されたクラスターに Insights をデプロイする方法
- cgroup v2 への移行方法
- 仮想マシンの再起動後に Kerberos 認証を回復する方法
- ローカルの Docker イメージをクラスター内のレジストリにプッシュする方法
- バックアップからバケットを除外する方法
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- TLS 証明書の検証エラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- RHEL 8.9 でレジストリの一時インストールが失敗する
- オフライン インストール中に uipath 名前空間のデプロイで頻繁に発生する再起動の問題
- DNS 設定が CoreDNS によって受け入れられない
- メモリ不足によりクラスター内レジストリのシーディングが失敗する
- Document Understanding モダン プロジェクトが有効化されていて、AI Center が無効化されている場合、前提条件の確認に失敗します
- Ceph の異常によりアップグレードが失敗する
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- オフライン環境でアップグレードが失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- Insights の PVC サイズが上書きされたためにアップグレードが失敗する
- 大文字のホスト名が原因でアップグレードが失敗する
- 管理ポータルのタイムアウト期間を設定する
- 移行後に認証が機能しない
- Kinit: Cannot find KDC for realm <AD Domain> while getting initial credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- 無効なステータス コードが原因で GSSAPI 操作が失敗した
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- アカウントが無効なため AD ユーザーのログインに失敗した
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- 初回インストール後に ArgoCD が進行中ステートになる
- ArgoCD リポジトリ サーバー ポッドが CrashLoopBackOff になる
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- 診断ヘルスチェック中に報告されたエラーの不一致
- uipathctl で作成されたワークロードのリソース要求と制限を設定する
- アップストリームに正常な問題はありません
- Redis の起動がウイルス対策によってブロックされる
- TLS 証明書の検証が有効化されていると、AI Center と Document Understanding ポッドの起動に失敗する
- Fluentd では、IPv6 環境ではログはエクスポートされません
- デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- pyodbc 形式の接続文字列を使用して AutomationSuite_ProcessMining_Warehouse データベースに接続できない
- Airflow のインストールが「sqlalchemy.exc.ArgumentError: Could not parse rfc1738 URL from string ''」で失敗する
- SQL Server ポート 1433 を使用する IP テーブル ルールを追加する方法
- CData Sync を実行しているサーバーの Automation Suite の証明書が信頼されない
- Process Mining fails to load after disabling and re-enabling it
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
Automation Suite から Kubernetes インフラストラクチャとアプリケーション ログを Elasticsearch に転送する (利用可能なオプションと推奨されるアプローチを含む)。
Automation Suite は、Kubernetes インフラストラクチャとアプリケーション ログの外部オブザーバビリティ プラットフォームへの転送をサポートします。
このセクションでは、ログを Elasticsearch に転送する方法、利用可能なオプション、およびほとんどのシナリオで推奨されるアプローチの概要について説明します。
このセクションでは、Kubernetes ポッド ログの転送について説明します。
ロボット ログを転送する方法については、「ロボット ログを Elasticsearch に保存する」をご覧ください。
ログ転送オプションを選択する
Elastic は、Kubernetes からログを収集する複数のエージェントと演算子を提供します。Elastic Stack のバージョンに応じて、最適なメカニズムを選択できます。
- Filebeat (従来のアプローチ) Filebeat は、Kubernetes ログを収集して Elasticsearch に配布するための従来の方法でした。古いバージョンの Elasticsearch (7.x および初期 8.x) に適しています。詳しくは、 Elastic の公式ドキュメントをご覧ください。
- Elastic Agent (統合エージェント): Elastic Agent は、ホストごとに 1 つの統合エージェントを使用して、あらゆる形態のデータをどこからでも収集します。Elastic Stack 8.x に推奨されます。詳しくは、 Elastic の公式ドキュメントをご覧ください。
- OpenTelemetry のエラスティック分散 (EDOT) EDOT (Elastic Distribution of OpenTelemetry) は、新規インストールおよび Elasticsearch 8.16+ を使用する環境に推奨されます。
EDOT は、以下の理由から推奨されています。
- OpenTelemetry に完全に準拠
- Elastic が開発とサポートを実施
- 操作が簡単 (Helm チャートおよび CRD)
- 将来に備えた対応力 (Elastic は OTel ファースト戦略を発表)
EDOT を Automation Suite クラスターにインストールするには、Elastic の公式ドキュメントに記載されている手順に従います。
EDOT 構成をカスタマイズする
EDOT の値ファイルを、環境やログ要件に合わせて変更できます。
EDOT の値ファイル内で対応するセクションを見つけ、必要に応じて更新します。設定に関連するものだけを適用します。
完全な構成オプションについては、Elasticsearch と EDOT の公式ドキュメントをご覧ください。
次の例は、一般的なカスタマイズを示しています。
-
ノイズの多いログや大量のログを除外するには、次の設定例を参照してください。
config: receivers: filelog: exclude: - /var/log/pods/opentelemetry-operator-system_opentelemetry-kube-stack*/*/*.log - /var/log/pods/*/*/istio-proxy/*.log - /var/log/pods/*/*/istio-init/*.log - /var/log/pods/*/*/aicenter-hit-count-update/*.log - /var/log/pods/*/*/istio-configure-executor/*.log - /var/log/pods/*/*/on-prem-tenant-license-update/*.log - /var/log/pods/*/*/curl/*.log - /var/log/pods/*/*/recovery/*.log - /var/log/pods/*/*/aicenter-oob-scheduler/*.log - /var/log/pods/*/*/cert-trustor/*.log - /var/log/pods/default_*/*.log - /var/log/pods/fleet-system_*/*.log - /var/log/pods/gatekeeper_*/*.logconfig: receivers: filelog: exclude: - /var/log/pods/opentelemetry-operator-system_opentelemetry-kube-stack*/*/*.log - /var/log/pods/*/*/istio-proxy/*.log - /var/log/pods/*/*/istio-init/*.log - /var/log/pods/*/*/aicenter-hit-count-update/*.log - /var/log/pods/*/*/istio-configure-executor/*.log - /var/log/pods/*/*/on-prem-tenant-license-update/*.log - /var/log/pods/*/*/curl/*.log - /var/log/pods/*/*/recovery/*.log - /var/log/pods/*/*/aicenter-oob-scheduler/*.log - /var/log/pods/*/*/cert-trustor/*.log - /var/log/pods/default_*/*.log - /var/log/pods/fleet-system_*/*.log - /var/log/pods/gatekeeper_*/*.log -
開発設定で自己署名証明書を使用する場合の TLS 設定を構成するには、次の設定例を参照してください。
config: exporters: elasticsearch/otel: tls: insecure_skip_verify: trueconfig: exporters: elasticsearch/otel: tls: insecure_skip_verify: true
これは、非運用環境でのみ使用してください。
-
メトリックとトレースを無効化し、ログ専用モードを使用するには、次の設定例を参照してください。
config: service: pipelines: metrics: null traces: nullconfig: service: pipelines: metrics: null traces: null
EDOT をデプロイすると、クラスター全体で実行されるコンポーネント (コレクター、プロセッサ、エクスポーターなど) が追加されます。その結果、全体的な CPU とメモリの使用量が増加します。クラスターに、これらのコンポーネントをサポートするのに十分なリソースがあることを確認してください。クラスターの要件を満たすために、値ファイル内の EDOT リソースのリクエストと制限を調整できます。