Amazon MQ überwachen

Online bearbeiten

Der Amazon- MQ -Sensor wird automatisch bereitgestellt und installiert, nachdem Sie den Instana -Agenten installiert haben.

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

Sensor (Datenerfassung)

Online bearbeiten

Die Erfassung von Metriken wird für ActiveMQ -und RabbitMQ -Enginetypen unterstützt.

Verfolgte Konfiguration

Online bearbeiten

Die folgenden Brokerdetails sind unabhängig von den verwendeten Engines verfügbar.


Brokerdetails
Name
ARN
Status
Erstellungszeitpunkt
Enginetyp
Engineversion
Instanztyp
Implementierung
Öffentliche Zugänglichkeit
AWS-Region

Metriken

Online bearbeiten

ActiveMQ Kennzahlen

Online bearbeiten


Brokermessdaten	Beschreibung
CpuCreditBalance	Die Anzahl der verdienten CPU-Gutschriften, die eine Instanz seit dem Start bzw. Start erworben hat (einschließlich der Anzahl der Startgutschriften).
CpuUtilization	Der Prozentsatz der zugeordneten EC2-Recheneinheiten, die der Broker derzeit verwendet.
CurrentConnectionsCount	Die aktuelle Anzahl der aktiven Verbindungen auf dem aktuellen Broker.
JournalFilesForFastRecovery	Die Anzahl der Journaldateien, die nach einem ordnungsgemäßen Herunterfahren wiedergegeben werden.
JournalFilesForFullRecovery	Die Anzahl der Journaldateien, die nach einem nicht ordnungsgemäßen Herunterfahren erneut wiedergegeben werden.
HeapUsage	Der Prozentsatz des ActiveMQ-JVM-Speicherlimits, den der Broker momentan verwendet.
NetworkIn	Das Volumen des eingehenden Datenverkehrs für den Broker.
NetworkOut	Das Volumen des abgehenden Datenverkehrs für den Broker.
OpenTransactionsCount	Die Gesamtzahl der laufenden Transaktionen.
StorePercentUsage	Der vom Storage-Limit verwendete Prozentsatz. Wenn der Wert 100 erreicht, weist der Broker Nachrichten zurück.
TotalConsumerCount	Die Anzahl der Nachrichtenkonsumenten, die Ziele im aktuellen Broker subskribiert haben.
TotalMessageCount	Die Anzahl der Nachrichten, die auf dem Broker gespeichert sind.
TotalProducerCount	Die Anzahl der Nachrichtenproduzenten, die für Ziele auf dem aktuellen Broker aktiv sind.


Zielmesswerte	Beschreibung
ConsumerCount	Die Anzahl der Konsumenten, die das Ziel subskribiert haben.
EnqueueCount	Die Anzahl der Nachrichten, die an das Ziel gesendet wurden
EnqueueTime	Die Zeit, die der Broker benötigt, um eine Nachricht vom Producer anzunehmen und an das Ziel zu senden.
ExpiredCount	Die Anzahl der Nachrichten, die nicht zugestellt werden konnten, weil sie abgelaufen sind.
DispatchCount	Die Anzahl der Nachrichten, die an Konsumenten gesendet werden.
DequeueCount	Die Anzahl der Nachrichten, die von den Konsumenten bestätigt werden.
MemoryUsage	Der Prozentsatz des Speicherlimits, den das Ziel momentan verwendet.
ProducerCount	Die Anzahl der Produzenten für das Ziel.
QueueSize	Die Anzahl der Nachrichten in der Warteschlange. (Dieser Messwert gilt nur für Warteschlangen.)

RabbitMQ Kennzahlen

Online bearbeiten


Brokermessdaten	Beschreibung
ConnectionCount	Die Gesamtzahl der Verbindungen, die auf dem Broker hergestellt wurden.
ConsumerCount	Die Gesamtzahl der Konsumenten, die mit dem Broker verbunden sind.
MessageCount	Die Gesamtzahl der Nachrichten in den Warteschlangen.
MessagesRate	Die Gesamtzahl der Nachrichten pro Sekunde in den Warteschlangen.
MessageReadyCount	Die Gesamtzahl der bereiten Nachrichten in den Warteschlangen.
MessagesReadyRate	Die Anzahl der Nachrichten pro Sekunde, die für die Zustellung an Clients bereit sind.
MessageUnacknowledgedCount	Die Gesamtzahl der nicht bestätigten Nachrichten in den Warteschlangen.
MessageUnacknowledgedRate	Die Anzahl der Nachrichten pro Sekunde, die an Clients zugestellt, aber noch nicht bestätigt wurden.
PublishRate	Die Rate, mit der Nachrichten im Broker veröffentlicht werden.
ConfirmRate	Die Rate, mit der der RabbitMQ -Server veröffentlichte Nachrichten bestätigt.
AckRate	Die Rate, mit der Nachrichten von Konsumenten bestätigt werden.


Knotenmesswerte	Beschreibung
SystemCpuUtilization	Der Prozentsatz der zugeordneten Amazon EC2 -Recheneinheiten, die momentan vom Broker verwendet werden.
MemoryLimit	Der RAM-Grenzwert für einen RabbitMQ .
MemoryUsed	Das von einem RabbitMQ -Knoten verwendete RAM-Volumen.
DiskFreeLimit	Der Plattengrenzwert für einen RabbitMQ -Knoten.
DiskFree	Das Gesamtvolumen des freien Plattenspeicherplatzes, der auf dem Knoten RabbitMQ verfügbar ist.
FileDescriptorsUsed	Die Anzahl der verwendeten Dateideskriptoren.

Wenn der Bereitstellungstyp des „ RabbitMQ “-Brokers „CLUSTER_MULTI_AZ“ lautet, kann es in seltenen Fällen vorkommen, dass im Dashboard „ RabbitMQ “ mehr als drei Knoten aufgeführt sind. Dies kann vorkommen, wenn der Broker CLUSTER_MULTI_AZ gelöscht, mit demselben Namen erstellt und dann vom Agenten innerhalb weniger Stunden erkannt wird. Dieses Problem ist darauf zurückzuführen, dass der „ CloudWatch “ Metriken auch nach dem Löschen der Ressource beibehält. Um das Problem zu beheben, können Sie den Agenten neu starten. {: note}


Warteschlangenmetriken	Beschreibung
ConsumerCount	Die Anzahl der Konsumenten, die die Warteschlange abonniert haben.
MessageReadyCount	Die Anzahl der Nachrichten, die momentan für die Zustellung verfügbar sind.
MessageUnacknowledgedCount	Die Anzahl der Nachrichten, für die der Server auf Bestätigung wartet.
MessageCount	Die Gesamtzahl der „ MessageReadyCount “ und „ MessageUnacknowledgedCount “ (auch als Warteschlangentiefe bezeichnet).

Erforderliche Berechtigungen

Online bearbeiten

cloudwatch:GetMetricData
cloudwatch:GetMetricStatistics
mq:ListBrokers
mq:DescribeBroker

Konfiguration

Online bearbeiten

Metriken für Amazon MQ werden alle 5 Minuten extrahiert, was über die Agentenkonfiguration geändert werden kann (<agent_install_dir>/etc/instana/configuration.yaml):

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

Verwenden Sie die folgende Konfiguration, um die Überwachung von MQ instanzen zu inaktivieren:

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

ActiveMQ Konfiguration

Online bearbeiten

Um die detaillierte Metriküberwachung der ActiveMQ -Broker zu aktivieren, müssen Sie den Hostagenten über die Warteschlangen oder Themen informieren, die Sie für jeden Broker überwachen möchten. Sie können sie wie folgt in der Agentenkonfigurationsdatei <agent_install_dir>/etc/instana/configuration.yaml konfigurieren:

com.instana.plugin.aws.mq:
  PLACEHOLDER_ACTIVE_MQ_BROKER_NAME: # replace PLACEHOLDER_ACTIVE_MQ_BROKER_NAME with your ActiveMQ broker name
    queues: # max 165 queues
      - 'queue1'
      - 'queue2'
    topics: # max 165 topics
      - 'topic1'

RabbitMQ Konfiguration

Online bearbeiten

Um die detaillierte Metriküberwachung der RabbitMQ -Broker zu aktivieren, müssen Sie den Hostagenten über die Warteschlangen informieren, die Sie für jeden Broker überwachen möchten (bis zu 700 Warteschlangen). Sie können sie wie folgt in der Agentenkonfigurationsdatei <agent_install_dir>/etc/instana/configuration.yaml konfigurieren:

com.instana.plugin.aws.mq:
  PLACEHOLDER_RABBIT_MQ_BROKER_NAME: # replace PLACEHOLDER_RABBIT_MQ_BROKER_NAME with your RabbitMQ broker name
    queuesRegex: '.*' # Regex pattern used for matching monitored queues
    monitorQueues:
    - queue: 'queue1' # name of the queue
      vhost: '/' # name of the vhost, default is '/'
    - queue: 'queue2' # name of the queue
      vhost: '/' # name of the vhost, default is '/'

Proxy-Konfiguration

Online bearbeiten

Um den spezifischen AWS Sensor so zu konfigurieren, dass er die Proxy-Konfiguration verwendet, fügen Sie die folgenden Konfigurationseinstellungen für den Agenten hinzu:

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

Informationen zum Einrichten der Überwachung mehrerer AWS -Konten mit einem AWS -Agenten in derselben Region finden Sie in der Dokumentation zur Überwachung mehrerer AWS -Konten .

Ansatz mit benannten AWS-Profilen

Online bearbeiten

Verwenden Sie die folgende Konfiguration, um die Profile zu überschreiben, die zum Überwachen von MQverwendet werden:

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

Hinweis: Durch die Definition von Profilen auf Dienstebene wird die globale Konfiguration der „ AWS “-Profile überschrieben.

AWS-STS-Ansatz

Online bearbeiten

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

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

Filterung

Online bearbeiten

Es können mehrere Tags getrennt durch Kommata definiert werden. Tags werden als Schlüssel/Wert-Paar bereitgestellt, die durch Folgendes getrennt sind: Zur Vereinfachung der Konfiguration können Sie definieren, welche Tags in die Erkennung eingeschlossen oder von der Erkennung ausgeschlossen werden sollen. Falls Sie Tags in beiden Listen (Ein- und Ausschlussliste) definieren möchten, hat die Ausschlussliste die höhere Priorität. Wenn keine Filterservices erforderlich sind, sollte die Konfiguration nicht definiert werden. Es ist nicht obligatorisch, alle Werte zu definieren, um die Filterung zu aktivieren.

Benutzer können angeben, wie oft Sensoren die mit AWS gekennzeichneten Ressourcen abfragen, die die Konfigurationseigenschaft tagged-services-poll-rate verwenden (Standardwert 300 Sekunden).

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

Verwenden Sie die folgende Konfiguration, um zu definieren, wie oft Sensoren die mit Tags versehenen Ressourcen abfragen:

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

Verwenden Sie die folgende Konfiguration, um Services nach Tags in die Erkennung einzuschließen:

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

Verwenden Sie die folgende Konfiguration, um Services nach Tags von der Erkennung auszuschließen:

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

AWS -Services ohne Tags werden standardmäßig überwacht, können jedoch ausgeschlossen werden, indem das Feld include_untagged auf falsegesetzt wird:

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

Instana-Agenten-Tags

Online bearbeiten

Bitte beachten Sie, dass Tags nur mit dem „ AWS “-Agent verfügbar sind. Weitere Informationen zur Verwendung von Tags finden Sie hier.