Recuperação de registros do QHMM usando o utilitário ibm-lh

O utilitário ibm-lh permite que você recupere os logs do QHMM (fornece informações sobre as execuções de consultas, permitindo que os usuários monitorem e analisem as métricas de desempenho) sem executar consultas SQL. Ele pode ser usado para recuperar facilmente as seguintes informações de consulta com a ajuda de palavras-chave.

  • Informações básicas de consulta
  • Informações básicas de erro de consultas com falha
  • Informações sobre estatísticas de consulta
  • Consultar informações da memória
  • Consultar informações sobre a coleta de lixo
  • Consulta de maior tempo gasto

Procedimento

  1. Instale o pacote do cliente ibm-lh. Para obter informações, consulte Instalação do pacote ibm-lh-client.

  2. Use o utilitário cert-mgmt para adicionar ou remover certificados SSL no truststore do ibm-lh-client para estabelecer conexão com o mecanismo Presto.

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

  3. Estabeleça conexão com watsonx.data usando os utilitários do pacote ibm-lh-client.

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

    Para obter mais informações, consulte Estabelecimento de conexão.

  4. Configure os detalhes Presto usando o seguinte 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. Selecione a instância atual.

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

  6. Use o comando do utilitário ibm-lh monitor qhmm para recuperar os registros do QHMM. Para obter mais informações sobre a sintaxe e as diferentes palavras-chave, consulte ibm-lh monitor qhmm.

    A sintaxe é a seguinte./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>

Parâmetros:

    • --type <type_name>: especifica o tipo de consulta (por exemplo, query_failed_info, query_basic_info, query_stats_info, query_memory_info, query_gc_info).
    • --start-time <start_time>: registro de data e hora inicial em AAAA-MM-DD HH:MM:SS (UTC).
    • --end-time <end_time>: carimbo de data e hora de término (opcional).
    • --user <user_id>: ID do usuário associado às consultas (opcional).
    • --query-id <query_id>: ID de consulta específica (opcional).
    • --query-state <query_state>: estado da consulta (por exemplo, COMPLETED, FAILED) (opcional).
    • --limit <valor_limite>: número de linhas a serem retornadas (opcional).
    • --order: Nome das colunas para classificação (opcional).

Consulta de amostra para recuperar informações básicas sobre todas as consultas executadas:

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

Esse comando obtém informações básicas para consultas executadas por user123 entre 1º de outubro e 8 de outubro de 2023.