製品アップデート情報
製品のお知らせ
ログ管理の概要
概要
ログ管理機能は、指定したソースバケットへの詳細なアクセス情報を記録し、これらの情報をログファイル形式で指定のバケットに保存することで、バケットのより適切な管理を実現するものです。
ターゲットバケット内のログレコードのパスは次のとおりです。
ターゲットバケット/パスプレフィックス{YYYY}/{MM}/{DD}/{time}_{random}_{index}
ログは5分に1回生成され、1件のレコードにつき1行となります。各レコードに複数のフィールドが含まれ、フィールドの間はスペースで区切られます。単一のログファイルは最大256MBまでであり、この5分間に生成されたログの量が256MBを超えた時点で、ログが複数のログファイルに分割される点に注意が必要です。現在サポートされているログフィールドは次のとおりです。
フィールド番号 | 名 称 | 意 味 | 例 |
1 | eventVersion | レコードのバージョン | 1.0 |
2 | bucketName | バケット名 | examplebucket-1250000000 |
3 | qcsRegion | リクエストリージョン | ap-beijing |
4 | eventTime | イベント時間（リクエスト終了時間、UTC 0時 タイムスタンプ） | 2018-12-01T11:02:33Z |
5 | eventSource | ユーザーがアクセスしたドメイン名 | examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com |
6 | eventName | UploadPart | |
7 | remoteIp | ソースIP | 192.168.0.1 |
8 | userSecretKeyId | ユーザーアクセスKeyId | ************************************ |
9 | reservedFiled | 予約フィールド | 予約フィールドは -と表示されます。 |
10 | reqBytesSent | リクエストバイト数（Bytes） | 83886080 |
11 | deltaDataSize | ストレージ量変更のリクエスト（Bytes） | 808 |
12 | reqPath | リクエストのファイルパス | /folder/text.txt |
13 | reqMethod | リクエストメソッド | put |
14 | userAgent | ユーザーUA | cos-go-sdk-v5.2.9 |
15 | resHttpCode | HTTP戻りコード | 404 |
16 | resErrorCode | エラーコード | NoSuchKey |
17 | resErrorMsg | エラーメッセージ | The specified key does not exist. |
18 | resBytesSent | 戻りバイト数（Bytes） | 197 |
19 | resTotalTime | リクエスト総消費時間（ミリ秒、応答のTTLB-リクエストのTTFBと同じ） | 4295 |
20 | logSourceType | ログソースタイプ | USER（ユーザーアクセスリクエスト）、CDN（CDN back-to-originリクエスト） |
21 | storageClass | ストレージタイプ | STANDARD，STANDARD_IA，ARCHIVE |
22 | accountId | バケット所有者のID | 100000000001 |
23 | resTurnAroundTime | リクエストサーバー消費時間（ミリ秒、応答のTTFB-リクエストのTTLBと同じ） | 4295 |
24 | requester | アクセス元のアカウント。 アクセス元がルートアカウントの場合、アカウント形式は ルートアカウント UIN:ルートアカウント UINです。アクセス元がサブアカウントの場合、アカウント形式は ルートアカウント UIN:サブアカウント UINです。匿名アクセスの場合、 -と表示されます。 | 100000000001:100000000001 |
25 | requestId | リクエストID | NWQ1ZjY4MTBfMjZiMjU4NjRfOWI1N180NDBiYTY= |
26 | objectSize | オブジェクトサイズ（Bytes） | 808。マルチパートアップロードを使用した場合、objectSizeフィールドはアップロード完了後にしか表示されません。各パートのアップロード中、このフィールドには -と表示されます |
27 | versionId | オブジェクトのバージョンID | ランダムな文字列 |
28 | targetStorageClass | ターゲットバケットのタイプ。コピー操作のリクエストを送信すると、このフィールドが記録されます | STANDARD，STANDARD_IA，ARCHIVE |
29 | referer | リクエストのHTTP referer | *.example.comまたは111.111.111.1 |
30 | requestUri | リクエストのURI | "GET /fdgfdgsf%20/%E6%B5%AE%E7%82%B9%E6%95%B0 HTTP/1.1" 説明： 署名が query_string 形式で作成された場合、requestUri に署名が表示されます。それ以外の場合、requestUri には署名情報が含まれません。 |
31 | vpcId | VPCリクエストのID | "0"(VPCではない)/"12345"(VPC。「0」以外のstringとします) |
注意：
COS のログ管理機能が現在サポートしているリージョンは、北京、南京、上海、広州、成都、重慶、深セン（金融）、上海（金融）、中国香港、シンガポール、ソウル、バンコク、東京、シリコンバレー、バージニア、フランクフルトです。
ログ管理機能を使用するには、ソースバケットとターゲットバケットが同一のリージョンにあることが必要です。
ログを保存するターゲットバケットはソースバケットと同じにすることもできますが、推奨されません。
現時点では、XML APIおよびXML APIをベースにして実装したSDK、ツールなどによってバケットへのアクセスリクエストを行った場合にのみ、ログが記録されます。JSON APIおよびJSON APIをベースにして実装したSDK、ツールなどによるアクセスでは、ログは記録されません。
ユーザーのニーズおよび業務の発展に応じて、COSはアクセスログに新しいフィールドを追加する場合があります。ログ解析の際に必ず適切に処理してください。
COSはログデータの100%の正確性を保証するものではなく、あくまで参考用のもので、計測や課金の根拠としては使用できません。
ログ管理の有効化
コンソールの使用
1. COSコンソールにログインします。
2. 左側ナビゲーションバーでバケットリストをクリックし、バケットリスト管理ページに進みます。
3. ログ管理を有効にしたいソースバケットを見つけ、そのバケット名をクリックし、バケット管理ページに進みます。
4. 左側ナビゲーションバーで、ログ管理 > ログストレージを選択し、編集をクリックして現在のステータスを「有効」に変更します。
5. ログストレージの設定項目で、以下の説明に従って設定します。
ターゲットバケット：ログ管理が有効になっているソースバケットとログが保存されているターゲットバケットは、同じリージョンにある必要があります。COSは、ソースバケットをログを保存するためのバケットとして設定することを推奨していません。
パスプレフィックス：ログを見つけやすくするために、カスタムのパスプレフィックスを入力します。入力しない場合は、デフォルトでターゲットバケットのルートパスとなります。
サービス権限の承認：初めてログストレージ機能を開始する際には、CLS製品サービスがあなたのバケットにアクセスログを投入することを認証する必要があります。プロンプトに従って認証を完了してください。
6. 入力情報が正しいことを確認したら、保存をクリックします。この時点で、ログ管理機能が有効になります。
説明：
ログストレージ機能を開始した後、最初のログ配信が完了するまでに約1時間かかると予想されます。その後は5分ごとにログが生成され、ログの配信時刻はデータ量によって異なります。
7. ログを保存するように以前に設定したターゲットバケットを見つけると、発行されたログファイルを確認することができます。
8. ログファイルをダウンロードすると、フィールドの説明に従ってログを確認することができます。詳細については、ログ管理の概要をご参照ください。
注意：
現在、ログストレージを設定する権限を持っているのはストレージバケット所有者だけで、他のユーザーログインコンソールにはログストレージ構成項目は表示されません。
関連説明
ログ管理機能が有効になっている場合は、CAMコンソールでログロールを作成し、そのロールがターゲットバケットに対してログの読み取り/書き込み操作を許可する必要があります。
ログ管理機能が無効になっている場合、ログロールを削除しない限り、ターゲットバケットへのログの読み取り/書き込み操作を実行するロールの権限は削除されません。
APIの使用
APIを使用して、指定のバケットでログ管理機能を有効化する場合は、次の手順をご参照ください。
1. ログロールの作成
ログロールを作成します。具体的なインターフェースの情報については、CreateRoleをご参照ください。
このうち、roleNameは必ずCLS_QcsRoleとします。
policyDocumentは次のとおりです。
{"version": "2.0","statement": [{"action": "name/sts:AssumeRole","effect": "allow","principal":{"service": "cls.cloud.tencent.com"}}]}
2. ログロールへの権限のバインド
ロール権限に権限をバインドします。具体的なインターフェースの情報については、AttachRolePolicyをご参照ください。
このうち、policyNameはQcloudCOSAccessForCLSRoleとします。roleNameは手順1のCLS_QcsRoleとします。roleNameの作成時に返されたroleIDを使用することもできます。
3. ログ管理の有効化
インターフェースを呼び出してログ管理機能を有効化します。具体的なインターフェースの情報については、PUT Bucket loggingをご参照ください。ログを保存するターゲットバケットはソースバケットと同一のリージョンにあることが必要です。
フィードバック