Añadir herramientas de diagnóstico de telemetría a través de la interfaz de usuario

Este tema proporciona el procedimiento para añadir herramientas de diagnóstico de telemetría para su motor Presto ( Java ) a través de la interfaz de usuario de IBM® watsonx.data.

Antes de empezar

Asegúrese de tener acceso a la watsonx.data consola y las credenciales para las herramientas de telemetría (Instana o Prometheus ).

La herramienta Prometheus Instana o debe instalarse siguiendo las instrucciones que se proporcionan a continuación en función de los requisitos:

Procedimiento

  1. Inicie la sesión en la consola de watsonx.data.

  2. En el menú de navegación, seleccione Configuraciones y haga clic en OpenTelemetry.

  3. En la OpenTelemetry página, haz clic en Diagnóstico +.

  4. En la ventana Añadir diagnóstico de telemetría, introduzca los siguientes datos:

    Añadir detalles de diagnóstico de telemetría
    Campo Descripción
    Herramientas de telemetría disponibles Seleccione la herramienta de diagnóstico de telemetría (Instana, Prometheus ) de la lista.
    Punto final de telemetría Introduzca el punto final URL de la herramienta seleccionada. Formato: http://<host>:<port>/<path> o https://<host>:<port>/<path>. Utilice el puerto 4317 para OTLP sobre GRPC y 4318 para OTLP sobre HTTP.
    Nombre de host Si la herramienta de telemetría seleccionada es Instana, introduzca el ID de host de la herramienta. Consulte Configuración de los atributos de los recursos.
    Contraseña Introduzca la clave o Prometheus contraseña del agente Instana.
    Estado de conexión Haga clic en Probar conexión para validar el punto final y las credenciales.
    Diagnósticos asociados Seleccione la casilla de verificación para asociar un tipo de diagnóstico (registros, métricas, trazas) a la herramienta de telemetría.

    Actualmente, Instana solo proporciona métricas y datos de diagnóstico de rastreos. Prometheus proporciona únicamente datos métricos de diagnóstico.

  5. Haga clic en Añadir para aplicar la integración de la herramienta de telemetría.

    Es posible que el usuario tenga que esperar un poco hasta que se reinicien los pods.

  6. Acceda y revise la lista de métricas de diagnóstico para los motores compatibles con su instancia utilizando el menú desplegable para:

    • Habilitar: Activar el diagnóstico.
    • Desactivar: Pausar la recopilación de datos.
    • Editar: Actualizar los detalles de configuración.
    • Ver detalles: Inspeccionar la configuración actual.
    • Desvincular: Eliminar el diagnóstico del motor.

    Una vez que todos los tipos de diagnóstico compatibles se han asociado correctamente con una o ambas herramientas de telemetría, el botón Añadir diagnóstico se desactiva.

    Para configurar una nueva herramienta de diagnóstico o cambiar a otra, debe:

    • Edita la configuración existente.
    • Desactivar el diagnóstico actual.
    • Desvincularlo.

Navegar a Datos de telemetría de diagnóstico

Para revisar la telemetría de diagnóstico (incluidas las llamadas internas y sintéticas):

  1. Inicie sesión en la interfaz de usuario de Instana.
  2. Vaya a Analytics → Aplicaciones → Llamadas.
  3. En el panel izquierdo, localiza la sección Llamadas ocultas.
  4. Habilite las opciones siguientes:
    • Mostrar llamadas sintéticas
    • Mostrar llamadas internas

Esto garantiza que todos los datos de llamadas internos, generados por el sistema y sintéticos relevantes para el diagnóstico sean visibles en la interfaz de usuario.

Visualización de rastros para una consulta específica utilizando CRN

  1. Vaya a Analytics → Aplicaciones → Llamadas.
  2. Selecciona Añadir filtro.
  3. En la barra de búsqueda del filtro, escriba OpenTelemetry → Personalizado → crn.
  4. Seleccione el atributo crn y configúrelo como desee <crn_value>.
  5. Ajuste la ventana de retención para centrarse en la actividad reciente de rastreo:
    • Últimos 5 minutos.
    • Últimos 10 minutos
    • Últimos 30 minutos

Estos períodos de retención ayudan a garantizar que los registros recientes de ejecución de consultas sean visibles sin el ruido de las llamadas más antiguas.

Visualización de OpenTelemetry métricas en Instana

  1. Inicie sesión en la interfaz de usuario de Instana y vaya a Analizar infraestructura.
  2. En el selector de fuentes de datos, seleccione OpenTelemetry para ver todos OpenTelemetry los recursos.
  3. Haga clic en Añadir filtro, seleccione OpenTelemetry Recurso → otel.attribute → k8s.namespace.name. Introduzca el espacio de nombres de watsonx.data instancia requerido para filtrar la vista.
  4. De los resultados filtrados, seleccione el punto final metric-scraper-presto asociado a su instancia.
  5. Utilice Seleccionar métricas para explorar todas las métricas OpenTelemetry disponibles expuestas por el Presto rastreador de métricas.
  6. Elija cualquier métrica para abrir su visualización de series temporales en tiempo real, donde podrá analizar los valores actuales, las tendencias y los atributos.

Visualización de métricas en la Prometheus interfaz de usuario

  1. Acceda a la Prometheus interfaz de usuario de su entorno.
  2. En el campo Expresión, comience a escribir el nombre de la métrica (por ejemplo, presto_).
  3. Prometheus Mostrará automáticamente todas las métricas recopiladas desde metric-scraper-presto.
  4. Seleccione la métrica requerida y haga clic en Ejecutar para ver el resultado.