Updated the documentation.

Michael Khmelnitsky · Michael Khmelnitsky · commit 99da5fab0945 · 2019-07-24T18:07:11.000Z
diff --git a/doc_source/index.md b/doc_source/index.md
@@ -84,9 +84,10 @@ Amazon's trademarks and trade dress may not be used in
       + [Managing Phone Numbers and SMS Subscriptions](sms_manage.md)
       + [Reserving a Dedicated Short Code for SMS Messaging](sms_shortcodes.md)
       + [Supported Regions and Countries](sms_supported-countries.md)
-+ [Monitoring and Logging Amazon SNS Topics](sns-monitoring-logging.md)
++ [Monitoring, Logging, and Troubleshooting Amazon SNS Topics](sns-monitoring-logging-troubleshooting.md)
    + [Monitoring Amazon SNS Topics Using CloudWatch](sns-monitoring-using-cloudwatch.md)
    + [Logging Amazon Simple Notification Service API Calls Using AWS CloudTrail](sns-logging-using-cloudtrail.md)
+   + [Troubleshooting Amazon Simple Notification Service Topics Using AWS X-Ray](sns-troubleshooting-using-x-ray.md)
 + [Amazon SNS Security](sns-security.md)
    + [Authentication and Access Control for Amazon SNS](sns-authentication-and-access-control.md)
       + [Overview of Managing Access Permissions to Your Amazon Simple Notification Service Resource](sns-overview-of-managing-access.md)
diff --git a/doc_source/sms_preferences.md b/doc_source/sms_preferences.md
@@ -78,7 +78,7 @@ public static void setDefaultSmsAttributes(AmazonSNSClient snsClient) {
 }
 ```
 
-This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For **New limit value**, enter your desired monthly spend limit\. In the **Use Case Description** field, explain that you are requesting an SMS monthly spend limit increase\. Typically, AWS Support processes your case within 2 business days\. Depending on the spend limit you request and the complexity of your case, AWS Support might require an additional 3 \- 5 days to ensure that your request can be processed\.
+This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For **New limit value**, enter your desired monthly spend limit\. In the **Use Case Description** field, explain that you are requesting an SMS monthly spend limit increase\. The AWS Support team provides an initial response to your request within 24 hours\.
 
 To verify that the attributes were set correctly, the example prints the result of the `getSMSAttributes` method\. When you run this example, the attributes are displayed in the console output window of your IDE:
 
@@ -124,7 +124,7 @@ public static void SetDefaultSmsAttributes(AmazonSimpleNotificationServiceClient
 }
 ```
 
-This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For **New limit value**, enter your desired monthly spend limit\. In the **Use Case Description** field, explain that you are requesting an SMS monthly spend limit increase\. Typically, AWS Support processes your case within 2 business days\. Depending on the spend limit you request and the complexity of your case, AWS Support might require an additional 3 \- 5 days to ensure that your request can be processed\.
+This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For **New limit value**, enter your desired monthly spend limit\. In the **Use Case Description** field, explain that you are requesting an SMS monthly spend limit increase\. The AWS Support team provides an initial response to your request within 24 hours\.
 
 To verify that the attributes were set correctly, the example prints the result of the `GetSMSAttributes` method\. When you run this example, the attributes are displayed in the console output window of your IDE:
 
diff --git a/doc_source/sns-document-history.md b/doc_source/sns-document-history.md
@@ -5,6 +5,8 @@ The following table lists changes to the *Amazon Simple Notification Service Dev
 
 | Date | Documentation Update | 
 | --- | --- | 
+| August 8, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sns/latest/dg/sns-document-history.html)  | 
+| July 19, 2019 | Corrected the following statement throughout this guide: The AWS Support team provides an initial response to your request within 24 hours\. | 
 | July 16, 2019 | In addition to HTML, PDF, and Kindle, the Amazon Simple Notification Service Developer Guide is available on GitHub\. To leave feedback, choose the GitHub icon in the upper right\-hand corner\.![\[Image NOT FOUND\]](http://docs.aws.amazon.com/sns/latest/dg/images/amazon-sns-github.png) | 
 | July 11, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sns/latest/dg/sns-document-history.html)  | 
 | July 8, 2019 | Revised the information in the following sections: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sns/latest/dg/sns-document-history.html) | 
diff --git a/doc_source/sns-getting-started.md b/doc_source/sns-getting-started.md
@@ -158,5 +158,5 @@ Now that you've created a topic and a subscription and learned how to send messa
 + [Deploy and test the AWS Event Fork Pipelines sample application](sns-tutorial-deploy-test-fork-pipelines-sample-application.md)\.
 + [Learn about message filtering\.](sns-message-filtering.md)
 + Learn how to interact with Amazon SNS programmatically by exploring the [AWS Developer Center](https://aws.amazon.com/developer/)\.
-+ Learn about keeping an eye on costs and resources in the [Monitoring and Logging Amazon SNS Topics](sns-monitoring-logging.md) section\.
++ Learn about keeping an eye on costs and resources in the [Monitoring, Logging, and Troubleshooting Amazon SNS Topics](sns-monitoring-logging-troubleshooting.md) section\.
 + Learn about protecting your data and access to it in the [Security](sns-security.md) section\.
diff --git a/doc_source/sns-monitoring-logging-troubleshooting.md b/doc_source/sns-monitoring-logging-troubleshooting.md
@@ -0,0 +1,8 @@
+# Monitoring, Logging, and Troubleshooting Amazon SNS Topics<a name="sns-monitoring-logging-troubleshooting"></a>
+
+This section provides information about monitoring, logging, and troubleshooting Amazon SNS topics\.
+
+**Topics**
++ [Monitoring Amazon SNS Topics Using CloudWatch](sns-monitoring-using-cloudwatch.md)
++ [Logging Amazon Simple Notification Service API Calls Using AWS CloudTrail](sns-logging-using-cloudtrail.md)
++ [Troubleshooting Amazon Simple Notification Service Topics Using AWS X\-Ray](sns-troubleshooting-using-x-ray.md)
diff --git a/doc_source/sns-release-notes.md b/doc_source/sns-release-notes.md
@@ -5,6 +5,7 @@ The following table lists Amazon SNS feature releases and improvements\. For cha
 
 | Date | Feature Release | 
 | --- | --- | 
+| August 8, 2019 | You can troubleshoot messages passing through Amazon SNS topics using AWS X\-Ray\. For more information, see [Troubleshooting Amazon Simple Notification Service Topics Using AWS X\-Ray](sns-troubleshooting-using-x-ray.md) section\.  | 
 | July 5, 2019 |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/sns/latest/dg/sns-release-notes.html)  | 
 | May 16, 2019 | You can track your Amazon SNS resources \(for example, for cost allocation\) by adding, removing, and listing metadata tags for Amazon SNS topics using the AWS Management Console\. For more information, see [Amazon SNS Tags](sns-tags.md) and the [Tutorial: Listing, Adding, and Removing Tags for an Amazon SNS Topic](sns-tutorial-list-add-remove-tags-for-topic.md) and [Tutorial: Creating an Amazon SNS Topic](sns-tutorial-create-topic.md) tutorials\. Currently, tag\-based access control isn't available\.  | 
 | April 26, 2019 | You can track your Amazon SNS resources \(for example, for cost allocation\) by adding, removing, and listing metadata tags for Amazon SNS topics using the [TagResource](https://docs.aws.amazon.com/sns/latest/api/API_TagResource.html), [UntagResource](https://docs.aws.amazon.com/sns/latest/api/API_UntagResource.html), and [ListTagsForResource](https://docs.aws.amazon.com/sns/latest/api/API_ListTagsForResource.html) API actions or AWS SDKs\. For more information, see [Amazon SNS Tags](sns-tags.md) and the [Tutorial: Listing, Adding, and Removing Tags for an Amazon SNS Topic](sns-tutorial-list-add-remove-tags-for-topic.md) tutorial\. | 
diff --git a/doc_source/sns-subscription-filter-policies.md b/doc_source/sns-subscription-filter-policies.md
@@ -37,8 +37,8 @@ Because this message includes attributes, any topic subscription that includes a
    "Message": "message-body-with-transaction-details",
    "Timestamp": "2019-11-03T23:28:01.631Z",
    "SignatureVersion": "4",                                                                                                                                                                                                  ",
-   "Signature": signature,
-   "UnsubscribeURL": unsubscribe-url,
+   "Signature": "signature",
+   "UnsubscribeURL": "unsubscribe-url",
    "MessageAttributes": {
       "customer_interests": {
          "Type": "String.Array",
diff --git a/doc_source/sns-troubleshooting-using-x-ray.md b/doc_source/sns-troubleshooting-using-x-ray.md
@@ -0,0 +1,5 @@
+# Troubleshooting Amazon Simple Notification Service Topics Using AWS X\-Ray<a name="sns-troubleshooting-using-x-ray"></a>
+
+AWS X\-Ray collects data about requests that your application serves, and lets you view and filter data to identify potential issues and opportunities for optimization\. For any traced request to your application, you can see detailed information about the request, the response, and the calls that your application makes to downstream AWS resources, microservices, databases and HTTP web APIs\.
+
+You can use X\-Ray with Amazon SNS to trace and analyze the messages that travel through your application\. You can use the AWS Management Console to view the map of connections between Amazon SNS and other services that your application uses\. You can also use the console to view metrics such as average latency and failure rates\. For more information, see [Amazon SNS and AWS X\-Ray](https://docs.aws.amazon.com/xray/latest/devguide/xray-services-sns.html) in the *AWS X\-Ray Developer Guide*\.

Original file line number	Diff line number	Diff line change
`@@ -78,7 +78,7 @@ public static void setDefaultSmsAttributes(AmazonSNSClient snsClient) {`
`78`	`78`	`}`
`79`	`79`	```
`80`	`80`
`81`		-This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For New limit value, enter your desired monthly spend limit\. In the Use Case Description field, explain that you are requesting an SMS monthly spend limit increase\. Typically, AWS Support processes your case within 2 business days\. Depending on the spend limit you request and the complexity of your case, AWS Support might require an additional 3 \- 5 days to ensure that your request can be processed\.
	`81`	+This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For New limit value, enter your desired monthly spend limit\. In the Use Case Description field, explain that you are requesting an SMS monthly spend limit increase\. The AWS Support team provides an initial response to your request within 24 hours\.
`82`	`82`
`83`	`83`	To verify that the attributes were set correctly, the example prints the result of the `getSMSAttributes` method\. When you run this example, the attributes are displayed in the console output window of your IDE:
`84`	`84`
`@@ -124,7 +124,7 @@ public static void SetDefaultSmsAttributes(AmazonSimpleNotificationServiceClient`
`124`	`124`	`}`
`125`	`125`	```
`126`	`126`
`127`		-This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For New limit value, enter your desired monthly spend limit\. In the Use Case Description field, explain that you are requesting an SMS monthly spend limit increase\. Typically, AWS Support processes your case within 2 business days\. Depending on the spend limit you request and the complexity of your case, AWS Support might require an additional 3 \- 5 days to ensure that your request can be processed\.
	`127`	+This example sets the value for the `MonthlySpendLimit` attribute to 1\.00 USD\. By default, this is the maximum amount allowed by Amazon SNS\. If you want to raise the limit, submit an [SNS Text Messaging case](https://console.aws.amazon.com/support/home#/case/create?issueType=service-limit-increase&limitType=service-code-sns-text-messaging) with AWS Support\. For New limit value, enter your desired monthly spend limit\. In the Use Case Description field, explain that you are requesting an SMS monthly spend limit increase\. The AWS Support team provides an initial response to your request within 24 hours\.
`128`	`128`
`129`	`129`	To verify that the attributes were set correctly, the example prints the result of the `GetSMSAttributes` method\. When you run this example, the attributes are displayed in the console output window of your IDE:
`130`	`130`