Aggiunta di strumenti diagnostici di telemetria tramite l'interfaccia utente

Questo argomento illustra la procedura per aggiungere strumenti diagnostici di telemetria per il motore Presto ( Java ) tramite l'interfaccia utente di IBM® watsonx.data.

Prima di iniziare

Assicurati di avere accesso alla watsonx.data console e alle credenziali per gli strumenti di telemetria (Instana o Prometheus ).

Lo strumento Prometheus Instana o deve essere installato seguendo le istruzioni fornite di seguito in base ai requisiti:

Procedura

  1. Accedi alla console watsonx.data.

  2. Dal menu di navigazione, seleziona Configurazioni e fai clic su OpenTelemetry.

  3. Nella OpenTelemetry pagina, clicca su Diagnostica +.

  4. Nella finestra Aggiungi diagnostica telemetrica, inserisci i seguenti dettagli:

    Aggiungi dettagli diagnostici telemetrici
    Campo Descrizione
    Strumenti di telemetria disponibili Selezionare lo strumento diagnostico di telemetria (Instana, Prometheus ) dall'elenco.
    Endpoint di telemetria Inserisci il punto finale URL dello strumento selezionato. Formato: http://<host>:<port>/<path> o https://<host>:<port>/<path>. Utilizzare la porta 4317 per OTLP su GRPC e 4318 per OTLP su HTTP.
    Nome host Se lo strumento di telemetria selezionato è Instana, inserisci l'ID host dello strumento. Vedere Configurazione degli attributi delle risorse.
    Password Inserisci la chiave o Prometheus la password dell'agente Instana.
    Stato connessione Fare clic su Verifica connessione per convalidare l'endpoint e le credenziali.
    Diagnostica associata Selezionare la casella di controllo per associare un tipo di diagnostica (log, metriche, tracce) allo strumento di telemetria.

    Attualmente Instana fornisce solo metriche e dati diagnostici di tracciamento. Prometheus fornisce solo dati diagnostici metrici.

  5. Fai clic su Aggiungi per applicare l'integrazione dello strumento di telemetria.

    L'utente potrebbe dover attendere qualche istante prima che i pod si riavviino.

  6. Accedi e consulta l'elenco diagnostico delle metriche per i motori supportati nella tua istanza utilizzando il menu a discesa per:

    • Abilita: attiva la diagnostica.
    • Disattiva: sospende la raccolta dei dati.
    • Modifica: aggiornamento dei dettagli di configurazione.
    • Visualizza dettagli: controlla la configurazione attuale.
    • Disassociare: rimuovere la diagnostica dal motore.

    Una volta che tutti i tipi di diagnostica supportati sono stati associati correttamente a uno o entrambi gli strumenti di telemetria, il pulsante Aggiungi diagnostica viene disabilitato.

    Per configurare un nuovo strumento diagnostico o passare a un altro, è necessario:

    • Modifica la configurazione esistente.
    • Disattiva la diagnosi corrente.
    • Disassociarlo.

Passa ai dati telemetrici diagnostici

Per rivedere la telemetria diagnostica (comprese le chiamate interne e sintetiche):

  1. Accedi all'interfaccia utente di Instana.
  2. Vai su Analisi → Applicazioni → Chiamate.
  3. Nel pannello a sinistra, individua la sezione Chiamate nascoste.
  4. Abilitare le seguenti opzioni:
    • Mostra chiamate sintetiche
    • Mostra chiamate interne

Ciò garantisce che tutti i dati relativi alle chiamate interne, generate dal sistema e sintetiche rilevanti per la diagnostica siano visibili nell'interfaccia utente.

Visualizzazione delle tracce per una query specifica utilizzando CRN

  1. Vai su Analisi → Applicazioni → Chiamate.
  2. Seleziona Aggiungi filtro.
  3. Nella barra di ricerca del filtro, digitare OpenTelemetry → Personalizzato → crn.
  4. Seleziona l'attributo crn e impostalo sul valore desiderato <crn_value>.
  5. Regola la finestra di conservazione per concentrarti sulle attività di tracciamento recenti:
    • Ultimi 5 minuti
    • Ultimi 10 minuti
    • Ultimi 30 minuti

Questi periodi di conservazione aiutano a garantire che le tracce di esecuzione delle query recenti siano visibili senza il rumore delle chiamate più vecchie.

Visualizzazione OpenTelemetry delle metriche in Instana

  1. Accedi all'interfaccia utente di Instana e vai su Analizza infrastruttura.
  2. Nel selettore dell'origine dati, selezionare OpenTelemetry per visualizzare tutte OpenTelemetry le risorse.
  3. Fai clic su Aggiungi filtro, seleziona OpenTelemetry Risorsa → otel.attribute → k8s.namespace.name. Inserisci lo spazio dei nomi dell'istanza watsonx.data richiesto per filtrare la visualizzazione.
  4. Dai risultati filtrati, seleziona l'endpoint metric-scraper-presto associato alla tua istanza.
  5. Utilizza Seleziona metriche per sfogliare tutte le metriche OpenTelemetry disponibili esposte dallo scraper Presto delle metriche.
  6. Scegli una metrica qualsiasi per aprire la relativa visualizzazione della serie temporale in tempo reale, dove potrai analizzare i valori attuali, le tendenze e gli attributi.

Visualizzazione delle metriche nell'interfaccia Prometheus utente

  1. Accedi all'interfaccia Prometheus utente per il tuo ambiente.
  2. Nel campo Espressione, iniziare a digitare il nome della metrica (ad esempio, presto_).
  3. Prometheus visualizzerà automaticamente tutte le metriche raccolte da metric-scraper-presto.
  4. Seleziona la metrica desiderata e clicca su Esegui per visualizzare il risultato.