Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pencatatan dan Pemantauan di Amazon SNS
Amazon SNS memungkinkan Anda melacak dan memantau aktivitas perpesanan dengan mencatat panggilan API dengan CloudTrail dan memantau topik dengan. CloudWatch Alat ini membantu Anda mendapatkan wawasan tentang pengiriman pesan, memecahkan masalah, dan memastikan kesehatan alur kerja pesan Anda. Topik ini mencakup hal-hal berikut:
+ [Pencatatan panggilan API AWS SNS menggunakan AWS CloudTrail](logging-using-cloudtrail.md). Pencatatan ini memungkinkan Anda melacak tindakan yang dilakukan pada topik Amazon SNS Anda, seperti pembuatan topik, manajemen langganan, dan penerbitan pesan. Dengan menganalisis CloudTrail log, Anda dapat mengidentifikasi siapa yang membuat permintaan API tertentu dan kapan permintaan tersebut dibuat, membantu Anda mengaudit dan memecahkan masalah penggunaan Amazon SNS Anda.
+ [Memantau topik Amazon SNS menggunakan CloudWatch](sns-monitoring-using-cloudwatch.md). CloudWatch menyediakan metrik yang memungkinkan Anda mengamati kinerja dan kesehatan topik Amazon SNS Anda secara real time. Siapkan alarm berdasarkan metrik ini, sehingga Anda dapat segera merespons anomali apa pun, seperti kegagalan pengiriman atau latensi pesan tinggi. Kemampuan pemantauan ini memastikan bahwa Anda dapat mempertahankan keandalan sistem pesan berbasis SNS Anda dengan secara proaktif menangani masalah potensial.
# Pencatatan panggilan API AWS SNS menggunakan AWS CloudTrail
AWS SNS terintegrasi dengan [AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-user-guide.html), layanan yang menyediakan catatan tindakan yang diambil oleh pengguna, peran, atau. Layanan AWS CloudTrail menangkap semua panggilan API untuk SNS sebagai peristiwa. Panggilan yang diambil termasuk panggilan dari konsol SNS dan panggilan kode ke operasi SNS API. Dengan menggunakan informasi yang dikumpulkan oleh CloudTrail, Anda dapat menentukan permintaan yang dibuat untuk SNS, alamat IP dari mana permintaan dibuat, kapan dibuat, dan detail tambahan.
Setiap entri peristiwa atau log berisi informasi tentang entitas yang membuat permintaan tersebut. Informasi identitas membantu Anda menentukan berikut hal ini:
+ Baik permintaan tersebut dibuat dengan kredensial pengguna root atau pengguna.
+ Apakah permintaan dibuat atas nama pengguna IAM Identity Center.
+ Apakah permintaan tersebut dibuat dengan kredensial keamanan sementara untuk satu peran atau pengguna gabungan.
+ Apakah permintaan tersebut dibuat oleh Layanan AWS lain.
CloudTrail aktif di Anda Akun AWS ketika Anda membuat akun dan Anda secara otomatis memiliki akses ke **riwayat CloudTrail Acara**. **Riwayat CloudTrail Acara menyediakan catatan** yang dapat dilihat, dapat dicari, dapat diunduh, dan tidak dapat diubah dari 90 hari terakhir dari peristiwa manajemen yang direkam dalam file. Wilayah AWS Untuk informasi selengkapnya, lihat [Bekerja dengan riwayat CloudTrail Acara](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html) di *Panduan AWS CloudTrail Pengguna*. Tidak ada CloudTrail biaya untuk melihat **riwayat Acara**.
Untuk catatan acara yang sedang berlangsung dalam 90 hari Akun AWS terakhir Anda, buat jejak atau penyimpanan data acara [CloudTrailDanau](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html).
**CloudTrail jalan setapak**
*Jejak* memungkinkan CloudTrail untuk mengirimkan file log ke bucket Amazon S3. Semua jalur yang dibuat menggunakan Konsol Manajemen AWS Multi-region. Anda dapat membuat jalur Single-region atau Multi-region dengan menggunakan. AWS CLI Membuat jejak Multi-wilayah disarankan karena Anda menangkap aktivitas Wilayah AWS di semua akun Anda. Jika Anda membuat jejak wilayah Tunggal, Anda hanya dapat melihat peristiwa yang dicatat di jejak. Wilayah AWS Untuk informasi selengkapnya tentang jejak, lihat [Membuat jejak untuk Anda Akun AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) dan [Membuat jejak untuk organisasi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/creating-trail-organization.html) di *Panduan AWS CloudTrail Pengguna*.
Anda dapat mengirimkan satu salinan acara manajemen yang sedang berlangsung ke bucket Amazon S3 Anda tanpa biaya CloudTrail dengan membuat jejak, namun, ada biaya penyimpanan Amazon S3. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/). Untuk informasi tentang harga Amazon S3, lihat [Harga Amazon S3](https://aws.amazon.com/s3/pricing/).
**CloudTrail Menyimpan data acara danau**
*CloudTrail Lake* memungkinkan Anda menjalankan kueri berbasis SQL pada acara Anda. CloudTrail [Lake mengonversi peristiwa yang ada dalam format JSON berbasis baris ke format Apache ORC.](https://orc.apache.org/) ORC adalah format penyimpanan kolumnar yang dioptimalkan untuk pengambilan data dengan cepat. Peristiwa digabungkan ke dalam *penyimpanan data peristiwa*, yang merupakan kumpulan peristiwa yang tidak dapat diubah berdasarkan kriteria yang Anda pilih dengan menerapkan pemilih acara [tingkat lanjut](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-concepts.html#adv-event-selectors). Penyeleksi yang Anda terapkan ke penyimpanan data acara mengontrol peristiwa mana yang bertahan dan tersedia untuk Anda kueri. Untuk informasi lebih lanjut tentang CloudTrail Danau, lihat [Bekerja dengan AWS CloudTrail Danau](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake.html) di *Panduan AWS CloudTrail Pengguna*.
CloudTrail Penyimpanan data acara danau dan kueri menimbulkan biaya. Saat Anda membuat penyimpanan data acara, Anda memilih [opsi harga](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-lake-manage-costs.html#cloudtrail-lake-manage-costs-pricing-option) yang ingin Anda gunakan untuk penyimpanan data acara. Opsi penetapan harga menentukan biaya untuk menelan dan menyimpan peristiwa, dan periode retensi default dan maksimum untuk penyimpanan data acara. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/).
## Peristiwa data SNS di CloudTrail
[Peristiwa data](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events) memberikan informasi tentang operasi sumber daya yang dilakukan pada atau di sumber daya (misalnya, membaca atau menulis ke objek Amazon S3). Ini juga dikenal sebagai operasi bidang data. Peristiwa data sering kali merupakan aktivitas bervolume tinggi. Secara default, CloudTrail tidak mencatat peristiwa data. **Riwayat CloudTrail peristiwa** tidak merekam peristiwa data.
Biaya tambahan berlaku untuk peristiwa data. Untuk informasi selengkapnya tentang CloudTrail harga, lihat [AWS CloudTrail Harga](https://aws.amazon.com/cloudtrail/pricing/).
Anda dapat mencatat peristiwa data untuk jenis sumber daya SNS menggunakan CloudTrail konsol AWS CLI, atau operasi CloudTrail API. Untuk informasi selengkapnya tentang cara mencatat peristiwa data, lihat [Mencatat peristiwa data dengan Konsol Manajemen AWS](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#logging-data-events-console) dan Mencatat [peristiwa data dengan AWS Command Line Interface](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-data-events-with-cloudtrail.html#creating-data-event-selectors-with-the-AWS-CLI) di *Panduan AWS CloudTrail Pengguna*.
Tabel berikut mencantumkan jenis sumber daya SNS yang dapat Anda log peristiwa data. Kolom **tipe peristiwa data (konsol)** menunjukkan nilai yang akan dipilih dari daftar **tipe peristiwa Data** di CloudTrail konsol. Kolom nilai **resources.type menunjukkan `resources.type` nilai**, yang akan Anda tentukan saat mengonfigurasi penyeleksi acara lanjutan menggunakan or. AWS CLI CloudTrail APIs CloudTrailKolom **Data yang APIs dicatat ke** menampilkan panggilan API yang dicatat CloudTrail untuk jenis sumber daya.
| Jenis peristiwa data (konsol) | nilai resources.type | Data APIs masuk CloudTrail |
| --- | --- | --- |
| Topik SNS | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sns-topic.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/logging-using-cloudtrail.html) |
| Titik akhir platform SNS | AWS::SNS::PlatformEndpoint | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/logging-using-cloudtrail.html) |
**catatan**
Jenis sumber daya SNS `AWS::SNS::PhoneNumber` tidak dicatat oleh CloudTrail.
Anda dapat mengonfigurasi pemilih acara lanjutan untuk memfilter pada `eventName``readOnly`,, dan `resources.ARN` bidang untuk mencatat hanya peristiwa yang penting bagi Anda. Untuk informasi selengkapnya tentang bidang ini, lihat [https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html](https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html)di *Referensi AWS CloudTrail API*.
Untuk informasi tentang peristiwa data pencatatan, lihat Mencatat peristiwa data dengan Konsol Manajemen AWS dan Logging peristiwa data dengan AWS CLI di Panduan CloudTrail Pengguna.
## Acara manajemen SNS di CloudTrail
[Acara manajemen](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) memberikan informasi tentang operasi manajemen yang dilakukan pada sumber daya di Anda Akun AWS. Ini juga dikenal sebagai operasi bidang kontrol. Secara default, CloudTrail mencatat peristiwa manajemen.
AWS SNS mencatat operasi bidang kontrol SNS berikut CloudTrail sebagai peristiwa *manajemen*.
+ `[AddPermission](https://docs.aws.amazon.com/sns/latest/api/API_AddPermission.html)`
+ `[CheckIfPhoneNumberIsOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_CheckIfPhoneNumberIsOptedOut.html)`
+ `[ConfirmSubscription](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)`
+ `[CreatePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformApplication.html)`
+ `[CreatePlatformEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_CreatePlatformEndpoint.html)`
+ `[CreateSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_CreateSMSSandboxPhoneNumber.html)`
+ `[CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html)`
+ `[DeleteEndpoint](https://docs.aws.amazon.com/sns/latest/api/API_DeleteEndpoint.html)`
+ `[DeletePlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_DeletePlatformApplication.html)`
+ `[DeleteSMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_DeleteSMSSandboxPhoneNumber.html)`
+ `[DeleteTopic](https://docs.aws.amazon.com/sns/latest/api/API_DeleteTopic.html)`
+ `[GetDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_GetDataProtectionPolicy.html)`
+ `[GetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetEndpointAttributes.html)`
+ `[GetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetPlatformApplicationAttributes.html)`
+ `[GetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSAttributes.html)`
+ `[GetSMSSandboxAccountStatus](https://docs.aws.amazon.com/sns/latest/api/API_GetSMSSandboxAccountStatus.html)`
+ `[GetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetSubscriptionAttributes.html)`
+ `[GetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_GetTopicAttributes.html)`
+ `[ListEndpointsByPlatformApplication](https://docs.aws.amazon.com/sns/latest/api/API_ListEndpointsByPlatformApplication.html)`
+ `[ListOriginationNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListOriginationNumbers.html)`
+ `[ListPhoneNumbersOptedOut](https://docs.aws.amazon.com/sns/latest/api/API_ListPhoneNumbersOptedOut.html)`
+ `[ListPlatformApplications](https://docs.aws.amazon.com/sns/latest/api/API_ListPlatformApplications.html)`
+ `[ListSMSSandboxPhoneNumbers](https://docs.aws.amazon.com/sns/latest/api/API_ListSMSSandboxPhoneNumbers.html)`
+ `[ListSubscriptions](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptions.html)`
+ `[ListSubscriptionsByTopic](https://docs.aws.amazon.com/sns/latest/api/API_ListSubscriptionsByTopic.html)`
+ `[ListTagsForResource](https://docs.aws.amazon.com/sns/latest/api/API_ListTagsForResource.html)`
+ `[ListTopics](https://docs.aws.amazon.com/sns/latest/api/API_ListTopics.html)`
+ `[OptInPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_OptInPhoneNumber.html)`
+ `[PutDataProtectionPolicy](https://docs.aws.amazon.com/sns/latest/api/API_PutDataProtectionPolicy.html)`
+ `[RemovePermission](https://docs.aws.amazon.com/sns/latest/api/API_RemovePermission.html)`
+ `[SetEndpointAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetEndpointAttributes.html)`
+ `[SetPlatformApplicationAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetPlatformApplicationAttributes.html)`
+ `[SetSMSAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSMSAttributes.html)`
+ `[SetSubscriptionAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetSubscriptionAttributes.html)`
+ `[SetTopicAttributes](https://docs.aws.amazon.com/sns/latest/api/API_SetTopicAttributes.html)`
+ `[Subscribe](https://docs.aws.amazon.com/sns/latest/api/API_Subscribe.html)`
+ `[TagResource](https://docs.aws.amazon.com/sns/latest/api/API_TagResource.html)`
+ `[Unsubscribe](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)`
+ `[UntagResource](https://docs.aws.amazon.com/sns/latest/api/API_UntagResource.html)`
+ `[VerifySMSSandboxPhoneNumber](https://docs.aws.amazon.com/sns/latest/api/API_VerifySMSSandboxPhoneNumber.html)`
**catatan**
Ketika Anda tidak masuk ke Amazon Web Services (mode tidak diautentikasi) dan [https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html](https://docs.aws.amazon.com/sns/latest/api/API_Unsubscribe.html)tindakan [https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html](https://docs.aws.amazon.com/sns/latest/api/API_ConfirmSubscription.html)atau tindakan dipanggil, maka mereka tidak akan masuk ke log. CloudTrail Misalnya, ketika Anda memilih tautan yang disediakan dalam notifikasi email untuk mengonfirmasi langganan tertunda ke topik, tindakan `ConfirmSubscription` dipanggil dalam mode tidak terautentikasi. Dalam contoh ini, `ConfirmSubscription` tindakan tidak akan dicatat CloudTrail.
## Contoh acara SNS
Peristiwa mewakili permintaan tunggal dari sumber manapun dan mencakup informasi tentang operasi API yang diminta, tanggal dan waktu operasi, parameter permintaan, dan sebagainya. CloudTrail file log bukanlah jejak tumpukan yang diurutkan dari panggilan API publik, sehingga peristiwa tidak muncul dalam urutan tertentu.
Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan **`ListTopics`**,`CreateTopic`, dan `DeleteTopic` tindakan.
```
{
"Records": [
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "ListTopics",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"nextToken": "ABCDEF1234567890EXAMPLE=="
},
"responseElements": null,
"requestID": "example1-b9bb-50fa-abdb-80f274981d60",
"eventID": "example0-09a3-47d6-a810-c5f9fd2534fe",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "CreateTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"name": "hello"
},
"responseElements": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"requestID": "example7-5cd3-5323-8a00-f1889011fee9",
"eventID": "examplec-4f2f-4625-8378-130ac89660b1",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
},
{
"eventVersion": "1.02",
"userIdentity": {
"type": "IAMUser",
"userName": "Bob",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE"
},
"eventTime": "2014-09-30T00:00:00Z",
"eventSource": "sns.amazonaws.com",
"eventName": "DeleteTopic",
"awsRegion": "us-west-2",
"sourceIPAddress": "127.0.0.1",
"userAgent": "aws-sdk-java/unknown-version",
"requestParameters": {
"topicArn": "arn:aws:sns:us-west-2:123456789012:hello-topic"
},
"responseElements": null,
"requestID": "example5-4faa-51d5-aab2-803a8294388d",
"eventID": "example8-6443-4b4d-abfd-1b867280d964",
"eventType": "AwsApiCall",
"recipientAccountId": "123456789012"
}
]
}
```
Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan `Publish` tindakan.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T16:44:05Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T16:48:37Z",
"eventSource": "sns.amazonaws.com",
"eventName": "Publish",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS",
"subject": "HIDDEN_DUE_TO_SECURITY_REASONS",
"messageStructure": "json",
"messageAttributes": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
"responseElements": {
"messageId": "0787cd1e-d92b-521c-a8b4-90434e8ef840"
},
"requestID": "0a8ab208-11bf-5e01-bd2d-ef55861b545d",
"eventID": "bb3496d4-5252-4660-9c28-3c6aebdb21c0",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
Contoh berikut menunjukkan CloudTrail peristiwa yang menunjukkan `PublishBatch` tindakan.
```
{
"eventVersion": "1.09",
"userIdentity": {
"type": "AssumedRole",
"principalId": "EX_PRINCIPAL_ID",
"arn": "arn:aws:iam::123456789012:user/Bob",
"accountId": "123456789012",
"accessKeyId": "AKIAIOSFODNN7EXAMPLE",
"sessionContext": {
"sessionIssuer": {
"type": "Role",
"principalId": "AKIAIOSFODNN7EXAMPLE",
"arn": "arn:aws:iam::123456789012:role/Admin",
"accountId": "123456789012",
"userName": "ExampleUser"
},
"attributes": {
"creationDate": "2023-08-21T19:20:49Z",
"mfaAuthenticated": "false"
}
}
},
"eventTime": "2023-08-21T19:22:01Z",
"eventSource": "sns.amazonaws.com",
"eventName": "PublishBatch",
"awsRegion": "us-east-1",
"sourceIPAddress": "192.0.2.0",
"userAgent": "aws-cli/1.29.16 md/Botocore#1.31.16 ua/2.0 os/linux#5.4.250-173.369.amzn2int.x86_64 md/arch#x86_64 lang/python#3.8.17 md/pyimpl#CPython cfg/retry-mode#legacy botocore/1.31.16",
"requestParameters": {
"topicArn": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic",
"publishBatchRequestEntries": [
{
"id": "1",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
{
"id": "2",
"message": "HIDDEN_DUE_TO_SECURITY_REASONS"
}
]
},
"responseElements": {
"successful": [
{
"id": "1",
"messageId": "30d68101-a64a-5573-9e10-dc5c1dd3af2f"
},
{
"id": "2",
"messageId": "c0aa0c5c-561d-5455-b6c4-5101ed84de09"
}
],
"failed": []
},
"requestID": "e2cdf7f3-1b35-58ad-ac9e-aaaea0ace2f1",
"eventID": "10da9a14-0154-4ab6-b3a5-1825b229a7ed",
"readOnly": false,
"resources": [
{
"accountId": "123456789012",
"type": "AWS::SNS::Topic",
"ARN": "arn:aws:sns:us-east-1:123456789012:ExampleSNSTopic"
}
],
"eventType": "AwsApiCall",
"managementEvent": false,
"recipientAccountId": "123456789012",
"eventCategory": "Data",
"tlsDetails": {
"tlsVersion": "TLSv1.2",
"cipherSuite": "ECDHE-RSA-AES128-GCM-SHA256",
"clientProvidedHostHeader": "sns.us-east-1.amazonaws.com"
}
}
```
Untuk informasi tentang konten CloudTrail rekaman, lihat [konten CloudTrail rekaman](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-record-contents.html) di *Panduan AWS CloudTrail Pengguna*.
# Memantau topik Amazon SNS menggunakan CloudWatch
Amazon SNS dan Amazon CloudWatch terintegrasi sehingga Anda dapat mengumpulkan, melihat, dan menganalisis metrik untuk setiap notifikasi Amazon SNS yang aktif. Setelah Anda mengonfigurasi CloudWatch untuk Amazon SNS, Anda dapat memperoleh wawasan yang lebih baik tentang kinerja topik Amazon SNS, pemberitahuan push, dan pengiriman SMS Anda. Misalnya, Anda dapat mengatur alarm untuk mengirimkan notifikasi email jika ambang batas tertentu dipenuhi untuk metrik Amazon SNS, seperti `NumberOfNotificationsFailed`. Untuk daftar semua metrik yang CloudWatch dikirimkan Amazon SNS, lihat. [Metrik Amazon SNS](#sns-metrics) Untuk informasi selengkapnya tentang notifikasi push Amazon SNS, lihat [Mengirim notifikasi push seluler dengan Amazon SNS](sns-mobile-application-as-subscriber.md).
**catatan**
Metrik yang Anda konfigurasikan CloudWatch untuk topik Amazon SNS Anda dikumpulkan dan didorong secara otomatis *pada* interval 1 CloudWatch menit. Metrik ini dikumpulkan pada semua topik yang memenuhi CloudWatch pedoman untuk aktif. Topik dianggap aktif hingga CloudWatch enam jam dari aktivitas terakhir (yaitu, panggilan API apa pun) pada topik tersebut.
Tidak ada biaya untuk metrik Amazon SNS yang dilaporkan CloudWatch; mereka disediakan sebagai bagian dari layanan Amazon SNS.
## Lihat CloudWatch metrik untuk Amazon SNS
Anda dapat memantau metrik untuk Amazon SNS menggunakan konsol CloudWatch, CloudWatch antarmuka baris perintah (CLI) sendiri, atau menggunakan API secara terprogram. CloudWatch Prosedur berikut menunjukkan cara mengakses metrik menggunakan Konsol Manajemen AWS.
**Untuk melihat metrik menggunakan konsol CloudWatch**
1. Masuk ke [konsol CloudWatch](https://console.aws.amazon.com/cloudwatch) tersebut.
1. Di panel navigasi, pilih **Metrics (Metrik)**.
1. Pada tab **All metrics (Semua metrik)**, pilih **SNS**, lalu pilih salah satu dimensi berikut:
+ **Negara, Jenis SMS**
+ **PhoneNumber**
+ **Metrik Topik**
+ **Metrik tanpa dimensi**
1. Untuk melihat detail lebih lanjut, pilih item tertentu. Misalnya, jika Anda memilih **Metrik Topik** dan kemudian memilih **NumberOfMessagesPublished**, jumlah rata-rata pesan Amazon SNS yang diterbitkan untuk periode 1 menit selama rentang waktu 6 jam akan ditampilkan.
1. Untuk melihat metrik penggunaan Amazon SNS, pada tab **Semua metrik**, pilih **Penggunaan**, dan pilih **metrik penggunaan Amazon SNS target** (misalnya,). `NumberOfMessagesPublishedPerAccount`
## Setel CloudWatch alarm untuk metrik Amazon SNS
CloudWatch juga memungkinkan Anda untuk mengatur alarm ketika ambang batas terpenuhi untuk metrik. Misalnya, Anda dapat mengatur alarm untuk metrik **NumberOfNotificationsFailed**, sehingga ketika nomor ambang batas yang Anda tentukan terpenuhi dalam periode pengambilan sampel, maka pemberitahuan email akan dikirim untuk memberi tahu Anda tentang peristiwa tersebut.
**Untuk mengatur alarm menggunakan konsol CloudWatch**
1. Masuk ke Konsol Manajemen AWS dan buka CloudWatch konsol di [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Pilih **Alarms (Alarm)** lalu pilih tombol **Create Alarm (Buat Alarm)**. Proses ini meluncurkan wizard **Create Alarm (Buat Alarm)**.
1. Gulir menggunakan metrik Amazon SNS untuk menemukan metrik yang ingin Anda aktifkan alarmnya. Pilih metrik untuk membuat alarm aktif dan pilih **Continue (Lanjutkan)**.
1. Isi nilai **Name (Nama)**, **Description (Deskripsi)**, **Threshold (Ambang)**, dan **Time (Waktu)** untuk metrik, dan kemudian pilih **Continue (Lanjutkan)**.
1. Pilih **Alarm (Alarm)** sebagai status alarm. Jika Anda CloudWatch ingin mengirimi Anda email saat status alarm tercapai, pilih salah satu topik Amazon SNS yang ada atau pilih **Buat Topik Email Baru**. Jika memilih **Create New Email Topic (Buat Topik Email Baru)**, Anda dapat mengatur nama dan alamat email untuk topik baru. Daftar ini akan disimpan dan muncul di kotak drop-down untuk alarm di masa mendatang. Pilih **Continue (Lanjutkan)**.
**catatan**
Jika Anda menggunakan **Create New Email Topic (Buat Topik Email Baru)** untuk membuat topik Amazon SNS baru, alamat email harus diverifikasi sebelum menerima notifikasi. Email hanya dikirim saat alarm memasuki status alarm. Jika perubahan status alarm ini terjadi sebelum alamat email diverifikasi, alamat tidak akan menerima notifikasi.
1. Pada proses ini, wizard **Create Alarm (Buat Alarm)** memberi Anda kesempatan untuk meninjau alarm yang akan Anda buat. Jika Anda perlu melakukan perubahan, Anda dapat menggunakan tautan **Edit** di sebelah kanan. Setelah Anda puas, pilih **Create Alarm (Buat Alarm)**.
Untuk informasi selengkapnya tentang penggunaan CloudWatch dan alarm, lihat [CloudWatchDokumentasi](https://aws.amazon.com/documentation/cloudwatch).
## Metrik Amazon SNS
Amazon SNS mengirimkan metrik berikut ke. CloudWatch
| Namespace | Metrik | Deskripsi |
| --- | --- | --- |
| AWS/SNS | NumberOfMessagesPublished | Jumlah pesan yang dipublikasikan ke topik Amazon SNS Anda. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah |
| AWS/SNS | NumberOfNotificationsDelivered | Jumlah pesan berhasil dikirim dari topik Amazon SNS Anda ke endpoint berlangganan. Agar upaya pengiriman berhasil, langganan dari endpoint harus menerima pesan tersebut. Langganan menerima pesan jika.) Tidak memiliki kebijakan filter atau b.) kebijakan filter mencakup atribut yang cocok dengan yang ditetapkan ke pesan. Jika langganan menolak pesan, upaya pengiriman tidak dihitung untuk metrik ini. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah |
| AWS/SNS | NumberOfNotificationsFailed | Jumlah pesan yang gagal dikirim oleh Amazon SNS. Untuk Amazon SQS, email, SMS, atau endpoint push seluler, metrik bertambah 1 saat Amazon SNS berhenti mencoba pengiriman pesan. Untuk endpoint HTTP atau HTTPS, metrik mencakup setiap upaya pengiriman yang gagal, termasuk percobaan ulang yang mengikuti upaya awal. Untuk semua endpoint lainnya, jumlah bertambah 1 ketika pesan gagal terkrim (terlepas dari jumlah upaya). Metrik ini tidak menyertakan pesan yang ditolak oleh kebijakan filter langganan. Anda dapat mengontrol jumlah pengulangan untuk endpoint HTTP. Untuk informasi selengkapnya, lihat [Pengiriman ulang pesan Amazon SNS](sns-message-delivery-retries.md). **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut | Jumlah pesan yang ditolak oleh kebijakan filter langganan. Kebijakan filter menolak pesan bila atribut pesan tidak cocok dengan atribut kebijakan. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageAttributes | Jumlah pesan yang ditolak oleh kebijakan filter langganan untuk pemfilteran berbasis atribut. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut-MessageBody | Jumlah pesan yang ditolak oleh kebijakan filter langganan untuk pemfilteran berbasis muatan. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidAttributes | Jumlah pesan yang ditolak oleh kebijakan filter langganan karena atribut pesan tidak valid — misalnya, karena atribut JSON salah diformat. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut-NoMessageAttributes | Jumlah pesan yang ditolak oleh kebijakan filter langganan karena pesan tidak memiliki atribut. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFilteredOut-InvalidMessageBody | Jumlah pesan yang ditolak oleh kebijakan filter langganan karena badan pesan tidak valid untuk pemfilteran — misalnya, badan pesan JSON tidak valid. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsRedrivenToDlq | Jumlah pesan yang telah dipindahkan ke antrean surat mati. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | NumberOfNotificationsFailedToRedriveToDlq | Jumlah pesan yang tidak dapat dipindahkan ke antrean surat mati. **Unit:** Hitung **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Jumlah, Rata-rata |
| AWS/SNS | PublishSize | Ukuran pesan yang diterbitkan. **Unit:** Bytes **Dimensi yang valid:** Aplikasi PhoneNumber, Platform, dan TopicName **Statistik yang valid:** Minimum, Maksimum, Rata-rata dan Hitungan |
| AWS/SNS | SMSMonthToDateSpentUSD | Biaya yang telah Anda dapatkan sejak awal bulan kalender saat ini untuk mengirim pesan SMS. Anda dapat mengatur alarm untuk metrik ini untuk mengetahui kapan month-to-date tagihan Anda mendekati kuota belanja SMS bulanan untuk akun Anda. Ketika Amazon SNS menentukan bahwa mengirim pesan SMS akan dikenakan biaya yang melebihi kuota ini, Amazon SNS akan berhenti menerbitkan pesan SMS dalam beberapa menit. Selengkapnya tentang pengaturan kuota belanja SMS bulanan Anda, atau untuk informasi tentang permintaan kenaikan kuota belanja dengan AWS, lihat [Mengatur preferensi pesan SMS di Amazon SNS](sms_preferences.md). **Satuan:** USD **Dimensi yang valid:** Tidak ada **Statistik yang valid:** Jumlah |
| AWS/SNS | SMSSuccessRate | Tingkat keberhasilan pengiriman pesan SMS. **Unit:** Hitung **Dimensi yang valid:** PhoneNumber **Statistik yang valid:** Jumlah, Rata-rata, Sampel Data |
## Dimensi untuk metrik Amazon SNS
Amazon Simple Notification Service mengirimkan dimensi berikut ke CloudWatch.
| Dimensi | Deskripsi |
| --- | --- |
| Application | Filter pada objek aplikasi, yang mewakili aplikasi dan perangkat yang terdaftar di salah satu layanan pemberitahuan push yang didukung, seperti APNs dan FCM. |
| Application,Platform | Filter pada objek aplikasi dan platform, di mana objek platform adalah untuk layanan pemberitahuan push yang didukung, seperti APNs dan FCM. |
| Country | Filter di negara tujuan atau wilayah pesan SMS. Negara atau wilayah diwakili oleh kode ISO 3166-1 alpha-2. |
| PhoneNumber | Filter pada nomor telepon saat Anda mempublikasikan SMS langsung ke nomor telepon (tanpa topik). |
| Platform | Filter pada objek platform untuk layanan pemberitahuan push, seperti APNs dan FCM. |
| TopicName | Filter pada nama topik Amazon SNS. |
| SMSType | Filter pada jenis pesan SMS. Bisa *promotional (promosi)* atau *transactional (transaksional)*. |
## Metrik penggunaan Amazon SNS
Amazon Simple Notification Service mengirimkan metrik penggunaan berikut ke CloudWatch.
| Namespace | Layanan | Metrik | Sumber daya | Tipe | Deskripsi |
| --- | --- | --- | --- | --- | --- |
| AWS/Penggunaan | SNS | ResourceCount | NumberOfMessagesPublishedPerAccount | Sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Penggunaan | SNS | ResourceCount | ApproximateNumberOfTopics | Sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Penggunaan | SNS | ResourceCount | ApproximateNumberOfFilterPolicies | Sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Penggunaan | SNS | ResourceCount | ApproximateNumberOfPendingSubscriptions | Sumber daya | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |
| AWS/Penggunaan | SNS | CallCount | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) | API | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/sns/latest/dg/sns-monitoring-using-cloudwatch.html) |