このトピックでは、Object Storage Service (OSS) ログのさまざまな種類と、各ログタイプのフィールドについて説明します。
OSS ログタイプ
ログタイプ | 説明 |
アクセスログ | このタイプのログは、OSS バケットへのアクセスを記録します。 アクセスログはリアルタイムで収集されます。 |
バッチ削除ログ | このタイプのログは、削除されたオブジェクトに関する情報を記録します。 バッチ削除ログはリアルタイムで収集されます。 説明 DeleteObjects 操作を呼び出すと、リクエストを記録するためのアクセスログが生成されます。 |
時間単位のメータリングログ | このタイプのログは、OSS バケットの時間単位のメータリング統計を記録し、データ分析に役立ちます。 ログは、生成されてから数時間後に収集されます。 |
OSS 組み込みロギングと Simple Log Service を利用した OSS ロギング
OSS アクセスログのリアルタイムクエリおよび分析機能は Simple Log Service によって提供され、OSS アクセスデータ、バッチ削除データ、および時間単位のメータリングデータのロギング、収集、保存、および分析が含まれます。 OSS 組み込みロギングは、OSS バケットのアクセスログを記録および保存する OSS の機能です。
Simple Log Service は OSS と同じアクセスログを記録しますが、ログフィールドは次の表に示すように異なります。詳細については、「アクセスログ」をご参照ください。
OSS に記録された OSS アクセスログのフィールド | Simple Log Service に記録された OSS アクセスログのフィールド |
Remote IP | client_ip |
Time | time |
Request-URI | request-uri |
HTTP Status | http_status |
SentBytes | response_body_length |
RequestTime (ms) | response_time |
Referer | referer |
User-Agent | user-agent |
HostName | host |
Request ID | request_id |
LoggingFlag | logging_flag |
Requester Aliyun ID | requester_id |
Operation | operation |
Bucket | bucket |
Key | object |
ObjectSize | object_size |
Server Cost Time (ms) | server_cost_time |
Error Code | error_code |
Request Length | request_length |
UserID | owner_id |
Delta DataSize | delta_data_size |
Sync Request | sync_request |
アクセスログ
フィールド | 説明 |
__topic__ | ログのトピック。 値は |
time | OSS がリクエストを受信した時刻。 例: 27/Feb/2018:13:58:45。 タイムスタンプが必要な場合は、このフィールドを使用します。 |
access_id | リクエスト元の AccessKey ID。 |
owner_id | OSS バケットが属する Alibaba Cloud アカウントの ID。 |
user_agent | HTTP リクエストの User-Agent ヘッダー。 例: curl/7.15.5。 |
logging_flag | ログを定期的に OSS バケットにエクスポートするロギングが有効になっているかどうかを示します。 true の値は、機能が有効になっていることを示します。 |
bucket | OSS バケットの名前。 |
content_length_in | リクエストの Content-Length ヘッダーの値。 単位: バイト。 |
content_length_out | レスポンスの Content-Length ヘッダーの値。 単位: バイト。 |
object | リクエストされた URL エンコードされたオブジェクト。 クエリ文に |
object_size | オブジェクトのサイズ。 単位: バイト。 |
operation | API 操作。 詳細については、「付録: アクセスタイプ」をご参照ください。 |
bucket_location | OSS バケットが存在するデータセンター。 値は |
request_uri | HTTP リクエストの URL エンコードされた URI。 クエリ文字列が含まれています。 クエリ文に |
error_code | OSS によって返されるエラーコード。 詳細については、「概要」をご参照ください。 |
request_length | HTTP リクエストのサイズ。 リクエストのヘッダーがカウントされます。 単位: バイト。 |
client_ip | リクエストの送信元の IP アドレス。 IP アドレスは、クライアント、ファイアウォール、またはプロキシの IP アドレスです。 |
response_body_length | HTTP レスポンス本文のサイズ。 |
http_method | HTTP リクエストメソッド。 |
referer | HTTP リクエストの Referer ヘッダー。 |
requester_id | リクエスト元の ID。 リクエストが匿名ユーザーによって送信された場合、このフィールドの値はハイフン (-) です。 |
request_id | リクエスト ID。 |
response_time | HTTP 応答時間。 単位: ミリ秒。 |
server_cost_time | OSS サーバーがリクエストを処理するのにかかった時間。 単位: ミリ秒。 |
http_type | リクエストの送信に使用されるプロトコル。 有効な値: HTTP および HTTPS。 |
sign_type | 署名の種類。 有効な値:
|
http_status | HTTP ステータスコード。 |
sync_request | 同期リクエストのタイプ。 有効な値:
|
bucket_storage_type | OSS オブジェクトのストレージタイプ。 有効な値:
|
host | OSS バケットのエンドポイント。 例: bucket123.oss-cn-beijing.aliyuncs.com。 |
vpc_addr | OSS バケットが属する VPC の高可用性仮想 IP アドレス (HAVIP)。 データ型: 整数。 例: 343819108。 |
vpc_id | VPC の ID。 |
delta_data_size | OSS オブジェクトのサイズの変更。 オブジェクトサイズが変更されない場合、このフィールドの値は 0 です。 リクエストがアップロードリクエストでない場合、このフィールドの値はハイフン (-) です。 |
ec | 詳細なエラーコード。 詳細については、「エラーコードを使用したセルフヘルプトラブルシューティング」をご参照ください。 |
acc_access_region | リクエストで指定された OSS エンドポイントのリージョン。 転送アクセラレーション機能が有効になっているときにリクエストが送信された場合、このフィールドの値はリージョンの名前です。 転送アクセラレーション機能が無効になっているときにリクエストが送信された場合、このフィールドの値はハイフン (-) です。 |
restore_priority | ログデータ復旧が発生した場合のログの優先度。 |
extend_information | 拡張フィールド。 デフォルト値: ハイフン (-)。 RAM ロールを使用してリクエストが開始された場合、ログには RAM ロールに関する情報が記録されます。 情報は |
user_defined_log_fields | 拡張フィールド。 デフォルト値: ハイフン (-)。 OSS バケットのカスタムヘッダーとパラメーターを構成した場合、ログはこのフィールドに JSON 形式でヘッダーとパラメーターの値を記録します。 このフィールドの値は、Base64 アルゴリズムを使用してエンコードされます。 |
archive_direct_read_size | リアルタイムアクセスに基づいてアーカイブオブジェクトから読み取られるメータリングデータのサイズ。 アーカイブオブジェクトへのリアルタイムアクセスが無効になっている場合、値はハイフン (-) です。 単位: バイト。 |
バッチ削除ログ
DeleteObjects 操作を呼び出すと、リクエストを記録するためのアクセスログが生成されます。 ただし、削除されたオブジェクトに関する情報は、リクエストの HTTP 本文に含まれています。 アクセスログの object フィールドの値はハイフン (-) です。 削除されたオブジェクトに関する情報を表示するには、バッチ削除ログを取得する必要があります。 次の表は、これらのログのフィールドについて説明しています。 request_id フィールドを使用して、バッチ削除ログをアクセスログに関連付けることができます。
フィールド | 説明 |
__topic__ | ログのトピック。 値は oss_batch_delete_log に固定されています。 |
client_ip | リクエストの送信元の IP アドレス。 IP アドレスは、クライアント、ファイアウォール、またはプロキシの IP アドレスです。 |
user_agent | HTTP リクエストの User-Agent ヘッダー。 例: curl/7.15.5。 |
bucket | OSS バケットの名前。 |
error_code | OSS が返すエラーコード。 詳細については、「エラーコード」をご参照ください。 |
request_length | HTTP リクエストのサイズ。 リクエストのヘッダーがカウントされます。 単位: バイト。 |
response_body_length | HTTP レスポンス本文のサイズ。 レスポンスのヘッダーはカウントされません。 |
object | リクエストされた URL エンコードされたオブジェクト。 ログをクエリするときに、 |
object_size | オブジェクトのサイズ。 単位: バイト。 |
operation | API 操作。 詳細については、「付録: API 操作」をご参照ください。 |
bucket_location | OSS バケットが存在するデータセンター。 値は oss-<リージョン ID> 形式です。 |
http_method | HTTP リクエストメソッド。 例: POST。 |
referer | リクエストの HTTP リファラー。 |
request_id | リクエスト ID。 |
http_status | HTTP ステータスコード。 |
sync_request | 同期リクエストのタイプ。
|
request_uri | リクエストの URL エンコードされた URI。 クエリ文字列が含まれています。 ログをクエリするときに、 |
host | OSS バケットのエンドポイント。 例: bucket123.oss-cn-beijing.aliyuncs.com。 |
logging_flag | ログを OSS バケットに定期的にエクスポートするロギングが有効になっているかどうかを示します。 true の値は、この機能が有効になっていることを示します。 |
server_cost_time | OSS サーバーがリクエストを処理するのにかかった時間。 単位: ミリ秒。 |
owner_id | OSS バケットが属する Alibaba Cloud アカウントの ID。 |
requester_id | リクエスト元の ID。 リクエストが匿名ユーザーによって送信された場合、このフィールドの値はハイフン (-) です。 |
delta_data_size | OSS オブジェクトのサイズの変更。 オブジェクトサイズが変更されない場合、このフィールドの値は 0 です。 リクエストがアップロードリクエストでない場合、このフィールドの値はハイフン (-) です。 |
時間単位のメータリングログ
時間単位のメータリングログは、OSS バケットの時間単位のメータリング統計を記録し、データ分析に役立ちます。
フィールド | 説明 |
__topic__ | ログのトピック。 値は |
owner_id | OSS バケットが属する Alibaba Cloud アカウントの ID。 |
bucket | OSS バケットの名前。 |
cdn_in | Alibaba Cloud CDN から OSS バケットへのインバウンドトラフィック。 単位: バイト。 |
cdn_out | OSS バケットから Alibaba Cloud CDN へのアウトバウンドトラフィック。 単位: バイト。 |
metering_datasize | OSS バケット内の、ストレージタイプが標準ではないデータの量。 |
get_request | GET リクエストの数。 |
intranet_in | 内部ネットワーク経由のインバウンドトラフィック。 単位: バイト。 |
intranet_out | 内部ネットワーク経由のアウトバウンドトラフィック。 単位: バイト。 |
network_in | インターネット経由のインバウンドトラフィック。 単位: バイト。 |
network_out | インターネット経由のアウトバウンドトラフィック。 単位: バイト。 |
put_request | PUT リクエストの数。 |
storage | OSS バケット内のデータ量。 単位: バイト。 |
storage_type | OSS バケットのストレージタイプ。 有効な値:
|
process_img_size | 処理されたイメージのサイズ。 単位: バイト。 |
sync_in | 同期操作によって生成されたインバウンドトラフィック。 単位: バイト。 |
sync_out | 同期操作によって生成されたアウトバウンドトラフィック。 単位: バイト。 |
start_time | メータリング操作の開始タイムスタンプ。 単位: 秒。 |
end_time | メータリング操作の終了タイムスタンプ。 単位: 秒。 |
region | OSS バケットが存在するリージョン。 |
process_img | 処理されたイメージに関する情報。 |
bucket_location | OSS バケットが存在するデータセンター。 値は oss-<リージョン ID> 形式です。 |
付録: API 操作
次の表に、サポートされている API 操作を示します。 詳細については、「関数別の操作リスト」をご参照ください。
操作 | 説明 |
AbortMultiPartUpload | マルチパートアップロードタスクをキャンセルします。 |
AppendObject | 既存のオブジェクトにオブジェクトを追加します。 |
CompleteUploadPart | オブジェクトのマルチパートアップロードタスクを完了します。 |
CopyObject | オブジェクトをコピーします。 |
DeleteBucket | バケットを削除します。 |
DeleteLiveChannel | LiveChannel を削除します。 |
DeleteObject | オブジェクトを削除します。 |
DeleteObjects | 複数のオブジェクトを削除します。 |
GetBucket | バケット内のすべてのオブジェクトに関する情報をクエリします。 |
GetBucketAcl | バケットのアクセス制御リスト (ACL) をクエリします。 |
GetBucketCors | バケットのオリジン間リソース共有 (CORS) ルールをクエリします。 |
GetBucketEventNotification | バケットの通知構成をクエリします。 |
GetBucketInfo | バケットに関する情報をクエリします。 |
GetBucketLifecycle | バケットに構成されているライフサイクルルールをクエリします。 |
GetBucketLocation | バケットが存在するリージョンをクエリします。 |
GetBucketLog | バケットのアクセスロギング構成をクエリします。 |
GetBucketReferer | バケットに構成されているホットリンク保護ルールをクエリします。 |
GetBucketReplication | バケットに構成されているクロスリージョンレプリケーション (CRR) ルールをクエリします。 |
GetBucketReplicationProgress | バケットで実行された CRR タスクの進捗状況をクエリします。 |
GetBucketStat | バケットに関する情報をクエリします。 |
GetBucketWebSite | バケットの静的 Web サイトホスティングのステータスをクエリします。 |
GetLiveChannelStat | LiveChannel のステータスをクエリします。 |
GetObject | オブジェクトをクエリします。 |
GetObjectAcl | オブジェクトの ACL をクエリします。 |
GetObjectInfo | オブジェクトに関する情報をクエリします。 |
GetObjectMeta | オブジェクトのメタデータをクエリします。 |
GetObjectSymlink | オブジェクトのシンボリックリンクをクエリします。 |
GetPartData | オブジェクトのすべての部分のデータをクエリします。 |
GetPartInfo | オブジェクトのすべての部分に関する情報を取得します。 |
GetProcessConfiguration | バケット内の画像処理構成をクエリします。 |
GetService | すべてのバケットを一覧表示します。 |
HeadBucket | バケットに関する情報をクエリします。 |
HeadObject | オブジェクトに関する情報をクエリします。 |
InitiateMultipartUpload | マルチパートアップロードタスクを初期化します。 |
ListMultiPartUploads | 進行中のすべてのマルチパートアップロードタスクをクエリします。 |
ListParts | 指定されたマルチパートアップロードタスクでアップロードされたすべての部分をクエリします。 |
PostObject | HTML フォームを使用してオブジェクトをアップロードします。 |
PostProcessTask | スクリーンショットなどのデータ処理操作をコミットします。 |
PostVodPlaylist | LiveChannel のプレイリストを作成します。 |
ProcessImage | イメージを処理します。 |
PutBucket | バケットを作成します。 |
PutBucketCors | バケットの CORS ルールを構成します。 |
PutBucketLifecycle | バケットのライフサイクルルールを構成します。 |
PutBucketLog | バケットのアクセスロギングを構成します。 |
PutBucketWebSite | バケットの静的 Web サイトホスティングモードを構成します。 |
PutLiveChannel | LiveChannel を作成します。 |
PutLiveChannelStatus | LiveChannel のステータスを構成します。 |
PutObject | オブジェクトをアップロードします。 |
PutObjectAcl | オブジェクトの ACL を変更します。 |
PutObjectSymlink | オブジェクトのシンボリックリンクを作成します。 |
RedirectBucket | リクエストをバケットエンドポイントにリダイレクトします。 |
RestoreObject | オブジェクトを復元します。 |
UploadPart | オブジェクトを部分的にアップロードします。 |
UploadPartCopy | 既存のオブジェクトからデータをコピーして、一部をアップロードします。 |
get_image_exif | イメージの EXIF データをクエリします。 |
get_image_info | 長さや幅などのイメージ情報をクエリします。 |
get_image_infoexif | イメージの長さ、幅、および EXIF データをクエリします。 |
get_style | バケット内のイメージスタイルをクエリします。 |
list_style | バケット内のすべてのイメージスタイルを一覧表示します。 |
put_style | バケットにイメージスタイルを作成します。 |