O agente Java atribui automaticamente um nome host:port
às suas JVMs. Se o nome padrão não for útil, você poderá definir um nome de exibição para distinguir suas JVMs na interface do New Relic. Para estrutura suportada, o agente Java usa o nome da instância em vez do nome de exibição.
O agente Java identifica exclusivamente o agente em execução por seu host, porta e despachante, independentemente do ambiente usado.
Nomes de exibição
Se o rótulo host:port
padrão na interface do APM não for útil, você poderá decorar esse nome na interface do New Relic com um nome de exibição. Defina o nome de exibição por meio de configuração, em uma variável de ambiente ou em seu arquivo de configuração newrelic.yml . A variável de ambiente tem precedência sobre o valor do arquivo de configuração. Depois que a JVM for reiniciada e o agente Java reportar novamente, o nome de exibição será exibido na lista da JVM, conforme visto no exemplo abaixo, além de host:port
.
Para definir um nome de exibição:
Defina a variável de ambiente
NEW_RELIC_PROCESS_HOST_DISPLAY_NAME
.
OUDefina
process_host.display_name
em seunewrelic.yml
.
Reinicie sua JVM para ver suas alterações na interface do New Relic.
Dica
Você também pode definir o nome de exibição com uma propriedade do sistema.
Nomes de instância
Para o usuário WebSphere e WebLogic, o agente Java também relata o nome da instância para cada instância ativa do servidor de aplicativos, que é visível na página Settings > Environment do APM. Geralmente, esse nome é fornecido pelo servidor de aplicativos. Se um nome de instância for definido, ele será usado em vez do nome de exibição na interface do New Relic.
Precedência lógica do nome do host
Se houver diversas configurações de nome do host (por exemplo, você usa o WebSphere e também define a propriedade display_name
), o agente usa esta precedência:
display_name
substitui o nome padrão e os nomes de instância do WebSphere e WebLogic.- Os nomes de instância do WebSphere e WebLogic substituem o nome padrão.
- O nome padrão (
host:port
) tem precedência mais baixa.
Hosts e identificador de agente exclusivo
O agente Java usa hosts, portas e despachantes para identificar exclusivamente diversas JVMs que se reportam ao mesmo nome de aplicativo. Vários agentes em execução no mesmo servidor são, portanto, relatados separadamente, desde que suas portas ou nomes de despachantes sejam diferentes.
O identificador exclusivo é baseado nos seguintes valores:
Host
: um identificador para o servidor pai do seu aplicativo derivado do sistema operacional. Este valor não é configurável pelo agente Java.
Port
: a porta associada ao servidor de aplicativos. Se o agente não conseguir determinar o número da porta ou se seu aplicativo não estiver em execução em um servidor de aplicativos, o padrão será
0
. Este valor é configurável pelo usuário.
Dispatcher Name
: o nome do servidor de aplicativos. Por exemplo, Apache Tomcat, Glassfish ou WebLogic. Se não houver nenhum servidor de aplicativos ativo, o padrão será
Unknown
.