Ajout d'outils de diagnostic télémétrique via l'interface utilisateur

Cette rubrique décrit la procédure à suivre pour ajouter des outils de diagnostic télémétrique pour votre moteur Presto ( Java ) via l'interface utilisateur de IBM® watsonx.data.

Avant de commencer

Assurez-vous d'avoir accès à la watsonx.data console et aux identifiants pour les outils de télémétrie (Instana ou Prometheus ).

L'outil Prometheus Instana ou doit être installé en suivant les instructions fournies ci-dessous en fonction des besoins :

Procédure

  1. Connectez vous à la console watsonx.data.

  2. Dans le menu de navigation, sélectionnez Configurations, puis cliquez sur OpenTelemetry.

  3. Dans la OpenTelemetry page, cliquez sur Diagnostic +.

  4. Dans la fenêtre Ajouter un diagnostic télémétrique, entrez les informations suivantes :

    Ajouter les détails du diagnostic télémétrique
    Zone Description
    Outils de télémétrie disponibles Sélectionnez l'outil de diagnostic télémétrique (Instana, Prometheus ) dans la liste.
    Point d'extrémité de télémétrie Entrez le point final URL de l'outil sélectionné. Format : http://<host>:<port>/<path> ou https://<host>:<port>/<path>. Utilisez le port 4317 pour OTLP sur GRPC et 4318 pour OTLP sur HTTP.
    Nom d'hôte Si l'outil de télémétrie sélectionné est Instana, entrez l'ID hôte de l'outil. Voir Configuration des attributs de ressource.
    Mot de passe Entrez la clé ou Prometheus le mot de passe de l'agent Instana.
    État de la connexion Cliquez sur Tester la connexion pour valider le point de terminaison et les informations d'identification.
    Diagnostics associés Cochez la case pour associer un type de diagnostic (journaux, métriques, traces) à l'outil de télémétrie.

    Actuellement, Instana fournit uniquement des métriques et des données de diagnostic de traces. Prometheus fournit uniquement des données métriques de diagnostic.

  5. Cliquez sur Ajouter pour appliquer l'intégration de l'outil de télémétrie.

    L'utilisateur devra peut-être patienter quelques instants jusqu'à ce que les pods redémarrent.

  6. Accédez à la liste des métriques de diagnostic pour les moteurs pris en charge dans votre instance et consultez-la à l'aide du menu déroulant pour :

    • Activer: Activez le diagnostic.
    • Désactiver: suspendre la collecte de données.
    • Modification: mise à jour des détails de configuration.
    • Afficher les détails: inspecter la configuration actuelle.
    • Dissocier: Supprimer le diagnostic du moteur.

    Une fois que tous les types de diagnostic pris en charge ont été associés avec succès à l'un ou aux deux outils de télémétrie, le bouton Ajouter un diagnostic est désactivé.

    Pour configurer un nouvel outil de diagnostic ou passer à un autre, vous devez soit :

    • Modifier la configuration existante.
    • Désactiver le diagnostic actuel.
    • Dissocier.

Accéder aux données de télémétrie diagnostique

Pour examiner la télémétrie diagnostique (y compris les appels internes et synthétiques):

  1. Connectez-vous à l'interface utilisateur Instana.
  2. Accédez à Analytics → Applications → Appels.
  3. Dans le panneau de gauche, repérez la section Appels masqués.
  4. Activez les options suivantes :
    • Afficher les appels synthétiques
    • Afficher les appels internes

Cela garantit que toutes les données d'appel internes, générées par le système et synthétiques pertinentes pour le diagnostic sont visibles dans l'interface utilisateur.

Affichage des traces pour une requête spécifique à l'aide du CRN

  1. Accédez à Analytics → Applications → Appels.
  2. Sélectionnez Ajouter un filtre.
  3. Dans la barre de recherche du filtre, tapez OpenTelemetry → Personnalisé → crn.
  4. Sélectionnez l'attribut crn et définissez-le sur la valeur souhaitée <crn_value>.
  5. Ajustez la fenêtre de conservation pour vous concentrer sur l'activité récente des traces :
    • Les 5 dernières minutes
    • 10 dernières minutes
    • 30 dernières minutes

Ces périodes de conservation permettent de garantir que les traces d'exécution des requêtes récentes sont visibles sans être perturbées par les appels plus anciens.

Affichage OpenTelemetry des métriques dans Instana

  1. Connectez-vous à l'interface utilisateur Instana et accédez à Analyser l'infrastructure.
  2. Dans le sélecteur de source de données, choisissez OpenTelemetry pour afficher toutes OpenTelemetry les ressources.
  3. Cliquez sur Ajouter un filtre, sélectionnez OpenTelemetry Ressource → otel.attribute → k8s.namespace.name. Entrez l'espace de noms d'instance watsonx.data requis pour filtrer la vue.
  4. Dans les résultats filtrés, sélectionnez le point de terminaison metric-scraper-presto associé à votre instance.
  5. Utilisez Sélectionner les métriques pour parcourir toutes les métriques OpenTelemetry disponibles exposées par le scraper Presto de métriques.
  6. Choisissez n'importe quel indicateur pour ouvrir sa visualisation en temps réel, où vous pouvez analyser les valeurs actuelles, les tendances et les attributs.

Affichage des métriques dans l'interface Prometheus utilisateur

  1. Accédez à Prometheus l'interface utilisateur de votre environnement.
  2. Dans le champ Expression, commencez à saisir le nom de la métrique (par exemple, presto_).
  3. Prometheus affichera automatiquement toutes les métriques collectées à partir de metric-scraper-presto.
  4. Sélectionnez la métrique requise et cliquez sur Exécuter pour afficher le résultat.