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

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

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

문제 신고

뉴렐릭 서비스 수준 작업

|View as Markdown (English)

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 모든 뉴렐릭 서비스 수준 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하면 워크플로우에서 직접 서비스 수준 지표(SLI) 및 해당 서비스 수준 목표(SLO)를 생성, 업데이트, 삭제 및 나열할 수 있습니다 ― 이를 통해 자동화된 서비스 온보딩, SLO 문제 해결 및 컴플라이언스 워크플로우를 활성화할 수 있습니다.

전제 조건

워크플로우 자동화에서 뉴렐릭 서비스 수준 작업을 사용하기 전에 다음 사항을 확인하십시오:

서비스 수준을 관리할 수 있는 적절한 권한이 있는 뉴렐릭 계정입니다.

서비스 수준 생성

작업 식별자는 newrelic.serviceLevel.create입니다.

엔티티에 대한 서비스 수준 목표(SLO)와 함께 새로운 서비스 수준 지표(SLI)를 생성합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

엔티티 가이드

문자열

필수 항목입니다.

이 SLI가 정의된 엔티티입니다.

"MjXzMzQ2fEFQTXxBUFBMSUNBVElPTnwyMzU5MzAzOTU"

이름

문자열

필수 항목입니다.

SLI 이름.

"Checkout API availability"

description

문자열

옵션.

SLI 설명입니다.

"Auto-provisioned on service onboarding"

회계처리

Int

필수 항목입니다.

SLI를 소유한 뉴렐릭 계정입니다.

1234567

validEventsFrom

문자열

필수 항목입니다.

유효한 이벤트 풀에 대한 NRDB 이벤트 유형입니다.

"Transaction"

validEventsWhere

문자열

선택 사항입니다.

유효한 이벤트 풀을 필터링하기 위한 NRQL 부울 조건입니다.

"appName = 'checkout-api'"

validEventsSelectFunction

문자열

옵션.

유효한 이벤트 풀에 대한 집계 함수입니다.

COUNT

,

SUM

,

GET_FIELD

,

GET_CDF_COUNT

중 하나입니다.

"COUNT"

validEventsSelectAttribute

문자열

선택 사항입니다.

유효한 이벤트 풀을 위해 집계할 속성입니다.

validEventsSelectFunction

이(가)

SUM

,

GET_FIELD

또는

GET_CDF_COUNT

일 때 필수입니다.

"duration"

validEventsSelectThreshold

뜨다

선택 사항입니다.

유효한 이벤트 풀에 대한 임계값입니다.

validEventsSelectFunction

이(가)

GET_CDF_COUNT

일 때만 사용됩니다.

500

eventCategory

문자열

필수 항목입니다.

조건 이벤트 버킷을 좋은 이벤트 또는 나쁜 이벤트로 분류합니다.

GOOD

,

BAD

중 하나입니다.

"GOOD"

conditionEventsFrom

문자열

필수 항목입니다.

좋은/나쁜 이벤트 버킷에 대한 NRDB 이벤트 유형입니다.

"Transaction"

conditionEventsWhere

문자열

선택 사항입니다.

좋은/나쁜 이벤트 버킷을 필터링하기 위한 NRQL 부울 조건입니다.

"appName = 'checkout-api' AND error IS FALSE"

conditionEventsSelectFunction

문자열

선택 사항.

좋음/나쁨 이벤트 버킷에 대한 집계 함수입니다.

COUNT

,

SUM

,

GET_FIELD

,

GET_CDF_COUNT

중 하나입니다.

"COUNT"

conditionEventsSelectAttribute

문자열

옵션.

좋음/나쁨 버킷에 대해 집계할 속성입니다.

conditionEventsSelectFunction

이(가)

SUM

,

GET_FIELD

또는

GET_CDF_COUNT

일 때 필수입니다.

"duration"

conditionEventsSelectThreshold

뜨다

옵션.

좋음/나쁨 버킷의 임계값입니다.

conditionEventsSelectFunction

이(가)

GET_CDF_COUNT

일 때만 사용됩니다.

500

패싯

목록

옵션.

SLI 결과를 그룹화할 속성입니다.

["appName"]

표적

뜨다

필수 항목입니다.

백분율로 표시된 SLO 목표입니다.

99.9

windowDays

Int

필수 항목입니다.

일 단위의 롤링 기간입니다.

1

,

7

또는

28

여야 합니다.

28

selectors

목록

선택 사항입니다.

응답에서 특정 값을 추출하는 JQ 선택자입니다. 이후 단계에서 사용할 새 SLI의 GUID를 캡처하려면

.data.serviceLevelCreate.guid

을(를) 사용하십시오.

selectors:
- name: sliGuid
expression: ".data.serviceLevelCreate.guid"

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

success

부울

true

기본

newrelic.nerdgraph.execute

호출에서 상속된 /

false

― 전송 실패와 NerdGraph 비즈니스 로직 오류를 모두 포함합니다.

errorMessage

문자열

전송 수준이든 NerdGraph 비즈니스 로직 오류이든 실패 시 오류 메시지입니다. 성공 시

null

입니다.

data

지도

NerdGraph 응답:

{
"data": {
"serviceLevelCreate": {
"guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
"name": "Checkout API availability"
}
}
}

data에서 guid 또는 name을(를) 추출하려면 selectors을(를) 사용하십시오.

다음 예제는 SLI/SLO를 생성하고 후속 단계에서 사용하기 위해 selectors을(를) 사용하여 새 SLI의 GUID를 캡처합니다.

워크플로 예

name: newrelic_service_level_create_workflow
description: Create an SLI/SLO for a service entity
steps:
- name: createSlo
type: action
action: newrelic.serviceLevel.create
version: 1
inputs:
entityGuid: ${{ .workflowInputs.entityGuid }}
name: "Checkout API availability"
accountId: ${{ .workflowInputs.accountId }}
validEventsFrom: "Transaction"
eventCategory: "GOOD"
conditionEventsFrom: "Transaction"
conditionEventsWhere: "appName = 'checkout-api' AND error IS FALSE"
target: 99.9
windowDays: 28
selectors:
- name: sliGuid
expression: ".data.serviceLevelCreate.guid"
next: end

서비스 수준 업데이트

작업 식별자는 newrelic.serviceLevel.update입니다.

기존 서비스 수준 지표의 설정 또는 서비스 수준 목표(SLO)를 업데이트합니다. newrelic.nerdgraph.execute을(를) 사용합니다.

필드 name 및 description은 개별적으로 선택 사항입니다 ― 둘 중 하나를 생략하면 기존 값이 유지됩니다. 필드 target 및 windowDays은 전부 아니면 전무입니다: SLO 타겟을 변경하려면 둘 다 제공하고, 기존 SLO를 변경하지 않고 유지하려면 둘 다 생략하십시오.

이벤트 설정(validEvents*, conditionEvents*, eventCategory, facets)의 경우 필드를 생략하면 필드가 유지되지 않고 제거됩니다. 이벤트 섹션에서 하나의 필드를 변경하려면 변경 사항과 함께 전체 현재 이벤트 정의를 다시 제공하십시오.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

sliGuid

문자열

필수 항목입니다.

SLI의 GUID입니다.

newrelic.serviceLevel.create

의

sliGuid

선택기 출력을 사용하십시오.

"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"

이름

문자열

옵션.

새 SLI 이름입니다. 생략하면 기존 이름이 유지됩니다.

"Checkout API availability (v2)"

description

문자열

선택 항목입니다.

새로운 SLI 설명입니다. 생략하면 기존 설명이 유지됩니다.

"Tightened after Q3 reliability review"

validEventsFrom

문자열

선택 사항입니다.

유효한 이벤트 풀에 대한 NRDB 이벤트 유형입니다. 다른

validEvents*

,

conditionEvents*

또는

eventCategory

필드가 설정된 경우 필수입니다.

"Transaction"

validEventsWhere

문자열

선택 사항입니다.

유효한 이벤트 풀을 필터링하기 위한 NRQL 부울 조건입니다.

"appName = 'checkout-api'"

validEventsSelectFunction

문자열

옵션.

유효한 이벤트 풀에 대한 집계 함수입니다.

COUNT

,

SUM

,

GET_FIELD

,

GET_CDF_COUNT

중 하나입니다.

"COUNT"

validEventsSelectAttribute

문자열

선택 사항입니다.

유효한 이벤트 풀을 위해 집계할 속성입니다.

validEventsSelectFunction

이(가)

SUM

,

GET_FIELD

또는

GET_CDF_COUNT

일 때 필수입니다.

"duration"

validEventsSelectThreshold

뜨다

선택 사항입니다.

유효한 이벤트 풀에 대한 임계값입니다.

validEventsSelectFunction

이(가)

GET_CDF_COUNT

일 때만 사용됩니다.

500

eventCategory

문자열

선택 사항입니다.

조건 이벤트 버킷을 좋은 이벤트 또는 나쁜 이벤트로 분류합니다.

GOOD

,

BAD

중 하나입니다. 이벤트 설정을 구성할 때

conditionEventsFrom

와(과) 함께 필수 항목입니다.

"GOOD"

conditionEventsFrom

문자열

선택 사항.

좋음/나쁨 이벤트 버킷에 대한 NRDB 이벤트 유형입니다.

"Transaction"

conditionEventsWhere

문자열

선택 사항입니다.

좋은/나쁜 이벤트 버킷을 필터링하기 위한 NRQL 부울 조건입니다.

"appName = 'checkout-api' AND error IS FALSE"

conditionEventsSelectFunction

문자열

선택 사항.

좋음/나쁨 이벤트 버킷에 대한 집계 함수입니다.

COUNT

,

SUM

,

GET_FIELD

,

GET_CDF_COUNT

중 하나입니다.

"COUNT"

conditionEventsSelectAttribute

문자열

옵션.

좋음/나쁨 버킷에 대해 집계할 속성입니다.

conditionEventsSelectFunction

이(가)

SUM

,

GET_FIELD

또는

GET_CDF_COUNT

일 때 필수입니다.

"duration"

conditionEventsSelectThreshold

뜨다

옵션.

좋음/나쁨 버킷의 임계값입니다.

conditionEventsSelectFunction

이(가)

GET_CDF_COUNT

일 때만 사용됩니다.

500

패싯

목록

옵션.

SLI 결과를 그룹화할 속성입니다.

["appName"]

표적

뜨다

옵션.

새로운 SLO 타겟(백분율)입니다.

windowDays

과(와) 함께 전부 아니면 전무입니다: 둘 다 함께 제공하거나 둘 다 생략하십시오.

99.95

windowDays

Int

옵션.

일 단위의 롤링 기간입니다. 설정 시

1

,

7

또는

28

이어야 합니다.

target

과(와) 함께 전부 아니면 전무 방식으로 적용됩니다: 둘 다 함께 제공하거나 둘 다 생략하십시오.

28

selectors

목록

선택 항목입니다.

응답에서 특정 값을 추출하기 위한 JQ 선택기입니다.

selectors:
- name: sliGuid
expression: ".data.serviceLevelUpdate.guid"

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

success

부울

true

기본

newrelic.nerdgraph.execute

호출에서 상속된 /

false

― 전송 실패와 NerdGraph 비즈니스 로직 오류를 모두 포함합니다.

errorMessage

문자열

전송 수준이든 NerdGraph 비즈니스 로직 오류이든 실패 시 오류 메시지입니다. 성공 시

null

입니다.

data

지도

NerdGraph 응답:

{
"data": {
"serviceLevelUpdate": {
"guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
"name": "Checkout API availability (v2)"
}
}
}

data에서 guid 또는 name을(를) 추출하려면 selectors을(를) 사용하십시오.

다음 예제는 이전 newrelic.serviceLevel.create 단계에서 캡처한 GUID를 사용하여 기존 SLI의 SLO 목표를 강화합니다.

워크플로 예

name: newrelic_service_level_update_workflow
description: Tighten the SLO target on an existing SLI
steps:
- name: tightenSlo
type: action
action: newrelic.serviceLevel.update
version: 1
inputs:
sliGuid: ${{ .steps.createSlo.outputs.sliGuid }}
target: 99.95
windowDays: 28
next: end

서비스 수준 삭제

작업 식별자는 newrelic.serviceLevel.delete입니다.

기존 서비스 수준 지표(SLI) 및 해당 서비스 수준 목표(SLO)를 제거합니다. newrelic.nerdgraph.execute을(를) 사용합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

sliGuid

문자열

필수 항목입니다.

SLI의 GUID입니다.

newrelic.serviceLevel.create

의

sliGuid

선택기 출력을 사용하십시오.

"MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE"

selectors

목록

선택 항목입니다.

응답에서 특정 값을 추출하기 위한 JQ 선택기입니다.

selectors:
- name: deletedGuid
expression: ".data.serviceLevelDelete.guid"

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

success

부울

true

/

false

, 기본

newrelic.nerdgraph.execute

호출에서 상속됨 ― 전송 실패(200이 아님, 네트워크 오류) 및 NerdGraph 비즈니스 로직 오류(정상적인 200 응답의

errors

어레이)를 모두 포함합니다.

errorMessage

문자열

전송 수준이든 NerdGraph 비즈니스 로직 오류이든 실패 시 오류 메시지입니다. 성공 시

null

입니다.

data

지도

NerdGraph 응답:

{
"data": {
"serviceLevelDelete": {
"guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
"name": "Checkout API availability"
}
}
}

data에서 guid 또는 name을(를) 추출하려면 selectors을(를) 사용하십시오.

다음 예제는 워크플로우 입력으로 전달된 GUID를 사용하여 SLI를 삭제합니다.

워크플로 예

name: newrelic_service_level_delete_workflow
description: Delete an existing SLI/SLO
steps:
- name: retireSlo
type: action
action: newrelic.serviceLevel.delete
version: 1
inputs:
sliGuid: ${{ .workflowInputs.sliGuid }}
next: end

서비스 수준 목록

작업 식별자는 newrelic.serviceLevel.list입니다.

선택적으로 계정 또는 컴플라이언스 상태로 범위가 지정된 서비스 수준 지표 엔티티를 나열합니다. newrelic.nerdgraph.execute을(를) 사용합니다.

다음 표는 이 작업에 사용할 수 있는 모든 입력 필드를 설명합니다.

입력

유형

설명

예시

회계처리

Int

선택 항목입니다.

결과를 하나의 뉴렐릭 계정으로 제한합니다. 생략하면 요청자가 액세스할 수 있는 모든 계정의 SLI가 반환됩니다.

11933347

onlyNonCompliant

부울

선택 사항.

규정 준수 상태 필터입니다.

true

인 경우 결과를

Non-compliant

또는

At risk

(으)로 태그가 지정된 SLI로 제한합니다 ― 이는 서비스 수준 관리 UI의 "위험 및 비준수만 표시" 토글과 동일합니다.

false

및 이 필드를 생략하면 규정 준수 상태와 관계없이 모든 SLI가 반환됩니다.

true

filter

문자열

선택 사항입니다.

쿼리에 추가된 추가 원시

entitySearch

필터 절입니다.

"name LIKE '%checkout%'"

limit

Int

옵션.

결과의 페이지 크기입니다.

50

커서

문자열

옵션.

이전 호출의

nextCursor

출력에서 가져온 페이지 매기기 토큰입니다. 첫 번째 호출 시에는 비워 두십시오.

"oWUNlXQ65ke3hEVGplVS1UOWJFRstmVTZFMVhj..."

selectors

목록

선택 사항입니다.

응답에서 특정 값을 추출하는 JQ 선택자입니다. SLI 목록을 가져오려면

.data.actor.entitySearch.results.entities

을(를) 사용하고 페이지 매김 토큰에는

.data.actor.entitySearch.results.nextCursor

을(를) 사용하십시오.

selectors:
- name: entities
expression: ".data.actor.entitySearch.results.entities"
- name: nextCursor
expression: ".data.actor.entitySearch.results.nextCursor"

다음 표는 이 작업에서 반환된 모든 출력 필드를 설명합니다.

산출

유형

설명

success

부울

true

기본

newrelic.nerdgraph.execute

호출에서 상속된 /

false

― 전송 실패와 NerdGraph 비즈니스 로직 오류를 모두 포함합니다.

errorMessage

문자열

전송 수준이든 NerdGraph 비즈니스 로직 오류이든 실패 시 오류 메시지입니다. 성공 시

null

입니다.

data

지도

원시 NerdGraph 응답입니다. selectors을(를) 사용하여 data에서 entities, count 또는 nextCursor을(를) 추출하십시오. 더 이상 페이지가 없으면 nextCursor은(는) null 입니다.

{
"data": {
"actor": {
"entitySearch": {
"count": 2,
"results": {
"entities": [
{
"guid": "MXxFWFR8U0VSVklDRV9MRVZFTHwzMjk5NjE",
"name": "Checkout API availability"
}
],
"nextCursor": null
}
}
}
}
}

다음 예는 계정에 대한 모든 비준수 SLI를 나열하고 selectors을(를) 사용하여 엔티티 목록을 추출합니다.

워크플로 예

name: newrelic_service_level_list_workflow
description: List non-compliant SLIs for an account
steps:
- name: findNonCompliantSlis
type: action
action: newrelic.serviceLevel.list
version: 1
inputs:
accountId: ${{ .workflowInputs.accountId }}
onlyNonCompliant: true
limit: 50
selectors:
- name: entities
expression: ".data.actor.entitySearch.results.entities"
next: end
Copyright © 2026 New Relic Inc.

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