Metriche di chiamata personalizzate (anteprima pubblica)
È possibile aggiungere annotazioni alle chiamate della propria applicazione con metriche personalizzate (valori numerici) tramite la strumentazione manuale con gli SDK di * Instana * specifici per il linguaggio. Utilizzando queste metriche relative alle chiamate nella vista di analisi di Unbounded, è possibile filtrare le chiamate in base a condizioni numeriche (minore o maggiore di) e rappresentare graficamente gli aggregati di questi valori nel tempo.
Scopo ed esempi di utilizzo
Grazie alle metriche personalizzate sulle chiamate, è possibile analizzare i dati numerici relativi alle chiamate che Instana non raccoglie di default. Possono essere utilizzati per metriche tecniche, come le dimensioni dei dati o i tempi, o anche per metriche commerciali, come il valore totale degli articoli in un carrello. I valori devono essere interi, quindi è necessario utilizzare una scala appropriata.
Le metriche delle chiamate personalizzate estendono il supporto esistente per l'annotazione delle chiamate nel codice strumentato con tag di chiamata personalizzati, che consentono di filtrare e classificare le chiamate in base a valori stringa definiti dall'utente. Poiché le metriche personalizzate sono valori numerici, è possibile utilizzarle non solo per filtrare e raggruppare, ma anche per aggregare i numeri su gruppi di chiamate.
Le seguenti attività presentano alcuni esempi di utilizzo delle metriche delle chiamate nella vista analitica Unbounded:
- Annotate le chiamate con la dimensione di alcuni dati elaborati e poi filtrate su tale dimensione per vedere le chiamate in cui la dimensione supera una certa soglia.
- Utilizzate le stesse annotazioni sulla dimensione dei dati per vedere come cambia nel tempo la dimensione massima dei dati nelle chiamate.
- Tieni traccia dei tempi all'interno di una chiamata, se ti interessa una determinata fase di elaborazione oltre alla latenza complessiva della chiamata che Instana registra di default.
- Tenere traccia degli accessi alla cache da parte delle chiamate, rappresentando una cache hit come '
100e una cache miss come '0, quindi utilizzare l'aggregazione media per visualizzare un grafico della percentuale di cache hit per le chiamate nel tempo.
Invio di metriche personalizzate sulle chiamate a Instana
Per inviare metriche personalizzate sulle chiamate a Instana, procedere come segue:
- Annotate le chiamate dell'applicazione nel vostro codice con gli stessi metodi dell'SDK di tracciamento usati per annotare le chiamate con dati stringa-chiave-valore per i tag delle chiamate.
- Se si desidera che l'annotazione sia memorizzata come metrica di chiamata numerica invece che come tag di chiamata stringa, utilizzare il prefisso '
metrics.per la chiave. - Assicurarsi che il valore possa essere analizzato come un numero intero. A seconda del linguaggio e dell'SDK, passare i numeri interi direttamente oppure convertirli in stringhe per adattarli alle definizioni dell' API.
Per l 'SDK Trace di Java, è possibile annotare una chiamata con metriche personalizzate, come illustrato nell'esempio seguente:
SpanSupport.annotate("metrics.processingTime", String.valueOf(1234));
Analisi delle metriche delle chiamate personalizzate
È possibile utilizzare le metriche delle chiamate per le seguenti attività:
Filtrare le chiamate utilizzando le metriche delle chiamate
Per filtrare le chiamate in base alle metriche delle chiamate, completare i passaggi seguenti nella vista Analisi senza limiti:
- Dalla barra laterale dell'interfaccia utente di Instana, seleziona Analytics.
- Nella pagina Analytics, fare clic sulla freccia del percorso di ricerca Applicazioni, quindi selezionare Chiamate.
- Fare clic su Aggiungi filtro.
- Selezionare Chiamate > Metriche chiamate personalizzate, quindi fornire una chiave metrica, un valore e un operatore di confronto per il filtro.
processingtime > 1000 (minuscolo t) non troverà corrispondenze con la chiamata mostrata nell'esempio precedente, che utilizza processingTime come chiave.È inoltre possibile utilizzare le metriche delle chiamate nelle condizioni di filtro delle prospettive dell'applicazione, proprio come qualsiasi altro filtro relativo alle chiamate.
Raggruppare le chiamate utilizzando le metriche delle chiamate
È possibile utilizzare le metriche delle chiamate come campo di raggruppamento nella vista analitica Unbounded. Poiché le query relative a chiamate con un numero eccessivo di gruppi potrebbero risultare poco efficienti, è consigliabile utilizzare una metrica di chiamata per il raggruppamento solo se si è certi che l'intervallo dei valori possibili inviati dall'applicazione sia limitato al massimo a poche centinaia di valori diversi.
Visualizzazione di grafici per le metriche di chiamata personalizzate
È inoltre possibile visualizzare i grafici per le metriche delle chiamate personalizzate in Unbounded analytics for calls. Per visualizzare i grafici, procedere come segue:
- Dalla barra laterale dell'interfaccia utente di Instana, seleziona Analytics.
- Nella pagina Analytics, fare clic sulla freccia del percorso di ricerca Applicazioni, quindi selezionare Chiamate.
- Nel widget Grafico, selezionare le metriche delle chiamate personalizzate dall'elenco, quindi inserire una chiave metrica e l'aggregazione da utilizzare per combinare le metriche in ciascun bucket temporale.
Nota sulle prestazioni
Come per le annotazioni chiave-valore sotto forma di stringhe, limita il numero di chiavi utilizzate (fino a qualche centinaio) ed evita di includere nelle stringhe delle chiavi elementi soggetti a frequenti modifiche, come gli ID dei processi. L'uso eccessivo di chiavi diverse può ridurre le prestazioni.
Limitazioni note
I seguenti aspetti delle metriche delle chiamate non sono pienamente supportati:
- Le metriche delle chiamate non possono essere utilizzate nei cruscotti personalizzati. È possibile tracciare le metriche delle chiamate solo nella vista analitica Unbounded.
- I grafici delle metriche delle chiamate nella vista Unbounded Analytics non visualizzano correttamente i numeri negativi. L'asse Y parte sempre da 0, come per tutte le altre metriche predefinite.