Connect 시작하기

전체 문서 PDF

Connect는 서버, 애플리케이션, 데이터베이스, Kubernetes의 관측 데이터를 Monithub로 전송하기 위한 설정을 생성합니다. 연결할 카탈로그와 실행 환경을 선택하면 현재 조직에 맞는 설정 파일과 적용 명령을 안내합니다.

시작하기 전에

수집 설정을 적용하고 필요한 프로세스를 실행하거나 재시작할 수 있는 작업 권한이 필요합니다. 데이터베이스 계정처럼 카탈로그별로 필요한 권한은 각 연결 문서에서 확인합니다.
데이터베이스 비밀번호와 TLS 인증서는 Connect에 입력하지 않습니다. 생성된 안내에 표시된 환경 변수나 경로를 Collector 실행 환경에 직접 설정합니다.
생성된 설정과 토큰은 공개 저장소, 메신저, 티켓에 공유하지 않습니다.

첫 연결 만들기

Monithub 상단에서 데이터를 저장할 조직을 선택합니다.
Connect에서 연결할 카탈로그와 실행 환경을 선택합니다.
연결 정보의 필수 항목과 카탈로그별 추가 항목을 입력합니다.
설정 생성을 누릅니다.
설치 · 설정 적용에 표시된 작업을 번호 순서대로 펼쳐 실제 실행 환경에 반영합니다.
카탈로그에 맞게 데이터가 전송되는지 확인한 뒤 데이터 수집 확인을 실행합니다.

이름과 운영 환경 입력란에 보이는 값은 형식만 보여주는 예시입니다. 실제 값을 입력해야 설정을 생성할 수 있습니다.

Monithub_Connect 조직에서 PostgreSQL의 Docker 실행 환경과 orders-db 연결 정보를 입력한 화면

설정을 생성하면 데이터 수집이 확인되기 전까지 설정 초안으로 저장됩니다. 다른 카탈로그를 선택해도 초안은 유지되며, 카탈로그 목록의 진행 중인 설정에서 다시 열 수 있습니다. 데이터 수집이 확인된 설정만 연결 목록에 등록됩니다.

설정 진행 단계

단계	할 일
`1 대상 및 연결 정보`	카탈로그, 실행 환경과 연결 정보를 확인하거나 수정합니다.
`2 설치 · 설정 적용`	필요한 작업을 하나씩 펼쳐 설정과 명령을 실제 환경에 적용합니다.
`3 데이터 수집 확인`	Monithub에 데이터가 도착했는지 확인하고 연결을 등록합니다.

2단계의 작업은 한 번에 하나만 펼쳐집니다. 코드가 길면 코드 박스 안에서 스크롤하고, 오른쪽의 복사를 사용해 전체 내용을 복사합니다.

Custom OTLP 설정 적용 단계에서 Collector 실행 작업과 복사할 명령을 펼친 화면

생성된 설정 적용하기

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

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

파일명과 명령은 현재 설정 계획에 표시된 값을 우선합니다. 설정을 적용한 뒤에는 해당 Collector나 애플리케이션을 기존 운영 방식으로 실행하거나 재시작합니다.

플레이스홀더 바꾸기

Connect 코드에 {REPLACE_WITH_...}로 표시된 값은 그대로 실행할 수 없는 플레이스홀더입니다. 복사한 뒤 endpoint, 계정, 파일 경로, Docker network, 이미지 이름 등을 실제 환경 값으로 바꾸세요.

{REPLACE_WITH_MYSQL_ENV_FILE_PATH} → /srv/monithub/mysql-collector.env
{REPLACE_WITH_PRIVATE_NETWORK} → observability-private
{REPLACE_WITH_YOUR_IMAGE:TAG} → checkout-api:1.4.0

${env:MYSQL_ENDPOINT}는 Collector가 환경 변수를 읽는 설정 문법입니다. 실제 주소·비밀번호를 여기에 직접 넣지 말고 실행 환경의 변수에 설정하세요. 기존 설정에 추가할 때는 안내에 따라 변수 이름의 접두어를 함께 바꿉니다.
코드 박스의 복사를 사용하고 명령의 실행 순서와 줄바꿈을 유지하세요.

환경 변수는 Collector나 애플리케이션이 시작되는 환경에 설정해야 합니다. 터미널에서 설정한 값은 이미 실행 중인 프로세스나 별도의 서비스에 자동으로 전달되지 않습니다. Docker에서는 코드가 export KEY=VALUE 형식인지, --env-file용 KEY=VALUE 형식인지 구분하세요. 실행 환경별 적용 방법은 각 카탈로그 문서에서 안내합니다.

이미 Collector를 운영 중이고 선택한 카탈로그가 이 방식을 지원한다면, 설정 생성 후 설치 · 설정 적용에서 기존 수집 설정에 추가를 선택하고 기존 설정에 적용을 따릅니다.

카탈로그 선택하기

연결할 대상	카탈로그 문서
이미 OTLP를 보내거나 여러 서비스의 OTLP 데이터를 한곳에 모으는 환경	Custom OTLP
Java, Node.js, Python 서비스	애플리케이션
Linux 서버, Docker Engine, NGINX	인프라
PostgreSQL, MySQL, Redis	데이터베이스
Kubernetes 클러스터	Kubernetes

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

데이터 수집 확인하기

Collector나 애플리케이션이 실행된 것만으로 Monithub까지 데이터가 전달됐다고 볼 수는 없습니다. 다음과 같이 데이터를 준비한 뒤 3단계의 데이터 수집 확인을 실행합니다.

애플리케이션: 계측이 적용된 애플리케이션에서 HTTP 요청이나 기존 작업을 실행합니다. 로그를 확인하려면 지원되는 로깅 라이브러리로 로그도 남깁니다.
인프라·데이터베이스: Collector가 대상에 접근하면 메트릭을 주기적으로 수집합니다. 확인을 위해 별도의 부하나 데이터 변경 작업을 만들 필요는 없습니다.
Custom OTLP: 앞단 송신기에서 실제 OTLP 데이터 전송

확인이 완료되면 설정이 연결 목록에 등록됩니다. 데이터가 확인되지 않는 경우는 연결 및 수집 확인에서 원인을 순서대로 점검하세요.