メインコンテンツへスキップ
システム管理者として、常に ABBYY Vantage を監視・管理し、ドキュメント処理中に発生しうるエラーとその原因を特定する役割があります。 ABBYY Vantage を監視するには、次の方法を使用できます。
  • Vantage ログファイル
  • 組み込みの Skill Monitor サービス – 既存の Vantage Skill の統計情報を収集し、完了したトランザクションおよび進行中のトランザクションに関する詳細情報を提供します。また、このサービスを使用して、テクニカルサポートに必要なトランザクションイベント情報を取得できます。
  • サードパーティ製サービス – Vantage の内部プロセスや特定のワークフローを監視し、収集したデータを分析してドキュメント処理のさらなるチューニングおよび最適化を行い、ログを収集・分析できます。
テクニカルサポートに連絡する際には、エラーに関する情報に加えて、次の操作を行うことで、製品およびそのコンポーネントのバージョン情報も提供できます。
  1. 左側のペインで Help をクリックし、About を選択してから Version 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: Client for NFS をインストールし、エクスプローラーを開いて \\<nfs server ip> に移動します。
    • その他の種類の外部ストレージを使用する場合: アクセス方法についてシステム管理者にお問い合わせください。
  2. \\<nfs server ip>\<sharename>\<env>\abbyy-monitoring\fluentd-pvc ディレクトリに移動します。

テクニカルサポートへのログ提供

ABBYY テクニカルサポートに Vantage のログを提供するには、次の手順を実行します。
  1. ログフォルダーに移動します。ログは、Kubernetes クラスターの Namespace と同じ名前のサブフォルダーに保存されています。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 と一緒にはインストールされないため、別途インストールとセットアップを行う必要があります。これは、製品がインストールされているかどうかに関係なく実施できます。既存のインストール環境を使用することもできます。
以下のサンプルセットアップ手順は簡略化されたものであり、例としてのみ提供されています。
Elasticsearch と Kibana をインストールするには、次の手順を実行します。
  1. リポジトリをクローンします:
  1. リソースをデプロイするためのオペレーターをインストールします:
  1. 次の内容で elastic.yaml という名前のファイルを作成します:
  1. kibana.yaml という名前のファイルを、次の内容で作成します:
  1. 次のコマンドを実行して Elasticsearch をインストールします:
デプロイのステータスを確認します:
  1. Kibana をインストールするには、次のコマンドを実行します。
デプロイ状況を確認する:
  1. Elasticsearch ユーザーのパスワードを取得します:
  1. 次の Parameter を env_specific.yaml ファイルに追加します:
  1. 既に製品がインストールされている環境に後から Kibana をインストールする場合は、env_specific.yaml ファイルを更新し、次のコマンドを実行します。

Grafana

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