Adicionando ferramentas de diagnóstico de telemetria por meio da interface do usuário

Este tópico fornece o procedimento para adicionar ferramentas de diagnóstico de telemetria para o seu motor Presto ( Java ) através da interface do usuário do IBM® watsonx.data.

Antes de Iniciar

Certifique-se de ter acesso ao watsonx.data console e às credenciais para as ferramentas de telemetria (Instana ou Prometheus ).

A ferramenta Prometheus Instana deve ser instalada seguindo as instruções fornecidas abaixo, com base nos requisitos:

Procedimento

  1. Efetue login no console do watsonx.data.

  2. No menu de navegação, selecione Configurações e clique em OpenTelemetry.

  3. Na página OpenTelemetry, clique em Diagnóstico +.

  4. Na janela Adicionar diagnóstico de telemetria, insira os seguintes detalhes:

    Adicionar detalhes de diagnóstico de telemetria
    Campo Descrição
    Ferramentas de telemetria disponíveis Selecione a ferramenta de diagnóstico de telemetria (Instana, Prometheus ) na lista.
    Terminal de telemetria Insira o ponto final URL da ferramenta selecionada. Formato: http://<host>:<port>/<path> ou https://<host>:<port>/<path>. Use a porta 4317 para OTLP sobre GRPC e 4318 para OTLP sobre HTTP.
    Nome do host Se a ferramenta de telemetria selecionada for Instana, insira o ID do host da ferramenta. Consulte Configurando os atributos do recurso.
    Senha Digite a chave ou Prometheus senha do agente Instana.
    Status da conexão Clique em Testar conexão para validar o endpoint e as credenciais.
    Diagnósticos associados Marque a caixa de seleção para associar um tipo de diagnóstico (logs, métricas, rastreamentos) à ferramenta de telemetria.

    Atualmente, a Instana fornece apenas métricas e dados de diagnóstico de rastreamento. Prometheus fornece apenas dados de diagnóstico métricos.

  5. Clique em Adicionar para aplicar a integração da ferramenta de telemetria.

    O usuário pode precisar aguardar um pouco até que os pods sejam reiniciados.

  6. Acesse e analise a lista de métricas de diagnóstico para os motores compatíveis com sua instância usando o menu suspenso para:

    • Ativar: Ative o diagnóstico.
    • Desativar: Pausar a coleta de dados.
    • Editar: Atualizar detalhes da configuração.
    • Ver detalhes: Inspecione a configuração atual.
    • Desassociar: Remova o diagnóstico do motor.

    Depois que todos os tipos de diagnóstico suportados forem associados com sucesso a uma ou ambas as ferramentas de telemetria, o botão Adicionar diagnóstico será desativado.

    Para configurar uma nova ferramenta de diagnóstico ou mudar para outra, você deve:

    • Edite a configuração existente.
    • Desative o diagnóstico atual.
    • Desvincule-o.

Navegue até Dados de telemetria de diagnóstico

Para revisar a telemetria de diagnóstico (incluindo chamadas internas e sintéticas):

  1. Faça login na interface do usuário do Instana.
  2. Navegue até Análises → Aplicativos → Chamadas.
  3. No painel esquerdo, localize a seção Chamadas ocultas.
  4. Ative as seguintes opções:
    • Mostrar chamadas sintéticas
    • Mostrar chamadas internas

Isso garante que todos os dados de chamadas internas, gerados pelo sistema e sintéticos relevantes para o diagnóstico sejam visíveis na interface do usuário.

Visualizando rastros para uma consulta específica usando CRN

  1. Vá para Análise → Aplicativos → Chamadas.
  2. Selecione Adicionar filtro.
  3. Na barra de pesquisa do filtro, digite OpenTelemetry → Personalizado → crn.
  4. Selecione o atributo crn e defina-o como desejado <crn_value>.
  5. Ajuste a janela de retenção para se concentrar nas atividades de rastreamento recentes:
    • Últimos 5 minutos
    • Últimos 10 minutos
    • Últimos 30 minutos

Esses períodos de retenção ajudam a garantir que os traços de execução de consultas recentes fiquem visíveis sem interferência de chamadas mais antigas.

Visualizando OpenTelemetry métricas no Instana

  1. Faça login na interface do usuário do Instana e navegue até Analisar infraestrutura.
  2. No seletor de fonte de dados, escolha OpenTelemetry para visualizar todos OpenTelemetry os recursos.
  3. Clique em Adicionar filtro, selecione OpenTelemetry Recurso → otel.attribute → k8s.namespace.name. Insira o namespace da instância watsonx.data necessário para filtrar a exibição.
  4. A partir dos resultados filtrados, selecione o endpoint metric-scraper-presto associado à sua instância.
  5. Use Selecionar métricas para navegar por todas as métricas OpenTelemetry disponíveis expostas pelo coletor Presto de métricas.
  6. Escolha qualquer métrica para abrir sua visualização de série temporal em tempo real, onde você pode analisar valores atuais, tendências e atributos.

Visualizando métricas na interface Prometheus do usuário

  1. Acesse a Prometheus interface do usuário para o seu ambiente.
  2. No campo Expressão, comece a digitar o nome da métrica (por exemplo, presto_).
  3. Prometheus exibirá automaticamente todas as métricas coletadas do metric-scraper-presto.
  4. Selecione a métrica necessária e clique em Executar para visualizar o resultado.