Grafana 모니터링 연동

개요#

파일 전송 작업과 기기 상태 변화를 Grafana에 주석(Annotation)으로 기록하여 모니터링하려면 Grafana 연동을 설정할 수 있습니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 Grafana에 주석이 생성되며, 지정한 기본 태그(Default Tags)로 대시보드에서 필터링하여 확인할 수 있습니다.

전체 과정은 ① 서비스 계정 토큰 발급 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항#

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

Grafana 서비스 계정 토큰 발급#

Grafana에 주석을 기록하려면 서비스 계정(Service Account) 을 생성하고 서비스 계정 토큰을 발급받습니다.

Step 1. 서비스 계정 생성#

Grafana에서 Administration → Users and access → Service accounts → Add service account로 이동합니다.

서비스 계정 이름을 입력하고 역할(Role)을 지정합니다.

ℹ️ 주석 생성에는 Editor 이상의 권한이 필요합니다.

Step 2. 서비스 계정 토큰 생성#

생성한 서비스 계정에서 Add service account token을 클릭합니다.

토큰 이름(필요 시 만료일)을 지정한 후 Generate를 클릭하여 토큰을 생성합니다.

ℹ️ 토큰은 생성 시 한 번만 표시되므로 안전한 위치에 복사하여 보관합니다. 서비스 계정 토큰은 비밀번호와 동일한 권한을 가지므로 외부에 노출되지 않도록 주의합니다. 유출된 경우 해당 토큰을 삭제하고 새로 발급합니다.

Step 3. Grafana Base URL 확인#

주석을 기록할 Grafana 인스턴스의 주소를 확인합니다.

예시:

https://grafana.company.com

확인 사항#

• ✔ Editor 이상의 서비스 계정을 생성했습니다.
• ✔ 서비스 계정 토큰을 발급했습니다.
• ✔ Grafana Base URL을 확인했습니다.

Grafana 연동 설정#

확인한 정보를 제품에 입력합니다.

Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

Step 1. Grafana Base URL 입력#

Grafana Base URL 항목에 Grafana 주소를 입력합니다.

Step 2. Service Account Token 입력#

Service Account Token (Bearer) 항목에 발급한 토큰을 입력합니다.

Step 3. Default Tags 입력#

Default Tags 항목에 주석에 사용할 기본 태그를 쉼표(,)로 구분하여 입력합니다.

예시:

INNORIX, production

입력한 태그를 기준으로 Grafana 대시보드에서 주석을 필터링할 수 있습니다.

Step 4. 이벤트 선택#

Events 항목에서 모니터링할 이벤트를 선택합니다.

여러 개를 선택할 수 있으며 선택한 이벤트가 발생할 때만 Grafana에 주석이 생성됩니다.

Step 5. 설정 저장#

입력을 완료한 후 Add를 클릭하여 연동을 저장합니다.

확인 사항#

• ✔ Grafana Base URL이 입력되었습니다.
• ✔ Service Account Token이 입력되었습니다.
• ✔ Default Tags가 입력되었습니다.
• ✔ 모니터링할 이벤트가 선택되었습니다.

연동 확인#

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

Step 1. 테스트 이벤트 발생#

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

Step 2. Grafana 확인#

Grafana 대시보드에서 지정한 태그의 주석이 생성되었는지 확인합니다.

확인 사항#

• ✔ Grafana에 주석이 생성되었습니다.
• ✔ 발생한 이벤트가 정상적으로 전달되었습니다.

설정 완료#

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

이후 선택한 이벤트가 발생할 때마다 Grafana에 주석이 자동으로 생성됩니다.

문제 해결 (Troubleshooting)#