Membuat konfigurasi metrik yang melakukan filter berdasarkan prefiks, tag objek, atau titik akses

Ada tiga jenis metrik Amazon untuk Amazon S3: CloudWatch metrik penyimpanan, metrik permintaan, dan metrik replikasi. Metrik penyimpanan dilaporkan satu kali sehari, dan diberikan kepada semua pelanggan tanpa biaya tambahan. Metrik permintaan tersedia dalam interval satu menit setelah beberapa latensi untuk diproses. Metrik permintaan ditagih dengan tarif standar CloudWatch . Anda harus memilih untuk meminta metrik dengan mengonfigurasinya di dalam konsol, atau menggunakan API Amazon S3. Metrik Replikasi S3 memberikan metrik terperinci untuk aturan replikasi dalam konfigurasi replikasi Anda. Dengan metrik replikasi, Anda dapat memantau minute-by-minute kemajuan dengan melacak byte yang tertunda, operasi tertunda, operasi yang gagal replikasi, dan latensi replikasi.

Untuk informasi selengkapnya tentang CloudWatch metrik untuk Amazon S3, lihat. Memantau metrik dengan Amazon CloudWatch

Saat mengonfigurasi CloudWatch metrik, Anda dapat membuat filter untuk semua objek di bucket, atau memfilter konfigurasi ke dalam grup objek terkait dalam satu bucket. Anda dapat memfilter objek dalam bucket untuk disertakan dalam konfigurasi metrik berdasarkan satu atau beberapa jenis filter berikut ini:

• Prefiks nama kunci objek–Meskipun model data Amazon S3 adalah struktur datar, Anda dapat menyimpulkan hierarki dengan menggunakan prefiks. Konsol Amazon S3 mendukung prefiks ini dengan konsep folder. Jika Anda memfilter menurut prefiks, objek yang memiliki prefiks yang sama akan disertakan dalam konfigurasi metrik. Untuk informasi selengkapnya tentang prefiks, lihat Organisasi objek menggunakan prefiks.

• Tag–Anda dapat menambahkan tag, yang merupakan pasangan nama nilai-kunci, untuk objek. Tag membantu Anda untuk menemukan dan menata objek dengan mudah. Anda juga dapat menggunakan tag sebagai filter untuk konfigurasi metrik. Untuk informasi selengkapnya tentang tag objek, lihat Mengategorikan penyimpanan Anda menggunakan tag.

• Titik akses–Titik Akses S3 diberi nama titik akhir jaringan yang dilampirkan ke bucket dan menyederhanakan pengelolaan akses data pada skala untuk set data bersama di S3. Saat Anda membuat filter titik akses, Amazon S3 menyertakan permintaan ke titik akses yang Anda tentukan dalam konfigurasi metrik. Untuk informasi selengkapnya, lihat Pemantauan dan pencatatan titik akses.

  catatan

  Saat Anda membuat konfigurasi metrik yang memfilter berdasarkan titik akses, Anda harus menggunakan titik akses Amazon Resource Name (ARN), bukan alias titik akses. Pastikan Anda menggunakan ARN untuk titik akses itu sendiri, bukan ARN untuk objek tertentu. Untuk informasi lebih lanjut tentang titik akses ARN, lihat Menggunakan titik akses.

Jika Anda menetapkan filter, hanya permintaan yang beroperasi pada objek tunggal yang dapat cocok dengan filter dan disertakan dalam metrik yang dilaporkan. Permintaan suka DeleteObjectsdan ListObjects permintaan tidak menampilkan metrik apa pun untuk konfigurasi dengan filter.

Untuk meminta pemfilteran yang lebih kompleks, pilih dua atau lebih elemen. Hanya objek yang memiliki semua elemen tersebut yang disertakan dalam konfigurasi metrik. Jika Anda tidak mengatur filter, semua objek dalam bucket disertakan dalam konfigurasi metrik.

Menggunakan konsol S3

1. Masuk ke AWS Management Console dan buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

2. Di daftar Bucket, pilih nama bucket yang berisi objek yang Anda inginkan meminta metrik.

3. Pilih tab Metrik.

4. Di bagian bawah Metrik bucket, pilih Lihat bagan tambahan.

5. Pilih tab Minta metrik.

6. Pilih Buat filter.

7. Di dalam kotak Nama filter, masukkan nama filter Anda.

   Nama hanya dapat berisi huruf, angka, periode, tanda hubung, dan garis bawah.

8. Di bawah Cakupan filter, pilih Batasi cakupan filter ini menggunakan prefiks, tag objek, dan Titik Akses S3, atau kombinasi ketiganya.

9. Di bawah Jenis filter, pilih setidaknya satu jenis filter: Awalan, Tag objek, atau Titik akses.

10. Untuk menentukan filter prefiks dan membatasi cakupan filter ke satu jalur, di kotak Prefiks, masukkan prefiks.

11. Untuk menentukan filter tag objek, di bawah Tag objek, pilih Tambah tag, lalu masukkan tag Kunci dan Nilai.

12. Untuk menentukan filter titik akses, di bidang Titik Akses S3, masukkan titik akses ARN, atau pilih Telusuri S3 untuk menavigasi ke titik akses.

    penting

    Anda tidak dapat memasukkan alias titik akses. Anda harus memasukkan ARN untuk titik akses itu sendiri, bukan ARN untuk objek tertentu.

13. Pilih Simpan perubahan.

    Amazon S3 membuat filter yang menggunakan prefiks, tag, atau titik akses yang Anda tentukan.

14. Pada tab Minta metrik, di bagian bawah Filter, pilih filter yang baru saja Anda buat.

    Sekarang Anda telah membuat filter yang membatasi cakupan metrik permintaan berdasarkan prefiks, tag objek, atau titik akses. Sekitar 15 menit setelah CloudWatch mulai melacak metrik permintaan ini, Anda dapat melihat bagan untuk metrik di Amazon CloudWatch S3 dan konsol. Metrik permintaan ditagih dengan tarif standar CloudWatch . Untuk informasi selengkapnya, lihat CloudWatch harga Amazon.

    Anda juga dapat mengonfigurasi metrik permintaan di tingkat bucket. Untuk informasi, lihat Membuat konfigurasi CloudWatch metrik untuk semua objek di bucket.

Menggunakan AWS CLI

1. Instal dan atur AWS CLI. Untuk instruksi, lihat Menginstal, memperbarui, dan menghapus AWS CLI di AWS Command Line Interface Panduan Pengguna.

2. Buka terminal.

3. Untuk menambahkan konfigurasi metrik, jalankan salah satu dari perintah berikut ini:

   contoh : Untuk memfilter berdasarkan prefiks

   aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Prefix":"prefix1"}} '

   contoh : Untuk memfilter berdasarkan tag

   aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"Tag": {"Key": "string", "Value": "string"}} '

   contoh : Untuk memfilter berdasarkan titik akses

   aws s3api put-bucket-metrics-configuration --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '{"Id":"metrics-config-id", "Filter":{"AccessPointArn":"arn:aws:s3:Region:account-id:accesspoint/access-point-name"}} '

   contoh : Untuk memfilter berdasarkan prefiks, tag, dan titik akses

   aws s3api put-bucket-metrics-configuration --endpoint https://s3.Region.amazonaws.com --bucket DOC-EXAMPLE-BUCKET1 --id metrics-config-id --metrics-configuration '
   {
       "Id": "metrics-config-id",
       "Filter": {
           "And": {
               "Prefix": "string",
               "Tags": [
                   {
                       "Key": "string",
                       "Value": "string"
                   }
               ],
               "AccessPointArn": "arn:aws:s3:Region:account-id:accesspoint/access-point-name"
           }
       }
   }'

Penggunaan API REST

Anda juga dapat menambahkan konfigurasi metrik secara terprogram dengan API REST Amazon S3. Untuk informasi selengkapnya tentang menambahkan dan bekerja dengan konfigurasi metrik, lihat topik berikut di Referensi API Amazon Simple Storage Service:

• Konfigurasi Metrik Bucket PUT

• Konfigurasi Metrik Bucket GET

• Daftar Konfigurasi Metrik Bucket

• Konfigurasi Metrik Bucket DELETE