logging コマンドは、特定のバケットのログ設定を追加、変更、クエリ、または削除する場合に使用します。

ログの詳細は、「サーバーアクセスログ」をご参照ください。

コマンド構文

  • ログ設定を追加または変更する
    ./ossutil logging --method put oss://bucket  oss://target-bucket/[prefix]

    バケットのログが無効になっている場合、このコマンドを実行して、target-bucket パラメーターで指定したバケット内のオブジェクトとしてアクセスログを保存できます。 また、バケットのログが有効になっている場合、このコマンドを実行して、アクセスログが保存されるディレクトリを変更できます。

    prefix パラメーターには、アクセスログのプレフィックスと、バケットアクセスログが保存されるディレクトリを指定します。 このパラメーターを指定した場合、target-bucket パラメーターで指定したバケットのディレクトリにアクセスログが保存されます。 このパラメーターを指定していない場合、target-bucket パラメーターで指定したバケットのルートディレクトリにアクセスログが保存されます。 ログファイルの命名規則の詳細は、「ログの設定」をご参照ください。

  • ログ設定を取得する
    ./ossutil logging --method get oss://bucket  [local_xml_file]

    local_xml_file パラメーターには、設定ファイルの名前を指定します。 このパラメーターを指定した場合、取得したログ設定はローカルファイルとして保存されます。 このパラメーターを指定していない場合、取得したログ設定が表示されます。

  • ログ設定を削除する
    ./ossutil logging --method delete oss://bucket

  • ログ設定を追加する
    ./ossutil logging --method put oss://bucket1  oss://bucket2/logging
  • ログ設定を取得する
    ./ossutil logging --method get oss://bucket1  /file/logging.xml
  • ログ設定を削除する
    ./ossutil logging --method delete oss://bucket1

一般的なオプション

次の表に、logging コマンドに追加できるオプションを示します。
オプション 説明
--method HTTP リクエストメソッドを指定します。 有効値:
  • put:ログ設定を追加または変更します。
  • get:ログ設定を取得します。
  • delete:ログ設定を削除します。
--loglevel ログレベルを指定します。 デフォルト値は null で、ログファイルが生成されないことを示します。 有効値:
  • info:プロンプトログを生成します。
  • debug:対応する HTTP リクエストとレスポンス情報を含む詳細なログを生成します。
--proxy-host プロキシサーバーの URL を指定します。 HTTP、HTTPS、SOCKS5 がサポートされています。 URL の例:http://120.79.**.**:3128、socks5://120.79.**.**:1080 など。
--proxy-user プロキシサーバーのユーザー名を指定します。 デフォルト値は null です。
--proxy-pwd プロキシサーバーのパスワードを指定します。 デフォルト値は null です。
一般的なオプションの詳細は、「サポートされているすべてのオプションの表示」をご参照ください。