Amazon Simple Notification Service (SNS) überwachen

Online bearbeiten

Überwachen Sie Ihren Amazon SNS-Dienst mit „ Instana “, um einen umfassenden Überblick und Echtzeit-Einblicke in die Leistung Ihres Dienstes zu erhalten.

Weitere Informationen finden Sie unter Amazon SNS.

Um Amazon SNS zu überwachen, installieren Sie den „ Instana “-Agenten in Ihrer Umgebung. Der Agent installiert und aktiviert den Amazon-SNS-Sensor automatisch und erfasst damit die entsprechenden Metriken. Sie können diese Kennzahlen in der Benutzeroberfläche von „ Instana “ einsehen.

Weitere Informationen zu den anderen unterstützten Diensten von „ AWS “ finden Sie in der Dokumentation unter AWS.

Erforderliche IAM-Berechtigungen hinzufügen

Online bearbeiten

Fügen Sie dem Host, auf dem der „ Instana “-Agent ausgeführt wird, die folgenden IAM-Rollenberechtigungen hinzu, damit der „ Instana “-Agent Ihre „ AWS SNS “-Instanzen erkennt und überwacht:

cloudwatch:GetMetricStatistics
cloudwatch:GetMetricData
sns:ListTopics
sns:ListTagsForResource
sns:GetTopicAttributes

Konfigurieren des Amazon SNS-Sensors

Online bearbeiten

Nach der Installation des „ Instana “-Agenten ist der Amazon SNS-Sensor standardmäßig aktiviert.

Deaktivieren des Amazon SNS-Sensors

Online bearbeiten

Verwenden Sie die folgende Konfiguration, um die Überwachung von Amazon SNS-Instanzen zu inaktivieren:

com.instana.plugin.aws.sns:
  enabled: false

Festlegen des Intervalls für die Erfassung von Kennzahlen

Online bearbeiten

Standardmäßig werden Metriken für SNS alle 5 Minuten extrahiert. Um diese Häufigkeit zu ändern, bearbeiten Sie den Wert cloudwatch_period in der Agentenkonfigurationsdatei <agent_install_dir>/etc/instana/configuration.yml wie im folgenden Beispiel gezeigt:

com.instana.plugin.aws.sns:
  cloudwatch_period: 300

Proxy-Einstellungen vornehmen

Online bearbeiten

Um den Amazon SNS-Sensor für die Verwendung der Proxy-Konfiguration zu konfigurieren, fügen Sie die folgenden Agentenkonfigurationseinstellungen hinzu:

com.instana.plugin.aws.sns:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

Konfigurieren der Überwachung von Amazon SNS über mehrere „ AWS “-Konten hinweg

Online bearbeiten

Sie können die Überwachung mehrerer AWS -Konten mit einem AWS -Agenten in derselben Region einrichten. Weitere Informationen finden Sie unter Mehrere AWS -Konten überwachen.

Um den „ Instana “-Agenten so zu konfigurieren, dass er Amazon SNS über mehrere „ AWS “-Konten hinweg überwacht, wenden Sie eine der folgenden Vorgehensweisen an:

Ansatz mit benannten AWS-Profilen

Online bearbeiten

Verwenden Sie die folgende Konfiguration, um die Profile zu überschreiben, die für die Überwachung von Amazon SNS verwendet werden:

com.instana.plugin.aws.sns:
  profile_names:
    - 'profile2'
    - 'profile3'

Hinweis: Durch die Definition von Profilen auf Dienstebene wird die globale Profilkonfiguration unter „ AWS “ überschrieben.

AWS Security Token Service (STS)-Ansatz

Online bearbeiten

Verwenden Sie die folgende Konfiguration, um die IAM-Rollen zu überschreiben, die zum Überwachen von Amazon SNS verwendet werden:

com.instana.plugin.aws.sns:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'

Hinweis: Die Definition von IAM-Rollen auf Dienstebene hat Vorrang vor der globalen Konfiguration der IAM-Rollen unter AWS.

Filtern von Amazon SNS-Diensten durch Definieren von Tags

Online bearbeiten

Hinweis: Wenn Sie alle Amazon SNS-Dienste ohne Filterung überwachen möchten, sollten Sie keine Konfiguration festlegen.

Instana überwacht standardmäßig alle Amazon SNS-Dienste. Wenn Sie jedoch nicht alle Services überwachen möchten, definieren Sie in der Datei configuration.yaml des Agenten, welche Tags in die Erkennung ein-oder ausgeschlossen werden sollen. Wenn Sie einen Tag oder eine Ressourcengruppe in beiden Listen (Einschluss und Ausschluss) definieren, hat die Ausschlussliste Vorrang.

Wenn Sie mehrere Tags definieren möchten, trennen Sie sie durch Kommas. Definieren Sie Tags als Schlüssel/Wert-Paar, das durch einen Doppelpunkt (:) getrennt ist. Sie müssen nicht alle Werte definieren, um die Filterung zu aktivieren.

Um Services nach Tags in die Erkennung einzuschließen, aktualisieren Sie die C-Dateionfiguration.yaml wie im folgenden Beispiel gezeigt:

com.instana.plugin.aws.sns:
  include_tags: # Comma separated list of tags in key:value format (e.g. env:prod,env:staging)

Aktualisieren Sie die Datei configuration.yaml wie im folgenden Beispiel gezeigt, um Services nach Tags von der Erkennung auszuschließen:

com.instana.plugin.aws.sns:
  exclude_tags: # Comma separated list of tags in key:value format (e.g. env:dev,env:test)

Amazon SNS-Services ohne Tags werden standardmäßig überwacht, können jedoch ausgeschlossen werden, indem das Feld include_untagged wie im folgenden Beispiel auf false gesetzt wird:

com.instana.plugin.aws.sns:
  include_untagged: false # True value by default

Abfragefrequenz einstellen

Online bearbeiten

Mit der Konfigurationseigenschaft tagged-services-poll-rate können Sie angeben, wie oft Sensoren die Ressourcen mit Tags AWS abfragen. Standardmäßig 300 Sekunden.

Hinweis: Tags sind nur mit dem „ AWS “-Agenten verfügbar.

Um zu definieren, wie oft Sensoren die mit Tags versehenen Ressourcen abfragen, aktualisieren Sie die Datei configuration.yaml wie im folgenden Beispiel dargestellt:

com.instana.plugin.aws:
  tagged-services-poll-rate: 60 #default 300

Metriken anzeigen

Online bearbeiten

Gehen Sie wie folgt vor, um die Metriken anzuzeigen:

Klicken Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ auf „Infrastruktur “.
Klicken Sie auf einen angegebenen Host.

Sie können ein Host-Dashboard mit allen erfassten Metriken und überwachten Prozessen anzeigen. Metriken werden alle 5 Minuten extrahiert.

Verfolgte Konfiguration

Online bearbeiten

Die folgende Tabelle gibt einen Überblick über die Konfigurationsdaten, die der Sensor von Amazon-SNS-Instanzen erfasst:


SNS-Themendetails	Beschreibung
ARN	Der nicht qualifizierte Amazon Resource Name (ARN), der dem Thema zugewiesen ist.
Verfügbarkeitszone	Die Position der Instanz.
Themaname	Der Name des Themas.
Anzeigename	Der Name des benutzerdefinierten Themas.
Abonnements bestätigt	Die Anzahl der bestätigten Subskriptionen
Anzahl Wiederholungen	Die Anzahl der Wiederholungslimits für Benachrichtigungen.
Ziel für minimale Verzögerung	Die minimale Verzögerung für die Zielsubskription
Maximales Verzögerungsziel	Die maximale Verzögerung für die Zielsubskription

Metriken

Online bearbeiten

Die folgende Tabelle gibt einen Überblick über die Kennzahlen, die der Sensor von Amazon-SNS-Instanzen erfasst:


Topicmetriken	Beschreibung
NumberOfMessagesPublished	Die Anzahl der Nachrichten, die zu Ihren Amazon SNS-Themen veröffentlicht werden.
NumberOfNotificationsFailedToRedriveToDlq	Die Anzahl der Nachrichten, die nicht in eine Warteschlange für nicht zustellbare Mail verschoben wurden
NumberOfNotificationsDelivered	Die Anzahl der Nachrichten, die erfolgreich von Ihren Amazon SNS-Topics an subskribierende Endpunkte zugestellt wurden.
PublishSize	Die Größe der veröffentlichten Nachrichten.
NumberOfNotificationsRedrivenToDlq	Die Anzahl der Nachrichten, die in eine Warteschlange für nicht zustellbare Mail verschoben wurden
NumberOfNotificationsFailed	Die Anzahl der Nachrichten, die Amazon SNS nicht zustellen konnte.
NumberOfNotificationsFilteredOut	Die Anzahl der Nachrichten, die von Subskriptionsfilterrichtlinien zurückgewiesen werden. Eine Filterrichtlinie lehnt eine Nachricht ab, wenn die Attribute der Nachricht nicht mit den Attributen der Richtlinie übereinstimmen.