Log

3.3.1 Log

説明

Log - スクリプト実行ログ ファイルにメッセージをログ記録します。詳細については実行ログヘルプトピックを参照してください。

リリース4.4.2実行履歴ロギング.スクリプトが実行したステップを詳細にログに記録し、I/O操作の進行状況を記録するためのスクリーンショットを保存します。スクリプトの失敗を追跡するのに便利です。大量のデータが生成されるのを避けるため、ロガーは、設定可能な数の最新のログだけを保存し、スクリプトの実行終了後に実行ログ（log.html）に印刷します。履歴ログを即座にダンプするには歴史たとえば、スクリプトが回復可能な障害を検出した場合などであります。

リリース4.4.3では、履歴ログに以下のオプションが追加されました。履歴ログをコンソール/ターミナルに出力する。.メッセージは無制限に生成され、その場で出力されます。これは、出力を監視するサードパーティのフレームワークとの統合に便利です。

履歴ログとコンソール出力は、デフォルトではオフになっている。これらを有効にするには、Logコマンドに移動します。設定コンソール出力は、スクリプトから_log_history_to_terminal。変数を真の以下の通りです：

Var _LOG_HISTORY_TO_TERMINAL=true

この変数はコンソール出力の環境設定を上書きします。この変数は、環境設定のメイン履歴ロギングフラグが有効になっている場合にのみ動作します。

7.2.6からは、デフォルトのログファイル名 "log.html "をカスタマイズすることができます。そのためには、スクリプトの最初にこの変数を設定してください：

Var _LOG_FILENAME=mylog.html

SYNOPSIS

Log "<text>"[level=<logLevel>〕〔terminal=<true|false>〕 [history=<true|false>]

• 赤色は必須パラメータ

オプション

text

-ログテキスト。実行ログファイルはHTMLフォーマットで生成されるため、HTMLマークアップを含む可能性があります。

level=<ログレベル>

-オプションのログレベル

"SEVERE"、"WARNING"、"INFO"、"CONFIG"、"FINE"、"FINER"、"FINEST "のいずれか。デフォルト値は "INFO "またはLogコマンド環境設定で指定されたカスタム値。

レベルにより、メッセージの優先度によってログファイルをフィルタリングすることができます。デフォルトのフィルターレベル（「最小レベル」とも呼ばれる）は "INFO "であり、これは、ログがこのレベル以上のメッセージのみを記録することを意味します。これにより、詳細なログを記録するスクリプトを構築することができ、対応する環境設定の1つを変更するだけで、後でログの一部をオフにすることができます。

terminal=<true|false>

-trueを指定すると、コマンドはメッセージをターミナル（コマンドプロンプト）にコピーします。デフォルト値は 'false' です。v4.1.3以降でサポートされています。

history=<true|false>

• trueを指定すると、最新のスクリプト履歴がログファイルに記録されます。これには、最新の詳細ログとデバッグスクリーンショットが含まれる。スクリプトでエラーが発生する前に何が起こっていたかを追跡するために使用します。Logコマンドの環境設定でスクリプト履歴の記録機能が無効になっている場合、このパラメータは無視されます。デフォルト値は「false」です。v4.4.2以降でサポートされています。

戻り値

このコマンドは常に0（ゼロ）を返します。

使用例

Log "Suspicious image search coordinates: _SEARCH_X={_SEARCH_X}, _SEARCH_Y={_SEARCH_Y}" level="WARNING"

• 警告ログを作成します。