Nomeação automática de aplicativos

Os nomes que você dá ao seu aplicativo podem ajudar a organizar sua métrica de desempenho do New Relic.

O agente Java da New Relic relata todas as transações e outras métricas em uma única JVM para o nome do aplicativo especificado em newrelic.yml na configuração app_name (para obter mais informações sobre a nomenclatura do aplicativo, consulte Nomeie seu aplicativo Java). Ao alterar enable_auto_app_naming em newrelic.yml para true, o aplicativo será nomeado de acordo com seu contexto, filtro, servlet ou atributo de solicitação.

Essa configuração permite que você execute vários aplicativos da web em uma única JVM enquanto reporta transações, erros e métricas para outro aplicativo apropriado na interface do usuário do New Relic. As tarefas em segundo plano ainda usarão o nome do aplicativo padrão de newrelic.yml.

Fontes de nomes de aplicativos

Quando você define enable_auto_app_naming como true, o New Relic usa as seguintes fontes de informações para nomear seu aplicativo:

Solicitar atributo

O atributo de solicitação APPLICATION_NAME tem precedência sobre quaisquer configurações no XML. Defina esse atributo o mais cedo possível na transação da web. Se for chamada diversas vezes, a última invocação determinará o nome do aplicativo.

Para usar o atributo request para nomenclatura refinada do aplicativo com base no URI da solicitação:

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  ...
  String requestUri = httpServletRequest.getRequestURI();

  if (requestUri.startsWith("/my-special-request/")) {
      request.setAttribute("com.newrelic.agent.APPLICATION_NAME", "MySpecialWebApp");
  }
  ...

Parâmetro de inicialização do servlet

Para configurar o nome do aplicativo para servlets individuais em web.xml usando init parameters:

<servlet>
  <servlet-name>SqlServlet</servlet-name>
  <servlet-class>test.SqlServlet</servlet-class>
  <init-param>
    <param-name>com.newrelic.agent.APPLICATION_NAME</param-name>
    <param-value>MyServletApp</param-value>
  </init-param>
</servlet>

O agente obtém o valor de init-param chamando

javax.servlet.ServletConfig#getInitParameter(String)

com o argumento com.newrelic.agent.APPLICATION_NAME.

Se uma solicitação da web chamar vários servlets, o init-param do primeiro servlet a terminar terá precedência. Um servlet que não possui init-param usa o nome do aplicativo padrão para o aplicativo da web.

Além de declarar o nome do aplicativo em XML, você também pode defini-lo no código do seu aplicativo armazenando um atributo no javax.servlet.ServletRequest:

protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
  ...
  request.setAttribute("com.newrelic.agent.APPLICATION_NAME", "MyWebApp");
  ...

Parâmetro de inicialização do filtro

Se seu aplicativo web não tiver servlets, você poderá usar um parâmetro init para um filtro:

<filter>
  <filter-name>SqlFilter</filter-name>
  <filter-class>test.SqlFilter</filter-class>
  <init-param>
    <param-name>com.newrelic.agent.APPLICATION_NAME</param-name>
    <param-value>MyFilterApp</param-value>
  </init-param>
</filter>

O agente obtém o valor de init-param chamando javax.servlet.FilterConfig#getInitParameter(String) com o argumento com.newrelic.agent.APPLICATION_NAME. Os servlets têm precedência sobre os filtros para nomenclatura de aplicativos, portanto, o parâmetro init de um filtro será usado somente se nenhum servlet tiver sido chamado. O init-param do primeiro filtro a terminar tem precedência.

Parâmetro de contexto

Para usar um parâmetro de contexto para definir o nome do aplicativo:

<context-param>
  <param-name>com.newrelic.agent.APPLICATION_NAME</param-name>
  <param-value>MyWebApp</param-value>
</context-param>

O agente obtém o valor do parâmetro de contexto chamando javax.servlet.ServletContext#getInitParameter(String) com o argumento com.newrelic.agent.APPLICATION_NAME. O parâmetro de contexto tem precedência sobre o elemento display-name .

Nome de exibição

Para determinar o nome do aplicativo usando o elemento display-name em web.xml:

<display-name>MyWebApp</display-name>

O agente obtém o valor do elemento display-name chamando javax.servlet.ServletContext#getServletContextName().

Caminho de contexto

Se não houver nenhum elemento display-name e nenhum dos outros métodos de hierarquia superior for usado para definir o nome do aplicativo, o nome do aplicativo virá do caminho de contexto do aplicativo da web. O agente obtém o caminho do contexto chamando javax.servlet.ServletContext#getContextPath().

O caminho do contexto é a parte do URI da solicitação usada para selecionar o contexto da solicitação. O caminho do contexto sempre vem primeiro em um URI de solicitação. Por exemplo:

Considere o seguinte URL:

http://example.com/newrelic-axis2-ws/getWeather

Neste URL:

• O URI da solicitação é /newrelic-axis2-ws/getWeather.
• O caminho do contexto é /newrelic-axis2-ws.
• O aplicativo é denominado newrelic-axis2-ws.