Documentazione dell'infrastruttura Oracle Cloud

Attributi di trace e intervallo per l'agente Java APM

Gli attributi di trace (span radice) e di intervallo in Trace Explorer vengono definiti mediante l'applicazione di tag a un intervallo, che consente il monitoraggio efficace dei vari livelli di un'applicazione.

Gli attributi sono coppie chiave-valore associate a un intervallo per fornire informazioni e contesto aggiuntivi sull'operazione eseguita nell'intervallo. Un trace ha alcuni attributi solo traccia e tutti gli attributi di intervallo dell'intervallo radice.

In Trace Explorer è possibile utilizzare gli attributi per eseguire query e filtrare i trace e gli intervalli. Esistono due tipi di attributi: Dimensioni (attributi stringa) e Metriche (attributi numerici) disponibili nel pannello Attributi di Trace Explorer.

Questa sezione fornisce una lista completa degli attributi pronti all'uso applicabili all'agente Java APM. La tabella seguente include:

  • Nome: il nome dell'attributo.
  • Descrizione: breve descrizione dell'attributo.
  • Trace/Span: disponibilità dell'attributo. Un attributo può essere disponibile per trace, intervalli o entrambi.
  • Tipo: tipo di attributo: Dimensione o Metrica.
Nome Descrizione Traccia/intervallo Tipo
ApmVersion La versione dell'agente Application Performance Monitoring. Attributo traccia e intervallo Dimensione
Appserver Flag che indica se è stato rilevato un server applicazioni. Quando il tipo di server applicazioni è java-jmx o java-no-jmx, la dimensione viene impostata su false. Attributo traccia e intervallo Dimensione
AppserverDisplayPort Numero di porta dell'Application Server. L'impostazione predefinita è la porta HTTPS più bassa, se disponibile, o la porta HTTP più bassa. Attributo traccia e intervallo Dimensione
AppserverId L'hash di risorse significative dell'Application Server, che indica se c'è una modifica delle risorse nell'Application Server nel tempo. Attributo traccia e intervallo Dimensione
AppserverName Nome dell'Application Server. Attributo traccia e intervallo Dimensione
AppserverPorts Numeri di porta dell'Application Server. In genere, esiste un solo numero di porta per il server Oracle WebLogic e più per il server Apache Tomcat. In caso di più numeri di porta, i valori sono separati da virgole. Attributo traccia e intervallo Dimensione
AppserverType Il tipo di server applicazioni. Ad esempio: Weblogic o Tomcat. Attributo traccia e intervallo Dimensione
AppserverVersion Versione del software dell'Application Server. Attributo traccia e intervallo Dimensione
ClassMethod Nome della classe e nome del metodo in cui si è verificata l'osservazione dell'intervallo. Attributo traccia e intervallo Dimensione
ClientIp

L'IP del client che ha richiamato il servlet tramite HTTP.

Per impostazione predefinita, l'agente controllerà l'intestazione della richiesta X-FORWARDED-FOR per queste informazioni.

Se non è disponibile, richiamerà il metodo ServletRequest.getRemoteAddr.

Il funzionamento predefinito può essere aggiornato utilizzando il file ProbeConfig.acml dell'agente Java APM. Vedere i parametri capture_client_ip e client_ip_header.

Queste informazioni vengono utilizzate per la GeoMap. A seconda degli IP client acquisiti, la configurazione del mapping IP geografico può aiutare a fornire risultati più accurati.

Attributo traccia e intervallo Dimensione
Component Componente che ha generato l'intervallo dallo standard https://opentracing.io/specification/conventions/, con valori quali JDBC, SERVLET e BROWSER. Attributo traccia e intervallo Dimensione
ContextRoot La radice contesto dell'applicazione Web monitorata. Attributo traccia e intervallo Dimensione
DbConnUrl L'URL di connessione JDBC utilizzato per connettersi al database. Attributo traccia e intervallo Dimensione
DbOracleConnectionId L'ID connessione Oracle di rete univoco generato dal driver JDBC Oracle per ogni connessione JDBC al database Oracle. Questo attributo è supportato sui client JDBC 21 e più recenti di Oracle. Attributo traccia e intervallo Dimensione
DbErrorSqlState Il codice SQLState restituito da SQLException.getSQLState negli scenari di errore. Attributo traccia e intervallo Dimensione
DbErrorVendorCode Numero che identifica l'errore che ha causato la generazione dell'istanza SQLException. Attributo traccia e intervallo Metrica
DbOracleSessionId ID della sessione Oracle dell'istruzione eseguita. Attributo traccia e intervallo Dimensione
DbOracleSqlId L'ID Oracle SQL calcolato dall'istruzione SQL eseguita. Attributo traccia e intervallo Dimensione
DbOracleSqlId1 Nelle esecuzioni delle istruzioni batch, l'ID Oracle SQL calcolato in base alla prima istruzione SQL eseguita. Attributo traccia e intervallo Dimensione
DbOracleSqlId2 Nelle esecuzioni delle istruzioni batch, l'ID Oracle SQL calcolato in base alla seconda istruzione SQL eseguita. Attributo traccia e intervallo Dimensione
DbStatement Testo SQL normalizzato eseguito dall'istruzione JDBC. Attributo traccia e intervallo Dimensione
DbStatement1 Nelle esecuzioni delle istruzioni batch, il testo SQL normalizzato della prima istruzione JDBC eseguita. Attributo traccia e intervallo Dimensione
DbStatement2 Nelle esecuzioni delle istruzioni batch, il testo SQL normalizzato della seconda istruzione JDBC eseguita. Attributo traccia e intervallo Dimensione
DbStatementAdditionalFetchCount Numero di round-trip nel database per recuperare righe aggiuntive del set di risultati non restituite all'esecuzione iniziale dell'istruzione. Attributo traccia e intervallo Metrica
DbStatementAdditionalFetchTime Tempo (in millisecondi) impiegato per recuperare dal database ulteriori righe del set di risultati che non sono state restituite all'esecuzione iniziale dell'istruzione. Attributo traccia e intervallo Metrica
DbStatementExecTime Il tempo (in millisecondi) impiegato per l'esecuzione iniziale dell'istruzione e la restituzione di eventuali righe iniziali. Attributo traccia e intervallo Metrica
DbType Il tipo di database. Attualmente sono supportati solo database di tipo 'sql'. Attributo traccia e intervallo Dimensione
DbUser L'utente di connessione JDBC sottostante. Attributo traccia e intervallo Dimensione
DeploymentInfo Informazioni sulla distribuzione dell'applicazione Web monitorata. Questo può essere visualizzato in due formati, a seconda che il tipo di distribuzione sia disponibile:

<Deployment Name>; <Deployment File Name>

<Deployment Name>; <Deployment File Name>; <Deployment Type>

 Attributo traccia e intervallo Dimensione
DisplayName Nome visualizzato dell'Application Server. Attributo traccia e intervallo Dimensione
ECID ID contesto esecuzione Oracle. Attributo intervallo Dimensione
Error Proprietà di intervallo che contrassegna un intervallo come "non riuscito" con valore booleano true, in caso di errore. Indica che l'applicazione ha considerato l'operazione rappresentata dall'intervallo non riuscita. Il valore booleano predefinito è false (nessun errore). Attributo traccia e intervallo Dimensione
ErrorObject Descrizione leggibile dell'errore. Attributo traccia e intervallo Dimensione
GenAIChatHistory Cronologia delle conversazioni o contesto delle interazioni precedenti con il modello di intelligenza artificiale generativa Attributo intervallo Dimensione
GenAICompartmentId Identificativo univoco del compartimento in cui viene elaborata la richiesta GenAI. Attributo intervallo Dimensione
GenAIEmbeddingsPerSentence Dimensione dell'incorporamento vettoriale generato per frase. Specifico per il modello utilizzato Attributo intervallo Dimensione
GenAIEmbedResponseId Identificativo univoco della risposta di incorporamento Attributo intervallo Dimensione
GenAIEmbedSentenceCount Numero di frasi elaborate per la generazione dell'integrazione Attributo intervallo Dimensione
GenAIEmbedTruncate Strategia per troncare gli input che superano i limiti del modello (ad esempio NONE, START) Attributo intervallo Dimensione
GenAIFinishReason Il motivo per cui il modello ha interrotto la generazione della risposta (ad esempio, limite massimo di token, sequenza di arresto) Attributo intervallo Dimensione
GenAIFrequencyPenalty Penalizza la ripetizione di parole a seconda della frequenza del verificarsi di parole Attributo intervallo Dimensione
GenAIInputSentences Frasi o blocchi di testo effettivi sottomessi per l'incorporamento Attributo intervallo Dimensione
GenAIIsEcho Flag booleano che indica se il prompt deve essere ripetuto nella risposta Attributo intervallo Dimensione
GenAIMaxTokens Numero massimo di token che il modello può generare nella risposta Attributo intervallo Dimensione
GenAIModelName Nome del modello di intelligenza artificiale generativa utilizzato per la richiesta (ad esempio, cohere.command) Attributo intervallo Dimensione
GenAIModelVersion Versione specifica del modello di intelligenza artificiale generativa in uso Attributo intervallo Dimensione
GenAINumGenerations Numero di risposte alternative generate per lo stesso prompt Attributo intervallo Dimensione
GenAIOpcRequestId ID univoco per il trace della richiesta Attributo intervallo Dimensione
GenAIPresencePenalty Penalizza le parole dopo la prima occorrenza, non tiene conto della frequenza dell'occorrenza Attributo intervallo Dimensione
GenAIPrompt Il prompt formattato finale inviato al modello, incluse le istruzioni di sistema, il preambolo, l'input dell'utente, i documenti, le informazioni sugli strumenti ecc Attributo intervallo Dimensione
GenAIPromptLength Il numero totale di caratteri del prompt completo Attributo intervallo Dimensione
GenAIQuery Query di input dell'utente inviata al modello di intelligenza artificiale generativa Attributo intervallo Dimensione
GenAIQueryLength Il conteggio dei caratteri della query di input dell'utente Attributo intervallo Dimensione
GenAIResponse La risposta completa generata dal modello di intelligenza artificiale generativa Attributo intervallo Dimensione
GenAIResponseLength Conteggio dei caratteri della risposta del modello di intelligenza artificiale generativa Attributo intervallo Dimensione
GenAIResponseTimeCreated Indicatore orario durante la generazione della risposta AI generativa Attributo intervallo Dimensione
GenAISearchQueriesOnly Se true, restituisce solo query di ricerca pertinenti, non risposte complete Attributo intervallo Dimensione
GenAISeed Valore iniziale casuale utilizzato per i risultati di generazione riproducibili Attributo intervallo Dimensione
GenAIStatusCode Codice di stato HTTP restituito dall'endpoint AI generativa Attributo intervallo Dimensione
GenAIStopSequences Lista di sequenze personalizzate specificate dall'utente che attivano il modello per interrompere la generazione di testo Attributo intervallo Dimensione
GenAITemperature Controlla la casualità nelle parole selezionate per la risposta, la temperatura più bassa è più deterministica Attributo intervallo Dimensione
GenAITopK Limita le scelte di token del modello ai token K più probabili in base alle loro probabilità previste Attributo intervallo Dimensione
GenAITopP Il modello seleziona il token successivo dall'insieme di candidati più probabili la cui probabilità cumulativa raggiunge la soglia massima Attributo intervallo Dimensione
GenAITotalInputLength Conteggio totale dei caratteri di tutte le frasi di input o i chunk di testo combinati per la generazione dell'incorporamento Attributo intervallo Dimensione
GenAIUserPreamble Istruzioni personalizzate o contesto fornito prima della query principale Attributo intervallo Dimensione
HostAddress L'indirizzo IPv4 è stato risolto dal nome host. Attributo traccia e intervallo Dimensione
Hostname Il nome dell'host. Attributo traccia e intervallo Dimensione
HostnameCanonical Il nome canonico (FQDN) dell'host. Attributo traccia e intervallo Dimensione
HostNames Elenco dei nomi host nelle interfacce di rete dell'host. Attributo traccia e intervallo Dimensione
HttpClientType Il tipo di client HTTP monitorato, ad esempio Apache HttpClient e HttpURLConnection. Attributo traccia e intervallo Dimensione
HttpMethod Metodo HTTP utilizzato nella richiesta, ad esempio GET, POST e DELETE. Attributo traccia e intervallo Dimensione
HttpRequestContentSize Lunghezza del contenuto della richiesta se Content-Length è stato impostato come parte dell'intestazione della richiesta. Attributo traccia e intervallo Dimensione
HttpResponseContentSize Lunghezza del contenuto della risposta se Content-Length è stato impostato come parte dell'intestazione della risposta. Attributo traccia e intervallo Dimensione
HttpStatusCode Codice di stato HTTP della risposta, ad esempio 200, 404 o 500. Attributo traccia e intervallo Dimensione
HttpStatusDetails Descrizione del codice di stato della risposta HTTP. Attributo traccia e intervallo Dimensione
HttpUrl URL HTTP correlato all'intervallo. Attributo traccia e intervallo Dimensione
HttpUrlFragment Il frammento dell'URL HTTP correlato all'intervallo. Attributo traccia e intervallo Dimensione
HttpUrlHost Il nome host dell'URL HTTP correlato all'intervallo. Attributo traccia e intervallo Dimensione
HttpUrlPath Il percorso dell'URL HTTP correlato all'intervallo. Attributo traccia e intervallo Dimensione
HttpUrlQuery Query URL HTTP correlata all'intervallo. Attributo traccia e intervallo Dimensione
Kind Il campo correlato alla definizione di trace aperto (https://opentracing.io/specification/conventions/) span.kind0. L'agente del browser può segnalare valori quali CLIENT o INTERNAL e l'agente Java e altri traccianti possono riportare valori quali SERVER per i servlet e CLIENT per HttpClient e JDBC. Attributo traccia e intervallo Dimensione
NonSampledCount Numero di intervalli radice precedenti non campionati con lo stesso nome operazione. Attributo traccia e intervallo Metrica
OciAvailabilityDomain Dominio di disponibilità di Oracle Cloud Infrastructure in cui è in esecuzione l'istanza di computazione. Attributo traccia e intervallo Dimensione
OciCompartmentId OCID del compartimento in cui risiede l'istanza di computazione. Attributo traccia e intervallo Dimensione
NonSampledCount Numero di intervalli radice precedenti non campionati con lo stesso nome operazione. Attributo traccia e intervallo Metrica
OciAvailabilityDomain Dominio di disponibilità di Oracle Cloud Infrastructure in cui è in esecuzione l'istanza di computazione. Attributo traccia e intervallo Dimensione
OciComputeShape La forma dell'istanza di computazione. Attributo traccia e intervallo Dimensione
OciDisplayName Nome visualizzato dell'istanza di computazione o del nodo Kubernetes. Attributo traccia e intervallo Dimensione
OciFaultDomain Nome del dominio di errore di Oracle Cloud Infrastructure in cui è in esecuzione l'istanza di computazione. Attributo traccia e intervallo Dimensione
OciInstanceId OCID dell'istanza di computazione. Attributo traccia e intervallo Dimensione
OciRegion Area di Oracle Cloud Infrastructure che contiene il dominio di disponibilità in cui è in esecuzione l'istanza di computazione. Attributo traccia e intervallo Dimensione
OpcRequestIdRequest Il set di valori di intestazione opc-request-id nell'ambito della richiesta inviata a Oracle Cloud Infrastructure. Attributo traccia e intervallo Dimensione
OpcRequestIdResponse Il set di valori di intestazione opc-request-id nell'ambito della risposta inviata da Oracle Cloud Infrastructure. Attributo traccia e intervallo Dimensione
OperationName Il nome dell'intervallo. Attributo traccia e intervallo Dimensione
OsAvailableProcessors Numero di processori disponibili per Java Virtual Machine (JVM). Attributo traccia e intervallo Metrica
OsFamily Famiglia di sistemi operativi derivata dall'user agent. Ad esempio, Linux. Attributo traccia e intervallo Dimensione
OsName Nome del sistema operativo. Attributo traccia e intervallo Dimensione
OsVersion La versione del sistema operativo. Attributo traccia e intervallo Dimensione
ProcessId ID processo dell'Application Server. Attributo traccia e intervallo Metrica
RequestPayload Corpo del payload della richiesta acquisito come parte della richiesta. Il payload della richiesta può essere filtrato per visualizzare solo informazioni utili utilizzando una combinazione di xpath, jsonpath o regex. Per ulteriori dettagli, controllare il file ProbeConfig.acml. Attributo traccia e intervallo Dimensione
ResponsePayload Corpo del payload della risposta acquisito come parte della risposta. Il payload della risposta può essere filtrato per visualizzare solo informazioni utili utilizzando una combinazione di xpath, jsonpath o regex. Per ulteriori dettagli, controllare il file ProbeConfig.acml. Attributo traccia e intervallo Dimensione
ServletContainerSpecification La versione della specifica Servlet su cui si basa l'applicazione rappresentata da questo ServletContext.

Attributo traccia e intervallo Dimensione
ServletSpecification La versione dell'API servlet supportata da questo contenitore servlet. Attributo traccia e intervallo Dimensione
ServiceInstanceId L'ID osservatore dell'agente. Attributo traccia e intervallo Dimensione
ServiceName Il nome assegnato al servizio. Attributo traccia e intervallo Dimensione
SessionId L'identificativo univoco della sessione o del browser. Attributo traccia e intervallo Dimensione
SoaTaskAssigneeUsers Elenco di nomi utente degli utenti a cui è stato assegnato questo task.

Per visualizzare questa dimensione, è necessario impostare capture_username=true nel file ProbeConfig.acml.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskCompletionDuration Il tempo espresso in millisecondi da quando il task viene avviato a quando viene completato.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskName Il nome del task

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskNumber Il numero di task visualizzato nella colonna Number dell'elenco lavori BPM.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskOutcome Il risultato del task al completamento.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskRequester Nome utente del richiedente del task.

Per visualizzare questa dimensione, è necessario impostare capture_username=true nel file ProbeConfig.acml.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskState Lo stato del task.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaTaskSubstate Substato del task, se disponibile.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SoaWorkflowNumber Numero del flusso di lavoro.

Questo attributo è presente quando si utilizza Oracle SOA Human Workflow.

 Attributo intervallo Dimensione
SpanID L'identificativo univoco per ogni intervallo. Attributo intervallo Dimensione
StartTime Ora di inizio dell'intervallo. Attributo intervallo Metrica
Subcomponent Sottocomponente che ha generato l'intervallo. Attributo ambito Dimensione
ThreadAllocatedMemory L'approssimazione della quantità totale di memoria in byte allocata nella memoria heap per l'intervallo servlet associato. Queste informazioni vengono acquisite per impostazione predefinita da ThreadMXBean.

Il comportamento predefinito può essere disabilitato utilizzando il file ProbeConfig.acml dell'agente Java APM. Vedere il parametro tag_thread_allocated_memory.

Attributo intervallo Dimensione
ThreadCpuTime Il tempo CPU totale per l'intervallo Servlet associato in millisecondi. Queste informazioni vengono acquisite per impostazione predefinita da ThreadMXBean.

Il comportamento predefinito può essere disabilitato utilizzando il file ProbeConfig.acml dell'agente Java APM. Vedere il parametro tag_thread_cpu_time.

Attributo intervallo Dimensione
ThreadId L'ID del thread in cui è iniziato l'intervallo. Attributo intervallo Metrica
ThreadIdEnd L'ID del thread in cui è terminato l'intervallo. Attributo intervallo Metrica
ThreadName Il nome del thread in cui è iniziato l'intervallo. Attributo intervallo Dimensione
ThreadNameEnd Il nome del thread in cui è terminato l'intervallo. Attributo intervallo Dimensione
UserName Il nome utente dell'utente finale che utilizza il sistema o un identificativo che identifica in modo univoco l'utente.

Per informazioni sulle opzioni di acquisizione e configurazione del nome utente, vedere Modify or Disable Default Probe Settings.

Attributo traccia e intervallo Dimensione
VmName Il nome della virtual machine. Attributo traccia e intervallo Dimensione
VmVendor Il fornitore della macchina virtuale. Attributo traccia e intervallo Dimensione
VmVersion La versione della virtual machine. Attributo traccia e intervallo Dimensione
WorkingDirectory La directory di lavoro del server applicazioni. Attributo traccia e intervallo Dimensione