Konfigurieren der Überwachung von „ IBM MQ “ in virtuellen oder physischen Maschinen

Online bearbeiten

Konfigurieren Sie den Sensor „ IBM MQ “ basierend auf der Bereitstellung des Agenten „ Instana “ und des Queue-Managers in Ihrer Umgebung.

Bereitstellungsbasierte Konfigurationsszenarien

Online bearbeiten

Wenn der Host-Agent „ Instana “ und „ IBM MQ “ auf demselben Rechner ausgeführt werden, werden die folgenden Verbindungsmodi unterstützt: lokaler Bindungsmodus und Client-Bindungsmodus. Wenn der Host-Agent „ Instana “ und „ IBM MQ “ auf unterschiedlichen Rechnern ausgeführt werden, wird nur der Client-Bindungsmodus unterstützt.

Die folgende Tabelle zeigt die Konfigurationen für verschiedene Szenarien der Bereitstellung von Agent-Warteschlangen-Managern:

Agenten-Warteschlangen-Manager-Bereitstellung Benutzertyp Überwachungsverfahren Konfigurationsanforderung
Beide in derselben virtuellen oder physischen Maschine Privilegierter Benutzer Lokale Überwachung mit lokalem Bindungsmodus Keine Konfiguration erforderlich (automatische Überwachung)
Beide in derselben virtuellen oder physischen Maschine Nicht privilegierter Benutzer Lokale Überwachung mit Client-Bindungsmodus Manuelle Konfiguration erforderlich in configuration.yaml
Beide auf demselben „ Linux “-Rechner Benutzer ohne Sonderrechte und ohne Root-Rechte Lokale Überwachung mit Client-Bindungsmodus Manuelle Konfiguration erforderlich in configuration.yaml
In verschiedenen Umgebungen ( VM, Docker oder Kubernetes ) Fernüberwachung mit Client-Bindungsmodus Manuelle Konfiguration erforderlich in configuration.yaml

Konfigurieren der lokalen Überwachung mit lokalem Bindungsmodus

Online bearbeiten

Wenn das Benutzerkonto des Agenten „ Instana “ über Sonderrechte verfügt, verwendet der Sensor „ IBM MQ “ den lokalen Bindungsmodus, um Daten von „ IBM MQ “ abzurufen.

Durch Verwendung des lokalen Bindungsmodus kann der Sensor „ IBM MQ “ automatisch Instanzen des Warteschlangenmanagers „ IBM MQ “ erkennen und alle Daten anzeigen. Sie müssen die Konfigurationsdatei des Agenten „ Instana “ nicht konfigurieren.

Konfigurieren der lokalen Überwachung mit Client-Bindungsmodus

Online bearbeiten

Wenn das Benutzerkonto des Agenten „ Instana “ nicht über Berechtigungen verfügt, muss der Sensor „ IBM MQ “ den Client-Bindungsmodus verwenden, um Daten von „ IBM MQ “ abzurufen. Sie müssen die Verbindungsparameter für „ IBM MQ “ in der Konfigurationsdatei des Agenten konfigurieren.

Um die Verbindungsparameter für „ IBM MQ “ zu konfigurieren, führen Sie die folgenden Schritte aus:

  1. Konfigurieren Sie den Abschnitt ibmmq „plug-in“ in der Agent-Konfigurationsdatei wie folgt:

    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel

  2. Konfigurieren Sie andere Berechtigungen basierend auf Ihren „ IBM MQ “-Konfigurationen. Wenn die Sicherheit von IBM MQ aktiviert ist, konfigurieren Sie den Benutzer und das Passwort. Wenn „ TLS “ von „ IBM MQ “ aktiviert ist, geben Sie die Informationen zum Keystore in der Agent-Konfigurationsdatei an. Dies wird im folgenden Konfigurationsbeispiel gezeigt:

    Hinweis: Für die Keystore-Zertifikatsdatei wird nur die jks Datei unterstützt.
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel
      username: '<INSERT_USERNAME_HERE>' # User ID to connect to MQ (optional)
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to MQ (optional)
      keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled for remote monitoring. Optional)

    Durch Verwendung des Client-Bindungsmodus kann der Sensor „ IBM MQ “ einige Konfigurationen, wie z. B. Host und Port, in der lokalen Überwachung automatisch teilweise erkennen und Metriken in der Benutzeroberfläche von „ Instana “ anzeigen.

  3. Für Benutzer ohne Sonderrechte und Nicht-Root-Benutzer unter Linux : Konfigurieren Sie das enableStatisticsQueueMetrics Flag in der Agentenkonfigurationsdatei, damit der Sensor „ IBM MQ “ Warteschlangenstatistiken abrufen kann. Siehe „Konfigurieren der Warteschlangenstatistiken “.

    Umfassende Informationen zur Ausführung des „ Instana “-Agenten als Nicht-Root-Benutzer unter Linux finden Sie unter „Ausführen des Agenten als Nicht-Root-Benutzer “.

Konfigurieren der Warteschlangenstatistiken

Führen Sie die folgenden Schritte aus, um die Warteschlangenstatistiken zu konfigurieren:

  1. Warteschlangenstatistiken aktivieren: Um die Erfassung von Leistungskennzahlen (wie z. B. Nachrichtenraten) für alle Warteschlangen zu aktivieren, muss der mqm Benutzer die folgenden Schritte ausführen:

    1. Aktivieren Sie die Statistiken auf der Ebene des Queue-Managers, indem Sie den folgenden Befehl ausführen. Dieser Befehl fungiert als Hauptschalter für alle Warteschlangen, deren STATQ Attribut auf QMGR (den Standardwert) gesetzt ist.

      ALTER QMGR STATQ(ON)

    2. b. Legen Sie das Erfassungsintervall (obligatorisch) fest, indem Sie den folgenden Befehl ausführen. Der STATINT Wert muss mit dem Agenten übereinstimmen, um Echtzeit- poll_rate und genaue Statistiken zu erhalten. Wenn größer STATINT als ist poll_rate, erfolgt die Statistik nicht in Echtzeit.

      ALTER QMGR STATINT(60)
      Wichtig: Der mqm Benutzer muss alle erforderlichen Berechtigungen erteilen. {: important)
  2. Agent konfigurieren: Fügen Sie den enableStatisticsQueueMetrics Parameter in die configuration.yaml Agent-Datei (*instanaAgentDir*/etc/instana/configuration.yaml) ein:
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  enableStatisticsQueueMetrics: false # Default is false. If false, uses RESET PCF command (requires mqm privileges). If true (Linux only), uses STATS mode from statistics queue (STATINT must match POLL_RATE for accuracy).

    Nachdem diese Konfigurationen eingerichtet wurden, erfasst der Agent „ Instana “ erfolgreich Metriken zur Warteschlangenstatistik, indem er Nachrichten aus der Statistikwarteschlange abruft, ohne dass Root- oder mqm Gruppenzugriff erforderlich ist.

    Wenn auf truegesetzt enableStatisticsQueueMetrics ist, aktiviert der Sensor „ IBM MQ “ den STATS-Modus, um Statistiken zum Durchsatz der Warteschlange zu erfassen. Stellen Sie sicher, dass das STATINT (Statistikintervall) so eingestellt ist, dass es mit dem poll_rate Wert übereinstimmt. Wenn die Einstellung auf false (Standard) gesetzt ist, verwendet der Sensor den RESET PCF Befehlsansatz zur Erfassung von Statistiken, wofür Rechte mqm erforderlich sind.

Konfigurieren der Fernüberwachung mit Client-Bindungsmodus

Online bearbeiten

Bei der Fernüberwachung verwendet der Sensor „ IBM MQ “ den Client-Bindungsmodus, um Daten von „ IBM MQ “ abzurufen und anzuzeigen. Sie müssen die Verbindungsparameter für „ IBM MQ “ in der Konfigurationsdatei des Agenten konfigurieren. Die Konfigurationsschritte sind dieselben wie im Abschnitt „Lokale Überwachung mit Client-Bindungsmodus “.

Wenn Sie den Client-Bindungsmodus in der Fernüberwachung verwenden, müssen Sie den Host und den Port konfigurieren, da der Sensor „ IBM MQ “ diese in der Fernüberwachung nicht erkennen kann. Die Metriken werden auch in der Benutzeroberfläche von „ Instana “ angezeigt.