このトピックでは、さまざまな種類のObject Storage Service (OSS) ログと、各種類のログのフィールドについて説明します。
OSSログタイプ
| ログのタイプ | 説明 |
|---|---|
| アクセスログ | このタイプのログは、OSSバケットへのアクセスを記録します。 アクセスログはリアルタイムで収集されます。 |
| 一括削除ログ | このタイプのログは、削除されたオブジェクトに関する情報を記録します。 一括削除ログはリアルタイムで収集されます。 説明 DeleteObjects操作を呼び出すと、リクエストを記録するためのアクセスログが生成されます。 |
| 時間あたりのメータリングログ | このタイプのログは、OSSバケットの1時間ごとの計測統計を記録します。これにより、データの分析に役立ちます。 時間ごとの計測ログは、生成されてから数時間後に収集されます。 |
OSSビルトインロギングとLog Serviceを利用したOSSロギング
OSSは、log Serviceを利用したリアルタイムログクエリ機能を提供します。 この機能を有効にすると、Log ServiceはOSSアクセスログ、バッチ削除ログ、およびOSSの1時間ごとの計測ログを収集して保存します。 ログに対してさまざまな操作を実行できます。 たとえば、ログを照会および分析できます。 OSS組み込みログは、OSSの組み込み機能です。 この機能は、OSSのアクセスログを記録および保存します。
Log ServiceはOSSと同じアクセスログを記録しますが、ログフィールドは異なります。 詳細については、「アクセスログ」をご参照ください。
| OSSに記録されたOSSアクセスログのフィールド | Log Serviceに記録されたOSSアクセスログのフィールド |
|---|---|
| Remote IP | client_ip |
| 時間 | 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 |
| 要求 ID | request_id |
| LoggingFlag | logging_flag |
| Requester Aliyun ID | requester_id |
| 操作 | operation |
| バケット | バケット |
| キー | 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__ | ログのトピックです。 値はoss_access_logとして固定されています。 |
| acc_access_region | リクエストで指定されたOSSエンドポイントのリージョン。 転送アクセラレーション機能が有効になっているときにリクエストが送信された場合、このフィールドの値はリージョンの名前です。 転送アクセラレーション機能が無効になっているときにリクエストが送信された場合、このフィールドの値はハイフン (-) になります。 |
| access_id | 要求者のAccessKey ID。 |
| バケット | OSS バケットの名前。 |
| bucket_location | OSSバケットが存在するデータセンター。 値はoss-<Region ID> 形式です。 |
| bucket_storage_type | OSSオブジェクトのストレージクラス。 有効な値：
|
| client_ip | リクエストの送信元のIPアドレス。 IPアドレスは、クライアント、ファイアウォール、またはプロキシのIPアドレスです。 |
| content_length_in | リクエスト内のContent-Lengthヘッダーの値。 単位：バイト |
| content_length_out | レスポンス内のContent-Lengthヘッダーの値。 単位：バイト |
| delta_data_size | OSSオブジェクトのサイズの変更。 オブジェクトサイズが変化しない場合、このフィールドの値は0である。 リクエストがアップロードリクエストでない場合、このフィールドの値はハイフン (-) です。 |
| error_code | OSSによって返されるエラーコード。 詳細については、「エラー応答」をご参照ください。 |
| host | OSSバケットのエンドポイント。 例: bucket123.oss-cn-beijing.aliyuncs.com。 |
| http_method | HTTP リクエストの方式。 |
| http_status | HTTP ステータスコード |
| http_type | リクエストが送信されるプロトコル。 有効な値: HTTPおよびHTTPS。 |
| logging_flag | ログをOSSバケットに定期的にエクスポートするためにログが有効になっているかどうかを示します。 値がtrueの場合は、機能が有効になっていることを示します。 |
| object | 要求されるURLエンコードされたオブジェクト。 クエリステートメントにselect url_decode(object) を含めて、オブジェクトをデコードできます。 |
| object_size | オブジェクトのサイズ。 単位：バイト |
| operation | API操作。 詳細については、「付録: API操作」をご参照ください。 |
| owner_id | OSSバケットが属するAlibaba CloudアカウントのID。 |
| referer | HTTPリクエストのRefererヘッダー。 |
| request_id | リクエストの ID です。 |
| request_length | HTTPリクエストのサイズ。 リクエストのヘッダーがカウントされます。 単位：バイト |
| request_uri | HTTPリクエストのURLエンコードされたURI。 クエリ文字列が含まれています。 クエリ文にselect url_decode(request_uri) を含めて、URIをデコードできます。 |
| requester_id | リクエスト送信者の ID。 リクエストが匿名ユーザーによって送信された場合、このフィールドの値はハイフン (-) です。 |
| response_body_length | HTTPレスポンスボディのサイズ。 |
| response_time | HTTP応答時間。 単位：ミリ秒。 |
| server_cost_time | OSSサーバーがリクエストを処理するために消費した時間。 単位：ミリ秒。 |
| sign_type | 署名のタイプ。 有効な値：
|
| sync_request | 同期リクエストのタイプ。 有効な値：
|
| time | OSSがリクエストを受信した時刻。 例: 27/Feb/2018:13:58:45。 タイムスタンプが必要な場合は、__time__ フィールドを使用できます。 |
| user-agent | HTTPリクエストのUser-Agentヘッダー。 例: curl/7.15.5。 |
| vpc_addr | virtual Private Cloud (VPC) に存在し、OSSバケットをホストするサーバーの仮想IPアドレス (VIP) 。 データ型: 整数。 例: 343819108。 |
| vpc_id | クライアントが存在するVPCのID。 |
| restore_priority | ログデータの復元時のログの優先度。 |
| extend_information | 拡張フィールド。 デフォルト値: hyphen (-) 。 リクエストがRAMロールを使用して開始された場合、ログにはRAMロールに関する情報が記録されます。 情報は、 |
一括削除ログ
DeleteObjects操作を呼び出すと、リクエストを記録するためのアクセスログが生成されます。 DeleteObjects操作で指定したオブジェクトに関する情報は、リクエストの本文に格納されます。 したがって、生成されたアクセスログのobjectフィールドの値はハイフン (-) です。 削除されたオブジェクトに関する情報を表示する場合は、一括削除ログを取得する必要があります。 バッチ削除ログのrequest_idフィールドを使用して、オブジェクトの削除に使用されるリクエストを検索できます。 一括削除ログのフィールドを次の表に示します。
| フィールド | 説明 |
|---|---|
| __topic__ | ログのトピックです。 値はoss_batch_delete_logとして固定されています。 |
| client_ip | リクエストの送信元のIPアドレス。 IPアドレスは、クライアント、ファイアウォール、またはプロキシのIPアドレスです。 |
| user_agent | HTTPリクエストのUser-Agentヘッダー。 例: curl/7.15.5。 |
| バケット | OSS バケットの名前。 |
| error_code | OSSによって返されるエラーコード。 詳細については、「エラー応答」をご参照ください。 |
| request_length | HTTPリクエストのサイズ。 リクエストのヘッダーがカウントされます。 単位：バイト |
| response_body_length | HTTPレスポンスボディのサイズ。 応答のヘッダーはカウントされません。 |
| object | 要求されるURLエンコードされたオブジェクト。 クエリステートメントにselect url_decode(object) を含めて、オブジェクトをデコードできます。 |
| object_size | オブジェクトのサイズ。 単位：バイト |
| operation | API操作。 詳細については、「付録: API操作」をご参照ください。 |
| bucket_location | OSSバケットが存在するデータセンター。 値はoss-<Region ID> 形式です。 |
| http_method | HTTP リクエストの方式。 例: POST。 |
| referer | HTTPリクエストのRefererヘッダー。 |
| request_id | リクエストの ID です。 |
| http_status | HTTP ステータスコード |
| sync_request | 同期リクエストのタイプ。 有効な値：
|
| request_uri | リクエストのURLエンコードされたURI。 クエリ文字列が含まれています。 クエリ文にselect url_decode(request_uri) を含めて、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である。 リクエストがアップロードリクエストでない場合、このフィールドの値はハイフン (-) です。 |
時間あたりのメータリングログ
1時間ごとの計測ログは、OSSバケットの1時間ごとの計測統計を記録します。これは、データの分析に役立ちます。
| フィールド | 説明 |
|---|---|
| __topic__ | ログのトピックです。 値はoss_metering_logとして固定されています。 |
| owner_id | OSSバケットが属するAlibaba CloudアカウントのID。 |
| バケット | OSS バケットの名前。 |
| cdn_in | CDNからOSSバケットへのインバウンドトラフィック。 単位：バイト |
| cdn_out | OSSバケットからCDNへのアウトバウンドトラフィック。 単位：バイト |
| get_request | GET リクエストの数です。 |
| intranet_in | 内部ネットワーク上のインバウンドトラフィック。 単位：バイト |
| intranet_out | 内部ネットワーク上のアウトバウンドトラフィック。 単位：バイト |
| network_in | インターネット上のインバウンドトラフィック。 単位：バイト |
| network_out | インターネット上のアウトバウンドトラフィック。 単位：バイト |
| put_request | PUT リクエストの数です。 |
| storage_type | OSSバケットのストレージクラス。 有効な値：
|
| ストレージ | OSSバケット内のデータ量。 単位：バイト |
| metering_datasize | OSSバケット内のストレージクラスがStandardではないデータの量。 |
| process_img_size | 処理される画像のサイズ。 単位：バイト |
| process_img | 処理される画像に関する情報。 |
| sync_in | 同期操作によって生成される受信トラフィック。 単位：バイト |
| sync_out | 同期操作によって生成されるアウトバウンドトラフィック。 単位：バイト |
| start_time | 計測操作の開始タイムスタンプ。 単位：秒。 |
| end_time | 計測操作の終了タイムスタンプ。 単位：秒。 |
| region | OSSバケットが存在するリージョン。 |
| bucket_location | OSSバケットが存在するデータセンター。 値はoss-<Region ID> 形式です。 |
付録: API操作
次の表に、サポートされているAPI操作を示します。 詳細については、「機能別操作一覧」をご参照ください。
| 操作 | 説明 |
|---|---|
| AbortMultiPartUpload | マルチパートアップロードタスクをキャンセルします。 |
| AppendObject | 既存のオブジェクトにオブジェクトを追加します。 |
| CompleteUploadPart | オブジェクトのマルチパートアップロードタスクを完了します。 |
| CopyObject | オブジェクトをコピーします。 |
| DeleteBucket | バケットを削除します。 |
| DeleteLiveChannel | LiveChannel を削除します。 |
| DeleteObject | オブジェクトを削除します。 |
| DeleteObjects | 複数のオブジェクトを削除します。 |
| GetBucket | バケット内のすべてのオブジェクトに関する情報を照会します。 |
| GetBucketAcl | バケットのアクセス制御リスト (ACL) を照会します。 |
| GetBucketCors | バケットの Cross-Origin Resource Sharing (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 | バケットのスタイルを作成します。 |