# tLogCatcher

次の3つのいずれかによってトリガーされるログ機能として動作します: ログデータを収集して転送するためのJava例外、tDie、またはtWarn。

コンポーネントtDieおよびtWarnはどちらもコンポーネントtLogCatcherと密接に関連しています。これらのコンポーネントは、一般に、ログデータを収集およびカプセル化し、定義済みの出力に受け渡すためにtLogCatcherコンポーネントと併用した場合に意味をなします。

設定済みのフィールドとメッセージをJavaの例外、tDie、またはtWarnから取得し、次のコンポーネントに受け渡します。

## tLogCatcherの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtLogCatcherを設定するために使われます。

標準のtLogCatcherコンポーネントは、ログおよびエラーファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| [Schema] (スキーマ)と[Edit Schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドを定義するものです。<br><br>このコンポーネントのスキーマは読み取り専用です。これは、ログデータのプロパティについて説明します。[Edit schema] (スキーマを編集)の横にある[...]ボタンをクリックすると、次のフィールドを含む定義済みのスキーマを表示できます。<br><br><ul> <li> <p> <span>[moment] (モーメント)</span>: メッセージがキャッチされる時刻。</p> </li> <li> <p> <span>pid</span>: ジョブのプロセスID。</p> </li> <li> <p> <span>root_pid</span>: ルートプロセスID。</p> </li> <li> <p> <span>father_pid</span>: 親プロセスID。</p> </li> <li> <p> <span>[project] (プロジェクト)</span>: プロジェクトの名前。</p> </li> <li> <p> <span>job</span>: ジョブの名前。</p> </li> <li> <p> <span>[context] (コンテキスト)</span>: ジョブの実行に使われるコンテキスト。</p> </li> <li> <p> <span>[priority] (優先度)</span>: メッセージの優先度レベル。</p> </li> <li> <p> <span>[type] (タイプ)</span>: メッセージのタイプ。</p> </li> <li> <p> <span>[origin] (原点)</span>: メッセージをトリガーするコンポーネントの名前。</p> </li> <li> <p> <span>[message] (メッセージ)</span>: メッセージのコンテンツ。</p> </li> <li> <p> <span>[code] (コード)</span>: エラーコードレベル。</p> </li> </ul> |
| [Catch Java Exception] (Java例外をキャッチ) | ジョブでJava例外が発生した時にtCatchファンクションをトリガーするには、このチェックボックスを選択します。 |
| [Catch tDie] (tDieのキャッチ) | ジョブでtDieコンポーネントが呼び出された時にtCatchファンクションをトリガーするには、このチェックボックスを選択します。 |
| [Catch tWarn] (tWarnのキャッチ) | ジョブでtWarnコンポーネントが呼び出された時にtCatchファンクションをトリガーするには、このチェックボックスを選択します。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はのコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントは、通常、メインジョブの後に自動的にトリガーされる二次ジョブの開始コンポーネントとして使われます。 |

**関連概念**

[tWarnコンポーネントによってトリガーされたメッセージをキャッチする](https://help.qlik.com/talend/ja-JP/components/8.0/logs-and-errors/twarn-tlogcatcher-tlogrow-trowgenerator-catching-messages-triggered-by-twarn-component-standard-component "この例では、tWarnコンポーネントでトリガーされたメッセージをtLogCatcherコンポーネントを使ってキャッチする方法を示します。")

[tDieコンポーネントによってトリガーされたメッセージをキャッチする](https://help.qlik.com/talend/ja-JP/components/8.0/logs-and-errors/tdie-tlogcatcher-tjava-catching-message-triggered-by-tdie-component-standard-component "この例では、tDieコンポーネントでトリガーされたメッセージをtLogCatcherコンポーネントを使ってキャッチする方法を示します。")