オンプレミス転送ログ形式

このドキュメントでは、Transfer Service for On Premises Data の現在の転送ログの形式について説明します。

形式の説明

Transfer Service for On Premises Data のログはタブ区切り(TSV)形式で保存されます。このファイルでは、フィールド名がヘッダー行になっています。通常、フィールドの表示順序は固定されていますが、常に一定とは限りません。ヘッダー行から順序を推測する必要があります。

各行が 1 つのログレコードを表します。各レコードは、転送オペレーションの中で発生したステータスの更新を表します。

次の表に、ログファイルのフィールドの説明を示します。

ログフィールド 説明
Timestamp イベントが記録された時間を表す ISO 8601 遵守のタイムスタンプ。
Operation Name 完全修飾のオペレーション名。
Action このタスクの操作を表します。次のいずれかです。
  • FIND: 検索操作(オンプレミスでファイルを一覧表示するなど)
  • TRANSFER: ファイルのアップロード
  • DELETE: 転送先でのファイルの削除
ActionStatus 操作のステータス。次のいずれかです。
  • SUCCEEDED: 操作が正常に完了しました。
  • FAILED: 操作に失敗しました。失敗した操作の詳細は FailureDetails フィールドで確認できます。
FailureDetails.ErrorType 発生したエラーの種類を表す文字列。たとえば、FILE_NOT_FOUND。エラーが発生した場合にのみ設定されます。
FailureDetails.GrpcCode Google RPC コードの文字列値。たとえば、FAILED_PRECONDITION です。エラーが発生した場合にのみ設定されます。
FailureDetails.Message 失敗に関するエラー メッセージ。人が読める形式で提供されます。エラーが発生した場合にのみ設定されます。
Src.Type ソースのストレージ システムのタイプを表す文字列。これは常に ON_PREM です。
Src.File.Path 転送されたオンプレミス ファイルのパス。
Src.File.LastModified オンプレミス ファイルの POSIX 変更時刻(mtime)。
Src.FileSize バイト単位のファイルサイズ。
Src.File.Crc32C ファイルのコンテンツの CRC32C チェックサム。
Dst.Type 転送先のストレージ システムのタイプを表す文字列。これは常に GCS です。
Dst.Gcs.BucketName 転送先の Cloud Storage のバケット名。
Dst.Gcs.ObjectName 転送先オブジェクトのオブジェクト接頭辞。
Dst.Gcs.LastModified 転送先オブジェクトの POSIX 変更時刻(mtime)。
Dst.Gcs.Size オブジェクトのサイズ(バイト単位)。
Dst.Gcs.Crc23C オブジェクトのコンテンツの CRC32C チェックサム。
Dst.Md5 Cloud Storage の最終オブジェクトの MD5 チェックサム。

ログエントリの例

以下に、ヘッダーとデータ行の 2 行から構成されるログ出力の例を示します。

Timestamp       OperationName   Action  ActionStatus    FailureDetails.ErrorType        FailureDetails.GrpcCode FailureDetails.Message     Src.Type        Src.File.Path   Src.File.LastModified   Src.File.Size   Src.File.Crc32C Dst.Type   Dst.Gcs.BucketName      Dst.Gcs.ObjectName      Dst.Gcs.LastModified    Dst.Gcs.Size    Dst.Gcs.Crc32C  Dst.Gcs.Md5
2019-10-18T21:06:17Z    transferOperations/agent-manual_transferJobs/OPI1494275376193533620_0000000001571432448     TRANSFER        SUCCEEDED                               ON_PREM_FILE    /mnt/disks/disk-1/directory1/file.txt      1561409931      406     3089075447      GCS_OBJECT      destination-gcs-bucket    file.txt  1571432776      406     3089075447      FDjya7dWbd0OrgnZ7g9ZJw==