Integrate New Relic Monitoring

개요

파일 전송 작업과 기기 상태 변화를 New Relic으로 전송하여 모니터링하려면 New Relic 연동을 설정할 수 있습니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 New Relic으로 이벤트가 전송되어 New Relic에서 모니터링할 수 있습니다.

전체 과정은 ① Ingest License Key 발급 및 Data Region 확인 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

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으로 전송됩니다.

Step 4. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ Ingest License Key가 입력되었습니다.

✔ Data Region이 선택되었습니다.

✔ 모니터링할 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.

Step 2. New Relic 확인

New Relic에서 해당 이벤트가 수신되었는지 확인합니다.

확인 사항

✔ New Relic에 이벤트가 도착했습니다.

✔ 발생한 이벤트가 정상적으로 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 New Relic으로 이벤트가 자동으로 전송됩니다.

문제 해결 (Troubleshooting)