すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:logging

最終更新日:Dec 20, 2023

Object Storage Service (OSS) にアクセスすると、多数のアクセスログが生成されます。 バケットのロギングを有効にして設定すると、事前定義された命名規則に従って1時間ごとにログオブジェクトが生成され、アクセスログが指定されたバケットにオブジェクトとして保存されます。 loggingコマンドを実行して、バケットのロギングを有効または無効にし、バケットのロギング設定を照会できます。

説明
  • このトピックのサンプルコマンドラインは、64ビットLinuxシステムに基づいています。 他のシステムの場合は、を交換します。対応するバイナリ名を持つコマンドの /ossutil64。 詳細については、「ossutilの使用を開始する」をご参照ください。

  • ロギングの詳細については、「ログストレージ」をご参照ください。

バケットのロギングの有効化

バケットのロギングが有効になっていない場合は、このコマンドを実行してこのバケットのロギングを有効にできます。 このバケットのロギングが有効になっている場合、このコマンドを実行すると、このバケットの既存のロギング設定が上書きされます。

次のコマンド構文を使用して、バケットのログ設定を有効または変更します。

  • コマンド構文

    . /ossutil64ロギング-メソッドput oss:// bucketname oss:// targetbucket/[prefix]

    次の表に、このコマンドを実行してバケットのロギングを有効にするときに設定できるパラメーターを示します。

    パラメーター

    説明

    bucketname

    ログオブジェクトが生成されるソースバケットの名前。

    targetbucket

    ログオブジェクトが保存されている宛先バケットの名前。

    プレフィックス

    ログオブジェクトが保存されているディレクトリ。 このパラメーターを指定すると、ログオブジェクトは宛先バケットの指定されたディレクトリに保存されます。 このパラメーターを指定しない場合、ログオブジェクトは宛先バケットのルートディレクトリに保存されます。

    重要

    ログオブジェクトが生成されるソースバケットと、生成されたログオブジェクトが格納される宛先バケットは、同じバケットであっても、異なるバケットであってもよい。 ただし、宛先バケットは、ソースバケットと同じリージョンの同じアカウントに属している必要があります。

  • srcbucketソースバケット用に生成されたログオブジェクトを、destbucket宛先バケットのルートディレクトリに格納します。

    . /ossutil64ロギング -- メソッドput oss:// srcbucket oss:// destbucket

    srcbucketソースバケットに対して生成されたログオブジェクトを、destbucket宛先バケットのルートディレクトリのdestdirサブディレクトリに格納します。

    . /ossutil64ロギング -- メソッドput oss:// srcbucket oss:// destbucket/destdir

    同様の出力が表示される場合、srcbucketバケットのロギングが有効になります。

    0.098601経過

バケットのログ設定の表示

  • コマンド構文

    . /ossutil64ロギング -- メソッドget oss:// bucketname [local_xml_file]

    次の表に、このコマンドを実行してバケットのログ設定を表示するときに設定できるパラメーターを示します。

    パラメーター

    説明

    bucketname

    ログ設定を照会するバケットの名前。

    local_xml_ファイル

    ログ設定の保存に使用されるローカルファイルの名前。 例: localfile.txt このパラメーターを指定しない場合、取得したログ設定はローカルファイルに保存されずに表示されます。

    • examplebucketバケットのログ設定を照会し、取得した設定結果をlocalfile.txtローカルファイルに書き込みます。

      . /ossutil64ロギング -- メソッドget oss:// examplebucket localfile.txt

      同様の出力が表示される場合は、ログ設定を取得しています。

      0.212407経過
    • examplebucketバケットのログ設定を照会し、結果をローカルファイルに保存せずに結果を表示します。

      . /ossutil64ロギング -- メソッドget oss:// examplebucket

      同様の出力が表示される場合、examplebucketバケットのログオブジェクトはdestbucketバケットのルートディレクトリに格納されます。

      <?xml version="1.0" encoding="UTF-8"?>
        <BucketLoggingStatus>
            <LoggingEnabled>
                <TargetBucket>destbucket</TargetBucket>
                <TargetPrefix></TargetPrefix>
            </LoggingEnabled>
        </BucketLoggingStatus>
      
      
      0.109979経過 

バケットのロギングを無効にする

ログを無効にする前に、OSSはログオブジェクトの生成を続けます。 ライフサイクルルールに基づいてストレージコストを削減する必要がなくなったログオブジェクトを削除します。 詳細については、「最終変更時刻に基づくライフサイクルルール」をご参照ください。

  • コマンド構文

    . /ossutil64ロギング -- メソッドdelete oss:// bucketname

    bucketnameは、ロギングを無効にするバケットの名前を示します。

  • examplebucketバケットのロギングを無効にします。

    . /ossutil64ロギング -- メソッドdelete oss:// examplebucket

    同様の出力が表示される場合、examplebucketバケットのロギングは無効になります。

    0.212409経過

一般的なオプション

ossutilを使用して別のリージョンにあるバケットに切り替える場合は、コマンドに -eオプションを追加して、指定したバケットがあるリージョンのエンドポイントを指定します。 ossutilを使用して別のAlibaba Cloudアカウントに属するバケットに切り替える場合、コマンドに -iオプションを追加して、指定されたアカウントのAccessKey IDを指定し、コマンドに -kオプションを追加して、指定されたアカウントのAccessKeyシークレットを指定します。

次のコマンドは、中国 (杭州) リージョンのtestbucketソースバケット用に生成されたログオブジェクトをdestbucket宛先バケットに転送する方法の例を示します。

. /ossutil64ロギング -- メソッドput oss:// testbucket oss:// destbucket -e oss-cn-hangzhou.aliyuncs.com -i LTAI4Fw2NbDUCV8zYUzA **** -k 67DLVBkH7EamOjy2W5RVAHUY9H ****

ロギングコマンドに使用できるその他の共通オプションの詳細については、「共通オプション」をご参照ください。