본문으로 건너뛰기

OpenMetrics 에이전트 설치

OpenAgent는 Prometheus 엔드포인트에서 메트릭을 수집해 와탭 서버로 전송하는 에이전트입니다. SingleStore 프로젝트에서 OpenMetrics 탐색기와 템플릿을 사용하려면 먼저 OpenAgent를 설치해야 합니다.

OpenAgent 동작에는 다음 세 파일이 같은 디렉터리에 필요합니다.

FileDescription
openagent메트릭 수집·전송 실행 파일
whatap.conf라이센스·수집 서버 주소 등 기본 설정
scrape_config.yaml스크래핑 대상(엔드포인트) 정의

설치 절차 요약​

  1. 설치 디렉터리 생성 후 아키텍처에 맞는 바이너리 다운로드(AMD64/ARM64).

    mkdir -p /opt/whatap/openagent
    cd /opt/whatap/openagent
    wget https://repo.whatap.io/openagent/latest/amd/openagent
    chmod +x openagent

  2. whatap.conf에 라이센스·서버 주소·포트 입력.

    echo "WHATAP_LICENSE=your-whatap-license" >> whatap.conf
    echo "WHATAP_HOST=your-whatap-host"       >> whatap.conf
    echo "WHATAP_PORT=your-whatap-port"       >> whatap.conf

  3. scrape_config.yaml에 수집 대상 엔드포인트 정의(수정 시 자동 재로드, 재시작 불필요).

  4. standalone 모드로 실행.

    ./openagent standalone
노트

전체 설치 절차·실행 모드·scrape_config.yaml 상세 옵션(StaticEndpoints·params·metricRelabelConfigs)과 설정 항목은 OpenAgent 설치 및 OpenAgent 설정 문서를 참고하세요. 쿠버네티스 환경은 OpenAgent 쿠버네티스 구성을 따릅니다.

노트

macOS Apple Silicon은 지원되지 않습니다. Linux AMD64 또는 ARM64에서만 동작합니다.

최종 수정: