모니터링 인프라를 설정한 후에는 쿼리를 사용하여 합성 엔티티에 대한 정보를 검색할 수 있습니다. 쿼리는 모니터, 컨트롤러, 자격 증명 및 다운타임에 대한 데이터를 가져오기 위해 requests 합니다. 이 튜토리얼에서는 NerdGraph API 사용하여 쿼리 세부정보 모니터링 데이터를 사용하는 방법에 대한 예를 제공합니다.
팁
Quick Navigation: 아래 링크를 사용하여 특정 쿼리 유형으로 이동하세요:
합성 엔티티에서 사용할 수 있는 추가 쿼리 기능에 대해 알아보려면 NerdGraph 엔티티 API 튜토리얼을 참조하세요.
일반 모니터 쿼리
이 쿼리는 계정의 모든 종합 모니터를 검색하여 모니터의 GUID, 이름, 계정 ID, 모니터 유형 및 관련 태그를 포함한 필수 정보를 반환합니다. 태그에는 각 모니터에 대한 추가 설정 세부정보와 메타데이터가 포함되어 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 필터링할 검색 쿼리입니다.
사용하여 모든 합성 모니터를 검색합니다. |
샘플 쿼리
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR'") { results { entities { ... on SyntheticMonitorEntityOutline { guid name accountId monitorType tags { key values } } } } } }}엔티티 지원 쿼리
이 쿼리는 귀하의 계정에 있는 모든 리그 위치를 검색하여 해당 위치의 GUID, 이름, 계정 ID 및 관련 태그를 포함한 필수 정보를 반환합니다. 군대 로케이션을 사용하면 귀하의 그룹 뒤에 있는 디스플레이를 사용할 수 있으며, 해당 설정 세부 정보는 태그를 통해 액세스할 수 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 필터링할 검색 쿼리입니다. 모든 독립로케이션을 검색하려면
사용하세요. |
샘플 쿼리
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'PRIVATE_LOCATION'") { results { entities { accountId guid name tags { key values } } } } }}이 쿼리는 귀하의 계정에 있는 모든 모니터 다운타임을 검색하여 다운타임의 GUID, 이름, 계정 ID 및 관련 태그를 포함한 필수 정보를 반환합니다. 모니터 다운타임은 종합 모니터 실행이 중지되는 예정된 기간으로, 계획된 유지 관리 또는 알려진 가동 중단 중에 유용합니다. 일정 유형, 시간대, 반복 패턴 등의 설정 세부 정보는 태그에 저장됩니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 필터링할 검색 쿼리입니다.
사용하여 모든 모니터 다운타임을 검색하세요. |
샘플 쿼리
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'MONITOR_DOWNTIME'") { results { entities { accountId guid name tags { key values } } } } }}이 쿼리는 계정에 있는 모든 보안 자격 증명을 검색하고 자격 증명의 GUID, 이름, 계정 ID, 태그 및 마지막 업데이트 타임스탬프를 포함한 메타데이터 정보를 반환합니다. 보안 자격 증명은 암호, API 키 또는 암호화된 인증서와 같은 중요한 정보를 저장, 보호 및 중앙에서 관리하는 데 도움이 됩니다. 보안상의 이유로 보안 자격 증명을 조회하면 메타데이터만 반환되고 실제 자격 증명 값은 반환되지 않습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 필터링할 검색 쿼리입니다. 보안 자격 증명을 모두 검색하려면
사용하십시오. |
샘플 쿼리
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'SECURE_CRED'") { results { entities { ... on SecureCredentialEntityOutline { accountId guid name tags { key values } updatedAt } } } } }}모니터별 쿼리
이 쿼리는 스크립트 API 또는 스크립트 브라우저 모니터에서 사용되는 스크립트 내용을 가져옵니다. 스크립트에는 API 호출, 브라우저 상호작용 또는 사용자 지정 유효성 검사 로직과 같은 모니터의 동작을 정의하는 JavaScript 코드가 포함되어 있습니다. 이 쿼리는 스크립트 모니터 유형에서만 작동합니다: 다른 모니터 유형(단순, 핑, 단계, 인증서 확인, 끊어진 링크)은 사용자 지정 스크립트를 사용하지 않으므로 오류를 반환합니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
(계정) | 정수 | 네 | 모니터가 포함된 뉴렐릭 계정 ID입니다. |
| 문자열 | 네 | 스크립트를 가져오려는 스크립트 모니터의 고유 엔티티 GUID입니다. |
샘플 쿼리
{ actor { account(id: ACCOUNT_ID) { synthetics { script(monitorGuid: "ENTITY_GUID") { text } } } }}이 쿼리는 단계 모니터에 대해 구성된 단계를 조회합니다. 스텝 모니터는 탐색, 클릭, 양식 입력 및 어설션과 같은 사전 정의된 일련의 작업을 통해 코드 없는 다단계 브라우저 기반 모니터링을 제공합니다. 각 단계에는 순서 위치, 작업을 정의하는 유형, 그리고 단계의 설정 데이터를 포함하는 값이 있습니다. 이 쿼리는 스텝 모니터에서만 작동합니다: 다른 모니터 유형은 스텝 기반 설정을 사용하지 않으므로 오류를 반환합니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
(계정) | 정수 | 네 | 모니터가 포함된 뉴렐릭 계정 ID입니다. |
| 문자열 | 네 | 단계 데이터를 조회하려는 단계 모니터의 고유 엔티티 GUID입니다. |
샘플 쿼리
{ actor { account(id: ACCOUNT_ID) { synthetics { steps(monitorGuid: "ENTITY_GUID") { ordinal type values } } } }}고급 쿼리
이 쿼리는 모니터 ID를 사용하여 합성 모니터의 엔티티 GUID를 검색합니다. 이는 숫자 형식의 모니터 ID가 있고 이를 대부분의 NerdGraph 작업에 필요한 GUID 형식으로 변환해야 할 때 유용합니다. 부분 GUID는 업데이트, 삭제 및 기타 모니터 관리 작업에 사용되는 최신 제외이고, 모니터 ID는 URL 또는 공간 통합에 나타날 수 있는 이전 숫자 제외입니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 모니터를 찾기 위한 검색 쿼리.
이(가) 찾으려는 모니터의 숫자 ID인 경우
을(를) 사용하세요. |
샘플 쿼리
{ actor { entitySearch(query: "(domainId = 'MONITOR_ID')") { results { entities { ... on SyntheticMonitorEntityOutline { guid name monitorId } } } } }}이 쿼리는 귀하의 계정에 있는 구형 런타임 모니터에 대한 모든 런타임 업그레이드 테스트 상태를 검색합니다. 이 테스트는 이전 런타임(예: Chrome 72 또는 Node.js API )을 사용하는 프로그램이 최신 런타임(Chrome 100 이상 또는 Node.js 16.10)에서 성공적으로 실행될 수 있는지 여부를 검증합니다. 해당 결과는 런타임 업그레이드 UI 에 표시되어 업그레이드 준비가 된 모니터를 식별하는 데 도움이 됩니다. 테스트 결과는 validationStatus 태그에 저장되며, 업그레이드 테스트가 실패한 경우 자세한 오류 정보는 validationError 태그에서 확인할 수 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 필터링할 검색 쿼리입니다. 런타임 업그레이드 테스트 결과를 모두 검색하려면
사용하십시오. |
샘플 쿼리
{ actor { entitySearch(query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION'") { results { entities { accountId guid name tags { key values } } } } }}이 쿼리는 모니터 ID를 사용하여 특정 구형 런타임 모니터에 대한 런타임 업그레이드 테스트 상태를 검색합니다. 이 기능은 계정에 있는 모든 모니터가 아닌 특정 모니터의 업그레이드 준비 상태를 확인하려는 경우에 유용합니다. 이 테스트는 모니터가 최신 런타임에서 성공적으로 실행될 수 있는지 여부를 검증하며, 이러한 결과는 런타임 업그레이드 UI에 표시됩니다. 테스트 결과는 validationStatus 태그에 저장되며, 업그레이드 테스트가 실패한 경우 자세한 오류 정보는 validationError 태그에서 확인할 수 있습니다.
입력스피커, 변수
매개변수 | 데이터 형식 | 꼭 필요한가요? | 설명 |
|---|---|---|---|
| 문자열 | 네 | 엔티티를 필터링하기 위한 검색 쿼리입니다.
이(가) 특정 모니터의 숫자 ID인 경우
을(를) 사용하세요. |
샘플 쿼리
{ actor { entitySearch( query: "domain = 'SYNTH' AND type = 'RUNTIME_VALIDATION' AND domainId = 'MONITOR_ID'" ) { results { entities { accountId guid name tags { key values } } } } }}