Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Amazon SNS und AWS X-Ray
AWS X-Ray Mit Amazon Simple Notification Service (Amazon SNS) können Sie Anfragen verfolgen und analysieren, während sie über Ihre SNS-Themen an Ihre SNS-supported Abonnementdienste weitergeleitet werden. Verwenden Sie das X-Ray Tracing mit Amazon SNS, um die Latenzen in Ihren Nachrichten und deren Back-End-Diensten zu analysieren, z. B. wie lange eine Anfrage in einem Thema verweilt und wie lange es dauert, bis die Nachricht an die einzelnen Abonnements des Themas zugestellt wird. Amazon SNS unterstützt X-Ray Tracing sowohl für Standard- als auch für FIFO-Themen.
Wenn Sie über einen Service, der bereits mit Tools ausgestattet ist, zu einem Amazon SNS-Thema veröffentlichen X-Ray, leitet Amazon SNS den Trace-Kontext vom Herausgeber an die Abonnenten weiter. Darüber hinaus können Sie das aktive Tracing aktivieren, um Segmentdaten über Ihre Amazon SNS-Abonnements an Nachrichten zu X-Ray senden, die von einem instrumentierten SNS-Client veröffentlicht wurden. Aktivieren Sie das aktive Tracing für ein Amazon SNS-Thema mithilfe der Amazon SNS-Konsole oder mithilfe der Amazon SNS-API oder CLI. Weitere Informationen zur Instrumentierung Ihrer SNS-Clients finden Sie unter Instrumentieren Ihrer Anwendung.
Konfigurieren Sie das aktive Amazon SNS-Tracing
Sie können die Amazon SNS-Konsole oder die AWS CLI oder das SDK verwenden, um die aktive Amazon SNS-Ablaufverfolgung zu konfigurieren.
Wenn Sie die Amazon SNS-Konsole verwenden, versucht Amazon SNS, die erforderlichen Berechtigungen für SNS zum Aufrufen zu erstellen. X-Ray Der Versuch kann abgelehnt werden, wenn Sie nicht über ausreichende Berechtigungen zum Ändern X-Ray der Ressourcenrichtlinien verfügen. Weitere Informationen zu diesen Berechtigungen finden Sie unter Identitäts- und Zugriffsmanagement in Amazon SNS und Beispiele für Amazon SNS-Zugriffskontrolle im Amazon Simple Notification Service Developer Guide. Weitere Informationen zum Aktivieren der aktiven Protokollierung mithilfe der Amazon SNS-Konsole finden Sie unter Aktivieren von aktivem Tracing in einem Amazon SNS-Thema im Amazon Simple Notification Service Developer Guide.
Wenn Sie die AWS CLI oder das SDK verwenden, um das aktive Tracing zu aktivieren, müssen Sie die Berechtigungen mithilfe ressourcenbasierter Richtlinien manuell konfigurieren. Verwenden Sie diese PutResourcePolicy Option, um X-Ray mit der erforderlichen ressourcenbasierten Richtlinie zu konfigurieren, an die Amazon SNS Traces senden kann. X-Ray
Beispiel Beispiel für eine X-Ray ressourcenbasierte Richtlinie für das aktive Tracing von Amazon SNS
Dieses Beispiel-Richtliniendokument spezifiziert die Berechtigungen, die Amazon SNS benötigt, um Trace-Daten zu senden an: X-Ray
{ Version: "2012-10-17", Statement: [ { Sid: "SNSAccess", Effect: Allow, Principal: { Service: "sns.amazonaws.com", }, Action: [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], Resource: "*", Condition: { StringEquals: { "aws:SourceAccount": "account-id" }, StringLike: { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }
Verwenden Sie die CLI, um eine ressourcenbasierte Richtlinie zu erstellen, die Amazon SNS Berechtigungen zum Senden von Trace-Daten an folgende Adressen erteilt: X-Ray
aws xray put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "SNSAccess", "Effect": "Allow", "Principal": { "Service": "sns.amazonaws.com" }, "Action": [ "xray:PutTraceSegments", "xray:GetSamplingRules", "xray:GetSamplingTargets" ], "Resource": "*", "Condition": { "StringEquals": { "aws:SourceAccount": "account-id" }, "StringLike": { "aws:SourceArn": "arn:partition:sns:region:account-id:topic-name" } } } ] }'
Um diese Beispiele zu verwenden, ersetzen Sie partitionregiontopic-nameaccount-id*
Sehen Sie sich die Amazon SNS-Ablisher- und Abonnenten-Traces in der Konsole an X-Ray
Verwenden Sie die X-Ray Konsole, um eine Trace-Map und Trace-Details anzuzeigen, die eine zusammenhängende Ansicht der Amazon SNS-Publisher und -Abonnenten anzeigen. Wenn das aktive Amazon SNS-Tracing für ein Thema aktiviert ist, zeigen die X-Ray Trace-Map und die Trace-Detailkarte verbundene Knoten für Amazon SNS-Publisher, das Amazon SNS-Thema und Downstream-Abonnenten an:
Nachdem Sie einen Trace ausgewählt haben, der sich über einen Amazon SNS-Publisher und -Abonnenten erstreckt, werden auf der Seite mit den X-Ray Trace-Details eine Karte mit den Trace-Details und eine Segmentzeitleiste angezeigt.
Beispiel Beispiel für einen Zeitplan mit Amazon SNS-Herausgeber und -Abonnenten
Dieses Beispiel zeigt eine Zeitleiste mit einem Amazon SNS-Herausgeber, der eine Nachricht an ein Amazon SNS-Thema sendet, die von einem Amazon SQS-Abonnenten bearbeitet wird.
Die obige Beispielzeitleiste enthält Details zum Amazon SNS-Nachrichtenfluss:
Das SNS-Segment stellt die Round-Trip-Dauer des
PublishAPI-Aufrufs vom Client dar.Das MyTopic-Segment stellt die Latenz der Amazon SNS-Antwort auf die Veröffentlichungsanfrage dar.
Das SQS-Subsegment stellt die Round-Trip-Zeit dar, die Amazon SNS benötigt, um die Nachricht in einer Amazon SQS-Warteschlange zu veröffentlichen.
Die Zeit zwischen dem MyTopic-Segment und dem SQS-Subsegment stellt die Zeit dar, die die Nachricht im Amazon SNS-System verbringt.
Beispiel Beispiel für einen Zeitplan mit gebündelten Amazon SNS-Nachrichten
Wenn mehrere Amazon SNS-Nachrichten in einem einzigen Trace gebündelt werden, werden in der Segmentzeitleiste Segmente angezeigt, die jede verarbeitete Nachricht repräsentieren.
