Hinzufügen von Telemetrie-Diagnosetools über die Benutzeroberfläche

Dieses Thema beschreibt das Verfahren zum Hinzufügen von Telemetrie-Diagnosetools für Ihre Presto ( Java ) Engine über die Benutzeroberfläche von IBM® watsonx.data.

Vorbereitende Schritte

Stellen Sie sicher, dass Sie Zugriff auf die watsonx.data Konsole und die Anmeldedaten für die Telemetrie-Tools (Instana oder Prometheus ) haben.

Das Instana- oder Prometheus Tool muss gemäß den unten aufgeführten Anweisungen entsprechend den Anforderungen installiert werden:

Vorgehensweise

  1. Melden Sie sich bei der watsonx.data-Konsole an.

  2. Wählen Sie im Navigationsmenü „ Konfigurationen “ aus und klicken Sie auf OpenTelemetry.

  3. Klicken Sie auf der OpenTelemetry Seite auf „ Diagnostik + “.

  4. Geben Sie im Fenster „ Telemetriediagnose hinzufügen “ die folgenden Details ein:

    Telemetrie-Diagnosedetails hinzufügen
    Feld Beschreibung
    Verfügbare Telemetrie-Tools Wählen Sie das Telemetrie-Diagnosetool (Instana, Prometheus ) aus der Liste aus.
    Telemetrie-Endpunkt Geben Sie den Endpunkt URL des ausgewählten Werkzeugs ein. Format: http://<host>:<port>/<path> oder https://<host>:<port>/<path>. Verwenden Sie den Port 4317 für OTLP über GRPC und 4318 für OTLP über HTTP.
    Host Name Wenn das ausgewählte Telemetrie-Tool Instana ist, geben Sie die Host-ID des Tools ein. Siehe Konfigurieren der Ressourcenattribute.
    Kennwort Geben Sie den Instana-Agentenschlüssel oder Prometheus das Passwort ein.
    Connection Status Klicken Sie auf „Verbindung testen“, um den Endpunkt und die Anmeldedaten zu überprüfen.
    Zugehörige Diagnostik Aktivieren Sie das Kontrollkästchen, um dem Telemetrie-Tool einen Diagnosetyp (Protokolle, Metriken, Traces) zuzuordnen.

    Derzeit stellt Instana nur Metriken und Diagnosedaten zu Traces bereit. Prometheus liefert nur Metrik-Diagnosedaten.

  5. Klicken Sie auf „Hinzufügen“, um die Integration des Telemetrie-Tools anzuwenden.

    Der Benutzer muss möglicherweise kurz warten, bis die Pods neu gestartet sind.

  6. Greifen Sie auf die Diagnoseliste der Metriken für die in Ihrer Instanz unterstützten Engines zu und überprüfen Sie diese, indem Sie das Dropdown-Menü verwenden, um:

    • Aktivieren: Aktivieren Sie die Diagnose.
    • Deaktivieren: Datenerfassung pausieren.
    • Bearbeiten: Konfigurationsdetails aktualisieren.
    • Details anzeigen: Aktuelle Konfiguration überprüfen.
    • Trennen: Entfernen Sie die Diagnoseeinrichtung vom Motor.

    Sobald alle unterstützten Diagnosetypen erfolgreich mit einem oder beiden Telemetrie-Tools verknüpft wurden, wird die Schaltfläche „Diagnose hinzufügen” deaktiviert.

    Um ein neues Diagnosetool zu konfigurieren oder zu einem anderen zu wechseln, müssen Sie entweder:

    • Bearbeiten Sie die vorhandene Konfiguration.
    • Deaktivieren Sie die aktuelle Diagnose.
    • Trennen Sie es.

Navigieren Sie zu den Diagnose-Telemetriedaten

Zur Überprüfung der Diagnosetelemetrie (einschließlich interner und synthetischer Anrufe):

  1. Melden Sie sich bei der Instana-Benutzeroberfläche an.
  2. Navigieren Sie zu „Analytics“ → „Anwendungen“ → „Anrufe “.
  3. Suchen Sie im linken Bereich den Abschnitt „ Versteckte Anrufe “.
  4. Aktivieren Sie die folgenden Optionen:
    • Synthetische Aufrufe anzeigen
    • Interne Aufrufe anzeigen

Dadurch wird sichergestellt, dass alle internen, vom System generierten und synthetischen Anrufdaten, die für die Diagnose relevant sind, in der Benutzeroberfläche sichtbar sind.

Anzeigen von Spuren für eine bestimmte Abfrage mithilfe von CRN

  1. Gehen Sie zu Analytics → Anwendungen → Anrufe.
  2. Wählen Sie „Filter hinzufügen ”.
  3. Geben Sie in die Suchleiste OpenTelemetry des Filters → Benutzerdefiniert → crn ein.
  4. Wählen Sie das crn-Attribut aus und setzen Sie es auf den gewünschten Wert <crn_value>.
  5. Passen Sie das Aufbewahrungsfenster an, um sich auf die jüngsten Trace-Aktivitäten zu konzentrieren:
    • Letzte 5 Minuten
    • Letzte 10 Minuten
    • Letzte 30 Minuten

Diese Aufbewahrungsfristen tragen dazu bei, dass die Spuren der zuletzt ausgeführten Abfragen sichtbar sind, ohne dass sie durch ältere Aufrufe verfälscht werden.

Anzeigen von OpenTelemetry Metriken in Instana

  1. Melden Sie sich bei der Instana-Benutzeroberfläche an und navigieren Sie zu „ Infrastruktur analysieren “.
  2. Wählen Sie im OpenTelemetry Datenquellen-Selektor aus, um alle OpenTelemetry Ressourcen anzuzeigen.
  3. Klicken Sie auf „Filter hinzufügen“, wählen Sie OpenTelemetry „Ressource“ → otel.attribute „→ k8s.namespace.name “. Geben Sie den erforderlichen watsonx.data Instanz-Namespace ein, um die Ansicht zu filtern.
  4. Wählen Sie aus den gefilterten Ergebnissen den Endpunkt metric-scraper-presto aus, der mit Ihrer Instanz verknüpft ist.
  5. Verwenden Sie „Metriken auswählen“, um alle verfügbaren OpenTelemetry Metriken zu durchsuchen, die vom Presto Metrik-Scraper bereitgestellt werden.
  6. Wählen Sie eine beliebige Metrik aus, um deren Live-Zeitreihenvisualisierung zu öffnen, in der Sie aktuelle Werte, Trends und Attribute analysieren können.

Anzeigen von Metriken in der Prometheus Benutzeroberfläche

  1. Greifen Sie auf die Prometheus Benutzeroberfläche für Ihre Umgebung zu.
  2. Geben Sie im Feld „Ausdruck“ den Namen der Metrik ein (z. B. presto_).
  3. Prometheus zeigt automatisch alle von metric-scraper-presto gesammelten Metriken an.
  4. Wählen Sie die gewünschte Metrik aus und klicken Sie auf „Ausführen“, um das Ergebnis anzuzeigen.