こんにちは。CData Software Japan の色川です。
CData のテクニカルサポートでは、製品プロフェッショナルが、それぞれのユースケースにあわせたサポートをご提供しています。
CData Arc についてサポートを利用される際、利用しているArc のバージョンやライセンス情報を最初にお伝え頂くと、サポートの初動がスムーズになり、よりスピーディーに必要な情報をご案内することができます。
何かのエラーが発生した場合のトラブルシュートでは、Arc が出力する各種ログファイルが役に立ちます。Arc ではフローを構成する各コネクタの挙動や、アプリケーション全体の実行状況など様々な情報が記録されており、トラブルシュートではそれらのログ情報がとても有効です。もちろんサポートへお問合せ頂く際にも、これらのログ情報はとても有用です。
また、Arc で作成したフローが期待通りに動作しない場合などにご相談頂く場合では、フローやコネクタの設定をエクスポートしてお問合せ頂くとスムーズです。
この記事では、CData Arc のサポートを利用するときに役立つ設定情報や各種ログの取得方法をご紹介します。
ライセンス情報
CData Arc についてサポートを利用される際、利用しているArc のバージョンやライセンスに関する情報をお伝え頂くと、サポートの初動がスムーズになり、より迅速にご案内することができます。
Arc の設定ページにある「ライセンス」タブでは、利用しているライセンスエディションやArc のバージョン、コネクタの利用状況などの情報を確認することができます。ちなみにバージョン情報はこちらで確認することができます。
サポートを利用される際は、製品ライセンスやバージョン情報を明記してお問合せいただくと、よりスムーズにご案内することができます。ぜひご活用ください。ライセンスタブのスクリーンショットをお送り頂くのも手軽かも知れません。
ログ
Arc で何かのエラーが発生した場合のトラブルシュートでは、Arc が出力する各種ログファイルが役に立ちます。Arc ではフローを構成する各コネクタの挙動や、アプリケーション全体の実行状況など様々な情報が記録されており、トラブルシュートではそれらのログ情報がとても有効です。
ログの見方や取得の仕方を知っておくと日々の運用に役立ちますし、これらのログ情報はサポートへお問合せ頂く際にも有用です。ここではトラブルシュートで利用することが多い、コネクタログとアプリケーションログの取得方法をご紹介します。
コネクタログ（フローページ）
コネクタの実行結果は、フローデザイナー上では各コネクタのインプットやアウトプットタブで確認することができます。フローの起点となるコネクタではアウトプットタブで。それ以外のコネクタではインプットタブで、コネクタの実行結果を記録したログを確認することができます。
確認したいトランザクションについて左側の「+」で開くと、実行メタデータ（Additional Details）やログを確認することができます。
コネクタログを取得したい場合は、ここにある「すべてのログをダウンロード」から取得するのが便利です。コネクタログとして、処理対象となったメッセージファイルとコネクタの実行ログを含んだzip ファイルを取得することができます。
トラブルシュートの内容によっては、通常のコネクタログより更に詳細な情報が必要になる場合があります。豊富なコネクタを持つArc ではログのレベルを調整するプロパティが幾つかありますが、最も一般的なプロパティはコネクタの「高度な設定」に含まれる「ログレベル」です。サポートへ問合せたときに「ログレベルをDebug 以上にしたコネクタログを取得してください」等のようなリクエストがあった場合は、このプロパティで調整して、必要なログを取得してください。
コネクタログ（アクティビティページ）
コネクタの実行結果はアクティビティページでも確認することができます。もちろんアクティビティページからもコネクタログを取得することができます。開発段階ではなく運用段階の場合、アクティビティページから確認・取得するケースが多いかも知れません。
メッセージタブでは、フローを通るメッセージの全体的な流れについて確認することができます。確認したいステータスのメッセージがあれば、左側の「+」から詳細を開きます。
トランザクションタブでは、フローを構成する各コネクタのインプット/アウトプット単位に確認することができます。確認したいステータスのトランザクションがあれば、左側の「+」から詳細を開きます。
いずれのタブでも、エラー表示を開いて「すべてのログをダウンロード」をクリックすると、コネクタログとして、処理対象となったメッセージファイルとコネクタの実行ログを含んだzip ファイルを取得することができます。
アプリケーションログ
アクティビティページのアプリケーションタブでは、Arc の実行中に発生したアプリケーションレベルのエラーや、様々なリソースへのリクエストなどが記録されます。Arc の全体的な挙動を把握したい場合など、アプリケーションログの確認が有効がアプローチの1つです。
アプリケーションログはアプリケーションタブ右側の「ログファイルをダウンロード」から取得することができます。アプリケーションログは*.log ファイルとして取得することができます。
設定情報
Arc で作成したフローが期待通りに動作しない場合などにお問合せ頂く際は、フローやコネクタの設定をエクスポートして共有頂くとスムーズです。またArc の全体状況について調査や確認が必要な場合、Arc 全体の設定をエクスポートが役に立つケースもあります。
コネクタやフローをエクスポート（*.arcflow）
コネクタやフロー、それらを含むワークスペースの単位でエクスポートしたい場合、エクスポートウィザードを利用します。
フローデザイナーのワークスペース選択から実行できる「ワークスペースをエクスポート」は、対象のコネクタやフローを含むワークスペース全体を対象にエクスポートしたい時に便利です。カスタムエクスポートでは、必要なコネクタや設定種類だけを選択することもできます。
フロー中の幾つかのコネクタを選択してエクスポートしたい時には「複数アイテムを選択」をクリックしてから、エクスポートしたいコネクタ群をボックス選択し、右クリックから「コネクタ設定をエクスポート」してエクスポートウィザードを起動します。
単一のコネクタをエクスポートしたい時には、エクスポートしたいコネクタを右クリックして「コネクタ設定をエクスポート」からエクスポートウィザードを起動します。
上記のようにエクスポートウィザードの起動方法は幾つかありますが、ワークスペース全体か、複数のコネクタか、単一のコネクタかで使いやすい方法を選ぶと便利です。エクスポートウィザードでは機密情報を含めるか否かや、必要なコネクタや設定種類だけを選択することもできます。エクスポートファイルは *.arcflow ファイルとして取得することができます。
Arc のアプリケーション設定をエクスポート（*.arc）
複数のワークスペースやArc 全体の設定などを含む、Arc のアプリケーション設定（グローバルアプリケーションデータ）をエクスポートしたい場合、「移行」機能に含まれる「アプリケーション設定のエクスポート」を利用します。
Arc の設定ページに含まれる「移行」タブから「設定をエクスポート」を選択すると「アプリケーション設定のエクスポート」が起動します。カスタムエクスポートでは、全てのワークスペースや各種設定（プロファイルやユーザー、ロール、Vault など）から必要なモノだけを選択することもできます。エクスポートファイルは *.arc ファイルとして取得することができます。
まとめ
この記事では「CData Arc のサポートを利用するときに役立つ設定情報や各種ログの取得方法」をご紹介しました。
CData Arc を効率的に使いこなすために、機能や使い方に関する質問や、エラー発生時のトラブルシュートで困ったときには、ぜひテクニカルサポートをご活用ください。製品プロフェッショナルが、ユースケースにあわせて適切にサポートします。
CData Arc はシンプルで拡張性の高いコアフレームワークに、豊富なMFT・EDI・エンタープライズコネクタを備えたパワフルな製品です。CData Drivers との組み合わせで270を超えるアプリケーションへの連携を実現できます。
皆さんのつなぎたいシナリオでぜひ CData Arc を試してみてください。
CData Arc - セキュアなデータ連携とマネージドファイル転送（MFT）
製品を試していただく中で何かご不明な点があれば、テクニカルサポートへお気軽にお問い合わせください。
CData Software Japan - Support Form
この記事では CData Arc™ 2023 - 23.4.8839.0 を利用しています
関連コンテンツ
