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

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

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

문제 신고

NRQL 매크로 생성 및 관리

|View as Markdown (English)

매크로를 생성하기 전에 아래의 매크로 권한과 명명 및 표현식 규칙을 검토하십시오. 이러한 규칙을 따르지 않는 매크로는 저장하려고 할 때 유효성 검사에 실패합니다.

매크로 규칙 및 제한 사항

중요

매크로는 조직의 모든 사용자에게 표시됩니다. 매크로를 생성하거나 업데이트할 때 민감한 정보나 계정 관련 정보를 포함하지 마십시오.

매크로 액세스

뉴렐릭 플랫폼에서 Administration > NRQL Macros(으)로 이동하십시오. 이 페이지에서는 매크로를 조회, 생성, 편집 및 삭제할 수 있습니다.

매크로 생성

NRQL Macros 페이지에서 고유한 이름과 표현식을 제공하여 매크로를 생성하십시오. 명명 및 표현식 규칙을 따르십시오. 이름 앞에 $ 문자를 붙이지 마십시오. 예를 들어 WHERE 절 조건을 저장하려면 WHERE 키워드 없이 appName = 'ProductionApp' AND environment = 'prod'을(를) 입력하십시오.

매크로를 생성하면 NRQL Macros 목록에 나타납니다. 뉴렐릭 전체의 모든 NRQL 쿼리에서 사용할 수 있습니다.

NerdGraph API를 사용하여 프로그래밍 방식으로 매크로를 생성, 업데이트 및 쿼리할 수도 있습니다. 매크로를 생성하거나 업데이트하기 전에 명명 규칙, 표현식 규칙 및 제한 사항을 검토하십시오.

시작하려면 NerdGraph API 탐색기로 이동하십시오. NerdGraph API 탐색기를 사용하는 데 도움이 필요하면 NerdGraph API 탐색기 튜토리얼을 참조하십시오.

entityManagementCreateNrqlMacro 뮤테이션을 사용하십시오:

mutation CreateMacro($name: String!, $expression: String!, $orgId: ID!) {
entityManagementCreateNrqlMacro(
nrqlMacroEntity: {
expression: $expression
name: $name
scope: { type: ORGANIZATION, id: $orgId }
}
) {
entity {
id
name
expression
}
}
}

예제 변수:

{
"name": "prod_filter",
"expression": "(appName = 'ProductionApp' AND environment = 'prod')",
"orgId": "your-organization-id"
}

조직 ID를 찾으려면 조직 또는 매크로 ID 찾기를 참조하십시오.

쿼리에서 매크로 사용

NRQL 쿼리에서 매크로를 사용하려면 쿼리 빌더에서 $을(를) 입력한 다음 매크로 이름을 입력하십시오. 예를 들어 표현식이 appName = 'ProductionApp' AND environment = 'prod'인 prod_filter (이)라는 매크로가 있다고 가정해 보겠습니다. 다음과 같이 쿼리에서 사용할 수 있습니다.

SELECT count(*) FROM Transaction WHERE $prod_filter SINCE 1 hour ago

쿼리가 실행될 때 뉴렐릭은 매크로를 해당 표현식으로 바꿉니다:

SELECT count(*) FROM Transaction WHERE appName = 'ProductionApp' AND environment = 'prod' SINCE 1 hour ago

팁

쿼리 시 특수 문자가 포함된 매크로 이름은 백틱으로 묶으십시오. 예: $`my#Macro`.

중요

매크로는 실행 전에 인라인 처리되며, 이는 이항 연산자 우선순위에 영향을 미칩니다. 예를 들어, 1 + 4로 정의되고 $five * 3로 사용되는 five 이라는 매크로는 표현식이 1 + 4 * 3가 되기 때문에 15가 아닌 13으로 평가됩니다. 이를 방지하려면 매크로를 정의할 때 (1 + 4)과 같이 표현식을 괄호로 묶거나, 매크로를 사용할 때 ($five) * 3과 같이 매크로를 괄호로 묶으십시오. 두 방법 모두 15로 올바르게 평가됩니다.

다음 예는 일반적인 쿼리 문제를 해결하는 매크로를 보여줍니다:

매크로 관리

매크로 편집

NRQL Macros 페이지에서 매크로를 선택하고 표현식 규칙에 따라 표현식을 업데이트하십시오.

NerdGraph를 사용하여 프로그래밍 방식으로 매크로의 표현식을 업데이트할 수도 있습니다. 업데이트하기 전에 표현식 규칙을 검토하십시오.

entityManagementUpdateNrqlMacro 돌연변이를 사용합니다.

mutation UpdateMacro($expression: String!, $macroId: ID!) {
entityManagementUpdateNrqlMacro(
id: $macroId
nrqlMacroEntity: { expression: $expression }
) {
entity {
id
name
expression
}
}
}

예제 변수:

{
"expression": "(appName = 'ProductionApp' AND environment = 'prod' AND region = 'us-east-1')",
"macroId": "your-macro-id"
}

매크로의 ID를 찾으려면 조직 또는 매크로 ID 찾기를 참조하십시오.

중요

매크로를 편집하면 해당 매크로를 사용하는 모든 쿼리가 자동으로 업데이트된 버전을 사용합니다. 기존 쿼리가 손상되지 않도록 변경 사항을 검토하십시오. 캐싱으로 인해 업데이트가 적용되기까지 약간의 지연이 발생할 수 있습니다. 생성 후에는 매크로의 이름을 업데이트할 수 없습니다. 이름을 변경해야 하는 경우 매크로를 삭제하고 새 매크로를 생성하십시오.

조직 또는 매크로 ID 찾기

관련 주제

NRQL 매크로

NRQL 매크로가 무엇인지, 이를 통해 무엇을 할 수 있는지, 누가 사용할 수 있는지 알아보십시오.

NRQL 참조

NRQL 구문, 조항 및 함수를 탐색하십시오.

Copyright © 2026 New Relic Inc.

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