Parca 데이터 소스 구성

Parca 데이터 소스 구성 (Configure the Parca data source)

이 문서는 Grafana에서 Parca 데이터 소스를 구성하는 방법을 설명해요. Grafana UI, YAML 프로비저닝 파일, 또는 Terraform으로 구성할 수 있습니다.

경고: 이 플러그인은 더 이상 지원되지 않으며(deprecated) 보안 업데이트만 받을 예정이에요. 지원은 2027년 1월 2일에 종료됩니다.

출처: 문서

본문

Parca 데이터 소스를 Grafana UI, YAML 프로비저닝 파일, Terraform으로 구성할 수 있어요. UI에서 변경하면 Save & test 를 선택해 변경 사항을 보존하세요.

시작하기 전에 (Before you begin)

Grafana 권한: Organization administrator 역할
Parca 인스턴스: Grafana 서버에서 접근 가능한 실행 중인 Parca 인스턴스(v0.19 이상)
데이터 소스를 프로비저닝하려면 Grafana 인스턴스를 호스팅하는 서버의 관리 권한도 필요해요.

데이터 소스 추가 (Add the data source)

왼쪽 메뉴에서 Connections 를 클릭합니다.
Add new connection 을 클릭합니다.
검색창에 Parca 를 입력합니다.
Parca 를 선택합니다.
Add new data source 를 클릭합니다.

설정 구성 (Configure settings)

Settings 탭에는 다음 구성 섹션이 있어요.

기본 설정(Basic settings):

설정	설명
Name	패널, 쿼리, Explore에서 이 데이터 소스를 식별할 이름
Default	새 패널의 기본 데이터 소스로 만들 토글

연결(Connection):

설정	설명
URL	Parca 인스턴스의 URL. 예: `http://localhost:7070`. Grafana는 gRPC-Web을 사용해 Parca에 연결하므로 URL은 Parca HTTP 엔드포인트를 가리켜야 함

인증(Authentication): 사용 가능한 방법:

방법	설명
Basic authentication	사용자명·비밀번호로 인증. User 와 Password 필드에 값 입력
Forward OAuth Identity	로그인한 사용자의 OAuth 토큰을 데이터 소스로 전달
No Authentication	자격 증명 없이 연결. Parca 인스턴스가 인증을 요구하지 않을 때 사용

TLS 설정: Parca와의 안전한 통신을 위한 TLS 구성.

설정	설명
Add self-signed certificate	CA 인증서를 제공하는 토글. 활성화 시 CA Certificate 필드에 CA 인증서 붙여넣기
TLS Client Authentication	상호 TLS(mTLS) 활성화 토글. 활성화 시 Server Name, Client Certificate, Client Key 제공
Skip TLS certificate validation	서버 인증서 검증 건너뛰기 토글. 테스트용으로만 사용

참고: Parca 작업 시 추가 보안 계층으로 Transport Layer Security(TLS)를 사용하세요.

Custom HTTP headers: Parca에 보내는 요청에 커스텀 HTTP 헤더를 추가합니다. Add header 를 클릭해 Header(이름)와 Value(시크릿) 필드가 있는 새 행을 추가하세요. 커스텀 헤더는 Grafana와 Parca 사이 프록시가 요구하는 인증 토큰이나 라우팅 정보를 전달하는 데 유용해요.

Additional settings(추가 설정): 아래 화살표를 클릭해 펼칩니다. 선택 사항입니다.

Advanced HTTP settings:

설정	설명
Allowed cookies	데이터 소스로 전달해야 할 쿠키. Grafana 프록시는 기본적으로 모든 쿠키를 제거함
Timeout	HTTP 요청 타임아웃(초)

Secure SOCKS proxy: (Grafana 서버에서 secure SOCKS proxy 기능이 활성화된 경우에만 표시됨)

설정	설명
Enabled	Parca 인스턴스로의 요청을 secure SOCKS 프록시를 통해 라우팅하는 토글

연결 확인 (Verify the connection)

Save & test 를 클릭해 Grafana가 Parca 인스턴스에 연결할 수 있는지 확인합니다. 상태 점검은 Parca 서버에서 사용 가능한 프로파일 유형을 쿼리합니다. 성공 시 Data source is working 메시지가 표시됩니다. 테스트 실패 시 URL이 올바른지, Parca 인스턴스가 실행 중이고 Grafana 서버에서 접근 가능한지 확인하세요. 자세한 내용은 Troubleshoot Parca data source issues 문서를 참고하세요.

데이터 소스 프로비저닝 (Provision the data source)

Grafana 프로비저닝 시스템의 일부로 YAML 파일에 데이터 소스를 정의할 수 있어요. 자세한 내용은 Provisioning Grafana 문서를 참고하세요.

YAML 프로비저닝 예시:

apiVersion: 1

datasources:
  - name: Parca
    type: parca
    url: http://localhost:7070

Basic authentication으로 프로비저닝:

apiVersion: 1

datasources:
  - name: Parca
    type: parca
    url: http://localhost:7070
    basicAuth: true
    basicAuthUser: <USERNAME>
    secureJsonData:
      basicAuthPassword: <PASSWORD>

<USERNAME>: Parca 사용자명, <PASSWORD>: Parca 비밀번호로 교체하세요.

Terraform 예시:

resource "grafana_data_source" "parca" {
  type = "parca"
  name = "Parca"
  url  = "http://localhost:7070"
}

Basic authentication으로 프로비저닝:

resource "grafana_data_source" "parca" {
  type                = "parca"
  name                = "Parca"
  url                 = "http://localhost:7070"
  basic_auth_enabled  = true
  basic_auth_username = "<USERNAME>"

  secure_json_data_encoded = jsonencode({
    basicAuthPassword = "<PASSWORD>"
  })
}

다음 단계 (Next steps)

Parca 쿼리 편집기로 프로파일링 데이터 쿼리하기

Parca 데이터 소스 구성