Récupération des journaux QHMM à l'aide de l'utilitaire ibm-lh

L'utilitaire ibm-lh vous permet de récupérer les journaux QHMM (qui fournissent des informations sur les exécutions de requêtes, permettant aux utilisateurs de surveiller et d'analyser les mesures de performance) sans exécuter de requêtes SQL. Il peut être utilisé pour retrouver facilement les informations suivantes à l'aide de mots-clés.

  • Informations de base sur les requêtes
  • Informations de base sur les erreurs des requêtes qui ont échoué
  • Informations sur les statistiques des requêtes
  • Demande d'informations sur la mémoire
  • Demande d'informations sur le ramassage des ordures
  • Requête la plus longue

Procédure

  1. Installer le paquet client ibm-lh. Pour plus d'informations, voir Installation du paquet ibm-lh-client.

  2. Utilisez l'utilitaire cert-mgmt pour ajouter ou supprimer des certificats SSL dans le truststore ibm-lh-client afin d'établir une connexion avec le moteur Presto.

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

  3. Établir une connexion avec watsonx.data en utilisant les utilitaires du paquet ibm-lh-client.

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

    Pour plus d'informations, voir Établissement d'une connexion.

  4. Configurez les détails de Presto en utilisant la commande suivante :

    ./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. Sélectionnez l'instance actuelle.

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

  6. Utilisez la commande de l'utilitaire ibm-lh monitor qhmm pour récupérer les journaux du QHMM. Pour plus d'informations sur la syntaxe et les différents mots-clés, voir ibm-lh monitor qhmm.

    La syntaxe est la suivante./ibm-lh monitor qhmm --type <type_name> --start-time <start_time> --end-time <end_time> --user <user_id> --query-id <query_id> --query-state <query_state>

Paramètres :

    • --type <nom_type> : spécifie le type de requête (par exemple, query_failed_info, query_basic_info, query_stats_info, query_memory_info, query_gc_info).
    • --start-time <start_time> : Horodatage de départ en AAAA-MM-JJ HH:MM:SS (UTC).
    • --end-time <end_time> : Horodatage de fin (facultatif).
    • --user <user_id> : ID de l'utilisateur associé aux requêtes (facultatif).
    • --query-id <query_id> : identifiant spécifique de la requête (facultatif).
    • --query-state <query_state> : état de la requête (par exemple, COMPLETED, FAILED) (facultatif).
    • --limit <valeur_limite> : Nombre de lignes à renvoyer (facultatif).
    • --order: Nom des colonnes à trier (facultatif).

Exemple de requête permettant d'obtenir des informations de base sur toutes les requêtes exécutées :

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

Cette commande permet d'obtenir des informations de base sur les requêtes exécutées par user123 entre le 1er et le 8 octobre 2023.