Web サービス データ ディップ コネクターのトラブルシューティング


コネクターは、プログラムの実行で起きたすべてのイベントを記録する標準ログ ファイルを含みます。これらのファイルでは追跡と診断が可能です。

コネクターのログ ファイルには 2 つのタイプがあります。

  • ininbridgehost_{X}: これらのログ ファイルは、Bridge サーバーがコネクターを読み込んだときに作成されます。
  • {connector group name}_{X}.ininlog: これらのログ ファイルは、コネクターと設定の読み込みからの両方の追跡、およびコネクターによってログされた追跡を含みます。これらのログ ファイルは毎日作成され、また、コネクターが再起動するたびに作成されます。

これらのログ ファイルのコピーについては、次の手順に従います:

  1. [コネクターの詳細] ページに進みます。
    • At the top of the Admin page, click Admin > Integrations.
    • Bridge ページで、[コネクター] タブをクリックします。
    • 閲覧したいログ ファイルのコネクターをクリックします。
  2. [インスタンス] セクションで、[ログ] をクリックします。
  3. クリックします。 コネクタのログを要求します。.
  4. ダウンロードするファイルをクリックします。

ダウンロードした zip ファイルに両方のタイプのコネクター ログ ファイルが含まれています。

The Bridge Server includes its own logging system for logging information about the internals of the server. These log files contain low-level process details that can describe any problems with starting the server as a whole or with receiving messages. For example, if the Windows processes of the server do not start or there are no relevant traces in the connector log files, check the Bridge Server log files.

サーバーのログ ファイルの 4 つのタイプがあります。

  • ininbridgeprocesslauncher.ininlog: these log files record information about Bridge Server processes, suchas crashes and restarts.
  • ininbridgeserver_{X}.ininlog: これらのログ ファイルは、コネクターおよびそのプロセスの管理についての情報を含みます。
  • ininbridgeservices_{X}.ininlog: これらのログ ファイルは、Bridge サーバーと Amazon Web サービス間の通信についての情報を含みます。
  • ininupdate_ {×} .ininlog: これらのログ ファイルをブリッジ サーバーをシャット ダウンする、新しい更新プログラム パッケージをインストールして、再起動に関する情報を記録します。

これらのログ ファイルのコピーについては、次の手順に従います:

  1. [サーバーの詳細] ページに進みます。
    1. At the top of the Admin page, click Admin > Integrations.
    2. On the Bridge page, click the Servers tab.
    3. Click the server whose log files you want to view.
  2. [ログ] をクリックします。
  3. [サーバーのログをリクエスト] をクリックします。
  4. ダウンロードするファイルをクリックします。

問題

Architectブリッジ アクション下ブリッジ アクションが表示されません。

原因

PureCloud のセットアップでエラーが原因は、Architectのブリッジ アクションは表示されません。

  • 選択していない場合 メタデータを平らにします。 ときに PureCloud のブリッジ アクションを作成します。

    一覧に表示する特定ブリッジ アクション名の代わりに「による互換性のないデータ。 除外アクション {1}」のメッセージが表示されます。 

    Architect での Bridge アクション エラーメッセージのスクリーンショット

  • PureCloud のブリッジ操作を公開していません。

ソリューション

PureCloud でブリッジ アクションを開きます。

  • [メタデータのフラット化]が選択されていることを確認します。
  • ブリッジ アクションが公開されていることを確認します。

問題

ブリッジ アクションは、障害パスをArchitectの呼び出しのフローにします。 

原因

Bridge アクションは、いくつかの理由で失敗することがあります:

  • Search result issues
    • コネクター アクションで検索結果が見つからないか、複数見つかります。

      各コネクター アクションで、コネクターは Web サービス サーバーから 1 つの検索結果を取得します。コネクター アクションが検索結果を見つけられない、または複数の検索結果を見つける場合、Architect の Call Bridge アクションからの失敗経路を取ります。コネクターは Web サービス サーバーから情報を返しません。 

  • Connection issues
    • コネクターが Web サービス サーバーに接続できません。 

      この問題は、一般に、エンドポイント設定がないために発生します。 ただし、この問題は、セキュリティの設定でネットワークのトラフィックが阻止されるか、Web サービス サーバーの機能停止によって発生することもあります。

  • Response issues 
    • 接続がタイムアウトになりました。

      コネクターは、15 秒経過するまで、サーバーから応答を受け取りません。

      メモ: Web サービスを待機しているプロセスはどれも、同時プロセスで許可される最大数から引かれます。このため、Architect または[アクションの詳細]ページでこの長さを超えるタイムアウトが設定されていても、 接続は 15 秒後にタイムアウトします。

    • エンドポイントは、間違ってフォーマットされた応答を送ります。

      コネクターは、応答の本文を正しいフォーマットに変換できません。

    • エンドポイントが実装されていない方法を呼び出そうとします。

      この問題は、デフォルト接続アクションの 1 つを実装していないのに、Web サービスがそれを呼び出そうとするために発生します。

ソリューション

  • Search result issues
    • Architect の入力変数が Web サービスの実装と互換性があり、予期されるものであることを確認します。Architect は引用、句読点、および記号を含め、入力変数を直接 Web サービスへ渡します。
    • Web サービス サーバーで、コネクターが検索したデータと同じデータを検索します。
      • Web サービス サーバーが結果を返さない場合、コール フローで不全パスが正しく選択されます。
      • Web サービス サーバーが 1 つ以上の結果を返す場合、コール フローで不全パスが正しく選択されます。
      • Web サービス サーバーが 1 つしか結果を返さないが、不全パスを選択する場合、コネクターのログ ファイルをチェックして、なぜ不全パスが選択され、結果が返されないか判断します。ログは、結果が返されないか、または複数の結果が返されるとトレースアウトします。 
  • Connection issues
  • Response issues 
    • コネクタがリクエストを完了できない理由に関する情報をログファイルでチェックします。
    • Web サービス プロバイダーに連絡してください。 

問題

プロキシ サーバーを使用すると、いくつかの分後ブリッジ サーバーが切断されます。

原因

ブリッジ サーバーは、PureCloud との双方向通信用長寿命安全な WebSocket 接続を使用します。

ソリューション

長寿命、非アイドル状態の接続を許可する web プロキシを構成します。

問題 

コネクターの起動に失敗しました。

原因

コネクターの失敗には、次のような理由が考えられます。

  • プロキシ サーバーの設定が正しくありません。
  • 他の予期されないエラーが発生した。

ソリューション

  • 設定し、構成されていることを確認、 プロキシ サーバー 正しく。
  • コネクター ログ ファイルでエラーに関する情報をチェックします。

問題

エラー メッセージがログに表示されません。

原因

トレースのデフォルト レベルでは、十分なトレースが返されません。

ソリューション

コネクターのトレース レベルを上げることによって、ロギングをより多く受け取ることができます。トラブルシューティングするには、コネクター設定で log.level を DEBUG に変更します。 

問題

コネクタは Web サービス サーバーに接続できません。

原因

この問題は一般に、コネクター設定のエンドポイント アドレスが無効なために発生します。 ただし、この問題は、セキュリティの設定でネットワークのトラフィックが阻止されるか、Web サービス サーバーの機能停止によって発生することもあります。

ソリューション