転送ジョブを指定して実行ログを取得します。
ジョブのステータス確認には転送ジョブ実行結果取得をご利用ください。実行ログの取得はジョブの完了を検知した後に行うことを推奨します。
実行ログの仕様
- 実行ログは約1年間保持されます。保持期間を過ぎた場合、
logs.streams[].statusがexpiredとなります。 - ジョブが完了しておらず実行ログがまだ出力されていない場合、
logs.streams[].statusがpendingとなります。時間をおいて再度取得してください。 - ログが一定の量を超える場合、先頭と末尾のみが取得され、中間は
skipped...に置き換えられます。この場合logs.streams[].truncatedがtrueとなります。 logs.streams[].contentは改行を含む複数行のテキストです。- 実行中のジョブの場合、取得した時点でのログを返します。前回取得分からの差分を取得することはできません。
取得した実行ログの取り扱い
- 実行ログには、接続先のホスト名やユーザー名、ファイルパス、実行したクエリ、エラーになったデータの値などが含まれる場合があります。
- 接続情報に保存したパスワードやトークンを、TROCCOがログに書き出すことはありません。ただし、HTTP・HTTPS転送元で「マスキングする」を選んでいないパラメータ、クエリやカスタム変数に直接記載した値、接続先のサービスがエラーメッセージに含めた値は、そのまま含まれる場合があります。
- 取得した内容を外部のAIサービスに渡す場合は、入力したデータが学習に使われない設定でご利用ください。あわせて、貴社のデータの取り扱い方針と、利用するAIサービスのデータの扱いを事前にご確認ください。
認証キーとなるAPI KEYをAuthorization: Token {{API KEY}}の形式でヘッダーにセットします。
API KEYがabc123の場合は、Authorization: Token abc123とします。
API KEYの作成方法は、TROCCO API KEYの作成を参照ください。
取得するログの種別を指定します。
未指定の場合、すべての種別のログを返します。
転送ジョブの実行ログを返します。
転送ジョブIDです。
転送設定IDです。
転送ジョブのステータスです。
queued- 実行待機setting_up- 実行準備executing- 実行中interrupting- 実行中断succeeded- 実行完了（成功）error- 実行完了（エラー）canceled- 実行完了（キャンセル）skipped- 実行完了（スキップ）timeout- 実行完了（タイムアウト）
種別ごとの実行ログです。typeを指定した場合、指定した種別のみを返します。（log, error_log の順）
ログの種別です。
log- 実行ログerror_log- エラーログ
この種別の実行ログの取得状態です。種別ごとに判定するため、typeでの絞り込みの有無によって値は変わりません。
available- 実行ログを取得できましたpending- ジョブが完了していないため、実行ログがまだ出力されていません。時間をおいて再度取得してくださいempty- ジョブは完了しており、この種別の実行ログは出力されませんでしたexpired- 保持期間を過ぎたため実行ログを取得できません
available以外の場合、contentは空文字を返します。
実行ログの本文です。改行を含む複数行のテキストです。
実行ログを取得できない場合、空文字を返します。
実行ログの中間が省略されているかどうかです。
trueの場合、contentにskipped...が含まれます。
contentのバイト数です。
Bad request.
不正なリクエストです。
Not authenticated.
認証エラーです。API KEYをご確認ください。
Forbidden.
対象の転送設定を参照する権限がありません。
Not found.
要求したリソースが見つかりません。
Service unavailable.
実行ログの取得に失敗しました。時間をおいて再度お試しください。