뉴렐릭 사용자로서 동일한 NRQL 쿼리를 반복해서 실행하여 중요한 패턴을 모니터링하고, 특정 조건을 확인하거나, 정기적인 보고서를 생성할 수 있습니다. 예를 들어, 실패한 거래를 매일 확인하거나, 매주 모니터링하거나, 전체에 걸쳐 시간별 성능 지표를 추적해야 합니다. 이러한 수동 프로세스는 시간이 많이 걸리고 적극적으로 모니터링하지 않으면 중요한 인사이트를 놓치기 쉽습니다.
예약된 NRQL 검색은 반복적인 쿼리를 자동화하여 이 문제를 해결합니다. 자동으로 실행되도록 쿼리를 예약하고 이메일로 결과를 받을 수 있으므로, 지속적으로 수동으로 모니터링하지 않고도 중요한 패턴에 대한 정보를 얻을 수 있습니다.
당신이 할 수 있는 일
예약된 NRQL 검색을 사용하면 다음을 수행할 수 있습니다.
- 반복적인 쿼리 흐름 자동화: 수동 쿼리를 일정에 따라 실행되는 자동화된 쿼리 흐름으로 변환합니다.
- 어디서든 시작: 관리 또는 로그 UI에서 직접 예약된 검색을 생성하십시오.
- 사전에 정보를 받아보세요: 쿼리 결과가 담긴 공지 이메일을 받은편지함으로 직접 전달됩니다.
- 공지 조건 설정: 매 실행 시 공지를 받을지, 아니면 쿼리의 결과 수를 기반으로 정의한 조건을 결과가 충족할 때만 공지를 받을지 선택하십시오.
- 유연한 일정 예약: 사용자 지정 크론 표현식 일정을 사용하여 쿼리가 실행되는 시기를 정의하십시오.
- 출력 형식을 선택하십시오: 결과를 이메일 공지에 첨부된 CSV 또는 JSON 파일로 내보냅니다.
- 팀과 협업하십시오: 예약된 검색 결과를 여러 이메일 수신자에게 전송하십시오.
- 모든 항목을 중앙에서 관리하십시오: 생성한 위치에 관계없이 관리 UI의 단일 위치에서 예약된 모든 검색을 보고, 편집하고, 관리하십시오.
가격
예약된 NRQL 검색에는 별도의 가격이 책정되지 않습니다. 계정의 가격 책정 모델에 따라 기본 NRQL 쿼리를 실행하는 데 드는 표준 쿼리 비용만 지불하시면 됩니다.
전제 조건
예약된 NRQL 검색을 사용하려면 다음이 필요합니다.
- 계정 액세스: 검색을 예약하려는 계정에 액세스합니다.
- 데이터 접근: 예약하려는 데이터를 쿼리하기 위한 적절한 권한. 예를 들어, 로그 데이터에 대한 쿼리를 예약하는 경우 해당 로그 데이터에 액세스해야 합니다.
권한
기본적으로 All product admin 및 Standard user 표준 역할에는 예약된 검색에 대한 Read 및 Modify 액세스 권한이 이미 포함되어 있으며, All product admin 에만 Delete 액세스 권한이 포함되어 있습니다. 이러한 역할에는 예약된 검색에 필요한 두 가지 기능도 이미 포함되어 있습니다:
- User API Keys (for self) > Modify (
account.create.own_api_keys): 뉴렐릭에서 검색을 성공적으로 실행하려면 이것이 필요합니다. - Workflow Schedules > Read (
workflow_automation.read.schedules): 예약된 검색 목록을 조회하는 데 필요합니다.
사용자 지정 역할을 생성 하고 특정 Scheduled Search 기능을 할당하려면 다음 방법 중 하나를 사용하십시오:
- NerdGraph: NerdGraph를 통해 계정 범위의 사용자 지정 역할을 생성하고, 다음 표의 권한 ID를
permissionIds어레이에 추가하십시오. - UI: 새 사용자 지정 역할을 생성하거나 기존 역할을 편집하여 Scheduled Search and Reports 섹션에서 Scheduled Search 기능을 추가하십시오.
중요
일부 기능은 다른 기능보다 더 광범위한 액세스 권한을 부여합니다. 예를 들어, Delete은(는) 읽기 및 수정 액세스 권한도 부여합니다. 더 제한적인 기능만 부여하려면 Delete 대신 해당 특정 기능을 선택하십시오.
다음 표는 각 기능, 해당 권한 ID 및 부여하는 항목을 나열합니다:
능력 | 권한 ID | 설명 |
|---|---|---|
Scheduled Search > Read |
| 예약된 검색 보기 |
Scheduled Search > Modify |
| 예약된 검색 보기, 생성 및 편집 |
Scheduled Search > Delete |
| 예약된 검색 보기, 생성, 편집 및 삭제 |
User API Keys (for self) > Modify |
| 예약된 검색을 실행하는 데 필요합니다. 뉴렐릭은 사용자 컨텍스트를 유지하기 위해 사용자를 대신하여 사용자 API 키를 생성하는 데 이를 사용합니다. 이것이 없으면 실행이 실패합니다. |
Workflow Schedules > Read |
| 예약된 검색 목록을 조회하는 데 필요합니다. |
새로운 검색 일정을 예약하세요
뉴렐릭은 제품 내에서 직접 이 흐름을 안내해 드립니다. 아래의 각 단계는 해당 위치에서 수행해야 할 작업과 화면에서 명확하게 알 수 없는 내용을 다룹니다.
예약된 검색 생성 흐름에 액세스하십시오:
워크플로우에 맞는 진입점을 선택하십시오. 두 가지 모두 동일한 설정 흐름으로 이어집니다.
one.newrelic.com > Administration > Scheduled Searches 으로 이동하여 Schedule a search 클릭합니다.
로그 UI에서 다음 옵션 중 하나를 사용하십시오:
오른쪽 상단에서 메뉴를 클릭하고 Schedule a search을 선택합니다.
쿼리 트렌드 차트 아래에서 시계 아이콘을 클릭하십시오.
이미 쿼리를 작성하고 실행한 경우, 설정 흐름으로 전달됩니다. 그렇지 않은 경우, 다음 단계에서 쿼리를 작성할 수 있습니다.
팁
관리 또는 로그 UI에서 예약된 검색을 생성할 수 있지만, 기존의 예약된 검색은 Administration > Scheduled Searches에서만 조회, 편집 또는 삭제할 수 있습니다.
쿼리를 구성하세요:
NRQL 쿼리를 작성하고 테스트한 후 계속 진행하십시오.
설정 공지:
다음을 설정하십시오:
검색의 이름을 지정한 다음 결과의 대상을 설정하십시오. 결과는 이메일 대상으로만 전송할 수 있습니다.
- 대상이 존재하면 목록에서 선택하십시오.
- 존재하지 않는 경우 하나 이상의 이메일 수신자를 추가하고 대상의 이름을 지정하십시오.
이메일의 제목, 메시지 및 출력 형식을 선택하십시오.
Send notification에서 공지 조건을 설정하십시오. 기본값은 Always입니다. 결과가 정의한 개수를 충족할 때만 전송하려면 여기에서 맞춤 설정하십시오.
주의
예약된 검색 결과는 CSV 또는 JSON 파일로 이메일에 첨부되며 민감한 데이터를 포함할 수 있습니다. 의도한 수신자만 포함되어 있는지 확인하려면 이메일 수신지를 검토하십시오.
일정을 설정하세요:
다음을 선택합니다:
빈도를 선택하십시오: 매시간, 매일, 매주 또는 사용자 지정 크론 표현식.
일정의 시간대를 선택하십시오.
cron 표현식을 사용하는 경우, 참고할 수 있는 몇 가지 일반적인 패턴은 다음과 같습니다:
0 * * * *- 매시 정각에0 9 * * *- 매일 오전 9시0 9 * * 1- 매주 월요일 오전 9시0 0 1 * *- 매월 1일 자정*/15 * * * *- 15분마다0 9 * * 1-5- 매주 평일 오전 9시팁
지원되는 가장 짧은 간격은 10분입니다.
매 실행 시 전송하는 대신 공지 조건을 설정하면, 뉴렐릭은 정확히 예약된 런타임에 조건을 확인합니다. 실행 간의 변동을 추적하지 않으므로, 다음 실행 전에 결과가 조건의 임계값 아래로 떨어지면 해당 실행에 대한 공지를 받지 못합니다.
검색 검토, 확인 및 예약:
설정을 검토한 다음 검색을 예약하십시오. Scheduled searches 페이지에 나타납니다.
예약된 검색 관리
관리 UI의 Scheduled searches 페이지에는 로그 UI에서 생성한 검색을 포함하여 모든 자동화된 검색이 나열됩니다. 메뉴에서 권한에 따라 검색을 보거나 편집하거나 삭제할 수 있습니다.
관련 주제
관련 정보는 다음을 참조하십시오.
- 더욱 정교한 자동 검색을 생성하기 위한 NRQL 쿼리에 대해 자세히 알아보세요.
- 공지 이메일 대상지를 구성하여 공지 옵션을 확장하세요.
- 보다 고급 자동화 기능을 활용하려면 귀우 자동화를 살펴보세요.