ライブ監視用にタスク実行ログを取得
GETメソッドを使って、/monitoring/executions/{runId}/logsエンドポイントからタスク実行のログを取得します。
タスク実行ログはロー形式では膨大なサイズになるため、解析に時間がかかることがあります。そのため、このライブモニタリングには前のセクションで説明した方法をお勧めします。
始める前に
-
TMCトークンを生成:
- ユーザーの場合は、パーソナルアクセストークンを生成に従ってパーソナルアクセストークンを生成します。
- サービスアカウントの場合は、サービスアカウントトークンを生成に従ってサービスアクセストークンを生成します。
生成されたサービスアカウントトークンは30分後に期限切れになります。期限切れになった場合は、エンドポイントhttps://api.<env>.cloud.talend.com/security/oauth/tokenでPOSTメソッドを使って新しいトークンを生成します。トークンの生成に関する詳細は、サービスアカウントトークンを生成をご覧ください。
- 使用するユーザーまたはサービスアカウントが監視するタスクが属するワークスペースで、[Author] (作成者)、[Viewer] (ビューアー)、[Executor] (エグゼキューター)の各権限を持っていること。
- 監視が必要なタスク実行のIDがあること。
このIDは、[Task execution log] (タスク実行ログ)ページの[Task execution ID] (タスク実行ID)が相当します。このIDはまた、/processing/executables/tasks/{taskId}/executionsエンドポイントのGETコールを使って取得することもできます。
このタスクについて
この例では、Talend API Testerを使ってAPIリクエストを発行します。Talend API Testerの詳細は、Talend Cloud API Testerユーザーガイドをご覧ください。
手順
-
[Method] (メソッド)ドロップダウンリストの横にあるフィールドに、使用するエンドポイントとしてhttps://api.<env>.cloud.talend.com/monitoring/executions/<runId>/logsと入力します。
例
タスクの結果
自分の監視システムにこのAPIコールを統合することで、実行の最新情報を継続的に取得および分析できるため、監視システムは適宜かつタイムリーに通知を送ることが可能になります。
以下はログのエントリー例です。isoDateフィールドは、v2.11.11以降のエンジンで実行中であるタスクのログにのみ表示されます。
{"logTimestamp":1619614861123,"isoDate":"2021-04-28 13:01:01.123","severity":"INFO","logType":null,"logMessage":"messageA1","bundleName":null,"bundleVersion":null}