연결 및 수집 확인

Connect는 설정 생성부터 첫 데이터 확인 전까지는 설정 초안으로 관리합니다. 데이터 수집이 확인된 설정만 연결 목록에 등록되므로, 아직 적용 중인 설정과 운영 중인 연결을 구분할 수 있습니다.

진행 중인 설정 확인

카탈로그 검색 아래의 진행 중인 설정에는 아직 데이터 수집을 확인하지 않은 설정이 표시됩니다.

• 계속 설정: 같은 Connect ID와 입력값으로 설정 계획을 다시 엽니다.
• 설정 초안 삭제: 초안과 생성된 Connect ID를 삭제합니다.
• 보관 기한: 각 초안에 표시된 시각 이후 자동으로 삭제됩니다.

다른 카탈로그를 선택해도 초안은 삭제되지 않습니다. 연결 목록에서도 진행 중인 설정 N개 보기를 눌러 카탈로그 화면으로 돌아갈 수 있습니다.

데이터 수집 확인

1. 설정 계획의 설치 · 설정 적용 작업을 실제 환경에 모두 반영합니다.
2. Collector나 애플리케이션을 실행 또는 재시작합니다.
3. 애플리케이션은 실제 요청이나 작업을 실행하고, Custom OTLP는 앞단 송신기에서 데이터를 보냅니다. 인프라·데이터베이스 메트릭은 Collector가 주기적으로 수집하므로 잠시 기다립니다.
4. 3단계 데이터 수집 확인으로 이동합니다.
5. 데이터 수집 확인을 실행합니다.

확인 모달은 다음 결과 중 하나를 표시합니다.

결과	의미	다음 행동
데이터 수집이 확인됨	이 Connect에서 보낸 데이터가 Monithub에 저장되었습니다.	연결 목록에서 보기로 이동합니다.
아직 데이터가 확인되지 않음	조회는 완료됐지만 최근 데이터가 없습니다. 연결 실패로 확정된 상태는 아닙니다.	설정 적용과 실행 상태를 확인한 뒤 수집 확인을 다시 실행합니다.
지금 확인할 수 없음	현재 수집 여부 조회를 완료하지 못했습니다.	잠시 후 다시 확인합니다.
활성 연결 한도 도달	데이터는 확인됐지만 현재 요금제의 연결 한도를 초과했습니다.	기존 연결을 정리하거나 사용 한도를 확인한 뒤 다시 시도합니다.

데이터 수집이 확인되면 초안이 확정 연결로 전환되고 연결 목록에 등록됩니다.

이 결과만으로 필요한 모든 신호가 수집된다고 볼 수는 없습니다. 사용하는 메트릭·로그·트레이스도 각 데이터 조회에서 확인하세요.

연결 목록 읽기

Connect → 연결 목록에는 데이터 수집이 한 번 이상 확인된 연결만 표시됩니다.

항목	의미
수집 대상	설정 생성 시 입력한 이름과 데이터 수집 상태 상세 버튼
카탈로그 · 실행 환경	사용한 카탈로그와 Collector·Agent 실행 환경
데이터 수집 상태	최근 텔레메트리 유입 상태
마지막 데이터 수집 시각	마지막으로 데이터가 확인된 시각
작업	선택한 연결 삭제

상단의 상태 필터로 연결을 좁혀 보고, 상태 새로고침으로 현재 조직의 수집 상태를 다시 조회할 수 있습니다. 수집 대상 옆 정보 버튼을 누르면 Connect ID와 상태 변경·마지막 수집 시각을 확인할 수 있습니다.

데이터 수집 상태

상태	의미	확인할 내용
수집 확인됨	최근 텔레메트리가 확인되었습니다.	대시보드, 로그와 트레이스에서 데이터를 확인합니다.
아직 확인되지 않음	아직 최근 데이터를 확인하지 못했습니다.	수집 프로세스와 대상에서 데이터가 발생하는지 확인합니다.
최근 데이터 지연	최근 데이터가 예상보다 늦게 들어오고 있습니다.	Collector·Agent, 실행 설정과 대상 트래픽을 확인합니다.
최근 데이터 없음	일정 시간 동안 새 데이터가 확인되지 않았습니다.	프로세스 중단, 인증과 네트워크 오류를 확인합니다.
지금 확인할 수 없음	현재 상태 조회를 완료하지 못했습니다.	잠시 후 상태 새로고침을 실행합니다.

이 상태는 Connect 설정의 생성 여부가 아니라 Monithub에 최근 데이터가 들어왔는지를 나타냅니다.

계속 수집하기

설정 계획의 명령으로 수집을 확인했다면, 기존 서비스 관리 도구나 배포 방식에 설정을 반영해 계속 실행되도록 구성합니다.

• 터미널에서 직접 실행한 Collector는 프로세스를 종료하면 수집도 중단됩니다. Linux 서비스나 기존 프로세스 관리 도구에 설정 파일과 환경 변수를 함께 등록하세요.
• Docker는 기존 Compose·배포 정의에 설정 파일, 환경 변수, 네트워크와 필요한 마운트를 반영합니다. docker run --rm은 실행 확인용으로 사용할 수 있지만 종료 후 자동으로 다시 시작되는 구성은 아닙니다.
• 환경 변수를 바꾼 경우 애플리케이션·서비스를 다시 시작합니다. Docker의 --env-file을 수정했다면 기존 컨테이너를 재시작하는 것만으로는 반영되지 않으므로 새 환경 변수로 컨테이너를 다시 생성합니다.
• 여러 대상을 하나의 Collector로 수집한다면 새 연결뿐 아니라 기존 연결의 수집 상태도 함께 확인합니다.

데이터가 확인되지 않을 때

다음 순서로 확인합니다.

1. 현재 설정 계획에서 복사한 설정 파일·환경 변수·명령을 같은 실행 환경에 모두 반영했는지 확인합니다.
2. Collector 또는 애플리케이션 프로세스가 실행 중이고 최근 재시작 이후 오류가 없는지 확인합니다.
3. 애플리케이션에는 실제 요청을 보내고 Custom OTLP 송신기가 데이터를 보내는지 확인합니다. 주기 수집 방식은 Collector가 대상 주소에 접근할 수 있는지 확인합니다.
4. Collector 또는 애플리케이션 로그에서 설정, 권한, 대상 주소, 인증과 전송 오류를 확인합니다.
5. 위 항목을 수정한 뒤 3단계에서 수집 확인을 다시 실행합니다.

Collector 로그에 전송 오류가 표시되면 실행 환경에서 otel.monithub.org:443으로 나가는 HTTPS 연결이 차단되지 않았는지 확인합니다. 외부에서 실행 환경으로 들어오는 포트를 열 필요는 없습니다.

401 또는 403 오류가 표시되면 현재 조직의 최신 Connect 설정인지 확인합니다. 조직 토큰을 갱신한 적이 있다면 모든 Collector·Agent의 Bearer token을 함께 교체해야 합니다.

연결 삭제

연결 목록의 작업 열에서 삭제할 수 있습니다. 삭제하면 Connect의 연결 설정은 복구할 수 없지만 이미 저장된 과거 데이터는 삭제되지 않습니다.

고객 환경에 적용한 Collector, Agent, 환경 변수와 설정 파일도 자동으로 제거되지 않습니다. 더 이상 데이터를 보내지 않으려면 해당 카탈로그 문서에 따라 수집 구성을 중단하거나 기존 설정에 적용의 설정 조각을 제거하세요.

조직 토큰 갱신

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

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

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

다음 단계

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