Connect 시작하기

Connect는 서버, 애플리케이션, 데이터베이스, Kubernetes의 관측 데이터를 Monithub에 연결하는 화면입니다. 수집 대상과 운영 환경을 선택하면 설치 명령과 설정 파일이 현재 조직에 맞게 생성됩니다.

시작하기 전에

• 데이터를 저장할 조직과 수집 대상에 접근할 권한이 필요합니다.
• 수집 대상에서 https://otel.monithub.org로 HTTPS 통신할 수 있어야 합니다.
• 데이터베이스 비밀번호와 TLS 인증서는 Connect에 입력하지 않습니다. 생성된 안내에 표시된 환경 변수나 경로를 Collector 실행 환경에 직접 설정합니다.
• 생성된 설정과 토큰은 공개 저장소, 메신저, 티켓에 공유하지 않습니다.

첫 연결 만들기

1. Monithub 상단에서 데이터를 저장할 조직을 선택합니다.
2. Connect에서 연결할 카탈로그와 설치 대상을 선택합니다.
3. 설정 계획에서 설치 방식을 선택합니다.
4. 연결 정보에 수집 대상 이름과 운영 환경을 입력합니다. 애플리케이션은 서비스 이름을, Kubernetes는 클러스터 ID를 입력합니다.
5. 필요한 추가 항목을 선택하고 설정 생성을 누릅니다.
6. 생성된 블록을 표시된 순서대로 실제 수집 대상에 적용합니다.
7. 애플리케이션 요청, 데이터베이스 쿼리, 컨테이너 실행처럼 수집할 활동을 발생시킵니다.
8. 데이터 수집 확인과 연결 목록에서 신호별 수집 결과를 확인합니다.

설정 생성을 누르면 연결 준비도 함께 시작됩니다. 별도의 시작 버튼을 누를 필요는 없습니다.

화면 따라 연결하기: Linux 호스트 예시

다음은 Linux 서버의 호스트 메트릭과 시스템 로그를 수집하는 예시입니다. 다른 카탈로그도 대상과 설치 환경을 선택하고, 생성된 설정을 적용하는 순서는 같습니다.

1. 대상과 설치 환경 선택하기

1. Linux 호스트 카탈로그를 선택합니다.
2. Collector를 실행할 실제 환경인 Linux를 선택합니다.
3. 수집 대상 이름과 운영 환경을 입력하고 설정 생성을 누릅니다.

2. 생성된 YAML을 파일로 저장하기

1. 호스트 Collector 설정 생성 단계를 선택합니다.
2. 오른쪽의 복사를 눌러 YAML 전체를 복사합니다.

수집 대상 Linux 서버에서 작업 폴더를 만든 뒤 설정 파일 입력을 시작합니다.

mkdir -p ~/monithub-connect/linux-host
cd ~/monithub-connect/linux-host
cat > otelcol-monithub.yaml

복사한 YAML 전체를 붙여 넣고 Ctrl+D를 눌러 저장합니다. 문서의 화면에 보이는 일부 YAML만 옮기거나 인증값을 직접 바꾸지 마세요.

3. Collector 실행하고 확인하기

1. Collector 실행 단계를 선택합니다.
2. 오른쪽의 실행 명령을 복사해 같은 작업 폴더에서 실행합니다.
3. Collector가 실행된 뒤 데이터 수집 확인을 누릅니다. 호스트 메트릭은 수집 주기 이후 표시될 수 있습니다.

otelcol-contrib --config ./otelcol-monithub.yaml

생성된 설정 적용하기

Connect에 표시된 전체 내용을 복사해 해당 블록이 안내하는 위치에 적용합니다. 문서의 예시 값을 대신 사용하거나 서로 다른 연결의 설정을 섞지 않습니다.

생성되는 항목	적용 위치
설치 명령	Collector 또는 Agent를 실행할 서버의 터미널
Collector YAML	안내된 파일명의 설정 파일
환경 변수	애플리케이션이나 Collector를 시작하는 셸·배포 환경
실행 명령	실제 애플리케이션 또는 Collector 실행 환경
Dockerfile 조각	애플리케이션 이미지의 Dockerfile
Helm values	연결할 Kubernetes 클러스터의 배포 작업 폴더

Collector 설정은 위 예시처럼 Connect에서 생성된 전체 내용을 파일로 저장한 뒤 실행합니다. 파일명과 명령은 Connect에 생성된 값을 우선합니다.

이미 Collector나 지원되는 애플리케이션 설정을 사용 중이라면 기존 설정 수정을 선택하고 기존 설정에 적용을 따릅니다.

어떤 카탈로그를 선택할까요?

연결할 대상	카탈로그
이미 OTLP를 보내는 서비스	커스텀 OTLP
Java, Node.js, Python 서비스	애플리케이션
Linux 서버, Docker Engine, NGINX	인프라
PostgreSQL, MySQL·MariaDB, Redis	데이터베이스
Kubernetes 클러스터	Kubernetes

지원 신호와 환경을 비교하려면 전체 카탈로그를 확인하세요.

데이터 수집 확인하기

Collector나 애플리케이션이 실행된 것만으로 수집이 확인되지는 않습니다. 대상에서 실제 활동을 발생시킨 뒤 필요한 신호의 최근 데이터가 표시되는지 확인합니다.

• 애플리케이션: HTTP 요청, 배치 작업, 메시지 처리
• Linux·Docker·Kubernetes: 일반적인 시스템 또는 컨테이너 활동
• 데이터베이스: 안전한 조회 쿼리
• NGINX: stub_status가 활성화된 서버로 요청
• 커스텀 OTLP: 앞단 송신기에서 실제 OTLP 데이터 전송

상태의 의미와 다시 확인하는 방법은 연결 및 수집 확인에서 안내합니다.

다음 문서

• 전체 카탈로그: 지원 대상, 신호, 설치 환경 비교
• Custom OTLP: 기존 OpenTelemetry 송신기 연결
• 애플리케이션: Java, Node.js, Python 연결
• 인프라: Linux 호스트, Docker, NGINX 연결
• 데이터베이스: PostgreSQL, MySQL·MariaDB, Redis 연결
• Kubernetes: Kubernetes 클러스터 연결