Recupero dei registri QHMM mediante l'utilità ibm-lh

L'utility ibm-lh consente di recuperare i log QHMM (che forniscono informazioni sulle esecuzioni delle query, consentendo agli utenti di monitorare e analizzare le metriche delle prestazioni) senza eseguire query SQL. Può essere utilizzato per recuperare facilmente le seguenti informazioni con l'aiuto di parole chiave.

  • Informazioni di base sulla query
  • Informazioni di base sugli errori delle query non riuscite
  • Informazioni sulle statistiche della query
  • Interrogare le informazioni sulla memoria
  • Interrogare le informazioni sulla garbage collection
  • Interrogazione con tempo massimo

Procedura

  1. Installare il pacchetto client ibm-lh. Per informazioni, vedere Installazione del pacchetto ibm-lh-client.

  2. Utilizzate l'utilità cert-mgmt per aggiungere o rimuovere i certificati SSL nel truststore ibm-lh-client per stabilire la connessione con il motore Presto.

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

  3. Stabilire la connessione a watsonx.data usando le utility del pacchetto ibm-lh-client.

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

    Per ulteriori informazioni, vedere Stabilire la connessione.

  4. Configurare i dettagli di Presto con il seguente comando:

    ./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. Selezionare l'istanza corrente.

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

  6. Utilizzare il comando di utilità ibm-lh monitor qhmm per recuperare i registri QHMM. Per ulteriori informazioni sulla sintassi e sulle diverse parole chiave, vedere ibm-lh monitor qhmm.

    La sintassi è./ibm-lh monitor qhmm --type <nome_tipo> --start-time <orario_inizio> --end-time <orario_fine> --user <id_utente> --query-id <id_query> --query-state <stato_query>

Parametri:

    • --type <nome_tipo>: Specifica il tipo di query (ad esempio, query_failed_info, query_basic_info, query_stats_info, query_memory_info, query_gc_info).
    • --start-time <start_time>: Timestamp iniziale in YYYY-MM-DD HH:MM:SS (UTC).
    • --end-time <end_time>: Timestamp finale (opzionale).
    • --user <user_id>: ID utente associato alle query (opzionale).
    • --query-id <query_id>: ID specifico della query (opzionale).
    • --query-state <query_state>: Stato della query (ad esempio, COMPLETED, FAILED) (opzionale).
    • --limit <valore_limite>: Numero di righe da restituire (opzionale).
    • --order: Nome delle colonne per l'ordinamento (opzionale).

Query di esempio per recuperare le informazioni di base su tutte le query eseguite:

./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"

Questo comando recupera le informazioni di base per le query eseguite da user123 tra il 1° ottobre e l'8 ottobre 2023.