Object Storage Service：logging, logging

Catatan penggunaan

• Untuk mengaktifkan logging pada sebuah bucket dan menyimpan log akses di dalam bucket tersebut, Anda memerlukan izin oss:PutBucketLogging. Untuk mengaktifkan logging pada sebuah bucket dan menyimpan log akses di bucket lain, Anda memerlukan izin oss:PutBucketLogging dan oss:PutObject. Untuk menanyakan konfigurasi logging sebuah bucket, Anda memerlukan izin oss:GetBucketLogging. Untuk menonaktifkan logging pada sebuah bucket, Anda memerlukan izin oss:DeleteBucketLogging. Untuk informasi lebih lanjut, lihat Lampirkan kebijakan kustom ke pengguna RAM.

• Untuk ossutil versi 1.6.16 dan lebih baru, Anda dapat langsung menggunakan ossutil sebagai nama biner di baris perintah tanpa perlu memperbarui nama biner berdasarkan sistem operasi. Untuk ossutil versi sebelum 1.6.16, Anda harus memperbarui nama biner sesuai dengan sistem operasi. Untuk informasi lebih lanjut, lihat Referensi Perintah ossutil.

• Untuk informasi lebih lanjut tentang logging, lihat Logging.

Aktifkan logging

Jika logging belum diaktifkan untuk sebuah bucket, perintah berikut akan mengaktifkannya. Jika logging sudah diaktifkan, perintah berikut akan menimpa konfigurasi logging yang ada.

Gunakan perintah berikut untuk mengaktifkan atau memodifikasi konfigurasi logging pada sebuah bucket:

• Sintaks Perintah

  ossutil logging --method put oss://bucketname   oss://targetbucket/[prefix]

  Tabel berikut menjelaskan parameter dan opsi dalam sintaks perintah:

  Parameter/Opsi	Deskripsi
  bucketname	Nama bucket sumber tempat objek log dihasilkan.
  targetbucket	Nama bucket tujuan tempat objek log disimpan.
  prefix	Direktori tempat objek log disimpan. Jika Anda menentukan parameter ini, objek log akan disimpan di direktori yang ditentukan dari bucket tujuan. Jika Anda tidak menentukan parameter ini, objek log akan disimpan di direktori root dari bucket tujuan.

  Penting

  Bucket sumber tempat objek log dihasilkan dan bucket tujuan tempat objek log disimpan dapat berupa bucket yang sama atau berbeda. Namun, bucket tujuan harus berada di wilayah yang sama dengan bucket sumber dan dimiliki oleh akun Alibaba Cloud yang sama.

• Contoh

  Jalankan perintah berikut untuk menyimpan objek log yang dihasilkan untuk bucket sumber srcbucket di direktori root bucket tujuan destbucket:

  ossutil logging --method put oss://srcbucket  oss://destbucket

  Jalankan perintah berikut untuk menyimpan objek log yang dihasilkan untuk bucket sumber srcbucket di subdirektori destdir dari direktori root bucket tujuan destbucket:

  ossutil logging --method put oss://srcbucket  oss://destbucket/destdir

  Output sampel berikut menunjukkan bahwa logging telah diaktifkan untuk bucket sumber:

  0.098601(s) elapsed

Tanyakan konfigurasi logging sebuah bucket

• Sintaks Perintah

  ossutil logging --method get oss://bucketname [local_xml_file]

  Tabel berikut menjelaskan parameter-parameter dalam perintah di atas:

  Parameter	Deskripsi
  bucketname	Nama bucket yang ingin Anda tanyakan konfigurasi loggingnya.
  local_xml_file	Nama file lokal tempat Anda ingin menyimpan konfigurasi logging. Contoh: localfile.txt. Jika parameter ini tidak ditentukan, konfigurasi logging yang diperoleh ditampilkan tanpa disimpan dalam file lokal.

• Contoh

  • Jalankan perintah berikut untuk menanyakan konfigurasi logging bucket examplebucket dan tulis konfigurasi logging ke file localfile.txt:

    ossutil logging --method get oss://examplebucket localfile.txt

    Output sampel berikut menunjukkan bahwa konfigurasi logging telah ditanyakan:

    0.212407(s) elapsed

  • Jalankan perintah berikut untuk menanyakan konfigurasi logging bucket examplebucket dan tampilkan konfigurasi logging tanpa menyimpannya dalam file lokal:

    ossutil logging --method get oss://examplebucket

    Output sampel berikut menunjukkan bahwa objek log yang dihasilkan untuk bucket examplebucket ditulis ke direktori root bucket destbucket:

    <?xml version="1.0" encoding="UTF-8"?>
      <BucketLoggingStatus>
          <LoggingEnabled>
              <TargetBucket>destbucket</TargetBucket>
              <TargetPrefix></TargetPrefix>
          </LoggingEnabled>
      </BucketLoggingStatus>
    
    
    0.109979(s) elapsed

Nonaktifkan logging

Sebelum menonaktifkan logging, OSS terus menghasilkan objek log. Untuk mengurangi biaya penyimpanan, kami sarankan Anda menghapus objek log yang tidak lagi diperlukan berdasarkan aturan siklus hidup. Untuk informasi lebih lanjut, lihat Aturan Siklus Hidup Berdasarkan Waktu Modifikasi Terakhir.

• Sintaks Perintah

  ossutil logging --method delete oss://bucketname

  Dalam sintaks perintah di atas, bucketname adalah nama bucket yang ingin Anda nonaktifkan loggingnya.

• Contoh

  Jalankan perintah berikut untuk menonaktifkan logging pada bucket examplebucket:

  ossutil logging --method delete oss://examplebucket

  Output sampel berikut menunjukkan bahwa logging telah dinonaktifkan untuk bucket:

  0.212409(s) elapsed

Opsi umum

Jika Anda menggunakan ossutil untuk beralih ke bucket yang berada di wilayah lain, tambahkan opsi -e untuk menentukan titik akhir wilayah tempat bucket berada. Jika Anda menggunakan ossutil untuk beralih ke bucket yang dimiliki oleh akun Alibaba Cloud lain, tambahkan opsi -i untuk menentukan ID AccessKey dari akun tersebut, dan tambahkan opsi -k untuk menentukan Rahasia AccessKey dari akun tersebut.

Sebagai contoh, Anda dapat menjalankan perintah berikut untuk menyimpan objek log yang dihasilkan untuk bucket testbucket yang berada di wilayah China (Hangzhou) dan dimiliki oleh akun Alibaba Cloud lain ke bucket destbucket:

ossutil logging --method put oss://testbucket  oss://destbucket -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Untuk informasi lebih lanjut tentang opsi umum, lihat Opsi Umum.