개요#
파일 전송 작업과 기기 상태 변화를 New Relic으로 전송하여 모니터링하려면 New Relic 연동을 설정할 수 있습니다.
연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 New Relic으로 이벤트가 전송되어 New Relic에서 모니터링할 수 있습니다.
전체 과정은 ① Ingest License Key 발급 및 Data Region 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.
준비 사항#
시작하기 전에 다음 사항을 확인하세요.
| 항목 | 설명 |
|---|---|
| New Relic 계정 | Ingest License Key를 확인하거나 발급할 수 있는 New Relic 계정이 필요합니다. |
| Data Region | 계정의 데이터 리전(US 또는 EU)을 확인합니다. |
| 네트워크 | 제품이 설치된 환경에서 선택한 Data Region의 New Relic Ingest 엔드포인트로의 외부 HTTPS(443) 통신이 허용되어야 합니다. |
Ingest License Key 발급 및 Data Region 확인#
New Relic으로 데이터를 전송하려면 Ingest License Key가 필요하며, 계정의 Data Region도 함께 확인합니다.
Step 1. Ingest License Key 확인#
New Relic에서 좌측 하단의 사용자 메뉴를 클릭한 후 API Keys(또는 Administration → API Keys)로 이동합니다.
키 유형이 Ingest - License인 키를 확인하고 복사합니다.
새 키가 필요한 경우 Create a Key → Ingest - License를 선택하여 발급합니다.
License Key는 일반적으로 NRAL로 끝납니다.
ℹ️ 이 키는 계정으로 데이터를 전송할 수 있는 권한을 가지므로 비밀번호처럼 취급하여 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다. 유출된 경우 기존 키를 Rotate하거나 새로 발급합니다.
Step 2. Data Region 확인#
계정이 US 또는 EU 중 어느 Data Region에 속하는지 확인합니다.
ℹ️ Data Region은 계정 생성 시 선택되며, 제품 설정에서도 동일한 값을 선택해야 합니다. 리전이 일치하지 않으면 데이터가 정상적으로 수집되지 않습니다.
확인 사항#
- ✔ Ingest License Key를 확인했습니다.
- ✔ Data Region을 확인했습니다.
New Relic 연동 설정#
확인한 License Key와 Data Region을 제품의 설정에 입력합니다.
Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.
Step 1. Ingest License Key 입력#
Ingest License Key 항목에 복사한 License Key를 입력합니다.
Step 2. Data Region 선택#
Data Region 드롭다운에서 계정의 Data Region을 선택합니다.
License Key를 발급한 계정의 Data Region과 동일해야 합니다.
Step 3. 이벤트 선택#
Events 항목에서 모니터링할 이벤트를 선택합니다.
여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 New Relic으로 전송됩니다.
| 이벤트 | 발생 시점 |
|---|---|
| Transfer Started | 전송 작업이 시작되었을 때 |
| Transfer Completed | 전송이 정상적으로 완료되었을 때 |
| Transfer Paused | 전송이 일시 중지되었을 때 |
| Transfer Recovered | 중단 또는 오류 후 전송이 자동 복구되어 재개되었을 때 |
| Device Connected | 기기가 연결되었을 때 |
| Device Disconnected | 기기 연결이 해제되었을 때 |
Step 4. 설정 저장#
입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.
확인 사항#
- ✔ Ingest License Key가 입력되었습니다.
- ✔ Data Region이 선택되었습니다.
- ✔ 모니터링할 이벤트가 선택되었습니다.
연동 확인#
설정이 정상적으로 동작하는지 확인합니다.
Step 1. 테스트 이벤트 발생#
실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.
Step 2. New Relic 확인#
New Relic에서 해당 이벤트가 수신되었는지 확인합니다.
확인 사항#
- ✔ New Relic에 이벤트가 도착했습니다.
- ✔ 발생한 이벤트가 정상적으로 전달되었습니다.
설정 완료#
설정을 저장하면 연동이 적용됩니다.
이후 선택한 이벤트가 발생할 때마다 New Relic으로 이벤트가 자동으로 전송됩니다.
문제 해결 (Troubleshooting)#
| 문제 | 확인 사항 |
|---|---|
| 이벤트가 표시되지 않음 | Ingest License Key와 Data Region이 정확한지, 앞뒤 공백이나 누락이 없는지 확인 |
| 인증 오류가 발생함 | License Key가 올바른지(NRAL로 끝남), Rotate 또는 재발급되지 않았는지 확인 |
| Region 불일치 | 계정의 Data Region과 제품 설정의 Data Region이 동일한지 확인 (US 계정 키는 EU 엔드포인트에서 사용할 수 없음) |
| 키 유형 오류 | 사용한 키가 Ingest - License 유형인지 확인 (User API Key 등 다른 유형은 사용할 수 없음) |
| 폐쇄망에서 연동 실패 | 선택한 Data Region의 New Relic Ingest 엔드포인트(443)로의 아웃바운드 HTTPS 통신이 방화벽 또는 프록시에서 허용되는지 확인 |