logapp - クラウド上のオンライン

プログラム：

NAME

logapp - アプリケーション出力スーパーバイザー。

SYNOPSIS

ログアプリ [オプション] ... [--logapp_オプション] ... [アプリの引数] ...

アプリケーションシンボリックリンク [--logapp_オプション] ... [アプリケーションの引数] ...

logapp を直接呼び出す代わりに、次の名前のシンボリックリンクを作成することもできます。
logapp を指すアプリケーション。 Logapp は名前のアプリケーションを自動的に起動します
に指差す。 シンボリックリンク名に接頭辞が付いている場合にも機能します。 ログ.

DESCRIPTION

Logapp は、アプリケーションの実行を監視するのに役立つラッパー ユーティリティです。
大量のコンソール出力を生成します (make、CVS、Subversion など)。 これはログを記録することで行われます。
出力を表示する前に、出力の各行をトリミングし、色付けします。 それは呼び出すことができます
監視すべき実行可能ファイルの代わりに。 次にアプリケーションを起動し、
すべてのコンソール出力をファイルに記録します。 ターミナルに表示される出力は次のとおりです
たとえば、印刷行の長さを制限したり、標準エラー出力を形式で表示したりするために前処理されます。
異なる色。 特定の条件に一致する行を自動的に強調表示することもできます。
正規表現。 したがって、出力は必要な量まで削減され、すべての
重要な行は簡単に識別できます。

OPTIONS

の前に提供されるオプションは、 引数は logapp によって直接処理されます。
の後に提供されるオプション 引数は、接頭辞が付いている場合にのみ解析されます。
--logapp_ (長いオプション名のみ) それ以外の場合、それらはアプリケーションに渡されます。 ログアプリの場合
シンボリックリンク経由で呼び出されると、プレフィックスのないすべてのオプションがアプリケーションに渡されます。

通常、すべてのアプリケーションは XNUMX つの独立した出力ストリームを使用します。 (Linuxで言うところのstdout） 通常出力の場合
　 stderr エラーや重要なメッセージについては、 両方とも独立して処理されます
logapp であるため、両方のストリームで多くのオプションを使用できます。

ブール型オプションを受け入れます 1/0 　 真/偽 価値として。 長いブール値オプションの場合、値
省略可能です。その場合は「true」とみなされます。

全般的な OPTIONS
-?, - 助けて
利用可能なすべてのオプションの簡単な概要を表示します。

- バージョン
バージョン情報を表示します。

--configfile =FILE
構成検索を検索する代わりに、特定の構成ファイルを使用する
パス。

--showconfig
logapp の現在の設定を出力し、アプリケーションが終了する前に終了します。
実行されました。 これを使用して、すべての構成オプションが設定されているかどうかを確認できます
何かが期待どおりに動作しない場合は正しく動作します。

--configsection=NAME
構成ファイル内の特定のセクションを有効にします。 このオプションが提供されていない場合
アプリケーション名がデフォルトとして使用されます。

-無効にする
これにより、logapp データの処理が完全に無効になります。 アプリケーションはまだ起動中ですが、
ただし、logapp はアプリケーションからのデータ ストリームには影響しません。 どちらでもない
ログ記録も出力フォーマットも実行されず、実行時と終了のみが実行されます。
状態は追跡されています。 これは、logapp が予期されたデータを処理できない場合に役立ちます。
たとえば、curses ベースのアプリケーションを開始する場合などに正しく実行されます。 見て
--disable_keywords このオプションを自動的に有効にする方法を確認してください。

--disable_keywords=キーワードリスト
このオプションを使用すると、カンマで区切られたキーワードのリストを指定できます。
原因 -無効にする アプリケーションオプションで見つかった場合は自動的に有効になります
リスト。 これは、アプリケーションが通常行ベースの出力を提供する場合に便利ですが、
バイナリデータを作成するか、特定のメソッドで呼び出された場合はcursesベースのフロントエンドを使用します。
パラメータ。 を使用することもできます。 --detectescape これを行う別の方法のオプション
ロギング機能を無効にすることなく。

--detectescape=ブール
このオプションを使用して、エスケープ シーケンスの検出をオンまたはオフに切り替えることができます。 逃避行で――
シーケンス検出ログアプリは自動的に char ベースのストリーム処理を有効にします。
エスケープ シーケンスが特定のストリームの一部になるとすぐに。 この動作は次の可能性があります
通常は行ベースのアプリケーションを使用している場合に便利ですが、
画面をフォーマットするためにエスケープ シーケンスを使用している可能性がある他のアプリケーションを起動します。
このオプションを使用すると、その場合に端末が混乱するのを防ぐことができます。

--dumbterm=ブール
このオプションを true に設定すると、端末出力の色付けは行われなくなります。 (Linuxで言うところのstdout）
　 stderr。 通常、このオプションは無効になっており、logapp は「ダム」を検出しようとします。
端子自体。

--usepty=ブール
このオプションは、logapp が PTY サポートを使用してコンパイルされている場合にのみ使用できます。 PTYの場合
このオプションを true に設定するとサポートが有効になり、logapp が開きます。 ニックネーム ターミナル
の (Linuxで言うところのstdout）。 これは、通常必要なアプリケーションで logapp を実行するのに役立ちます。
出力用の実端子。 ほとんどの行ベースではこのオプションを無効にすることができます
make、CVS、Subversion などのアプリケーション。 Telnet や
picocom は、PTY サポートなしで使用すると、奇妙な結果を引き起こす可能性があります。

--ptyremovecr=ブール
このオプションは、logapp が PTY サポートを使用してコンパイルされている場合にのみ使用できます。 いつ
アプリケーション出力を取得するために疑似端末を使用すると、常に CR- が得られます。
LF 行末。UNIX 環境で作業する場合、これは通常望ましくない。
このオプションを有効にすると、logapp はすべての CR-LF 行を自動的に変換します。
LF 行末で終わる。 このオプションはデフォルトで有効になっています。

--stdout_blen=バイト

--stderr_blen=バイト
ラインバッファのサイズは次のように調整できます。 (Linuxで言うところのstdout） 　 stderr これで独立して
オプション。 値が小さすぎると、バッファーがいっぱいになったときに行が分割されます。
デフォルトは 2048 バイト これは、ほとんどのアプリケーションにとって十分な大きさになるはずです。

--stdout_charbased=ブール

--stderr_charbased=ブール
行ベースの出力を生成しないアプリケーションで logapp を使用する場合
このオプションを有効にすると、 (Linuxで言うところのstdout） 　 stderr 独立して。 このオプションを使用すると
有効な logapp は完全な行を予期せず、データが入ってきたときに処理します。
このオプションがオンの場合、デフォルトではすべての単一データ パケットが新しい行に書き込まれます。
有効にすると、これは次のコマンドで変更できます。 --alignlog オプション。 結果がこうなるとしたら
使用できるかどうかは、アプリケーションによって生成されるデータの種類によって異なります。

--extended-regexp=ブール
このオプションが有効な場合、logapp は指定された正規表現を解釈します。
拡張正規表現としてのパターン。 デフォルトでは、基本的な通常を使用します。
式。

ロギング OPTIONS
このセクションには、ログファイルに影響するオプションが含まれています。

-l, --logfile =file
このオプションを使用すると、ログの保存に使用されるファイルを変更できます。
アプリケーションデータ。 空の文字列が指定された場合、ログ記録は無効になり、
ログファイルが作成されます。 デフォルトでは、logapp は次の名前のログファイルを作成します。
ログアプリ.ログ 現在のディレクトリにあります。

-a, --appendlog=ブール
このオプションは、ログファイルを切り詰めるか、データを切り詰めるかを指定します。
logapp の起動時に既存のファイルに追加されます。

--maxlogsize=キバイト
ログファイルの最大サイズを制限するには、このオプションを次の値に設定します。
10 　 4000000 キロバイト。 デフォルトは 0 これにより、ログファイルのサイズ制限が無効になります。
ログファイルを制限する方法はさまざまに実装されています。 を見てください。
オプション --logrename 　 --循環ログ 詳しく知ることができ。 デフォルトの方法は、
拡張子 .old がログファイルに追加され、新しいログファイルが開始されます。

--logrename=ブール
このオプションは、ログファイルが切り詰められるときの動作を指定します。 もし
--logrename 有効にすると、ログファイルの名前が変更されます。 新しいファイル名は次と同じになります
で定義された拡張子を使用する前 --oldlogext 追加した。 デフォルトの拡張子は
。古い。 このオプションは、次の値と一緒に使用されます。 --appendlog 　 --maxlogsize

--circularlog=ブール
このオプションが、ログファイルのサイズ制限とともに有効になっている場合、 --maxlogsize,
ログファイルは循環的に使用されます。 これは、最大サイズが次の場合を意味します。
に到達すると、ファイル ポインタはファイルの先頭と古いコンテンツに設定されます。
最初から上書きされます。 役立つタグがログファイルに追加されています
ファイル内を移動します。

--oldlogext=
これは、logapp がログファイルの名前を変更するときに使用される拡張子を定義します。 の
--logrename オプションは、logapp がファイルの名前とデフォルトの拡張子を変更するかどうかを定義します
は古い。

--locklogfile=ブール
このオプションをアクティブにすると、ログファイルはロックされます。
別のタスクによって上書きされます。 これは、そうでないと読み取れない混同が発生する場合に便利です。
結果は異なる内容になります。 の値に応じて、
--maxaltlogfiles オプションで、同じ名前と番号を持つ別のログファイルが選択されます
追加した。 ログファイルのロックはデフォルトで有効になっています。

--warnlogfilelock=ブール
このオプションは、次の場合にコンソールに警告を出力するかどうかを定義します。
選択したログファイルはすでにロックされているか、他の方法でアクセスできません。 この場合
アプリケーションの起動前と起動直後にメッセージが表示されます。
代替ログファイルの名前が記載されている実行。 このオプションは
デフォルトで有効になっています。 こちらもご覧ください --printlogname どこに定義できるか
報告された現在のログファイルを常に取得します。

--printlogname=ブール
このオプションは、使用されたログファイルの名前をログファイルの後に出力するかどうかを定義します。
アプリケーションの実行が終了しました。 このオプションはデフォルトでは無効になっています。 また
を見てください --warnlogfilelock ここで、警告を有効/無効にできます。
ログファイルがロックされているため、ログファイル名が変更されました。

--maxaltlogfiles=数
このオプションは、ログファイル名に追加できる最大数を定義します。
元のファイルにはアクセスできません。 logapp の起動時に、
現在定義されているログファイルは書き込み可能ですが、そうでない場合は自動的に書き込み可能です。
ファイル名に数字が付加されます。 代替ファイルにもアクセスできない場合
この数値は、ファイルが書き込み可能になるか、次の値になるまで増加します。 maxaltlogファイル is
に達しました。 後者の場合、アプリケーションはエラーで終了します。 の値の場合
0 を使用すると、元のログファイル名のみが試行されます。 こちらもご覧ください
--warnlogfilelock 　 --printlogname メッセージがあるかどうかを定義するオプション
現在使用されているログファイルについて。

--alignlog=ブール
このオプションは一緒に使用されます --stdout_charbased 　 --stderr_charbased 　
データパケットが到着時にログファイルに書き込まれるか、それともそれぞれのデータパケットがログファイルに書き込まれるかを定義します。
新しい行に書き込まれます。 デフォルトでは、各データ パケットは新しいパケットに書き込まれます。
行で、このオプションを false に設定して無効にします。

--alignlinebreaks=ブール
このオプションは一緒に使用されます --stdout_charbased 　 --stderr_charbased 　
プレフィックスとタイムスタンプに関してログファイル内の行を左に揃えます。
このオプションはデフォルトで有効になっています。

--jointimeout=時間
このオプションは一緒に使用されます --stdout_charbased 　 --stderr_charbased 　
単一パケットを XNUMX つに結合するためのミリ秒タイムアウトを定義します。 これは、たとえば、
タイムアウト内に XNUMX つの文字が書き込まれると、それらは XNUMX つのパケットとして扱われます。 これは
と一緒に使用するのが最適です --alignlog 　 --ログタイム。 データが次の場合にこのオプションを使用します。
パケットは何らかの理由で一貫性を失いました (たとえば、データが
シリアルライン）。 この機能はデフォルトでは無効になっていますが、設定によって有効にできます。
時間 0 ミリ秒より大きな値に設定します。

-t, --logtime=ブール
このオプションを有効にすると、ログファイルの各行にミリ秒タイムスタンプを追加できます。
通常はアプリケーション起動からの時間が使用されますが、これは次のように変更できます。
　 --logreltime オプションを選択します。

--logreltime=ブール
このオプションを true に設定すると、 --logreltime オプションは相対値を使用します
ログに記録されたタイムスタンプの最後の行からの時間。

--logenv=ブール
このオプションを true に設定すると、logapp はすべてのアクティブな環境のリストを追加します。
変数をログファイルに書き込みます。 このオプションはデフォルトでは無効になっています。

-p, --stdout_lineprefix=接頭辞

-P, --stderr_lineprefix=接頭辞
区別できるようになるには (Linuxで言うところのstdout） 　 stderr ログファイルの出力 logapp にはプレフィックスを付けることができます
各行には、その行が特定のデータに属しているかどうかを示す文字列が含まれます。
ストリーム。 これらの文字列はこのオプションで変更できます。 デフォルトでは、 (Linuxで言うところのstdout）
プレフィックスがありません、そして stderr 接頭辞が付いています 標準誤差:.

CONSOLE 出力 OPTIONS
このセクションには、コンソール上の視覚的な出力に影響を与えるオプションが含まれています。

--dumbterm=ブール
このオプションは出力の色付けを無効にします。 これは通常、次の場合に自動的に行われます。 ダム
端子が検出されました。

-s, --print_summary=ブール
このオプションが true に設定されている場合、短い概要がメッセージの後に出力されます。
アプリケーションは終了しました。 このオプションはデフォルトでは無効になっています。

-f, --stdout_fgcol=カラー

-F, --stderr_fgcol=カラー
このオプションは、特定のデータ ストリームの前景色を定義します。 値
のエントリの XNUMX つにすることができます。 コンソール カラー テーブル このセクションの終わりに。

-b, --stdout_bold=ブール

-B, --stderr_bold=ブール
このオプションは、特定のデータ ストリームのフォントを印刷するかどうかを定義します。
大胆な。

-r, --stdout_regexp=レギュラー 表現

-R, --stderr_regexp=レギュラー 表現
このオプションで定義できる正規表現は、すべてのオブジェクトに適用されます。
特定のデータ ストリームの行。 試合が行われると、背景色が次のように変わります。
で提供される値 --stdout_regexp_bgcol それぞれ --stderr_regexp_bgcol
オプションを選択します。

--stdout_regexp_bgcol=カラー

--stderr_regexp_bgcol=カラー
このオプションは、ケースの特定のデータ ストリームの背景色を定義します。
適切な正規表現が提供されていること --stdout_regexp or
--stderr_regexp 一致します。 値は、 コンソール カラー
テーブル このセクションの終わりに。

-c, --stdout_clip=幅

-C, --stderr_clip=幅
このオプションは、特定の出力に対してどの列で出力をクリップするかを定義します。
ストリームを使用して、コンソールに書き込まれるデータ量を削減します。 の値の場合 -1 is
ストリームのクリッピングが無効になっている場合。 の値 -2 クリッピングを次のように設定します
現在のコンソールの幅。 を使用することも可能です disable 　 オート
数値。 デフォルトでは、 (Linuxで言うところのstdout） コンソールの幅に制限されており、
クリッピングが無効になっている stderr.

領事 カラー テーブル

┌────┬────────────────────┐
│# │ 色 │
├────┼────────────────────┤
│-1 │ (コンソール) デフォルト │
├────┼────────────────────┤
│0 │ 黒 │
├────┼────────────────────┤
│1 │ 赤 │
├────┼────────────────────┤
│2 │ 緑 │
├────┼────────────────────┤
│3 │ 茶色 │
├────┼────────────────────┤
│4 │ 青 │
├────┼────────────────────┤
│5 │ マゼンタ │
├────┼────────────────────┤
│6 │ シアン │
├────┼────────────────────┤
│7 │ 白 │
└────┴────────────────────┘

COMMAND 実行 OPTIONS
このセクションには、定期的なコマンドの実行を構成するオプションが含まれています。
表現が一致します。

--exitoneexecfail=BOOL
このオプションは、次の場合に logapp が終了し、ラップされたアプリケーションを終了するかどうかを定義します。
実行されたコマンドの戻り値は失敗を示します。 デフォルトでは、このオプションは
無効になり、logapp は実行されたコマンドの戻り状態を無視します。

--preexec= command
このオプションで指定できるコマンドは、実行の直前に実行されます。
アプリケーションが開始されます。 この時点で、ヘッダーはすでにログファイルに書き込まれています。
コマンドで解析できます。

--postexec= command
このオプションで指定できるコマンドは、
アプリケーションが終了しました。 この時点では、ログファイルは書き込みのためにすでに閉じられているため、
すべてのアプリケーション出力とフッターはすでに組み込まれており、次のように処理できます。
コマンド。

-e, --stdout_execregexp=レギュラー 表現

-E, --stderr_execregexp=レギュラー 表現
このオプションで定義できる正規表現は、すべてのオブジェクトに適用されます。
特定のデータ ストリームの行。 試合では、付属のコマンドが使用されます。
--stdout_exec コマンド それぞれ --stderr_execcomand オプションが実行されます。 空っぽ
このオプションの値を指定すると、正規表現によるマッチングが無効になります。

-x, --stdout_execcommand= command

-X, --stderr_execcommand= command
このオプションは、正規表現の一致時に実行されるコマンドを定義します。 の
正規表現は、 (Linuxで言うところのstdout） 　 stderr とストリームします
　 --stdout_execregexp それぞれ --stderr_execregexp オプションを選択します。

REGULAR 表現

正規表現は文字列を記述するパターンです。 Logapp はこのパターンを使用して、
データ ストリーム内で見つかった文字列に基づいてアクションを実行します。 実装は同じです
によって使用されているものに grep.

Logapp は、次のように定義されている正規表現の「基本」および「拡張」構文を理解します。
ポシックス。 デフォルトでは基本セットが使用されますが、次のコマンドを使用して拡張パターンに切り替えることができます。
　 -拡張-正規表現 パラメータ。 ぜひご覧ください。 grep（1）と 正規表現（7）マンページ
詳細については。

例
String 「文字列」と一致します

^文字列
行頭の「文字列」と一致します

文字列$
行末の「文字列」と一致します

^文字列$
行には「文字列」のみが含まれています

[SS]文字列
「文字列」または「文字列」と一致します

強度 ドットはすべての文字に一致するため、たとえば「String」または「Strong」に一致します。

強度
ドットと星は任意の数の文字に一致するため、これは次の文字に一致します。
例「文字列」または「ストリーミング」

^[AZ] *
続く行の先頭にある A から Z までの文字のいずれかと一致します。
ゼロまたは任意の数のスペースで区切ります

文字列\|単語
作業時に「文字列」または「単語」と一致します。 基本 レギュラー 表現

文字列|単語
作業時に「文字列」または「単語」と一致します。 で レギュラー 表現

ENVIRONMENT

TERM この変数は、logapp が実行されているコンソールのタイプを確認するためにチェックされます。
現在は値のみ ダム コンソールを無効にするという特別な方法で処理されます
色。 もし TERM 変数が欠落している場合は、ダム端末が想定されます。 の
この設定は、ダム端末モードを有効/無効にすることで上書きできます。
--ダムターム オプションを選択します。

onworks.net サービスを使用してオンラインで logapp を使用する