強化されたログ記録プロジェクトの使用

Velocity Client の「強化されたログ記録」とは、管理者が Android デバイス上のデバッグログをオンにしてログファイルを容易に取得できるようにするための方法です。Velocity ログ、ネットワークログ、および画面キャプチャファイルに関して、強化されたログ記録を使用します。強化されたログ記録を使用してログレベルを変更すると、デバイス上のプロファイルで設定されているログレベルが一時的に上書きされます。これにより、既存のホストプロファイルの変更やデバイスへのファイルの配布を行うことなく、デバッグログの開始と停止を行えます。

強化されたログ記録プロジェクトを作成し、収集するログファイルまたは画面キャプチャを指定した後、表示された QR コードを Client を使用してスキャンします。Client は、次のいずれかの条件が満たされるまで、デバッグログまたは画面キャプチャまたはその両方をオンにします。

•デバイスユーザが強化されたログ記録をオフにする。

•[メニュー] > [終了] をタップすることで Client が閉じられる。

•デバイスの当該ファイル用のメモリが不足する。

強化されたログ記録が停止すると、Client はユーザにメッセージを表示し、ファイルを zip して Console に送信しますので、管理者は Console でそれらのファイルを調べることができます。Console が使用可能になっていない場合、zip ファイルはデバイスの Downloads/com.wavelink.velocity ディレクトリに保存されます。

QR コードを使用せずにデバイスユーザが強化されたログ記録をオンにすることはできますが、ファイルは常にデバイス上にローカルに保存され、Console には送信されません。QR コードを使用せずに強化されたログ記録をオンにする方法については、「Velocity Client の使用」をご参照ください。QR コードを使用せずに強化されたログ記録をオンにした場合、画面キャプチャファイルは含まれません。

強化されたログ記録プロジェクトで画面キャプチャをオンにすると、Client は、強化されたログ記録が使用されている間、アクティブになっているセッションごとに個別の画面キャプチャファイル (.wltsc) を作成します。

デバイスが Android 10である場合、Client は Downloads/com.wavelink.velocity ディレクトリにアクセスできないため、代わりにファイルを Android/data/com.wavelink.velocity/files ディレクトリに保存します。 Android 10 以降のバージョンの Android デバイスではダウンロードディレクトリにアクセスできますが、Android 10 ではアクセスできません。

QR コードはどのように機能するか

QR コードを使用して強化されたログ記録をオンにすると、Console は、HTTPS 経由でファイルを受信するサーバのような役割を果たすと同時に、QR コードの表示も行います。トラフィックは、QR コードに組み込まれているトークンを使用して保護されます。適切なセキュリティのため、強化されたログ記録を自発的に使用している場合にのみ、QR コードを表示するようにしてください。QR コードを印刷することを選ぶ場合は、QR コードへのアクセスを制限することを推奨します。QR コードは、QR コードを生成した Console に固有のものです。

Console が Client から zip ファイルを受信するためには、デバイスがロギングを停止したときに Console が QR コードを表示している必要があります。受信したファイルは Downloads フォルダに保存されます。QR コードが表示されていない場合、Console はいかなるファイルも受け取りません。(この場合、デバイスには Console が使用可能になっていない旨のメッセージが表示され、ファイルがローカルに保存されます)。ただし、プロジェクトを一度閉じて後で再度開いた場合に、Client がロギングを停止した際と同じ QR コードが表示されている限り、まだデバイスはファイルを Console に送信できます。この QR コードは、Console を再起動すると、またはホストアドレスまたはポートを変更すると、無効になります。

強化されたログ記録のオプション

強化されたログ記録プロジェクトには、以下のオプションがあります。

•顧客。プロジェクトが関連付けられている会社または組織の名前。

•ホスト。ローカルコンピュータの IP アドレスまたはホスト名。ホストアドレスは QR コードで使用されているため、ホストアドレスを変更すると QR コードも変更され、前に生成された QR コードは無効になります。

•ポート。Console が着信ファイルをリッスンするポート。他のものがこのポートを使用しないようにしてください。

•含む:

•デバッグログ。すべてのセッションのログレベルをデバッグに設定し、Console に送信されるファイルに Velocity ログを含めます。

•ネットワークロギング (TE のみ)。ネットワークロギングのログレベルをデバッグに設定し、Console に送信されるファイルにネットワークログを含めます。ネットワークログは Web セッションには適用されません。

•画面キャプチャ (TE のみ)。画面キャプチャをオンにして、アクティブなすべての TE セッションの画面をキャプチャします。セッションごとに個別の画面キャプチャファイルがあります。画面キャプチャファイルは Console に送信されます。画面をカスタマイズするための画面キャプチャの使用について詳細は、「画面の構成」をご参照ください。

•ログファイルの場所を開く。デバイスから送信されたファイルが保存されているローカルの場所を開きます。

QR コードを用いて強化されたログ記録を使用するには

最初の2つの手順は Velocity Console で実行し、残りの手順は Android デバイス上の Velocity Client で実行します。QR コードを使用せずにデバイスで強化されたログ記録を開始することはできますが、デバイスは、ロギング完了時にファイルを Console に送信しません。

1.Velocity Console で、強化されたログ記録プロジェクトを開きます。

2.右上端にある [バーコードを表示] をクリックします。

3.Android デバイス上の Velocity Client で、プロファイルリストに移動し、[メニュー] > [強化されたログ記録] をタップします。

4.必要に応じてパスワードを入力します。

5.デバイスで QR コードをスキャンします。

6.[強化されたログ記録を開始] をタップします。

デバイスユーザが [メニュー] > [強化されたログ記録] > [強化されたログ記録の停止] をタップして強化されたログ記録をオフにするか、ユーザが [メニュー] > [終了] をタップするか、デバイスの当該ファイル用のメモリが不足するか、このいずれかの条件が満たされるまで、Client は要求されたロギングタイプをオンにします。デバイスがファイルの送信を試行した際に、強化されたログ記録の QR コードが表示されること、また zip されたファイルが Console によって受信されたときに、それらのファイルが [受信したファイル] リストに表示されることを確認してください。

Console が使用可能になっていない場合、Client は Console に接続できない旨のメッセージを表示し、ログファイルをローカルに保存します。

Client が正常に接続されない場合は、Console の別のホスト名を使用してみてください。たとえば、短いホスト名で接続に失敗した場合は、代わりに IP アドレスを使用してみてください。