転送ジョブのモニタリング

Cloud Monitoring は、Storage Transfer Service ジョブの情報を自動的に収集して保存します。Cloud Monitoring を使用すると、さまざまな指標をグラフ化してモニタリングできます。

  • 検出されたオブジェクトの数とバイト数
  • コピーされたオブジェクトの数とバイト数
  • 削除されたオブジェクトの数とバイト数
  • エラーの数とそれに関連するエラーコード

Storage Transfer Service では、Cloud Monitoring が自動的に有効になります。Google Cloud コンソールでのデータの収集や指標の表示は無料です。API 呼び出しでは料金が発生する可能性があります。料金の詳細については、Cloud Monitoring の料金をご覧ください。

必要な IAM ロール

Cloud Monitoring で指標を表示するには、モニタリング閲覧者（roles/monitoring.viewer）ロールまたは同等の権限が必要です。

詳細は、IAM ロールの付与方法をご覧ください。

指標を表示する

Cloud Monitoring の指標は、Google Cloud コンソールの次の 2 つの場所で使用できます。

  • Storage Transfer Service のジョブの詳細ページには、特定の転送ジョブの指標が表示されます。以下に示す指標に加えて、コピーされたバイト数の帯域幅とコピーされたオブジェクトのレートが計算されます。

  • Cloud Monitoring ページには、1 つの転送ジョブ、複数のジョブ、プロジェクト内のすべてのジョブの指標が表示されます。複数のグラフ オプションとカスタマイズが用意されています。

ジョブの詳細ページで指標を表示する

特定のジョブの指標を表示するには:

  1. Google Cloud コンソールで [転送ジョブ] ページに移動します。

    [転送ジョブ] に移動

  2. 指標を表示するジョブをクリックします。[ジョブの詳細] ページが表示されます。

  3. [モニタリング] タブをクリックします。デフォルトのダッシュボードが表示されます。

Cloud Monitoring で指標を表示する

Cloud Monitoring で Storage Transfer Service の指標を表示する手順は次のとおりです。

  1. Google Cloud コンソールの [Metrics Explorer] ページに移動します。

    Monitoring の [Metrics Explorer] に移動

  2. Metrics Explorer でグラフを作成するの手順で指標を選択し、表示します。

リソースの詳細

モニタリング対象リソース名: storage_transfer_job

リソース フィールド / ターゲット フィールド このフィールドの入力に使用される REST リソースとフィールド 説明
project_id TransferJob.project_id このリソースに関連付けられたプロジェクトの ID
job_id TransferJob.name グローバルに一意の転送名。
location 転送ジョブはリージョンまたはロケーションに関連付けられないため、常に global に設定されます。 転送ジョブのロケーション

指標の詳細

Storage Transfer Service のすべての指標はデルタ指標です。この指標は、最後に記録された時点からの変更を測定します。たとえば、リクエスト数を測定する指標はデルタ指標です。各値には、最後のデータポイントが記録されてから受信されたリクエストの数が記録されます。

データは 60 秒ごとにサンプリングされます。サンプリング後、データは最長 180 秒間表示されません。

指標名はすべて storagetransfer.googleapis.com/transferjob/ で始まります。例: storagetransfer.googleapis.com/transferjob/found_bytes_count

指標名 ラベル 説明
found_bytes_count 

origin=[source | sink]

転送または削除するようにスケジュールされているバイト数（オブジェクトの条件に基づいてフィルタリングされたバイト数や、すでに宛先に存在するためにフィルタリングされたバイト数は除く）。シンク内のデータの上書きについては、TransferOptions をご覧ください。

対応する TransferCounters: bytesFoundFromSource、bytesFoundOnlyFromSink
found_objects_count 

origin=[source | sink]

転送または削除がスケジュールされているオブジェクトの数（オブジェクトの条件に基づいてフィルタリングされたオブジェクトや、同期によってスキップされたオブジェクトは除く）。

対応する TransferCounters: objectsFoundFromSource、objectsFoundOnlyFromSink
copied_bytes_count 

status=[succeeded | skipped | failed]

コピーされたバイト数。

対応する TransferCounters: bytesCopiedToSink、bytesFromSourceSkippedBySync、bytesFromSourceFailed

この指標では、正常にコピーされたバイト数がカウントされますが、これらのバイト数はコピーに失敗した場合は廃棄されます。このため、ステータスが succeeded の copied_bytes_count の値が bytesCopiedToSink カウンタと必ず一致するとは限りません。たとえば、Storage Transfer Service がオブジェクトの 100 バイトをコピーして、このバイト数が転送中に削除された場合、コピーされた 100 バイトは、succeeded というステータスで copied_bytes_count に記録されます。オブジェクト全体のバイト数も failed というステータスで copied_bytes_count に記録されます。
copied_objects_count 

status=[succeeded | skipped | failed]

コピーされたオブジェクトの数。

対応する TransferCounters: objectsCopiedToSink、objectsFromSourceSkippedBySync、objectsFromSourceFailed
deleted_bytes_count 

origin=[source | sink]
status=[succeeded | failed]

削除されたバイト数。Storage Transfer Service は、ソースまたは宛先のデータ（あるいはその両方）を削除するように構成できます。削除動作の構成については、TransferOptions をご覧ください。

対応する TransferCounters: bytesDeletedFromSource、bytesDeletedFromSink、bytesFromSourceFailed、bytesFailedToDeleteFromSink

注: このカウンタは deleted_bytes_count:status=failed,origin=source と copied_bytes_count:status=failed の合計です。
deleted_objects_count 

origin=[source | sink]
status=[succeeded | failed]

削除されたオブジェクトの数。

対応する TransferCounters: objectsDeletedFromSource、objectsDeletedFromSink、objectsFromSourceFailed、objectsFailedToDeleteFromSink

注: このカウンタは deleted_objects_count:status=failed,origin=source と copied_objects_count:status=failed の合計です。
error_count 

code=error code

ErrorSummary で報告されたエラーの数。