Abrufen von QHMM-Protokollen mit dem Dienstprogramm ibm-lh

Mit dem Dienstprogramm ibm-lh können Sie die QHMM-Protokolle abrufen (die Einblicke in Abfrageausführungen bieten und es den Benutzern ermöglichen, Leistungsmetriken zu überwachen und zu analysieren), ohne SQL-Abfragen auszuführen. Mit Hilfe von Schlüsselwörtern lassen sich die folgenden Abfrageinformationen leicht abrufen.

  • Grundlegende Informationen zur Abfrage
  • Grundlegende Fehlerinformationen zu fehlgeschlagenen Abfragen
  • Abfrage der Statistikinformationen
  • Abfrage von Speicherinformationen
  • Abfrage von Garbage-Collection-Informationen
  • Abfrage der Spitzenzeit

Vorgehensweise

  1. Installieren Sie das ibm-lh Client-Paket. Informationen finden Sie unter Installation des Pakets ibm-lh-client.

  2. Verwenden Sie das Dienstprogramm cert-mgmt, um SSL-Zertifikate im Truststore ibm-lh-client hinzuzufügen oder zu entfernen, um eine Verbindung mit dem Presto herzustellen.

    ./cert-mgmt --op=add --host=<saas_host> --port=<port>

  3. Stellen Sie die Verbindung zu watsonx.data mit ibm-lh-client package utilities her.

    ./connect-lh --op=add --name=<your_saas_name> --host=<saas_host> --port=<port> --username=<your_username> --password=<your_password>

    Weitere Informationen finden Sie unter Herstellen einer Verbindung.

  4. Konfigurieren Sie die Presto mit dem folgenden Befehl:

    ./ibm-lh config add_saas --name <your_saas_username> --crn <your_crn> --host <saas_host> --port <port> --prestohost <presto_host> --prestoport <presto_port> --username <your_username> --password <your_password>

  5. Wählen Sie die aktuelle Instanz aus.

    ./ibm-lh config select --current_instance <your_saas_username>

  6. Verwenden Sie den Dienstprogrammbefehl ibm-lh monitor qhmm, um die QHMM-Protokolle abzurufen. Weitere Informationen über die Syntax und die verschiedenen Schlüsselwörter finden Sie unter ibm-lh monitor qhmm.

    Die Syntax lautet /ibm-lh monitor qhmm --type <Typ_name> --start-time <Start_Zeit> --end-time <Ende_Zeit> --user <Benutzer_ID> --query-id <Abfrage_ID> --query-state <Abfrage_Zustand>

Parameter:

    • --type <type_name>: Gibt den Typ der Abfrage an (z.B. query_failed_info, query_basic_info, query_stats_info, query_memory_info, query_gc_info).
    • --start-time : Startzeitstempel in JJJJ-MM-TT HH:MM:SS (UTC).
    • --end-time : Zeitstempel für das Ende (optional).
  • -- --user <Benutzer_id>: Mit den Abfragen verbundene Benutzer-ID (optional).
    • --query-id <query_id>: Spezifische Abfrage-ID (optional).
    • --query-state <query_state>: Status der Abfrage (z.B. COMPLETED, FAILED) (optional).
    • --limit <limit_value>: Anzahl der zurückzugebenden Zeilen (optional).
    • --order: Name der Spalten für die Sortierung (optional).

Beispielabfrage zum Abrufen grundlegender Informationen über alle ausgeführten Abfragen:

./ibm-lh monitor qhmm --type query_basic_info --start-time "2023-10-01 00:00:00" --end-time "2023-10-08 23:59:59" --user "user123"

Mit diesem Befehl werden grundlegende Informationen für Abfragen abgerufen, die von user123 zwischen dem 1. und 8. Oktober 2023 ausgeführt wurden.