Documentação do Oracle Cloud Infrastructure

Definir Dimensão do Recurso

Depois que o agente Java do APM for implantado, você poderá definir a dimensão de recurso de 2 formas diferentes:

Definição de Recurso Simplificada

A dimensão de recurso simplificada pode ser definida com propriedades do par chave/valor.

A chave da propriedade deve começar com com.oracle.apm.agent.resource.tag.

A tabela a seguir mostra diferentes maneiras de definir a dimensão de recurso da forma simplificada:

Tipo e Descrição de Propriedades Suportado por Property Exemplo

AgentConfig.properties

Atualiza o arquivo AgentConfig.properties localizado no diretório oracle-apm-agent/config/<version>.

Agente do APM com.oracle.apm.agent.resource.tag.<ResourceName> com.oracle.apm.agent.resource.tag.MyDepartment=Sales

Propriedades do Sistema

Atualiza as propriedades do sistema.

 Agente do APM e Rastreador do APM com.oracle.apm.agent.resource.tag.<ResourceName>

-Dcom.oracle.apm.agent.resource.tag.MyDepartment=Sales

-Dcom.oracle.apm.agent.resource.tag.MyUser=${USERNAME}

-Dcom.oracle.apm.agent.resource.tag.MyAppVersion=${com.mycompany.myapp.version}

Variáveis de Ambiente

Atualiza as variáveis de ambiente.

 Agente do APM e Rastreador do APM com_oracle_apm_agent_resource.tag_<ResourceName>
Para Windows: 
set com_oracle_apm_agent_resource_tag_MyDepartment=Sales
set com.oracle.apm.agent.resource.tag.MyUser=${USERNAME}
Para Linux: 
export com_oracle_apm_agent_resource_tag_MyDepartment=Sales

Construtor de Rastreamento

 Rastreador do APM com.oracle.apm.agent.resource.tag.<ResourceName> 
new ApmTracer.Builder(...)
    ...
    .withProperty("com.oracle.apm.agent.resource.tag.MyDepartment", "Sales")
    .withProperty("com.oracle.apm.agent.resource.tag.MyUser", "${USERNAME}")
    ...
    .build();

O valor da propriedade do recurso pode ser um texto estático e/ou uma variável entre os símbolos ${ e }.

Um ou mais itens a seguir são aceitos como um valor de dimensão de recurso:
  • Qualquer texto.
  • Chave das propriedades do sistema Java entre os símbolos ${ e }.
  • Chave das variáveis de ambiente delimitada pelos símbolos ${ e }. Por exemplo:
    ${USERNAME}

Definição de Recurso Abrangente

A dimensão de recurso do servidor de aplicativos personalizado pode ser definida para atender a requisitos específicos.

Para definir uma dimensão de recurso do servidor de aplicativos personalizado, crie um novo arquivo de configuração chamado ResourceCollection.acml no diretório oracle-apm-agent/config/<version>.

O arquivo ResourceCollection.acml não é criado pela implantação do Agente do APM e deve ser criado manualmente.

O formato de ResourceCollection.acml é um formato ACML personalizado (subconjunto de YAML).

Tag ACML Tipos de Dados Obrigatório Descrição
RECURSO:   sim Cabeçalho da coleta de recursos.
<resource_entry_name>: string sim Nome do recurso de relatório.
propriedade: <chave de propriedade> string sim Chave da propriedade APM do recurso.

Esta é a chave de propriedade deste valor de recurso. Ele também é usado por outros recursos para resolução de variável.

tipo: <tipo de recurso> string sim Tipo desta propriedade.
escalar: <resource escalar> string sim Tipo de valor do recurso.

Os valores suportados são string, longa ou dupla.
identidade: <resource as identity> booliano Não O indicador indica se este recurso é usado para o cálculo de identidade do appserver.

Qualquer recurso com valor não nulo é usado para o cálculo da dimensão appserverId.

prioridade: <prioridade da coleta> inteiro não assinado Não Número inteiro positivo para indicar a prioridade de coleta de recursos. 0 (zero) é a prioridade mais alta. O recurso personalizado sempre deve definir esse valor como 0.
padrão: <valor padrão> string Não Valor padrão do recurso quando nenhuma das origens especificadas retorna um valor não nulo.
origem: Não aplicável sim Nó de matriz das origens deste recurso.

Um ou mais elementos filho podem ser definidos para esta matriz de origem. Cada elemento é avaliado na ordem definida, e o primeiro com valor não nulo é usado.

Se nenhuma avaliação de elemento retornar valor não nulo, esse recurso será ignorado.
- tipo: mbean string Não Colete metadados de recursos do mbean JMX. Vários podem ser definidos para cada recurso.
mbean_name: <nome do objeto bean> string Não O mbean_name é o ObjectName do mbean.
value_path: <caminho de seleção de valor> string Não

value_path é o caminho de seleção delimitado por barra que começa no mbean especificado.

O primeiro nó de caminho é o atributo do mbean e, em seguida, o valor do atributo é avaliado com cada nó de caminho sucessivo.

A avaliação oferece suporte ao seguinte

  • Atributo MBean
  • ObjectName
  • Nome do campo de objeto Java
  • nome do método no-arg do objeto java
  • Chave de CompositeData
  • Chave de TubularData
  • Índice de array
  • Chave do Mapa
  • Índice de Coleta
<parse de recgex> string Não

O valor de recurso selecionado pode ser processado ainda mais usando tags de parsing de regex. Consulte Parsing de Regex para obter mais informações.

tipo: propriedade string Não Valor de recurso da propriedade do sistema ou da variável de ambiente. Vários podem ser definidos para cada recurso.
chave: <chave da propriedade> string Não O nome da chave da propriedade do sistema ou da variável de ambiente.
- tipo: valor string Não O valor estático. No máximo um deve ser definido em cada recurso porque esse valor nunca é nulo.
valor: <valor estático e/ou variável> string Não O valor pode ser um ou mais dos seguintes:
  • String fixa.
  • Propriedade do sistema.
  • Variável de ambiente.
  • Propriedade do recurso.

As chaves de propriedades contêm os símbolos ${ e } que serão resolvidos no runtime em um valor de chave especificada. Se a chave de propriedade especificada não for encontrada, o valor desse recurso conterá a chave não resolvida incluindo os símbolos ${ e }.

<parse de recgex> string Não O valor de recurso selecionado pode ser processado ainda mais usando tags de parsing de regex. Consulte Parsing de Regex para obter mais informações.

Análise Regex

O parsing de Regex são tags adicionais do nó de origem para extrair o valor específico do recurso com a expressão regular. Para obter detalhes da sintaxe, consulte abaixo:

Tag Tipo Básico Descrição
regex: <regex:: string Uma expressão regular em relação ao valor do recurso com a construção do grupo.
<parse de recgex> inteiro não assinado Um número de grupo de regex. O valor do grupo especificado é o valor do recurso final.