Mengelola Peristiwa Amazon DocumentDB

Amazon DocumentDB (dengan kompabilitas MongoDB) menyimpan catatan peristiwa yang terkait dengan klaster, instans, snapshot, grup keamanan, dan grup parameter klaster Anda. Informasi ini mencakup tanggal dan waktu acara, nama sumber dan jenis sumber acara, dan pesan yang terkait dengan acara tersebut.

penting

Untuk fitur pengelolaan tertentu, Amazon DocumentDB menggunakan teknologi operasional yang dibagi dengan Amazon RDS dan Amazon Neptune. Batas wilayah, batas yang diatur di tingkat Wilayah, dibagi antara Amazon DocumentDB, Amazon RDS, dan Amazon Neptune. Untuk informasi selengkapnya, lihat Kuota Wilayah.

Menampilkan Kategori Peristiwa Amazon DocumentDB

Setiap jenis sumber daya Amazon DocumentDB memiliki jenis kejadian tertentu yang dapat dikaitkan dengannya. Anda dapat menggunakan operasi AWS CLI describe-event-categories untuk menampilkan pemetaan antara jenis peristiwa dan jenis sumber daya Amazon DocumentDB.

Parameter

• --source-type—Opsional. Gunakan parameter --source-type untuk melihat kategori kejadian pada jenis sumber tertentu. Nilai berikut diizinkan:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

• --filters—Opsional. Untuk menampilkan kategori peristiwa hanya untuk Amazon DocumentDB, gunakan filter --filter Name=engine,Values=docdb.

Kode berikut mencantumkan kategori peristiwa yang terkait dengan klaster.

Untuk Linux, macOS, atau Unix:

aws docdb describe-event-categories \
    --filter Name=engine,Values=docdb \
    --source-type db-cluster

Untuk Windows:

aws docdb describe-event-categories ^
    --filter Name=engine,Values=docdb ^
    --source-type db-cluster

Output dari operasi ini terlihat seperti berikut (format JSON).

{
    "EventCategoriesMapList": [
        {
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ],
            "SourceType": "db-cluster"
        }
    ]
}

Kode berikut mencantumkan kategori peristiwa yang terkait dengan setiap jenis sumber Amazon DocumentDB.

aws docdb describe-event-categories

Output dari operasi ini terlihat seperti berikut (format JSON).

{
    "EventCategoriesMapList": [
        {
            "SourceType": "db-instance",
            "EventCategories": [
                "notification",
                "failure",
                "creation",
                "maintenance",
                "deletion",
                "recovery",
                "restoration",
                "configuration change",
                "read replica",
                "backtrack",
                "low storage",
                "backup",
                "availability",
                "failover"
            ]
        },
        {
            "SourceType": "db-security-group",
            "EventCategories": [
                "configuration change",
                "failure"
            ]
        },
        {
            "SourceType": "db-parameter-group",
            "EventCategories": [
                "configuration change"
            ]
        },
        {
            "SourceType": "db-cluster",
            "EventCategories": [
                "notification",
                "failure",
                "maintenance",
                "failover"
            ]
        },
        {
            "SourceType": "db-cluster-snapshot",
            "EventCategories": [
                "backup"
            ]
        }
    ]
}

Menampilkan Peristiwa Amazon DocumentDB

Anda dapat mengambil kejadian untuk sumber daya Amazon DocumentDB Anda melalui konsol Amazon DocumentDB, yang menampilkan kejadian selama 24 jam terakhir. Anda juga dapat mengambil kejadian untuk sumber daya Amazon DocumentDB Anda dengan menggunakan AWS CLIperintah gambarkan-kejadian, atau operasi API DescribeEventsAmazon DocumentDB. Jika Anda menggunakan AWS CLI atau API Amazon DocumentDB untuk menampilkan kejadian, Anda dapat mengambil kejadian hingga 14 hari terakhir.

Using the AWS Management Console

Untuk menampilkan semua acara instans Amazon DocumentDB selama 24 jam terakhir

1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.

2. Di panel navigasi, pilih kejadian. Kejadian yang tersedia muncul dalam daftar.

3. Gunakan daftar Filter untuk menyelekasi peristiwa menurut jenisnya. Masukkan suatu istilah dalam kotak teks untuk menyeleksi hasil Anda lebih lanjut. Misalnya, cuplikan layar berikut menunjukkan pemfilteran semua peristiwa Amazon DocumentDB untuk peristiwa snapshot.

   

Using the AWS CLI

Untuk menampilkan semua peristiwa instans Amazon DocumentDB selama 7 hari terakhir

Anda dapat menampilkan semua peristiwa instans Amazon DocumentDB selama 7 hari terakhir dengan menjalankan operasi AWS CLI deskripsi kejadian dengan parameter --duration yang disetel ke 10080 (10.080 menit).

aws docdb describe-events --duration 10080

Penyaringan untuk Peristiwa Amazon DocumentDB

Untuk menampilkan peristiwa Amazon DocumentDB tertentu, gunakan operasi describe-events dengan parameter berikut.

Parameter

• --filter—Diperlukan untuk membatasi nilai yang ditampilkan ke peristiwa Amazon DocumentDB. Gunakan Name=engine,Values=docdb untuk memfilter semua peristiwa untuk Amazon DocumentDB saja.

• --source-identifier—Opsional. Pengidentifikasi sumber peristiwa yang akan menerima peristiwa tersebut. Jika dihilangkan, peristiwa dari semua sumber disertakan ke dalam hasilnya.

• --source-type—Opsional, jika --source-identifier tidak disediakan, maka ini diperlukan. Jika --source-identifier disediakan, --source-type harus setuju dengan jenis --source-identifier. Nilai berikut diizinkan:

  • db-cluster

  • db-instance

  • db-parameter-group

  • db-security-group

  • db-cluster-snapshot

Contoh berikut mencantumkan semua persitiwa Amazon DocumentDB Anda.

aws docdb describe-events --filters Name=engine,Values=docdb

Output dari operasi ini terlihat seperti berikut (format JSON).

{
    "Events": [
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:sample-cluster-instance3",
            "Message": "instance created",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:17:40.023Z",
            "SourceIdentifier": "sample-cluster-instance3",
            "EventCategories": [
                "creation"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance shutdown",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:01.245Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        },
        {
            "SourceArn": "arn:aws:rds:us-east-1:123SAMPLE012:db:docdb-2018-12-11-21-08-23",
            "Message": "instance restarted",
            "SourceType": "db-instance",
            "Date": "2018-12-11T21:25:11.441Z",
            "SourceIdentifier": "docdb-2018-12-11-21-08-23",
            "EventCategories": [
                "availability"
            ]
        }
    ]
}

Untuk informasi selengkapnya, lihat Mengaudit Peristiwa Amazon DocumentDB.