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
Sie können Amazon Simple Notification Service (Amazon SNS) verwenden AWS X-Ray , um Anfragen zu verfolgen und zu analysieren, während sie über Ihre SNS-Themen an Ihre von SNS unterstützten Abonnementdienste weitergeleitet werden. Verwenden Sie X-Ray Tracing mit Amazon SNS, um Latenzen in Ihren Nachrichten und deren Backend-Services 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 für Standard- und FIFO-Themen.
Wenn Sie über einen Service, der bereits mit X-Ray ausgestattet ist, zu einem Amazon SNS-Thema veröffentlichen, gibt Amazon SNS den Trace-Kontext vom Herausgeber an die Abonnenten weiter. Darüber hinaus können Sie die aktive Ablaufverfolgung aktivieren, um Segmentdaten über Ihre Amazon SNS SNS-Abonnements an X-Ray für Nachrichten zu senden, die von einem instrumentierten SNS-Client veröffentlicht wurden. Aktivieren Sie die aktive Ablaufverfolgung für ein Amazon SNS SNS-Thema mithilfe der Amazon SNS SNS-Konsole oder mithilfe der Amazon SNS SNS-API oder CLI. Weitere Informationen zur Instrumentierung Ihrer SNS-Clients finden Sie unter Instrumentierung Ihrer Anwendung.
Active Tracing von Amazon SNS konfigurieren
Sie können die Amazon SNS-Konsole oder die AWS CLI oder das SDK verwenden, um Amazon SNS Active Tracing zu konfigurieren.
Wenn Sie die Amazon SNS-Konsole verwenden, versucht Amazon SNS, die erforderlichen Berechtigungen zu erstellen, damit SNS X-Ray aufrufen kann. Der Versuch kann abgelehnt werden, wenn Sie nicht über ausreichende Berechtigungen zum Ändern der X-Ray-Ressourcenrichtlinien verfügen. Weitere Informationen zu diesen Berechtigungen finden Sie unter Identitäts- und Zugriffsmanagement in Amazon SNS und Beispielfälle für Amazon SNS SNS-Zugriffskontrolle im Amazon Simple Notification Service Developer Guide. Weitere Informationen zum Aktivieren der aktiven Ablaufverfolgung mithilfe der Amazon SNS-Konsole finden Sie unter Aktivieren der aktiven Ablaufverfolgung auf einem Amazon SNS im Amazon Simple Notification Service Developer Guide.
Wenn Sie die AWS CLI oder das SDK verwenden, um Active Tracing zu aktivieren, müssen Sie die Berechtigungen mithilfe ressourcenbasierter Richtlinien manuell konfigurieren. Wird verwendet PutResourcePolicy, um X-Ray mit der erforderlichen ressourcenbasierten Richtlinie zu konfigurieren, damit Amazon SNS Traces an X-Ray senden kann.
Beispiel für eine ressourcenbasierte X-Ray-Richtlinie für Amazon SNS Active Tracing
Dieses Beispielrichtliniendokument spezifiziert die Berechtigungen, die Amazon SNS benötigt, um Trace-Daten an X-Ray zu senden:
{ 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 X-Ray erteilt:
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 Siepartitionregionaccount-idtopic-name*
Amazon SNS SNS-Publisher- und Abonnenten-Traces in der X-Ray-Konsole anzeigen
Verwenden Sie die X-Ray-Konsole, um eine Ablaufverfolgungsübersicht und Ablaufverfolgungsdetails anzuzeigen, die eine verbundene Ansicht der Amazon SNS SNS-Publisher und -Abonnenten anzeigen. Wenn das aktive Tracing von Amazon SNS für ein Thema aktiviert ist, werden in der X-Ray-Trace-Map und der Trace-Details-Map verbundene Knoten für Amazon SNS SNS-Publisher, das Amazon SNS SNS-Thema und nachgeschaltete Abonnenten angezeigt:
Nachdem Sie einen Trace ausgewählt haben, der sich über einen Amazon SNS SNS-Publisher und -Abonnenten erstreckt, werden auf der Seite mit den X-Ray-Trace-Details eine Ablaufverfolgungsdetailübersicht und eine Segment-Timeline angezeigt.
Beispiel-Timeline mit Amazon SNS SNS-Publisher und Abonnent
Dieses Beispiel zeigt eine Zeitleiste mit einem Amazon SNS SNS-Publisher, der eine Nachricht an ein Amazon SNS SNS-Thema sendet, die von einem Amazon SQS SQS-Abonnenten bearbeitet wird.
Die obige Beispielzeitleiste enthält Details zum Amazon SNS SNS-Nachrichtenfluss:
Das SNS-Segment stellt die Round-Turn-Dauer des
PublishAPI-Aufrufs vom Client dar.Das MyTopic-Segment stellt die Latenz der Amazon SNS 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 SQS-Warteschlange zu veröffentlichen.
Die Zeit zwischen dem MyTopic-Segment und dem SQS-Subsegment entspricht der Zeit, die die Nachricht im Amazon SNS SNS-System verbringt.
Beispiel für eine Zeitleiste mit gebündelten Amazon SNS-Nachrichten
Wenn mehrere Amazon SNS SNS-Nachrichten in einem einzigen Trace gebündelt werden, zeigt die Segment-Timeline Segmente an, die jede verarbeitete Nachricht repräsentieren.
