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

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

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

문제 신고

뉴렐릭 Synthetics 작업

|View as Markdown (English)

이 페이지는 워크플로우 자동화 액션 카탈로그에서 사용할 수 있는 뉴렐릭 Synthetics 액션에 대한 참조를 제공합니다. 이러한 액션을 사용하면 기존 모니터에 대한 온디맨드 테스트 실행을 트리거하고, 유지 관리 기간 다운타임을 관리하며, 워크플로우 정의에서 직접 모니터 세부 정보를 읽을 수 있습니다.

전제 조건

워크플로우 자동화에서 뉴렐릭 Synthetics 작업을 사용하기 전에 다음 사항을 갖추고 있는지 확인하십시오:

  • 신세틱스 모니터에 액세스할 수 있는 적절한 권한이 있는 뉴렐릭 계정입니다.
  • 타겟으로 지정하려는 각 모니터의 엔티티 GUID입니다. 모니터의 GUID는 뉴렐릭의 Synthetics > [모니터 이름] > Settings에서 확인할 수 있습니다.

자동화된 테스트를 시작하십시오.

작업 식별자는 newrelic.synthetics.startAutomatedTest입니다.

하나 이상의 모니터에 대한 온디맨드 신세틱스 자동 테스트 실행을 트리거하고, newrelic.synthetics.getAutomatedTestResult을(를) 사용하여 결과를 폴링할 batchId을(를) 반환합니다.

중요

스크립트 API, 스크립트 브라우저, 단계 및 단순 브라우저 모니터 유형만 지원됩니다. SIMPLE(ping) 모니터는 호환되지 않는 모니터 유형 오류로 인해 API에서 거부됩니다.

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

입력

유형

설명

예시

테스트

목록

필수 항목입니다. 테스트할 모니터 목록입니다. 각 항목에는 monitorGuid이(가) 필요하며, 모니터별 재정의가 포함된 선택적 config 객체를 허용합니다. 아래 필드를 참조하십시오.

[{"monitorGuid": "MTE5Mz..."}]

tests[].monitorGuid

문자열

필수 항목입니다. 실행할 모니터의 엔티티 GUID입니다. 스크립트 또는 브라우저 기반 모니터 유형이어야 합니다.

"MTE5MzMzNDd8U1lOVEh8..."

tests[].config.isBlocking

부울

선택 항목입니다. true인 경우, 실패한 테스트는 차단으로 처리됩니다 ― 이는 결과에 따라 CI/CD 파이프라인을 제어하는 데 유용합니다.

true

tests[].config.overrides.location

문자열

선택 항목입니다. 모니터에 구성된 위치 대신 이 위치에서 테스트를 실행하십시오.

"US_EAST_1"

tests[].config.overrides.startingUrl

문자열

선택 항목입니다. 모니터가 시작되는 URL을 재정의하십시오 — 예를 들어, 이번 실행을 위해 프로덕션 모니터가 스테이징 환경을 가리키도록 설정할 수 있습니다.

"https://staging.example.com"

tests[].config.overrides.domain

목록

선택 항목입니다. 이번 실행에 한해 한 도메인에서 다른 도메인으로 requests를 리디렉션합니다. 각 항목에는 domain 및 override이(가) 필요합니다.

[{"domain": "example.com", "override": "staging.example.com"}]

tests[].config.overrides.secureCredential

목록

선택 항목입니다. 이번 실행을 위해 스크립트의 $secure.KEY 참조가 가리키는 저장된 보안 자격 증명을 교체합니다. 각 항목에는 key 및 overrideKey이(가) 필요합니다.

[{"key": "API_KEY", "overrideKey": "STAGING_API_KEY"}]

구성

지도

선택 항목입니다. 테스트 실행에 첨부된 배치 수준 메타데이터입니다. 모든 필드는 기술 목적으로만 사용되며 테스트 실행 방식에는 영향을 주지 않습니다. 지원되는 필드: batchName, branch, commit, deepLink, platform, repository.

{"batchName": "release-1.2.3", "branch": "main", "commit": "a1b2c3d"}

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "batchId", "expression": ".data.syntheticsStartAutomatedTest.batchId"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"syntheticsStartAutomatedTest": {
"batchId": "bdf77c8d-1987-4488-ac7d-112836e5f610"
}
}
}

결과를 폴링하려면 batchId을(를) newrelic.synthetics.getAutomatedTestResult에 전달하십시오.

워크플로 예

name: start_synthetics_automated_test
description: Trigger an on-demand Synthetics test run after a deploy
steps:
- name: startAutomatedTest
type: action
action: newrelic.synthetics.startAutomatedTest
version: 1
inputs:
tests:
- monitorGuid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
config:
batchName: "release-1.2.3"
branch: "main"
selectors:
- name: batchId
expression: ".data.syntheticsStartAutomatedTest.batchId"
next: end

자동화된 테스트 결과 가져오기

작업 식별자는 newrelic.synthetics.getAutomatedTestResult입니다.

batchId을(를) 통해 신세틱스 자동화 테스트 배치의 상태 및 모니터별 결과를 가져옵니다. startAutomatedTest 직후에 폴링하면 일시적인 "No automated test results found" 오류가 반환될 수 있습니다 — 폴링 전에 짧은 대기 단계를 추가하십시오.

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

입력

유형

설명

예시

회계처리

정수

필수 항목입니다. 뉴렐릭 계정 ID.

11933347

batchId

문자열

필수 항목입니다. newrelic.synthetics.startAutomatedTest에서 반환한 배치 ID입니다.

"bdf77c8d-1987-4488-ac7d-112836e5f610"

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "status", "expression": ".data.actor.account.synthetics.automatedTestResult.status"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"actor": {
"account": {
"synthetics": {
"automatedTestResult": {
"status": "IN_PROGRESS",
"startTimestamp": 1788519679406,
"finishTimestamp": null,
"tests": []
}
}
}
}
}
}

status PASSED, FAILED, IN_PROGRESS 또는 TIMEOUT 중 하나입니다.

워크플로 예

name: get_synthetics_test_result
description: Poll a Synthetics automated test batch for its outcome
steps:
- name: wait
type: wait
seconds: 15
- name: getAutomatedTestResult
type: action
action: newrelic.synthetics.getAutomatedTestResult
version: 1
inputs:
accountId: 11933347
batchId: "bdf77c8d-1987-4488-ac7d-112836e5f610"
selectors:
- name: status
expression: ".data.actor.account.synthetics.automatedTestResult.status"
- name: tests
expression: ".data.actor.account.synthetics.automatedTestResult.tests"
next: end

모니터 다운타임 생성

작업 식별자는 newrelic.synthetics.createMonitorDowntime입니다.

하나 이상의 특정 모니터에 대한 일회성 신세틱스 모니터 다운타임(유지보수 기간)을 예약합니다. API는 제출된 IANA 이름 대신 확인된 시간대 레이블(예: Pacific Standard Time)을 반환합니다.

중요

monitorGuids GraphQL 스키마에서는 null일 수 있지만 실제로는 필수입니다 ― 생략하면 서버 오류가 발생합니다. 계정 전체의 다운타임 모드는 없으며, 다운타임은 항상 특정 모니터를 타겟으로 합니다.

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

입력

유형

설명

예시

회계처리

정수

필수 항목입니다. 뉴렐릭 계정 ID.

11933347

이름

문자열

필수 항목입니다. 다운타임의 표시 이름입니다.

"Deploy maintenance window"

시작 시간

문자열

필수 항목입니다. timezone 입력을 사용하여 해석되는 NaiveDateTime(시간대 오프셋 없음) 형식의 시작 시간입니다. 포맷: YYYY-MM-DDTHH:MM:SS.

"2026-09-10T02:00:00"

종료 시간

문자열

필수 항목입니다. timezone 입력을 사용하여 해석되는 NaiveDateTime(시간대 오프셋 없음) 형식의 종료 시간입니다.

"2026-09-10T04:00:00"

시간대

문자열

필수 항목입니다. startTime 및 endTime을(를) 해석하는 데 사용하는 IANA 시간대 이름입니다.

"America/Los_Angeles"

monitorGuids

목록

필수 항목입니다. 다운타임 동안 알림을 중지할 모니터의 엔티티 GUID입니다. 최소 한 개의 GUID를 포함해야 합니다.

["MTE5MzMzNDd8U1lOVEh8..."]

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "guid", "expression": ".data.syntheticsCreateOnceMonitorDowntime.guid"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"syntheticsCreateOnceMonitorDowntime": {
"accountId": 11933347,
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0...",
"monitorGuids": ["MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0..."],
"name": "Deploy maintenance window",
"startTime": "2026-09-10T02:00",
"endTime": "2026-09-10T04:00",
"timezone": "Pacific Standard Time"
}
}
}

워크플로 예

name: create_monitor_downtime
description: Schedule a maintenance window for a Synthetics monitor
steps:
- name: createMonitorDowntime
type: action
action: newrelic.synthetics.createMonitorDowntime
version: 1
inputs:
accountId: 11933347
name: "Deploy maintenance window"
startTime: "2026-09-10T02:00:00"
endTime: "2026-09-10T04:00:00"
timezone: "America/Los_Angeles"
monitorGuids:
- "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
selectors:
- name: guid
expression: ".data.syntheticsCreateOnceMonitorDowntime.guid"
next: end

모니터 다운타임 편집

작업 식별자는 newrelic.synthetics.editMonitorDowntime입니다.

엔티티 GUID로 식별되는 기존 신세틱스 모니터 다운타임을 편집합니다.

중요

monitorGuids 모든 편집 호출 시 필요합니다. 이 필드가 생략되면 API는 기존 목록을 보존하지 않습니다 ― 대신 빈 상태로 지웁니다. 항상 원하는 전체 모니터 GUID 세트를 전달하십시오.

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

입력

유형

설명

예시

유구한

문자열

필수 항목입니다. 편집할 다운타임의 엔티티 GUID입니다.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz..."

monitorGuids

목록

필수 항목입니다. 다운타임이 적용되어야 하는 모니터 엔티티 GUID의 전체 세트입니다. 생략할 경우 API는 기존 값을 유지하는 대신 이 목록을 비웁니다.

["MTE5MzMzNDd8U1lOVEh8..."]

시작 시간

문자열

필수 항목입니다. timezone 입력을 사용하여 해석된 NaiveDateTime(시간대 오프셋 없음) 형식의 시작 시간입니다.

"2026-09-10T02:00:00"

종료 시간

문자열

필수 항목입니다. timezone 입력을 사용하여 해석되는 NaiveDateTime(시간대 오프셋 없음) 형식의 종료 시간입니다.

"2026-09-10T06:00:00"

시간대

문자열

필수 항목입니다. startTime 및 endTime을(를) 해석하는 데 사용하는 IANA 시간대 이름입니다.

"America/Los_Angeles"

이름

문자열

선택 항목입니다. 다운타임의 새 표시 이름입니다. 변경하지 않고 그대로 두려면 생략하십시오.

"Deploy maintenance window (extended)"

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "guid", "expression": ".data.syntheticsEditMonitorDowntime.guid"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"syntheticsEditMonitorDowntime": {
"accountId": 11933347,
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz...",
"name": "Deploy maintenance window (extended)",
"startTime": "2026-09-10T02:00",
"endTime": "2026-09-10T06:00",
"timezone": "Pacific Standard Time",
"monitorGuids": ["MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0..."]
}
}
}

워크플로 예

name: edit_monitor_downtime
description: Extend a Synthetics monitor downtime's end time
steps:
- name: editMonitorDowntime
type: action
action: newrelic.synthetics.editMonitorDowntime
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXwz..."
name: "Deploy maintenance window (extended)"
monitorGuids:
- "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC02MGRmLTQ4YWEtYTc4YS1jZDk5NjhmYTU4YmE"
startTime: "2026-09-10T02:00:00"
endTime: "2026-09-10T06:00:00"
timezone: "America/Los_Angeles"
selectors:
- name: guid
expression: ".data.syntheticsEditMonitorDowntime.guid"
next: end

모니터 다운타임 삭제

작업 식별자는 newrelic.synthetics.deleteMonitorDowntime입니다.

엔티티 GUID로 식별되는 신세틱스 모니터 다운타임을 삭제합니다.

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

입력

유형

설명

예시

유구한

문자열

필수 항목입니다. 삭제할 다운타임의 엔티티 GUID입니다.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "deletedGuid", "expression": ".data.syntheticsDeleteMonitorDowntime.guid"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"syntheticsDeleteMonitorDowntime": {
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."
}
}
}

워크플로 예

name: delete_monitor_downtime
description: Remove a Synthetics monitor downtime
steps:
- name: deleteMonitorDowntime
type: action
action: newrelic.synthetics.deleteMonitorDowntime
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUl9ET1dOVElNRXxhZGZlYmRiOS0..."
selectors:
- name: deletedGuid
expression: ".data.syntheticsDeleteMonitorDowntime.guid"
next: end

모니터 가져오기

작업 식별자는 newrelic.synthetics.getMonitor입니다.

엔티티 GUID를 통해 현재 상태, 로드 시간 백분위수 및 모니터 설정을 포함하여 신세틱스 모니터의 전체 세부 정보를 가져옵니다.

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

입력

유형

설명

예시

유구한

문자열

필수 항목입니다. 가져올 모니터의 엔티티 GUID입니다.

"MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2..."

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "status", "expression": ".data.actor.entity.monitorSummary.status"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"actor": {
"entity": {
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2...",
"name": "Homepage ping check",
"accountId": 123456,
"domain": "SYNTH",
"entityType": "SYNTHETIC_MONITOR_ENTITY",
"type": "MONITOR",
"alertSeverity": "NOT_ALERTING",
"permalink": "https://onenr.io/...",
"reporting": true,
"monitorType": "SIMPLE",
"monitorId": "1032899a-d2e6-4777-8b5f-5d3f7c9b6798",
"period": 5,
"monitoredUrl": "https://example.com",
"monitorSummary": {
"status": "SUCCESS",
"successRate": 1,
"locationsFailing": 0,
"locationsRunning": 1,
"loadTimeP50": 210,
"loadTimeP95": 480
}
}
}
}
}

워크플로 예

name: get_synthetics_monitor
description: Fetch a Synthetics monitor's current status and load time
steps:
- name: getMonitor
type: action
action: newrelic.synthetics.getMonitor
version: 1
inputs:
guid: "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnwxMDMyODk5YS1kMmU2LTQ3NzctOGI1Zi01ZDNmN2M5YjY3OTg"
selectors:
- name: status
expression: ".data.actor.entity.monitorSummary.status"
- name: successRate
expression: ".data.actor.entity.monitorSummary.successRate"
next: end

모니터 목록

작업 식별자는 newrelic.synthetics.listMonitors입니다.

선택적 이름 및 보고 상태 필터와 커서 기반 페이지네이션을 사용하여 계정의 신세틱스 모니터를 검색합니다.

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

입력

유형

설명

예시

회계처리

정수

필수 항목입니다. 모니터를 검색할 뉴렐릭 계정 ID입니다.

11933347

이름

문자열

선택 항목입니다. 모니터 이름에 대한 대소문자 구분 없는 포함 일치입니다.

"Homepage"

보고

부울

선택 항목입니다. 현재 보고 중인(true) 또는 보고 중이 아닌(false) 모니터로 필터링합니다. 둘 다 반환하려면 생략하십시오.

true

커서

문자열

선택 항목입니다. 이전 호출의 nextCursor 출력에서 가져온 페이지네이션 커서입니다. 첫 번째 페이지부터 시작하려면 생략하십시오.

"${{ .steps.listMonitors.outputs.nextCursor }}"

selectors

목록

선택 사항. 작업 출력에서 특정 필드를 추출하기 위한 JQ 선택자입니다.

[{"name": "monitors", "expression": ".data.actor.entitySearch.results.entities"}]

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

산출

유형

예시

success

부울

true 단계가 오류 없이 실행되었을 때.

errorMessage

문자열

HTTP/전송 수준에서 호출이 실패한 경우에만 채워집니다. 성공 시 null 입니다.

data

물체

{
"data": {
"actor": {
"entitySearch": {
"count": 1,
"results": {
"nextCursor": null,
"entities": [
{
"guid": "MTE5MzMzNDd8U1lOVEh8TU9OSVRPUnw1OGEwNmFjZC0...",
"name": "Homepage ping check",
"domain": "SYNTH",
"type": "MONITOR",
"reporting": true
}
]
}
}
}
}
}

nextCursor 더 많은 페이지가 존재할 때 표시됩니다. 다음 페이지를 가져오려면 다음 호출에서 cursor (으)로 전달하십시오.

워크플로 예

name: list_synthetics_monitors
description: Search for Synthetics monitors by name
steps:
- name: listMonitors
type: action
action: newrelic.synthetics.listMonitors
version: 1
inputs:
accountId: 11933347
name: "Homepage"
reporting: true
selectors:
- name: monitors
expression: ".data.actor.entitySearch.results.entities"
- name: nextCursor
expression: ".data.actor.entitySearch.results.nextCursor"
next: end
Copyright © 2026 New Relic Inc.

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