Integrazione intervallo

Informazioni sull'integrazione intervallo

Consente agli utenti di integrare gli intervalli con attributi personalizzati oppure di modificare, combinare o rimuovere i dati dagli attributi esistenti.
Le operazioni di arricchimento vengono definite mediante regole di intervallo che contengono una o più azioni da applicare in un determinato ordine in un determinato intervallo.
Esistono due tipi di regole di intervallo: personalizzate e fornite da Oracle.
L'arricchimento intervallo è configurato a livello di dominio APM.

Esempi di integrazione intervallo:

Rimozione delle informazioni di identificazione personale (PII) dagli intervalli.
Combina i dati provenienti da più attributi in uno solo.
Estrai dati da un attributo. Ad esempio, un percorso parziale da un URL più lungo.
Applicare funzioni matematiche sui dati. Ad esempio, convertire un'unità da secondi a millisecondi.
Mappare un valore di attributo a un nuovo valore. Ad esempio, mappare il valore '1' al colore 'blu', il valore '2' al colore 'rosso'.
Distribuire i valori numerici nei bucket. Ad esempio, un intervallo di valori di temperatura mappato in bucket 'freddo', 'caldo' e 'caldo'.

Argomenti:

Uso integrazione intervallo

L'arricchimento intervallo viene configurato mediante regole intervallo che operano su un intervallo e vengono utilizzate per modificare gli attributi dell'intervallo. La casella degli strumenti Regole intervallo fornisce una vasta gamma di azioni che possono essere eseguite come parte di una regola.

Le regole intervallo vengono gestite all'interno di gruppi. Un gruppo è una raccolta di regole applicate in un ordine specificato. Ogni regola può applicare una o più azioni a un intervallo e l'output di ogni regola può essere utilizzato come input per le regole di follow-up. I gruppi di regole richiedono un filtro intervallo utilizzato per selezionare gli intervalli in cui applicare le regole.

È possibile definire più gruppi. Ciò è utile quando è necessario gestire diversi tipi di regole per diversi tipi di intervalli poiché crea entità logiche con funzionalità progettate per uno scopo specifico. Ciò riduce la complessità complessiva del set di regole.

Se per più gruppi sono impostati filtri intervallo che corrispondono allo stesso intervallo, tutte le regole verranno applicate a tale intervallo. L'ordine in cui questo viene eseguito è determinato dall'ordine alfabetico dei nomi dei gruppi. Tienilo a mente quando dai un nome o rinomini i tuoi gruppi. Oracle consiglia di inserire un numero prima dei nomi per evitare che vengano ordinati alfabeticamente. ad esempio "1. Rimuovere i dati di posizione", "2. Converti unità lunghezza".

Tieni presente che quando più gruppi operano sullo stesso intervallo, questo significa che ogni gruppo opererà su una versione dell'intervallo che potrebbe essere stata modificata da un gruppo precedente nella catena. Ciò può essere utile in quanto è possibile scrivere regole in gruppi di follow-up che si basano su modifiche create da gruppi precedenti. D'altra parte, può anche causare errori nelle regole di follow-up se un attributo su cui una regola si basa, viene rimosso o modificato da un gruppo precedente.

Nota

Quanto sopra è importante solo quando un intervallo corrisponde a più gruppi.

Se i gruppi hanno filtri chiaramente disgiunti, un intervallo verrà sempre modificato da un singolo gruppo e le considerazioni di cui sopra diventano irrilevanti.

Attributi in eventi intervallo

Gli intervalli possono contenere un elenco di eventi denominati anche messaggi di log. Questi vengono in genere utilizzati per memorizzare informazioni sui momenti importanti durante l'esecuzione dell'intervallo. Ad esempio, se un intervallo descrive una query di database, è possibile generare eventi per contrassegnare il momento in cui la connessione era aperta, il momento in cui la richiesta di query è stata effettivamente sottomessa e il momento in cui è stata ricevuta la risposta.

Un evento è identificato da un name, timestamp e da un set di attributes (coppie chiave-valore) che forniscono un ulteriore contesto per le informazioni registrate.

Tutte le azioni delle regole di intervallo descritte di seguito, che richiedono un attributo come input o output, possono essere applicate anche agli attributi dei singoli eventi. Poiché gli attributi di evento sono indipendenti dagli attributi di intervallo regolari, sarà necessario utilizzare la seguente sintassi event reference per identificare l'attributo di evento appropriato:

event['NameOfEvent']:'NameOfAttribute'.

Nota

Gli attributi evento non possono essere utilizzati come filtri intervallo.

Crea e gestisce regole intervallo

È possibile creare e gestire le regole intervallo a seconda delle esigenze di generazione report.

Per creare regole intervallo per un determinato dominio APM, effettuare le operazioni riportate di seguito.

Andare alla pagina Domini APM e fare clic sul dominio APM desiderato.

Viene visualizzata la pagina Dettagli dominio.
Andare a Risorse, in basso a sinistra, quindi fare clic su Arricchimento intervallo.

Viene visualizzato il riquadro Arricchimento intervallo.
Fare clic su Crea gruppo per creare un nuovo gruppo di regole di intervallo.
Viene visualizzato il riquadro Crea gruppo di regole di intervallo.
- Immettere il nome del nuovo gruppo.
- Selezionare un filtro di intervallo da utilizzare con questo gruppo.
- Facoltativamente, specificare una descrizione per il nuovo gruppo.
- Fare clic su Successivo per passare al riquadro Azioni regola e iniziare ad aggiungere regole intervallo al nuovo gruppo a seconda del tipo di regola intervallo: Regola intervallo personalizzata o Regola intervallo fornita da Oracle.
- Immettere il nome della regola.
- Se si desidera, selezionare un filtro intervallo regole per limitare ulteriormente l'ambito dell'operazione della regola.
  
  Nota
  
  I filtri intervallo vengono creati separatamente. Per ulteriori informazioni, vedere Filtri intervallo.
- Se necessario, fornire una descrizione della regola.
- Selezionare un tipo di regola intervallo.
  - Se si seleziona Regola intervallo fornita da Oracle, viene offerto un elenco di regole tra cui scegliere.
    
    Le regole sono già state create da Oracle per fornire assistenza agli utenti. L'elenco include le informazioni riportate di seguito.
    Aggiunge l'indirizzo IP del client a un intervallo.
    Aggiunge l'indirizzo IP del client a un intervallo come attributo denominato ClientIP.
    
    Suite EBS.
    Fornisce il modello E-Business Suite.
    
    OpenTelemetry alla conversione dei nomi APM.
    Converte i nomi degli attributi span dalla convenzione di denominazione OpenTelemetry alla convenzione di denominazione APM. Per informazioni sull'uso di OpenTelemetry con APM, vedere Configurare le origini dati OpenTelemetry.
    Fare clic su una regola dalla lista per aggiungerla al gruppo.
    
    Nota
    
    Non è possibile configurare alcuna azione poiché è gestita internamente dalla regola stessa. Inoltre, non è possibile visualizzare le azioni per una regola fornita da Oracle.
  - Se si sceglie di creare una regola di intervallo personalizzata, è necessario definire una o più azioni. Una regola contiene sempre almeno un'azione.
    Prima di poter scegliere un'azione, è necessario selezionare un destinazione azione e un tipo di azione.
    
    La destinazione azione specifica la parte dell'intervallo in cui opera l'azione. Sono disponibili due destinazioni:
    
    Entità: definire il target dell'intero intervallo.
    
    Attributo: definire come target un singolo attributo.
    
    Il tipo di azione specifica il tipo. Viene utilizzato principalmente per raggruppare le azioni logicamente insieme. Ad esempio, stringa o numerico.
    
    Selezionare l'azione appropriata dall'elenco a discesa Azioni disponibili.
    Poiché le azioni hanno vari contesti, la finestra verrà modificata di conseguenza con ogni tipo di azione. Per ulteriori dettagli sulle azioni, vedere Utilizzo delle azioni.
    Per ulteriori informazioni sulle azioni disponibili per Destinazione azione e Tipo di azione, vedere Azioni disponibili.
    Utilizzare il pulsante Aggiungi azione per aggiungere altre azioni alla regola.
    
    Utilizzare il menu dell'elemento azione nella parte superiore destra di ogni azione per spostarlo verso l'alto o verso il basso nell'ordinamento delle regole oppure eliminare un'azione.

Utilizzo delle azioni

Le azioni con destinazione Attributo richiedono sempre di fornire il nome dell'attributo il cui valore verrà utilizzato come input per l'azione. La finestra di configurazione per ogni azione fa riferimento ad essa come Input Attribute.

Alcune azioni richiedono inoltre di fornire il nome di un attributo in cui memorizzare il risultato dell'operazione. Questo è denominato Output Attribute. Se l'attributo esiste nell'intervallo, qualsiasi valore di cui dispone in quel momento verrà sovrascritto dal risultato dell'azione. Se non esiste ancora, verrà aggiunto all'intervallo con il nuovo valore. È possibile utilizzare questo meccanismo per sostituire il valore di qualsiasi attributo dell'intervallo (anche l'attributo di input) con il risultato dell'operazione dell'azione.

Utilizzando questa opzione, è possibile inserire i risultati di qualsiasi azione in un'azione di follow-up (o anche in una regola all'interno dello stesso gruppo di regole).

È inoltre possibile utilizzarlo per memorizzare i valori in attributi temporanei che possono essere utilizzati da regole o azioni di follow-up, ma senza doverli conservare come parte del risultato finale. Assicurarsi solo di rimuovere gli attributi temporanei come ultimo passo utilizzando l'azione Rimuovi attributo.

Nota

Un'azione Blocca rifiuta l'intervallo e non può essere utilizzata in un secondo momento, nemmeno da un altro gruppo di regole.

Azioni disponibili

Destinazione azione	Tipo di azione	Azioni disponibili
Entità	Passthrough Azioni che controllano se l'intervallo nella sua interezza viene passato o bloccato. Gli intervalli bloccati vengono rifiutati dalla pipeline di elaborazione. Gli intervalli rifiutati non verranno più elaborati da APM, non verranno memorizzati in alcun luogo e non saranno disponibili per la visualizzazione in un secondo momento in altri strumenti o dashboard APM.	Blocco: blocca incondizionatamente questo intervallo. Eventuali azioni e regole di follow-up non verranno applicate e l'intervallo non sarà più disponibile negli strumenti e nei prodotti OCI APM. Campione: i campioni (accetta) si estendono in base a una percentuale di campioni. Ad esempio, una percentuale campione del 25% accetterà (casualmente) il 25% di tutti gli intervalli e bloccherà il resto. Gli intervalli bloccati qui vengono trattati allo stesso modo degli intervalli bloccati dall'azione Blocca.
Attributo	Stringa Azioni che consentono varie operazioni sul valore di un attributo che è una stringa. Ad esempio, modificare il caso, sostituire un valore o estrarre una parte della stringa.	Aggiungi: aggiunge una stringa statica al valore di un attributo utilizzando una stringa di separazione facoltativa. Concatenazione: concatena due valori di attributo. È possibile fornire una stringa di separazione facoltativa su cui unire i valori. Il risultato viene restituito come nuovo attributo. Estrai: estrae una parte del valore di un attributo in base a un'espressione regolare. Il risultato viene restituito come nuovo attributo. L'espressione regolare deve contenere un operatore del gruppo di acquisizione che identifica la parte della stringa da acquisire. Se l'espressione regolare non corrisponde o non esiste alcun gruppo di acquisizione, l'azione non produrrà alcun output. Facoltativamente, è possibile fornire un valore di fallback, che verrà utilizzato come output dell'azione nel caso in cui l'estrazione stessa non produca alcun risultato. Minuscole: converte il valore di un attributo in minuscolo. Cerca e sostituisci: sostituisce una o più parti del valore di un attributo utilizzando un'espressione regolare. La stringa modificata viene restituita come nuovo attributo. L'espressione regolare può contenere un solo gruppo di acquisizione. Senza un gruppo di acquisizione, il contenuto completo delle corrispondenze dell'espressione verrà sostituito. Quando è presente un gruppo di acquisizione, verrà sostituito solo il contenuto acquisito dal gruppo. È possibile utilizzare l'occorrenza di corrispondenza facoltativa se è necessario sostituire solo un'occorrenza specifica di una corrispondenza. Se questa opzione non è impostata o è impostata su 0, tutte le occorrenze corrispondenti verranno sostituite. Questo è il funzionamento predefinito. Trim: consente di rimuovere eventuali spazi iniziali e finali dal valore di un attributo. In maiuscolo: converte il valore di un attributo in maiuscolo.
Attributo	Numerico Azioni che consentono varie operazioni matematiche sui valori degli attributi (a condizione che siano numeri). Le azioni numeriche supportano sia i numeri effettivi che i numeri rappresentati come stringhe nel valore dell'attributo, ovvero le due seguenti sono equivalenti: "quantità" : 2.5 "quantità" : "2.5" Le azioni numeriche possono assumere come input una stringa che rappresenta il nome di un attributo il cui valore deve essere utilizzato nell'operazione oppure un numero che verrà utilizzato direttamente nel calcolo. Tutte le azioni numeriche hanno un'opzione che consente di applicare l'arrotondamento al valore di output. L'arrotondamento può essere uno dei seguenti. Arrotonda: arrotonda il numero per eccesso o per difetto al numero intero più vicino. Pavimento: arrotonda il numero per difetto al numero intero più vicino. Ceil: arrotonda il numero per eccesso al numero intero più vicino. Nessun arrotondamento: opzione predefinita.	Assoluto: restituisce il valore assoluto del valore di input. Aggiungi: somma due valori. Bucketize: esegue il mapping di un valore di attributo numerico in nomi di bucket. Se il valore dell'attributo rientra nell'intervallo di un bucket, verrà restituito il nome del bucket. Se nessun bucket corrisponde, verrà restituito un valore di fallback. Dividi: divide il primo per il secondo valore. Se il secondo valore è 0, il risultato sarà 0. Massimo: restituisce il massimo dei due valori. Minimo: restituisce il minimo dei due valori. Moltiplica: moltiplica i due valori. Nega: nega (modifica il segno) il valore. Sottrai: il secondo attributo viene sottratto dal primo attributo.
Attributo	Generic Le azioni generiche forniscono operazioni a livello di attributo, ad esempio la rimozione di un attributo dall'intervallo.	Mappa valore attributo: utilizza il valore di un attributo e lo associa a un nuovo valore. Rimuovi attributo: rimuove l'attributo dall'intervallo. Se l'attributo è un riferimento nome evento, `event['EventName']`, l'intero evento intervallo verrà rimosso. Rinomina attributo: rinomina l'attributo. Imposta attributo: imposta un attributo su un valore statico. Se l'attributo non esiste, viene aggiunto, altrimenti viene assegnato il nuovo valore, sovrascrivendo quello esistente.

Esempi di configurazione azioni

In questa sezione vengono forniti esempi dei passi di configurazione necessari per alcune singole azioni.

Esempio Bucketize:
Questa azione utilizza un mini editor per impostare un numero di bucket e i relativi valori di soglia. È possibile utilizzare il controllo a destra per creare, aggiornare e rimuovere i bucket.

I bucket vengono ordinati automaticamente in base ai relativi valori di soglia. Un valore di fallback viene utilizzato quando un valore è troppo grande per l'ultimo bucket. L'immagine seguente mostra un esempio con cinque bucket e un valore di fallback:
Esempio di mappa:
Questa azione utilizza un mini editor per impostare la mappa delle coppie di valori di input/output. Entrambi i valori possono essere numeri o stringhe. Utilizzare il controllo a destra per creare, aggiornare e/o rimuovere un mapping.
Il pulsante Esporta consente di scaricare qualsiasi mapping in un file (in formato CSV) sul computer.
Il pulsante Importa consente di popolare i mapping da un file CSV sul computer. Ciò è particolarmente utile se si dispone di un numero elevato di mapping.

Convalida regole integrazione intervallo

Le configurazioni di arricchimento intervallo possono essere complesse da scrivere e talvolta può essere difficile sapere in anticipo se una regola o un gruppo di regole funzionerà come previsto. A tale scopo, l'Editor configurazione arricchimento intervallo fornisce un'opzione per eseguire il test di una regola o di un gruppo di regole in un intervallo di esempio prima di salvarlo.

Per utilizzare l'opzione di test, effettuare le operazioni riportate di seguito.

Selezionare un gruppo, quindi fare clic su Modifica per aprire il pannello Modifica gruppo di regole di intervallo. Un altro modo è quello di creare un nuovo gruppo e visualizzare il pannello Modifica.
Fare clic per accedere al passo Configura azioni regola.
Fare clic su Test per eseguire il test dell'intero gruppo di regole. In alternativa, per eseguire il test di una singola regola, selezionarla e fare clic su Test della regola.
Nota

Regola di test non è disponibile se il gruppo di regole contiene una sola regola.
Viene visualizzato il pannello Gruppo di regole di intervallo di test.
Le regole da sottoporre a test verranno visualizzate con una casella di controllo accanto ad esse. È possibile alternarli come desiderato.
Immettere un intervallo di esempio nella casella di testo Esempio di intervallo.
Fare clic su Esegui test intervallo per eseguire un test delle regole selezionate nell'intervallo specificato.

Figura 9-1 Convalida regola di integrazione intervallo

Convalida regola integrazione intervallo

L'esecuzione del test segnala se l'intervallo corrisponde o meno ai filtri intervallo configurati.

Se i filtri corrispondono, le regole verranno applicate all'intervallo e le eventuali differenze risultanti verranno visualizzate nella tabella riportata di seguito. Tutti gli attributi aggiunti come risultato della regola verranno evidenziati in verde. Gli attributi rimossi verranno evidenziati in rosso. Gli attributi modificati verranno evidenziati in giallo.

Trace Explorer: per ottenere esempi accurati di intervalli dal traffico, fare clic su Trace Explorer, situato in alto a destra, per aprire Trace Explorer e visualizzare gli intervalli effettivi elaborati. È possibile selezionare un intervallo, aprire il menu di scelta rapida a destra (i tre punti verticali) e fare clic su Copia dati intervallo radice.

Viene visualizzato un popup con il contenuto dell'intervallo. È possibile copiare i dati dell'intervallo e utilizzarli durante il test.

Un'altra opzione è incollare i propri intervalli o immetterli manualmente, purché siano conformi al formato di intervallo riportato da Trace Explorer.

Alias proprietà intervallo

Nota

A poche proprietà dell'intervallo effettivo viene fatto riferimento con un nome diverso quando vengono utilizzate nelle funzioni Arricchimento intervallo o Filtri intervallo. Oltre alla differenza visiva, questo non ha alcun impatto sulla modalità di impostazione delle regole e dei filtri. Ad esempio, è consigliabile utilizzare sempre l'alias quando si fa riferimento alla proprietà specificata.

Di seguito sono riportate le proprietà che attualmente hanno un alias.

Proprietà intervallo	Alias integrazione intervallo	Commenti
`td-micros`	`SpanDuration`	`td-micros` è espresso in microsecondi, mentre `SpanDuration` è espresso in millisecondi. La conversione unità di tempo viene applicata automaticamente dai filtri di arricchimento intervallo e intervallo.
`name`	`OperationName`	Il nome dell'intervallo rappresenta l'operazione eseguita
`ts-micros`	`StartTime`	`ts-micros` è espresso in microsecondi, mentre `StartTime` è espresso in millisecondi. La conversione unità di tempo viene applicata automaticamente dai filtri di arricchimento intervallo e intervallo.
`id`	`SpanId`
`parent-id`	`ParentId`
`trace-id`	`TraceId`

Documentazione di Oracle Cloud Infrastructure

Integrazione intervallo