メインコンテンツへスキップ
システム管理者は、ABBYY Vantage を常時監視し、管理するとともに、文書処理中に発生する可能性のあるエラーやその原因を特定する必要があります。 ABBYY Vantage は、次の方法で監視できます。
  • Vantage のログファイル
  • 組み込みの Skill Monitor サービス。既存の Vantage Skill に関する統計を収集し、完了済みおよび進行中のトランザクションについて詳しい情報を提供します。また、技術サポートに必要なトランザクションイベント情報も取得できます。
  • サードパーティ製サービス。これらを使用すると、Vantage の内部プロセスや特定のワークフローを監視し、収集したデータを分析して文書処理をさらに調整・最適化し、ログを収集・分析できます。
技術サポートに問い合わせる際は、エラーに関する情報に加えて、次の手順で製品およびそのコンポーネントのバージョン情報も提供できます。
  1. 左側のペインで Help をクリックし、AboutVersion details の順に選択します。
  2. 詳細をコピーします。

診断ログにアクセスする方法

Vantage でドキュメントの処理中に作成されたログファイルは、製品をインストールしたマシン上にローカル保存されます。 ログは次のように保存されます。すべての Kubernetes ノードで実行されている Fluent Bit エージェントがコンテナーのログを収集し、Fluentd アグリゲーターサービスに送信します。既定では、すべてのログは永続ボリューム上にアーカイブファイルとして保存され、NFS を使用してアクセスできます。必要に応じて、管理者はログを Elasticsearch クラスターに送信することもできます。 Fluent Bit エージェントが Docker コンテナーからログを収集し、Fluentd アグリゲーターサービスに送信して、Elasticsearch と永続ボリュームストレージに出力する Kubernetes のロギングアーキテクチャ 診断ログにアクセスするには:
  1. 外部 NFS サーバーまたはその他の外部ストレージを使用している場合は、手順 3 に進んでください。
  2. クラスター内 NFS サーバーを使用するインストールの場合 (高可用性なし 構成の既定) 、NFS サーバーの IP アドレスを取得します:
  1. 共有にアクセスします:
    • NFS の場合:
      • Linux: mount –t nfs <nfs server ip>:/ /opt/mount
      • Windows: ClientForNFS をインストールし、エクスプローラーを開いて \\<nfs server ip> にアクセスします
    • その他の種類の外部ストレージの場合: アクセス方法については、システム管理者にお問い合わせください。
  2. \\<nfs server ip>\<sharename>\<env>\abbyy-monitoring\fluentd-pvc ディレクトリに移動します。

テクニカルサポートにログを提供する

ABBYYカスタマーサポートにVantageのログを提供するには、次の手順に従います。
  1. ログフォルダーに移動します。ログは、Kubernetes クラスターの各名前空間と同名のサブフォルダーに保存されています。Vantage のログは abbyy-vantage フォルダーにあります。
  2. 問題が発生した時間帯のファイルをコピーします。ログは gzip ファイルとして圧縮されており、ファイル名は Y-M-DD-H 形式です (例: 2022-12-09-0800.log.gz) 。
  3. ファイルを ABBYY テクニカルサポートに送信します。

Elasticsearch と Kibana

Elasticsearch と Kibana は、ログの検索、分析、可視化を行うためのツールです。Elasticsearch と Kibana は ABBYY Vantage と一緒にはインストールされないため、別途インストールして設定する必要があります。これは、製品がインストールされているかどうかにかかわらず実行できます。既存のインストール環境を使用できます。
以下のsampleセットアップ手順は簡略化されており、あくまで一例として記載しています。
Elasticsearch と Kibana をインストールするには:
  1. リポジトリをクローンします:
  1. リソースをデプロイするオペレーターをインストールします:
  1. 次の内容を記述した elastic.yaml という名前のファイルを作成します。
  1. 次の内容で、kibana.yaml という名前のファイルを作成します。
  1. Elasticsearch をインストールするには、次のコマンドを実行します。
デプロイのステータスを確認します:
  1. Kibanaをインストールするには、次のコマンドを実行します。
デプロイのステータスを確認します:
  1. Elasticsearch ユーザーのパスワードを取得します:
  1. 次のパラメーターを env_specific.yaml ファイルに追加します:
  1. 製品のインストール後に Kibana を追加でインストールする場合は、env_specific.yaml ファイルを更新し、次のコマンドを実行します。

Grafana

Grafana (Prometheus と併用) は、データの可視化、監視、分析を行うためのツールです。Grafana は ABBYY Vantage と同時にはインストールされないため、別途インストールして設定する必要があります。既存のインストール環境を使用できます。
Prometheus はクラスター内でのみ利用できるため、Grafana もクラスターにインストールする必要があります。
以下のセットアップ手順は簡略化したサンプルであり、例としてのみ提供されています。
Grafana をインストールするには:
  1. grafana.yaml という名前のファイルを作成します。
  2. 次のコードをファイルにコピーして貼り付け、保存します。
host パラメーターの値をお使いの Vantage クラスターのドメイン名に置き換え、初期管理者のパスワードを変更してください。
  1. 次のコマンドを実行します: