연결 및 수집 확인

Connect → 연결 목록에서는 현재 조직에서 만든 연결을 한곳에서 관리합니다. 연결 이름, 카탈로그, 연결 상태, 데이터 수집 상태, 마지막 수집 시각, 생성 시각을 확인할 수 있습니다.

1. 연결 상태에서 설정 생성 후 연결 구성이 완료됐는지 확인합니다.
2. 데이터 수집 상태에서 최근 텔레메트리 유입 여부를 확인합니다.
3. 마지막 데이터 수집 시각에서 마지막으로 데이터가 들어온 시간을 확인합니다.

연결 상태와 수집 상태 구분하기

두 상태는 서로 다른 내용을 나타냅니다.

항목	의미
연결 상태	설정 생성 후 연결 구성이 완료됐는지 나타냅니다.
데이터 수집 상태	Monithub에 최근 텔레메트리가 들어오고 있는지 나타냅니다.

따라서 연결됨이 표시돼도 수집 대상에서 데이터가 발생하지 않거나 Collector·Agent가 중단되면 수집 지연 또는 최근 데이터 없음이 표시될 수 있습니다.

연결 상태 확인하기

상태	의미	할 일
연결됨	연결 설정이 활성화되었습니다.	데이터 수집 상태와 마지막 수집 시각을 확인합니다.
대기 중·연결 중	연결 구성이 진행 중입니다.	완료될 때까지 기다립니다.
연결 실패	연결 과정이 완료되지 않았습니다.	표시된 안내를 확인한 뒤 재시도를 누릅니다.
연결 시간 만료	정해진 시간 안에 연결을 완료하지 못했습니다.	수집 환경을 확인하고 재시도를 누릅니다.
연결 해제	현재 연결이 활성 상태가 아닙니다.	다시 사용할 경우 다시 연결을 누릅니다.

화면을 다시 열거나 브라우저 탭으로 돌아오면 최신 상태를 다시 불러옵니다. 진행 상태가 오래 바뀌지 않으면 목록을 새로고침한 뒤 Collector·Agent의 실행 상태를 확인합니다.

데이터 수집 상태 확인하기

상태	의미	할 일
수집 정상	최근 텔레메트리가 확인되었습니다.	대시보드, 로그, 트레이스에서 데이터를 확인합니다.
수집 확인 중	첫 데이터 또는 최신 상태를 확인하고 있습니다.	수집 대상에서 실제 작업을 발생시키고 잠시 기다립니다.
수집 지연	마지막 수집 후 3분이 지났습니다.	Collector·Agent, 네트워크, 수집 대상 트래픽을 확인합니다.
최근 데이터 없음	마지막 수집 후 5분이 지났거나 아직 데이터가 없습니다.	실행 설정과 인증 오류를 확인합니다.
수집 상태 확인 불가	현재 상태 조회를 완료하지 못했습니다.	잠시 후 새로고침하고 같은 문제가 반복되는지 확인합니다.

연결 이름 옆의 상태 상세 버튼을 누르면 Connect ID, 상태 확인 시작 시각, 상태 변경 시각, 마지막 수집 시각을 볼 수 있습니다. 표 제목의 새로고침 버튼은 현재 조직의 수집 상태를 다시 조회합니다.

데이터 수집 확인 사용하기

설정 계획 화면의 데이터 수집 확인은 최근 메트릭, 로그, 트레이스를 신호별로 확인합니다.

• 수집 확인: 해당 신호의 최근 데이터가 있습니다.
• 아직 없음: 조회는 성공했지만 해당 신호 데이터가 아직 없습니다.
• 확인하지 못함: 현재 해당 신호를 조회할 수 없습니다. 잠시 후 다시 시도합니다.

카탈로그가 모든 신호를 자동으로 만드는 것은 아닙니다. 예를 들어 커스텀 OTLP는 앞단 송신기가 보낸 신호만 확인되고, Java 애플리케이션은 실제 애플리케이션 요청과 지원 logger 사용 여부에 따라 결과가 달라집니다.

다시 선택, 재시도와 삭제

설정 생성 후 카탈로그나 실행 환경을 바꾸려면 화면 위쪽의 다시 선택을 누릅니다.

• 수집된 데이터가 있는 연결: 연결 유지하고 새로 추가, 연결 삭제하고 다시 선택, 닫기 중에서 선택합니다.

• 수집된 데이터가 없는 연결: 연결 삭제하고 다시 선택하거나 모달을 닫습니다.

• 연결을 삭제해도 이미 수집된 과거 데이터는 삭제되지 않습니다.

• 재시도는 실패하거나 만료된 연결의 활성화를 다시 요청합니다. 먼저 수집 환경의 설정과 네트워크를 확인합니다.

• 다시 연결은 해제된 연결을 다시 활성화합니다.

• 삭제는 선택한 연결과 Monithub에 저장된 설정 계획을 제거하며 되돌릴 수 없습니다.

연결을 삭제해도 고객 환경에 적용한 수집 구성은 자동으로 중단되지 않습니다. 더 이상 전송하지 않을 경우 해당 카탈로그의 적용 가이드에 따라 수집 구성을 중단합니다.

조직 토큰 갱신

토큰 갱신은 현재 조직의 모든 Connect가 사용하는 조직 토큰을 새 값으로 교체합니다. 한 연결만 변경하는 기능이 아닙니다.

1. 갱신 확인창에서 영향을 받는 모든 Collector와 Agent를 다시 설정할 수 있는지 확인합니다.
2. 토큰 갱신을 누릅니다.
3. 한 번만 표시되는 새 토큰을 즉시 복사해 안전한 비밀 저장소에 보관합니다.
4. 현재 조직의 모든 Collector, Agent, Operator 설정에서 기존 Bearer token을 교체합니다.
5. 각 수집기를 재시작하거나 배포 설정을 다시 적용합니다.
6. 연결 목록과 데이터 수집 확인에서 복구 여부를 확인합니다.

기존 토큰은 갱신 즉시 사용할 수 없게 됩니다. 일부 수집기만 교체하면 나머지 연결에서 403 응답과 수집 중단이 발생합니다.

다음 단계

수집이 정상이라면 대시보드에서 메트릭을 확인하고, 서비스 맵에서 서비스 간 흐름을 확인합니다. 연결된 데이터를 정기 분석하려면 Sentinel 주기 분석을 확인합니다.