• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

Java 에이전트 7.x에서 8.x로 마이그레이션 가이드

이 가이드에서는 Java 에이전트 7.x와 8.x 시리즈 간의 주요 변경 사항을 다룹니다. 업그레이드하는 동안 발생할 수 있는 문제와 버전 8.x로 성공적으로 마이그레이션하는 방법을 다룹니다. 주요 변경 사항은 다음과 같습니다.

중요

버전 8.0-8.7에서 제거된 속성이 8.8.0에 다시 도입되었습니다. 이는 또는 대시보드에 해당 속성을 계속 사용하는 고객에게 이전 버전과의 호환성을 제공합니다.

트랜잭션 및 범위 속성 변경 및 제거

APM 에이전트 전반에 걸쳐 일관성을 제공하고 업계 표준에 더 잘 부합하기 위해 우리는 저항 에이전트의 프로세서 및 범위 속성을 변경했습니다. 배터리 에이전트 버전 7.6.0부터, 새로운 표준 속성 http.statusCodehttp.statusText 도입하고 httpResponseCode, response.statusresponse.statusMessage 를 더 이상 사용되지 않는 것으로 표시했습니다.

더 이상 사용되지 않는 속성새로운 속성데이터 유형 변경
httpResponseCodehttp.statusCodeString to INT
response.statushttp.statusCodeString to INT
response.statusMessagehttp.statusTextN/A

권장 조치

  • 더 이상 사용되지 않는 속성을 사용하는 경고 또는 대시보드가 있고 에이전트 버전 8.0 - 8.7을 사용하는 경우 에이전트를 8.8로 업데이트하거나 제거된 속성에 대한 참조를 업데이트해야 합니다. 모든 경고 또는 대시보드를 새 표준 속성으로 업데이트한 경우 호환성 플래그를 비활성화하여 새 표준 속성만 사용할 수 있습니다. 호환성 플래그 설정에 대해 알아보려면 http_attribute_mode 구성을 참조하세요.
  • 더 이상 사용되지 않는 속성을 사용하는 경고 및 대시보드를 업데이트합니다.

영향을 받은 경고 쿼리 찾기

영향을 받은 알림을 찾아 수정하려면 다음 안내를 따르세요.

  1. NerdGraph Explorer를 사용하고 찾고 있는 각 속성에 대해 queryLike 연산자를 사용하여 경고를 검색하세요. 예를 들어:

    {
    actor {
    user {
    name
    }
    account(id: <ACCOUNTID>) {
    alerts {
    nrqlConditionsSearch(searchCriteria: {queryLike: "httpResponseCode"}) {
    nrqlConditions {
    nrql {
    query
    }
    id
    name
    policyId
    }
    }
    }
    }
    }
    }
  2. 반환된 각 공지에 대해 Alerts> Alerts Conditions UI 의 ID나 이름을 사용하여 공지를 찾을 수 있습니다.

  3. 경고 조건과 신호 적용 범위를 검토하여 경고에 미치는 영향을 확인하세요.

  4. NRQL 문을 업데이트하려면 영향을 받은 경고 및 대시보드 NRQL 문 수정 의 지침을 사용하세요.

영향을 받은 대시보드 쿼리 찾기

대시보드에 대해 영향을 받는 쿼리를 찾으려면 다음을 수행합니다.

  1. NerdGraph Explorer와 대시보드의 메타데이터에 있는 엔터티 GUID를 사용하면 대시보드에 대한 모든 NRQL 쿼리를 얻을 수 있습니다.

    {
    actor {
    entity(guid: "[ENTITY GUID]") {
    ... on DashboardEntity {
    guid
    name
    pages {
    widgets {
    rawConfiguration
    }
    }
    }
    }
    }
    }
  2. NRQL 쿼리는 rawConfiguration 항목으로 반환됩니다. 텍스트 검색을 사용하여 제거된 속성을 찾을 수 있습니다.

  3. NRQL 문을 업데이트하려면 영향을 받은 경고 및 대시보드 NRQL 문 수정 의 지침을 사용하세요.

다음 쿼리를 사용하여 모든 대시보드에 대한 엔터티 GUID 목록을 가져올 수도 있습니다.

{
actor {
entitySearch(query: "domain IN ('VIZ')") {
results {
entities {
guid
accountId
}
}
}
}
}

영향을 받은 경고 및 대시보드 NRQL 문 수정

http.statusCode 데이터 유형도 다른 httpResponseCode 또는 response.status 에 대한 참조를 대체합니다. 이전에는 다음과 같은 참조를 사용했습니다.

[...] WHERE (Numeric(response.status)\>399 [...]

문자열 데이터 유형을 숫자로 변환합니다. 더 이상 이 작업을 수행할 필요가 없으며 대신 다음과 같은 간단한 숫자 연산을 사용할 수 있습니다.

[...] WHERE (http.statusCode \>399) [...]

http.statusText response.statusMessage 에 대한 참조를 대체합니다. 이 속성의 데이터 유형은 변경되지 않았습니다.

계측이 제거됨

해당 유지 관리 담당자가 더 이상 지원하지 않는 라이브러리 버전에 대해 다음 계측 모델을 제거했습니다.

  • 카산드라-datastax-2.1.2
  • http클라이언트-3.0
  • jdbc-임베디드-더비-10.2.1.6
  • jdbc-임베디드-더비-10.10.1.1
  • 부두-7
  • 부두-7.6
  • 부두-9
  • 부두-9.0.4
  • 부두-9.1
  • 몽고디비-2.12
  • 몽고디비-2.14
  • 몽고디비-3.0
  • khttp-3.0.0
  • khttp-3.4.0
  • khttp-3.5.0

애플리케이션이 라이브러리 중 하나를 사용하는 경우 Java 에이전트 버전 v8.x로 업데이트할 때 해당 라이브러리에 대한 계측에서 생성된 메트릭과 트랜잭션을 더 이상 수신하지 않습니다.

권장 조치

가능하다면 영향을 받는 라이브러리를 관리자와 New Relic이 지원하는 버전으로 업데이트하고 에이전트를 업데이트하세요. EOL된 라이브러리를 업데이트할 수 없는 경우에도 에이전트를 업데이트할 수 있지만 제거된 데이터로 인해 중요한 영역에 공백이 발생하는지 확인하기 위해 에이전트를 테스트하고 검토하는 것이 좋습니다.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.