Überwachung von Amazon DocumentDB

Online bearbeiten

Instana überwacht Ihre Amazon- DocumentDB -Umgebung und bietet Ihnen mithilfe des Amazon- DocumentDB -Sensors einen Überblick über Ihre Umgebung.

Nach der Installation des „ Instana “-Agenten wird der „Amazon DocumentDB “-Sensor automatisch bereitgestellt und installiert. In der Benutzeroberfläche von „ Instana “ können Sie Kennzahlen einsehen, die sich auf Amazon- DocumentDB s beziehen.

Amazon DocumentDB unterstützt instanzbasierte Cluster und elastische Cluster. Der Amazon DocumentDB Sensor überwacht beide Arten von Clustern und Instanzen von instanzbasierten Clustern.

Bei instanzbasierten Clustern unterstützt der Amazon DocumentDB-Sensor die folgenden Engine-Versionen:

5.0.0 (Standard)
4.0.0
3.6.0

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

Erforderliche Berechtigungen

Online bearbeiten

Der Amazon DocumentDB-Sensor benötigt die folgende AWS Identitäts- und Zugriffsmanagement (IAM)-Erlaubnis, um Metriken von Amazon DocumentDB:

docdb-elastic:ListClusters
docdb-elastic:GetCluster
docdb-elastic:ListTagsForResource
rds:DescribeDBClusters
rds:DescribeDBInstances
rds:ListTagsForResource

Konfigurieren des Amazon- DocumentDB -Sensors

Online bearbeiten

Nach der Installation des Host-Agenten für „ Instana “ wird „ Instana “ standardmäßig automatisch so konfiguriert, dass es Amazon- DocumentDB -Cluster und -Instanzen überwacht.

Die Kennzahlen für das Amazon- DocumentDB -System werden minütlich erfasst. Sie können dies ändern, indem Sie die folgende Konfiguration in der Konfigurationsdatei des „ <agent_install_dir>/etc/instana/configuration.yamlInstana “-Agenten vornehmen:

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

Den Sensor deaktivieren

Online bearbeiten

Um die Überwachung von DocumentDB Clustern und Instanzen zu deaktivieren, verwenden Sie die folgende Konfiguration:

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

Proxy-Konfiguration aktivieren

Online bearbeiten

Um den Amazon DocumentDB-Sensor für die Verwendung der Proxy-Konfiguration zu aktivieren, fügen Sie die folgenden Agent-Konfigurationseinstellungen hinzu:

com.instana.plugin.aws.documentdb:
  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

Mehrere AWS-Accounts überwachen

Online bearbeiten

Um die Überwachung mehrerer AWS-Konten mit einem AWS-Agenten in derselben Region einzurichten, können Sie zwei Ansätze verwenden. Weitere Informationen finden Sie unter Überwachung mehrerer AWS-Konten.

Ansatz mit benannten AWS-Profilen

Online bearbeiten

Bei der Methode AWS benannte Profile können Sie das Profil definieren. Um die Profile zu überschreiben, die zur Überwachung von DocumentDB, verwendet werden, verwenden Sie die folgende Konfiguration in der Konfigurationsdatei des Agenten:

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

Hinweis: Wenn Sie Profile auf Dienstebene definieren, haben diese Profile Vorrang vor der Konfiguration der globalen „ AWS “-Profile.

AWS Security Token Service (STS)-Ansatz

Online bearbeiten

Um die IAM-Rollen außer Kraft zu setzen, die zur Überwachung von Amazon DocumentDB, verwendet werden, verwenden Sie die folgende Konfiguration in der Konfigurationsdatei des Agenten:

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

Hinweis: Wenn Sie IAM-Rollen auf Dienstebene definieren, haben diese Rollen Vorrang vor der Konfiguration globaler IAM-Rollen unter AWS.

Dienste nach Tags filtern

Online bearbeiten

Instana überwacht standardmäßig alle Amazon- DocumentDB -Dienste. Sie können festlegen, welche Dienste Sie überwachen möchten, indem Sie mehrere durch Komma getrennte Tags definieren. Sie müssen Tags als Schlüssel-Wert-Paar angeben, das durch einen Doppelpunkt (:) in der configuration.yaml-Datei getrennt ist. Um den Amazon- DocumentDB -Sensor einfach zu konfigurieren, können Sie die Tags festlegen, die bei der Erkennung berücksichtigt oder davon ausgeschlossen werden sollen. Wenn Tags in beiden Listen (include und exclude) definiert sind, hat die exclude-Liste höhere Priorität. Wenn keine Filterung auf Serviceebene erforderlich ist, müssen Sie die Konfiguration für „ DocumentDB “ nicht festlegen, da die Konfiguration bereits auf der Ebene „ AWS “ vorgenommen wird.

Mit der Konfigurationseigenschaft tagged-services-poll-rate können Sie das Intervall festlegen, in dem der Sensor die AWS-gekennzeichneten Ressourcen abfragt (Standardwert 60 Sekunden).

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

Um das Intervall festzulegen, in dem die Sensoren die AWS-gekennzeichneten Ressourcen abfragen, verwenden Sie die folgende Konfiguration:

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

Um Dienste nach Tags in die Erkennung einzubeziehen, aktualisieren Sie die folgende Konfiguration:

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

Um die Dienste nach Tags von der Erkennung auszuschließen, aktualisieren Sie die folgende Konfiguration:

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

AWS Dienste ohne Tags werden standardmäßig überwacht, aber Sie können sie ausschließen, indem Sie das Feld include_untagged auf false setzen, wie im folgenden Beispiel gezeigt:

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

Instana-Agenten-Tags

Online bearbeiten

Instana Agent-Tags sind nur beim „ AWS “-Agenten verfügbar. Weitere Informationen zur Verwendung der Agent-Tags finden Sie unter „Überwachung der Infrastruktur “.

Metriken anzeigen

Online bearbeiten

Führen Sie die folgenden Schritte aus, um die Metriken anzuzeigen:

Wählen Sie im Navigationsmenü der Benutzeroberfläche von „ Instana “ die Option „Infrastruktur“ aus.
Klicken Sie auf eine bestimmte überwachte Amazon DocumentDB-Instanz. Sie können das Dashboard der Amazon DocumentDB-Instanz mit allen gesammelten Metriken sehen.
Wählen Sie aus dem Breadcrumb oben links im Dashboard den Cluster aus, der der Instanz zugeordnet ist. Sie können die Metriken des Clusters sehen.

DocumentDB Instanzbasierter Cluster

Online bearbeiten

Die folgenden Abschnitte zeigen die Konfigurationsdaten und Metriken, die für die DocumentDB instanzbasierten Cluster gesammelt wurden.

Konfigurationsdaten

Online bearbeiten

In der folgenden Tabelle sind die Konfigurationsdaten aufgeführt, die für den Amazon DocumentDB instanzbasierten Cluster erfasst wurden:


DocumentDB Cluster-Details	Beschreibung
ARN	Der Amazon Resource Name (ARN) des DocumentDB instanzbasierten Clusters.
Clustertyp	Der Typ des Clusters (instanzbasiert oder elastisch).
Clustererstellungszeit	Der Zeitpunkt der Erstellung des Clusters.
Name	Der Name des Clusters.
Engineversion	Die Motorversion des Clusters. Der Wert ist 5.0.0 (Standard), 4.0.0, oder 3.6.0.

Metriken

Online bearbeiten

In der folgenden Tabelle sind die Metrikdetails für den Amazon DocumentDB-Cluster auf Instanzbasis aufgeführt:


Clustermetriken	Beschreibung
CPU-Auslastung	Der Prozentsatz der CPU-Auslastung. Bei Clustern stellt diese Metrik eine Aggregation der CPU-Nutzungswerte aller Instanzen dar.
DatabaseConnections	Die Anzahl der offenen Verbindungen in einem Cluster, die im Abstand von einer Minute erfasst werden.
Band ReadIOPs	Die durchschnittliche Anzahl der abgerechneten Lese-E/A-Vorgänge von einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet werden.
Lautstärke WriteIOPs	Die durchschnittliche Anzahl der abgerechneten Schreib-E/A-Vorgänge von einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet werden.
Gelöschte Dokumente	Anzahl der Dokumente, die in einem Zeitraum von einer Minute gelöscht werden.
Eingefügte Dokumente	Anzahl der Dokumente, die in einem Zeitraum von einer Minute eingefügt werden.
Aktualisierte Dokumente	Die Anzahl der Dokumente, die in einem Zeitraum von einer Minute aktualisiert werden.
Zurückgegebene Dokumente	Anzahl der Dokumente, die in einem Zeitraum von einer Minute zurückgegeben werden.
Lesedurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde von der Festplatte gelesen werden.
Schreibdurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde auf die Festplatte geschrieben werden.
Offene Transaktionen	Die Anzahl der Transaktionen, die in einer Minute in einem Cluster geöffnet sind.
Max. offene Transaktionen	Die maximale Anzahl von Transaktionen, die in einer Minute in einem Cluster geöffnet sind.
Offene Transaktionen verwendet	Offene Transaktionen ÷ Max. offene Transaktionen * 100.
Latenzzeit beim Lesen	Die durchschnittliche Zeit, die für Festplatten-Lese-E/A-Vorgänge benötigt wird.
Latenzzeit beim Schreiben	Die durchschnittliche Zeit (in Millisekunden), die pro E/A-Vorgang auf der Festplatte benötigt wird.
DBCluster- ReplicaLag -Maximum	Die maximale Verzögerung (in Millisekunden) zwischen der primären Instanz und jeder Amazon DocumentDB-Instanz im Cluster.
DBCluster- ReplicaLag -Minimum	Der Mindestabstand (in Millisekunden) zwischen der primären Instanz und jeder Replikat-Instanz im Cluster.
Gestartete Transaktionen	Die Anzahl der Transaktionen, die in einer Minute gestartet werden.
Abgebrochene Transaktionen	Die Anzahl der Transaktionen, die in einer Minute abgebrochen werden.
Festgeschriebene Transaktionen	Die Anzahl der Transaktionen, die in einer Minute durchgeführt werden.

DocumentDB Beispiel

Online bearbeiten

Der Amazon DocumentDB Sensor sammelt die folgenden Daten von der Amazon DocumentDB Instanz:

Konfigurationsdaten

Online bearbeiten


DocumentDB Instanzdetails	Beschreibung
Instanz-ARN	Der Amazon Resource Name (ARN) der DocumentDB-Instanz.
Cluster-ARN	Der ARN des DocumentDB-Clusters, der die Instanz enthält.
Instanzerstellungszeit	Der Zeitpunkt, an dem die Instanz erstellt und dem Cluster hinzugefügt wird.
Name	Der Name der DocumentDB-Instanz.
Aktions-Preisstufe	Die Rolle, die eine Instanz zum Zeitpunkt des Failover und der Hochverfügbarkeit innerhalb des Clusters spielt. Die Instanz mit dem niedrigsten Wert für die Beförderungsstufe (in der Regel 1) hat die höchste Priorität, um die neue Primärinstanz zu werden.

Metriken

Online bearbeiten

In der folgenden Tabelle sind die Metrikdetails für die Amazon DocumentDB-Instanz aufgeführt:


Knotenmetriken	Beschreibung
CPU-Auslastung	Der Prozentsatz der CPU-Auslastung.
Datenbankverbindungen	Die Anzahl der offenen Verbindungen auf einer Instanz, die im Abstand von einer Minute erfasst werden.
Max. Datenbank-Verbindungen	Die maximale Anzahl von Datenbankverbindungen, die innerhalb einer Minute auf einer Instanz geöffnet sind.
Verwendete Datenbank-Verbindungen	Datenbank-Verbindungen ÷ Datenbank-Verbindungen Max * 100.
ReadIOPs	Die durchschnittliche Anzahl der Festplattenlesevorgänge pro Sekunde.
WriteIOPs	Die durchschnittliche Anzahl der Schreibvorgänge auf der Festplatte pro Sekunde.
Gelöschte Dokumente	Die Anzahl der Dokumente, die in einer Minute gelöscht werden.
Eingefügte Dokumente	Die Anzahl der Dokumente, die in einer Minute eingefügt werden.
Aktualisierte Dokumente	Die Anzahl der Dokumente, die in einer Minute aktualisiert werden.
Zurückgegebene Dokumente	Die Anzahl der Dokumente, die in einer Minute zurückgegeben werden.
Lesedurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde von der Festplatte gelesen werden.
Schreibdurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde auf die Festplatte geschrieben werden.
Offene Transaktionen	Die Anzahl der Transaktionen, die in einer Minute in einer Instanz offen sind.
Max. offene Transaktionen	Die maximale Anzahl von Transaktionen, die innerhalb einer Minute auf einer Instanz geöffnet sind.
Offene Transaktionen verwendet	Offene Transaktionen ÷ Max. offene Transaktionen * 100.
Latenzzeit beim Lesen	Die durchschnittliche Zeit, die für Festplatten-Lese-E/A-Vorgänge benötigt wird.
Latenzzeit beim Schreiben	Die durchschnittliche Zeit (in Millisekunden), die pro E/A-Vorgang auf der Festplatte benötigt wird.
DBInstance ReplicaLag	Die Verzögerung bei der Replikation der Aktualisierungen von der primären Instanz auf eine Replikat-Instanz.
Gestartete Transaktionen	Die Anzahl der Transaktionen, die innerhalb einer Minute gestartet werden.
Abgebrochene Transaktionen	Die Anzahl der Transaktionen, die innerhalb einer Minute abgebrochen werden.
Festgeschriebene Transaktionen	Die Anzahl der Transaktionen, die innerhalb einer Minute durchgeführt werden.

DocumentDB elastischer Cluster

Online bearbeiten

Der Amazon DocumentDB-Sensor sammelt die folgenden Daten aus dem elastischen Amazon DocumentDB-Cluster:

Konfigurationsdaten

Online bearbeiten


DocumentDB Details des elastischen Clusters	Beschreibung
ARN	Der Amazon Resource Name (ARN) des DocumentDB elastic cluster.
Clustertyp	Der Typ des Clusters (instanzbasiert oder elastisch).
Clustererstellungszeit	Der Zeitpunkt der Erstellung des Clusters.
Name	Der Name des Clusters.

Metriken

Online bearbeiten


Clustermetriken	Beschreibung
CPU-Auslastung	Der Prozentsatz der CPU-Nutzung der primären Instanz.
DatabaseConnections	Die Anzahl der offenen Verbindungen in einem Cluster, die im Abstand von einer Minute erfasst werden.
Band ReadIOPs	Die durchschnittliche Anzahl der abgerechneten Lese-E/A-Vorgänge von einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet werden.
Lautstärke WriteIOPs	Die durchschnittliche Anzahl der abgerechneten Schreib-E/A-Vorgänge von einem Cluster-Volume, die in 5-Minuten-Intervallen gemeldet werden.
Gelöschte Dokumente	Die Anzahl der Dokumente, die in einer Minute gelöscht werden.
Eingefügte Dokumente	Die Anzahl der Dokumente, die in einer Minute eingefügt werden.
Aktualisierte Dokumente	Die Anzahl der Dokumente, die in einer Minute aktualisiert werden.
Zurückgegebene Dokumente	Die Anzahl der Dokumente, die in einer Minute zurückgegeben werden.
Lesedurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde von der Festplatte gelesen werden.
Schreibdurchsatz	Die durchschnittliche Anzahl der Bytes, die pro Sekunde auf die Festplatte geschrieben werden.