Atributos de Rastreamento e Intervalo para o Agente Java do APM
Os atributos de rastreamento (intervalo raiz) e de intervalo no Trace Explorer são definidos marcando um intervalo, o que permite o monitoramento efetivo das várias camadas de um aplicativo.
Os atributos são pares de chave/valor anexados a um intervalo para fornecer informações adicionais e contexto sobre a operação executada no intervalo. Um rastreamento tem alguns atributos somente de rastreamento, bem como todos os atributos de intervalo do intervalo raiz.
No Explorador de Rastreamento, você pode usar atributos para consultar e filtrar rastreamentos e intervalos. Há dois tipos de atributos: Dimensões (atributos de string) e Métricas (atributos numéricos) que estão disponíveis no painel Atributos no Trace Explorer.
Esta seção fornece uma lista completa dos atributos prontos para uso aplicáveis ao agente Java do APM. A tabela abaixo inclui:
- Nome: Nome do atributo.
- Descrição: Descrição resumida do atributo.
- Rastreamento/Intervalo: Disponibilidade do atributo. Um atributo pode estar disponível para rastreamentos, intervalos ou ambos.
- Tipo: Tipo de atributo: Dimensão ou Métrica.
| Nome | Descrição | Rastreamento/Intervalo | Tipo |
|---|---|---|---|
ApmVersion |
A versão do agente do Application Performance Monitoring. | Atributo de rastreamento e intervalo | Dimensão |
Appserver |
O flag para indicar se um servidor de aplicativos foi descoberto. Quando o tipo de servidor de aplicativos é java-jmx ou java-no-jmx, essa dimensão é definida como false.
|
Atributo de rastreamento e intervalo | Dimensão |
AppserverDisplayPort |
O número da porta do servidor do aplicativo. O padrão é a porta HTTPS mais baixa, se disponível, ou a porta HTTP mais baixa. | Atributo de rastreamento e intervalo | Dimensão |
AppserverId |
O hash de recursos significativos do servidor do aplicativo, que indica se há alteração de recursos no servidor do aplicativo ao longo da duração. | Atributo de rastreamento e intervalo | Dimensão |
AppserverName |
O nome do servidor do aplicativo. | Atributo de rastreamento e intervalo | Dimensão |
AppserverPorts |
Os números de porta do servidor do aplicativo. Geralmente, há apenas um número de porta para o servidor Oracle WebLogic e vários para o servidor Apache Tomcat. No caso de vários números de porta, os valores são separados por vírgulas. | Atributo de rastreamento e intervalo | Dimensão |
AppserverType |
O tipo de servidor de aplicativos. Por exemplo: Weblogic ou Tomcat.
|
Atributo de rastreamento e intervalo | Dimensão |
AppserverVersion |
A versão do software do servidor do aplicativo. | Atributo de rastreamento e intervalo | Dimensão |
ClassMethod |
O nome da classe e o nome do método em que ocorreu a observação do intervalo. | Atributo de rastreamento e intervalo | Dimensão |
ClientIp |
O IP do cliente que chamou o Servlet via HTTP. Por padrão, o agente verificará o cabeçalho da solicitação Se não estiver disponível, ele chamará o método O comportamento padrão pode ser atualizado usando o arquivo ProbeConfig.acml do Agente Java do APM. (Consulte os parâmetros Essas informações são utilizadas para o GeoMap. Dependendo de quais IPs do Cliente são capturados, a configuração do Mapeamento de IP Geográfico pode ajudar a fornecer resultados mais precisos. |
Atributo de rastreamento e intervalo | Dimensão |
Component |
O componente que gerou o intervalo do padrão https://opentracing.io/specification/conventions/, com valores como JDBC, SERVLET e BROWSER.
|
Atributo de rastreamento e intervalo | Dimensão |
ContextRoot |
A raiz de contexto do aplicativo Web monitorado. | Atributo de rastreamento e intervalo | Dimensão |
DbConnUrl |
O URL de conexão JDBC usado para estabelecer conexão com o banco de dados. | Atributo de rastreamento e intervalo | Dimensão |
DbOracleConnectionId |
O ID de conexão Net Oracle exclusivo gerado pelo driver JDBC da Oracle para cada conexão JDBC com o banco de dados Oracle. Este atributo é suportado nos clientes Oracle JDBC 21 e mais recentes. | Atributo de rastreamento e intervalo | Dimensão |
DbErrorSqlState |
O código SQLState retornado pelo SQLException.getSQLState em cenários de erro.
|
Atributo de rastreamento e intervalo | Dimensão |
DbErrorVendorCode |
Um número que identifica o erro que causou a geração da instância SQLException.
|
Atributo de rastreamento e intervalo | Métrica |
DbOracleSessionId |
O ID da Sessão Oracle da instrução executada. | Atributo de rastreamento e intervalo | Dimensão |
DbOracleSqlId |
O ID do Oracle SQL calculado com base na instrução SQL executada. | Atributo de rastreamento e intervalo | Dimensão |
DbOracleSqlId1 |
Em execuções de instrução em batch, o ID do Oracle SQL calculado a partir da primeira instrução SQL executada. | Atributo de rastreamento e intervalo | Dimensão |
DbOracleSqlId2 |
Em execuções de instrução em batch, o ID do Oracle SQL calculado a partir da segunda instrução SQL executada. | Atributo de rastreamento e intervalo | Dimensão |
DbStatement |
O texto SQL normalizado executado pela instrução JDBC. | Atributo de rastreamento e intervalo | Dimensão |
DbStatement1 |
Em execuções de instrução em batch, o texto SQL normalizado da primeira instrução JDBC executada. | Atributo de rastreamento e intervalo | Dimensão |
DbStatement2 |
Em execuções de instrução em batch, o texto SQL normalizado da segunda instrução JDBC executada. | Atributo de rastreamento e intervalo | Dimensão |
DbStatementAdditionalFetchCount |
O número de round-trips para o banco de dados para extrair linhas adicionais do conjunto de resultados não retornadas na execução inicial do demonstrativo. | Atributo de rastreamento e intervalo | Métrica |
DbStatementAdditionalFetchTime |
O tempo (em milissegundos) gasto extraindo linhas adicionais do conjunto de resultados do banco de dados que não foram retornadas na execução da instrução inicial. | Atributo de rastreamento e intervalo | Métrica |
DbStatementExecTime |
O tempo (em milissegundos) gasto na execução da instrução inicial e retornando quaisquer linhas iniciais. | Atributo de rastreamento e intervalo | Métrica |
DbType |
O tipo do banco de dados. No momento, somente bancos de dados do tipo 'sql' são suportados. | Atributo de rastreamento e intervalo | Dimensão |
DbUser |
O usuário de conexão JDBC subjacente. | Atributo de rastreamento e intervalo | Dimensão |
DeploymentInfo |
As informações de implantação sobre o aplicativo Web monitorado. Isso pode ser exibido em dois formatos, dependendo do tipo de implantação estar disponível:
|
Atributo de rastreamento e intervalo | Dimensão |
DisplayName |
O nome de exibição do servidor do aplicativo. | Atributo de rastreamento e intervalo | Dimensão |
ECID |
O ID do Contexto de Execução Oracle. | Atributo do intervalo | Dimensão |
Error |
A propriedade de intervalo que marca um intervalo como "com falha" com o valor booliano true, no caso de um erro. Isso indica que o aplicativo considerou a operação representada pelo intervalo com falha. O valor booliano padrão é false (sem erro).
|
Atributo de rastreamento e intervalo | Dimensão |
ErrorObject |
Uma descrição legível do erro. | Atributo de rastreamento e intervalo | Dimensão |
GenAIChatHistory |
O histórico de conversas ou o contexto de interações anteriores com o modelo de IA Generativa | Atributo do intervalo | Dimensão |
GenAICompartmentId |
O identificador exclusivo do compartimento no qual a solicitação GenAI é processada. | Atributo do intervalo | Dimensão |
GenAIEmbeddingsPerSentence |
Tamanho da incorporação do vetor gerada por sentença. Específico ao modelo usado | Atributo do intervalo | Dimensão |
GenAIEmbedResponseId |
O identificador exclusivo da resposta de incorporação | Atributo do intervalo | Dimensão |
GenAIEmbedSentenceCount |
O número de frases processadas para geração de incorporação | Atributo do intervalo | Dimensão |
GenAIEmbedTruncate |
Estratégia para truncar entradas que excedem os limites do modelo (por exemplo, NONE, START) | Atributo do intervalo | Dimensão |
GenAIFinishReason |
O motivo pelo qual o modelo parou de gerar a resposta (por exemplo, limite máximo de token, sequência de interrupção) | Atributo do intervalo | Dimensão |
GenAIFrequencyPenalty |
Penaliza a repetição de palavras dependendo da frequência da ocorrência de palavras | Atributo do intervalo | Dimensão |
GenAIInputSentences |
As frases ou partes de texto reais enviadas para incorporação | Atributo do intervalo | Dimensão |
GenAIIsEcho |
Flag booliano indicando se o prompt deve ser repetido novamente na resposta | Atributo do intervalo | Dimensão |
GenAIMaxTokens |
O número máximo de tokens que o modelo pode gerar em sua resposta | Atributo do intervalo | Dimensão |
GenAIModelName |
O nome do modelo de IA Generativa que está sendo usado para a solicitação (por exemplo, cohere.command) | Atributo do intervalo | Dimensão |
GenAIModelVersion |
A versão específica do modelo de IA Generativa que está sendo usado | Atributo do intervalo | Dimensão |
GenAINumGenerations |
O número de respostas alternativas geradas para o mesmo prompt | Atributo do intervalo | Dimensão |
GenAIOpcRequestId |
ID exclusivo para rastrear a solicitação | Atributo do intervalo | Dimensão |
GenAIPresencePenalty |
Penaliza palavras após a primeira ocorrência, não leva em consideração a frequência de ocorrência | Atributo do intervalo | Dimensão |
GenAIPrompt |
O prompt formatado final enviado para o modelo, incluindo instruções do sistema, preâmbulo, entrada do usuário, documentos, informações da ferramenta etc. | Atributo do intervalo | Dimensão |
GenAIPromptLength |
A contagem total de caracteres do prompt completo | Atributo do intervalo | Dimensão |
GenAIQuery |
A consulta de entrada do usuário enviada ao modelo de IA Generativa | Atributo do intervalo | Dimensão |
GenAIQueryLength |
A contagem de caracteres da consulta de entrada do usuário | Atributo do intervalo | Dimensão |
GenAIResponse |
A resposta completa gerada pelo modelo de IA Generativa | Atributo do intervalo | Dimensão |
GenAIResponseLength |
A contagem de caracteres da resposta do modelo de IA Generativa | Atributo do intervalo | Dimensão |
GenAIResponseTimeCreated |
O timestamp quando a resposta da IA Generativa foi gerada | Atributo do intervalo | Dimensão |
GenAISearchQueriesOnly |
Se verdadeiro, retorna apenas consultas de pesquisa relevantes, não respostas completas | Atributo do intervalo | Dimensão |
GenAISeed |
Valor de seed aleatório usado para resultados de geração reproduzíveis | Atributo do intervalo | Dimensão |
GenAIStatusCode |
Código de status HTTP retornado pelo Ponto Final do Generative AI | Atributo do intervalo | Dimensão |
GenAIStopSequences |
Lista de sequências personalizadas especificadas pelo usuário que acionam o modelo para interromper a geração de texto | Atributo do intervalo | Dimensão |
GenAITemperature |
Controla a aleatoriedade nas palavras selecionadas para a resposta, menor temperatura é mais determinística | Atributo do intervalo | Dimensão |
GenAITopK |
Limita as opções de token do modelo aos principais K tokens mais prováveis com base em suas probabilidades previstas | Atributo do intervalo | Dimensão |
GenAITopP |
O modelo seleciona seu próximo token do conjunto de candidatos mais prováveis cuja probabilidade cumulativa se soma ao limite superior do p | Atributo do intervalo | Dimensão |
GenAITotalInputLength |
A contagem total de caracteres de todas as frases de entrada ou blocos de texto combinados para geração de incorporação | Atributo do intervalo | Dimensão |
GenAIUserPreamble |
Instruções personalizadas ou contexto fornecido antes da consulta principal | Atributo do intervalo | Dimensão |
HostAddress |
O endereço IPv4 foi resolvido pelo nome de host. | Atributo de rastreamento e intervalo | Dimensão |
Hostname |
O nome do host. | Atributo de rastreamento e intervalo | Dimensão |
HostnameCanonical |
O nome canônico (FQDN) do host. | Atributo de rastreamento e intervalo | Dimensão |
HostNames |
A lista de nomes de host nas interfaces de rede do host. | Atributo de rastreamento e intervalo | Dimensão |
HttpClientType |
O tipo de cliente HTTP que está sendo monitorado, por exemplo, Apache HttpClient e HttpURLConnection. | Atributo de rastreamento e intervalo | Dimensão |
HttpMethod |
O método HTTP usado na solicitação, por exemplo, GET, POST e DELETE.
|
Atributo de rastreamento e intervalo | Dimensão |
HttpRequestContentSize |
O tamanho do conteúdo da solicitação se Content-Length tiver sido definido como parte do cabeçalho da solicitação.
|
Atributo de rastreamento e intervalo | Dimensão |
HttpResponseContentSize |
O tamanho do conteúdo da resposta se Content-Length tiver sido definido como parte do cabeçalho da resposta.
|
Atributo de rastreamento e intervalo | Dimensão |
HttpStatusCode |
O código de status HTTP da resposta, por exemplo, 200, 404 ou 500.
|
Atributo de rastreamento e intervalo | Dimensão |
HttpStatusDetails |
A descrição do código de status da resposta HTTP. | Atributo de rastreamento e intervalo | Dimensão |
HttpUrl |
O URL HTTP relacionado ao intervalo. | Atributo de rastreamento e intervalo | Dimensão |
HttpUrlFragment |
O fragmento de URL HTTP relacionado ao intervalo. | Atributo de rastreamento e intervalo | Dimensão |
HttpUrlHost |
O nome do host do URL HTTP relacionado ao intervalo. | Atributo de rastreamento e intervalo | Dimensão |
HttpUrlPath |
O caminho do URL HTTP relacionado ao intervalo. | Atributo de rastreamento e intervalo | Dimensão |
HttpUrlQuery |
A consulta de URL HTTP relacionada ao intervalo. | Atributo de rastreamento e intervalo | Dimensão |
Kind |
O campo relacionado à definição de rastreamento aberto (https://opentracing.io/specification/conventions/) span.kind0. O agente do Browser pode reportar valores como CLIENT ou INTERNAL, e o agente Java e outros rastreadores podem reportar valores como SERVER para servlets e CLIENT para HttpClient e JDBC.
|
Atributo de rastreamento e intervalo | Dimensão |
NonSampledCount |
O número de intervalos raiz não amostrados anteriores com o mesmo nome de operação. | Atributo de rastreamento e intervalo | Métrica |
OciAvailabilityDomain |
O domínio do Oracle Cloud Infrastructure no qual a instância de computação está sendo executada. | Atributo de rastreamento e intervalo | Dimensão |
OciCompartmentId |
O OCID do compartimento no qual reside a instância de computação. | Atributo de rastreamento e intervalo | Dimensão |
NonSampledCount |
O número de intervalos raiz não amostrados anteriores com o mesmo nome de operação. | Atributo de rastreamento e intervalo | Métrica |
OciAvailabilityDomain |
O domínio do Oracle Cloud Infrastructure no qual a instância de computação está sendo executada. | Atributo de rastreamento e intervalo | Dimensão |
OciComputeShape |
A forma da instância de computação. | Atributo de rastreamento e intervalo | Dimensão |
OciDisplayName |
O nome para exibição da instância ou nó do serviço Kubernetes. | Atributo de rastreamento e intervalo | Dimensão |
OciFaultDomain |
O nome do domínio do Oracle Cloud Infrastructure no qual a instância de computação está sendo executada. | Atributo de rastreamento e intervalo | Dimensão |
OciInstanceId |
O OCID da instância de computação. | Atributo de rastreamento e intervalo | Dimensão |
OciRegion |
A região do Oracle Cloud Infrastructure que contém o domínio de disponibilidade em que a instância de computação está sendo executada. | Atributo de rastreamento e intervalo | Dimensão |
OpcRequestIdRequest |
O valor do cabeçalho opc-request-id definido como parte da solicitação enviada ao Oracle Cloud Infrastructure.
|
Atributo de rastreamento e intervalo | Dimensão |
OpcRequestIdResponse |
O valor do cabeçalho opc-request-id definido como parte da resposta enviada do Oracle Cloud Infrastructure.
|
Atributo de rastreamento e intervalo | Dimensão |
OperationName |
O nome do intervalo. | Atributo de rastreamento e intervalo | Dimensão |
OsAvailableProcessors |
O número de processadores disponíveis para a Java Virtual Machine (JVM). | Atributo de rastreamento e intervalo | Métrica |
OsFamily |
A família do Sistema Operacional derivada do agente do usuário. Por exemplo, Linux. | Atributo de rastreamento e intervalo | Dimensão |
OsName |
O nome do Sistema Operacional. | Atributo de rastreamento e intervalo | Dimensão |
OsVersion |
A versão do Sistema Operacional. | Atributo de rastreamento e intervalo | Dimensão |
ProcessId |
O ID do processo do servidor do aplicativo. | Atributo de rastreamento e intervalo | Métrica |
RequestPayload |
O corpo do payload da solicitação capturado como parte da solicitação. O payload da solicitação pode ser filtrado para exibir apenas informações úteis usando uma combinação de xpath, jsonpath ou regex. Para obter mais detalhes, verifique o arquivo ProbeConfig.acml.
|
Atributo de rastreamento e intervalo | Dimensão |
ResponsePayload |
O corpo do payload de resposta capturado como parte da resposta. O payload de resposta pode ser filtrado para exibir apenas informações úteis usando uma combinação de xpath, jsonpath ou regex. Para obter mais detalhes, verifique o arquivo ProbeConfig.acml.
|
Atributo de rastreamento e intervalo | Dimensão |
ServletContainerSpecification |
A versão da especificação do Servlet na qual o aplicativo representado por este ServletContext se baseia.
|
Atributo de rastreamento e intervalo | Dimensão |
ServletSpecification |
A versão da API do Servlet que este contêiner de servlet suporta. | Atributo de rastreamento e intervalo | Dimensão |
ServiceInstanceId |
O ID do observador do agente. | Atributo de rastreamento e intervalo | Dimensão |
ServiceName |
O nome que você designou ao serviço. | Atributo de rastreamento e intervalo | Dimensão |
SessionId |
O identificador exclusivo da sessão ou do navegador. | Atributo de rastreamento e intervalo | Dimensão |
SoaTaskAssigneeUsers
|
Lista de Nomes de Usuário dos usuários aos quais esta tarefa foi atribuída.
Para ver essa dimensão, você precisa definir Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskCompletionDuration
|
A hora em milissegundos a partir da qual a tarefa é iniciada até a conclusão.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskName
|
O nome da Tarefa.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskNumber |
O número da tarefa visto na coluna Number do BPM Worklist.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskOutcome |
O resultado da tarefa quando concluída.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskRequester |
O nome de usuário do solicitante da tarefa.
Para ver essa dimensão, você precisa definir Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskState |
O estado da tarefa.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaTaskSubstate |
O substrato da tarefa, se disponível.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SoaWorkflowNumber |
O número do workflow.
Este atributo está presente ao usar o Oracle SOA Human Workflow. |
Atributo do intervalo | Dimensão |
SpanID |
O identificador exclusivo de cada intervalo. | Atributo do intervalo | Dimensão |
StartTime |
O horário de início do intervalo. | Atributo do intervalo | Métrica |
Subcomponent |
O subcomponente que gerou o intervalo. | Atributo de Intervalo | Dimensão |
ThreadAllocatedMemory |
A aproximação da quantidade total de memória em bytes alocada na memória heap para o intervalo do Servlet associado. Essas informações são obtidas do ThreadMXBean e capturadas por padrão.
O comportamento padrão pode ser desativado usando o arquivo ProbeConfig.acml do Agente Java do APM. (Consulte o parâmetro |
Atributo do intervalo | Dimensão |
ThreadCpuTime |
O tempo total de CPU para o intervalo de Servlet associado em milissegundos. Essas informações são obtidas do ThreadMXBean e capturadas por padrão.
O comportamento padrão pode ser desativado usando o arquivo ProbeConfig.acml do Agente Java do APM. (Consulte o parâmetro |
Atributo do intervalo | Dimensão |
ThreadId |
O ID do thread em que o intervalo foi iniciado. | Atributo do intervalo | Métrica |
ThreadIdEnd |
O ID do thread no qual o intervalo terminou. | Atributo do intervalo | Métrica |
ThreadName |
O nome do thread no qual o intervalo foi iniciado. | Atributo do intervalo | Dimensão |
ThreadNameEnd |
O nome do thread no qual o intervalo terminou. | Atributo do intervalo | Dimensão |
UserName |
O nome do usuário final que usa o sistema ou um identificador que identifica exclusivamente o usuário.
Para obter informações sobre as opções de captura e configuração do nome de usuário, consulte Modificar ou Desativar Definições de Sondagem Padrão. |
Atributo de rastreamento e intervalo | Dimensão |
VmName |
O nome da máquina virtual. | Atributo de rastreamento e intervalo | Dimensão |
VmVendor |
O fornecedor da máquina virtual. | Atributo de rastreamento e intervalo | Dimensão |
VmVersion |
A versão da máquina virtual. | Atributo de rastreamento e intervalo | Dimensão |
WorkingDirectory |
O diretório de trabalho do servidor do aplicativo. | Atributo de rastreamento e intervalo | Dimensão |