변경 추적 기능을 사용하면 애플리케이션과 인프라 전반의 변경 사항을 캡처, 시각화하고 분석할 수 있습니다. 이 기능은 변경 사항이 시스템과 고객에게 어떤 영향을 미치는지 이해하는 데 도움이 되도록 설계되었습니다.
시스템에 영향을 미치는 모든 변경 사항을 캡처합니다. 기능 플래그 변경, 설정 변경, 비즈니스 이벤트 등 모든 유형의 변경에 대해 변경 이벤트를 보냅니다. 또한, 특정 요구 사항에 맞춰 사용자 정의 변경 이벤트를 만들 수도 있습니다. changeTrackingCreateEvent NerdGraph 뮤테이션을 사용하면 다양한 유형의 변경 이벤트를 쉽게 보낼 수 있습니다.
시스템 전체의 변경 사항을 관리하기 위한 포괄적인 보기를 확보하세요. 하나의 통합 인터페이스에서 모든 논문과 계정의 변경 사항을 원활하게 보고 필터링하세요. 팀, 유형, 사용자 정의 속성 및 기타 기준으로 필터링하여 변경 사항을 손쉽게 식별하세요.
텔레메트리를 통해 변화를 빠르게 연관시켜 근본 원인 발견을 가속화하세요. 시계열 데이터와 함께 변화를 시각화하여 변화의 영향에 대한 이해를 높이세요. 근본 원인을 더 빨리 찾으려면 관련 지표와 함께 변경 이벤트를 표시하는 시계열 쿼리를 추가하여 명확한 상관 관계를 얻을 수 있습니다.
포괄적인 메모 데이터로 변경 이벤트를 강화하세요. 사용자 정의 속성, 카테고리 및 유형을 사용하여 변경 사항에 대해 필요한 모든 정보를 추적하세요. 철저한 시스템 명확성을 위해 필요한 모든 세부 사항을 포함하도록 변경 이벤트를 맞춤화하세요.
모든 페이지의 Change Tracking 에는 액세스 권한이 있는 모든 및 계정에 대한 변경 사항이 표시됩니다. 다음 두 구성 요소에서 이러한 이벤트를 볼 수 있습니다.
변경 이벤트 표: 이 표는 접근 가능한 계정의 변경 이벤트를 나열합니다. 표의 각 이벤트는 시계열 차트에도 표시됩니다.
목록을 세분화하려면 이벤트 속성 및 분리 태그가 포함된 필터 표시줄을 사용하세요.
타임 피커를 사용하거나 차트에서 직접 선택 항목을 클릭하고 드래그하여 표시되는 시간 범위를 조정합니다.
변경 이벤트 시계열 차트: NRQL 쿼리를 실행하고 변경 이벤트가 중첩된 이 차트에서 결과를 확인합니다. 이 시각화는 계정 전반의 특정 시스템 변경 사항과 데이터 추세(급등이나 급락 등)를 연관시키는 데 도움이 됩니다.
팁
차트와 표는 각각 최대 1,000개의 이벤트를 표시할 수 있습니다. 현재 필터와 시간 범위로 인해 이벤트가 1,000개가 넘는 경우 가장 최근 이벤트 1,000개만 표시됩니다. 좀 더 구체적인 이벤트 집합(1,000개 미만)을 보려면 더 제한적인 필터를 적용하거나 더 짧은 시간 범위를 선택하세요.
/* <table> <thead> <tr> <th></th> <th></th> </tr> </thead> <tbody> <tr> <td>변경 이벤트 테이블</td> <td> 변경 추적 페이지의 변경 이벤트 테이블은 액세스 가능한 모든 계정에 대한 변경 사항을 보여줍니다. 각 이벤트는 시계열 차트에 표시됩니다. 필터 표시줄을 사용하여 이벤트 속성 및 태그 태그별로 목록을 세분화합니다. 표시되는 이벤트 수를 수정하려면 타임 피커로 시간 범위를 조정하세요.</td> </tr> <tr> <td>변경 이벤트 시계열 차트</td> <td>시계열 차트를 사용하면 유효한 <DNT>NRQL</DNT> 쿼리를 실행하고 결과에 변경 이벤트를 오버레이할 수 있습니다. 이 기능은 모든 계정의 변경 이벤트와 차트 데이터의 급증을 연관시키는 데 도움이 됩니다.</td> </tr> </tbody> </table> */
변경 추적 범위 보기
부분 범위의 Change Tracking 보기는 APM, 브라우저 또는 모바일과 같은 특정 부분에 대한 변경 이벤트를 표시합니다. 또한 각 변경 이벤트에 대한 골든 아이콘과 관련된 추가 정보도 제공합니다.
dataHandlingRules 속성 내에서 validationFlags 필드를 ALLOW_CUSTOM_CATEGORY_OR_TYPE 로 설정합니다.
type
문자열
type 속성은 변경 이벤트에 대한 추가적인 구분을 제공하며, 종종 category 과 함께 사용됩니다. 예를 들어, 이벤트의 categoryDeployment 인 경우 해당 유형은 Rolling 일 수 있습니다.
일반적으로 표준 category 과 연관된 미리 정의된 표준 type 을 사용하거나 사용자 정의 type 정의할 수 있습니다. 사용자 정의 유형을 정의하는 경우 다음 사항도 수행해야 합니다.
dataHandlingRules 속성을 구성합니다.
validationFlags 속성을 ALLOW_CUSTOM_CATEGORY_OR_TYPE 로 설정합니다.
version
문자열
category
속성이
Deployment
로 설정된 경우
categoryFields
속성 내에서
deployment
필드를 정의하고 이
deployment
필드에
version
포함되어 있는지 확인해야 합니다.
featureFlagId
문자열
categoryFields
속성에서
Feature flag
카테고리로 선택하는 경우
featureFlag
도 선택하고
featureFlagId
을 포함해야 합니다. 이
id
기능 플래그를 식별하는 데 사용할 수 있는 문자열입니다.
dataHandlingRules
문자열
사용자 지정 category, type 또는 category 와 type 의 비표준 조합을 정의하는 경우 dataHandlingRules 속성을 구성해야 합니다. 이 작업은 validationFlags 속성을 ALLOW_CUSTOM_CATEGORY_OR_TYPE 으로 설정하는 것과 결합됩니다.
이러한 사용자 지정 또는 비표준 값을 사용할 때 validationFlagsALLOW_CUSTOM_CATEGORY_OR_TYPE 로 설정되지 않으면 category 또는 type 값이 미리 정의된 표준 값과 정확히 일치하지 않으면 뉴렐릭은 오류를 반환합니다. 예를 들어, Deployment 와 같은 표준 category 사용하더라도 뉴렐릭 표준 조합이 아닌 Rainbow 과 같은 custom 유형과 페어링하려면 validationFlagsALLOW_CUSTOM_CATEGORY_OR_TYPE 로 설정하고 dataHandlingRules 구성해야 합니다.
팁
validationFlagsALLOW_CUSTOM_CATEGORY_OR_TYPE 로 설정된 경우 사용자 지정 category 또는 type 속성에 제공하는 문자열 값이 뉴렐릭 UI 에서 표시하려는 정확한 대소문자를 사용하는지 확인하세요.
entitySearchquery
문자열
부품 검색 속성을 사용하면 뉴렐릭 내에서 특정 항목을 찾을 수 있습니다. 해당 내용을 사용하여 검색할 수 있습니다. GUID 또는 entityGuid 알 수 없는 경우 다른 식별 정보를 제공하여 검색할 수 있습니다. entityGuid 은(는) 뉴렐릭이 측정, 축소 또는 설정 중에 분량 또는 마이크로서비스와 같은 시스템 구성 요소에 할당하는 고유한 항목입니다. 부분에 대한 자세한 내용은 뉴렐릭 부분을 참조하세요.
쿼리 특정: id 및 name 포함하여 다양한 속성에 대해 정확하거나 모호한 일치 항목을 검색할 수 있지만, 쿼리는 정확히 하나로 해결될 만큼 구체적이어야 합니다..
지원되는 연산자: =, AND, IN 및 LIKE 은 검색 쿼리에 지원되는 연산자입니다.
특수 문자 사용: (, ., ,, ;, :, *,-, _, ) 과 같은 특수 문자는 쿼리 문자열에서 공백으로 처리됩니다. 예를 들어, name LIKE ':aws:' 같은 쿼리는 -aws 또는 foo.aws 포함하는 모임 이름과 일치합니다.
태그: 역따옴표가 있거나 없는 태그를 참조할 수 있습니다. 기본 properties 및 tags 기준으로 필터링할 수 있습니다.
기본적으로 properties:
id
accountId
name
domainId
alertSeverity
reporting
indexedAt
firstIndexedAt
lastReportingChangeAt
Tags: 태그는 일반적으로 보다 구체적인 domainType 또는 domainTypes 그룹에 연결된 메타데이터입니다. 예를 들어:
language: APM 애플리케이션에 대한 에이전트 언어를 지정합니다.
clusterAgentId: 브라우저 기능의 경우 이 태그는 관련 APM 기능의 클러스터 에이전트로 연결됩니다.
aws.accountId: AWS 의 분리 모니터용 AWS account ID.
예:
GUID로 단어를 찾으려면: "id = '<entity guid>'"
REST v2 API 기능 ID를 사용하여 부품을 찾으려면 다음을 수행하세요. "domainId = '<app id>' AND domain = 'APM'"
OpenTelemetry 서비스를 찾으려면: "name = '<service name>' AND domain = 'EXT' AND type = 'SERVICE' AND accountId = '<account id>'"
추적 중인 변경 내용에 컨텍스트를 추가하기 위해 몇 가지 선택적이고 유용한 속성을 정의할 수 있습니다. 이러한 특성은 특정 변경 내용 추적 기능을 활성화할 수도 있습니다.
매개변수
데이터 유형
설명
description
문자열
변경 추적 이벤트에 대한 설명입니다. 예를 들어:
A change event to track the marketing campaign impact.
groupId
문자열
groupId 속성을 사용하면 하나 이상의 저장소에서 관련 변경 사항을 구성할 수 있습니다. 관련된 각 변경 사항에 대해 동일한 groupId 사용하면 뉴렐릭 인터페이스에서 이러한 변경 사항을 함께 쉽게 보거나 쿼리 결과를 구체화할 수 있습니다. 동일한 groupId 사용하여 기존 그룹에 변경 사항을 추가할 수도 있습니다.
팁
뉴렐릭은 하나 이상의 설명서에 여러 업데이트를 적용하거나 시스템 전체에서 다양한 변경 사항을 구현할 때 groupId 속성을 사용하는 것을 권장합니다.
shortDescription
문자열
각 변경 사항에 대한 간략한 설명을 통해 해당 변경 사항을 빠르게 식별할 수 있습니다. 비워 두면 ㅇ, ㅇ, ㅇ, ㅇ 등이 포함된 자동 생성 설명이 생성됩니다. 간략한 설명은 다음 영역에 나타납니다.
차트에서 변경 마커 위에 마우스를 올리면 마커 플래그 에 도구 설명이 표시됩니다.
Activity stream [활동 스트림] 패널에서.
user
문자열
사용자 식별 또는 유효한 이메일 주소. 예를 들어, 사용자:
datanerd@example.com
.
changelog
문자열
category
이
Deployment
로 설정된 경우 선택적으로
changelog
정보를 포함할 수 있습니다.
commit
문자열
category
이
Deployment
로 설정된 경우 선택적으로
commit SHA
과 같은
commit
정보를 포함할 수 있습니다.
deepLink
문자열
category
이
Deployment
로 설정된 경우 선택적으로 URL과 같은
deepLink
포함할 수 있습니다.
뉴렐릭은 timestamp 및 changeTrackingId 속성을 자동으로 설정합니다. timestamp 값을 수정할 수 있습니다. 그러나 changeTrackingId 은 고유해야 하며 항상 뉴렐릭에 의해 생성됩니다.
매개변수
데이터 유형
설명
타임스탬프
EpochMilliseconds
timestamp 속성은 NerdGraph 호출이 수신된 시점을 보여줍니다. Unix epoch 이후의 밀리초 수를 지정하여 이를 수정할 수 있습니다. 예를 들어: timestamp: 1032480000000.
중요
NerdGraph 호출이 이루어질 때 타임스탬프는 현재 시간으로부터 +/- 24시간 이내에 적용되어야 하며, 그렇지 않으면 페이로드가 거부됩니다.
changeTrackingId
문자열
changeTrackingId 은 변경 사항이 기록될 때 생성되는 고유 식별자입니다. NerdGraph 및 NRQL 쿼리에서 이 ID를 사용하여 특정 변경 사항을 식별할 수 있습니다. 예를 들어: changeTrackingId: "8a3a594c-e726-4bc2-8078-26dffec9a3d8".
사용자 정의 속성을 핵심 가치 쌍으로 정의하여 이벤트 변경에 대한 추가 메타데이터를 추가할 수 있습니다.
매개변수
데이터 유형
설명
customAttributes
물체
customAttributes 필드는 JavaScript 개체 형식의 key-value 쌍으로 지정되며, 여기서 값은 string, boolean 또는 number 유형일 수 있습니다. JavaScript 숫자는 √ long 또는 double 값으로 저장됩니다. .JSON 과 달리 JavaScript 객체의 키는 따옴표로 묶이지 않습니다. 사용자 정의 속성을 추가하려면 다음과 같이 구성하세요.
customAttributes: {key_name : "value_name"}
기본 속성 이름과 NRQL 키워드와의 이름 충돌을 방지하기 위해 다음과 같은 사용자 지정 속성 이름이 제한됩니다.
accountId
ago
and
appID
as
auto
begin
begintime
category
categoryType
changeTrackingId
compare
customAttributes
customType
day
days
description
end
endtime
entity.domain
entity.guid
entity.name
entity.type
entityGuid
entityName
explain
eventType
facet
from
fb.input
groupId
hostname
hour
hours
in
is
like
limit
log
minute
minutes
month
months
not
null
offset
or
plugin.type
raw
second
seconds
select
since
timeseries
timestamp
type
until
user
week
weeks
where
with
샘플 돌연변이
다음 예에서는 추적 마커를 생성하기 위한 NerdGraph 변형과 필수 및 선택적 속성을 보여줍니다.