새 상관관계 만들기
새 상관관계 만들기
상관관계(Correlations)는 두 데이터 소스 사이에 링크를 만들어, 한 데이터 소스의 조회 결과를 다른 데이터 소스의 쿼리로 연결하는 기능입니다. 이 문서에서는 그라파나 관리(Administration) 화면에서 상관관계를 만드는 방법을 안내합니다.
본문
시작하기 전에
- 원본(source) 데이터 소스와 대상(target) 데이터 소스에 접근할 수 있어야 합니다.
- 데이터 소스 쿼리 권한이 있어야 합니다.
상관관계 만들기
- 그라파나의 Administration 섹션에서 Correlations 페이지를 엽니다.
- Add correlation을 클릭합니다.
- Source data source를 선택합니다. 이 데이터 소스의 결과에 링크가 붙습니다.
- Label을 입력합니다. 시각화에서 링크로 표시될 이름이며 변수를 포함할 수 있습니다.
- Description(선택)을 입력합니다.
- Result field를 선택합니다. 원본 쿼리 결과 중 어떤 필드 값에 링크를 붙일지 지정합니다.
- Target query를 구성합니다. 대상 데이터 소스와 쿼리를 정의하며, 원본 결과 필드의 값을
${field}형태의 변수로 사용할 수 있습니다. - 필요하면 Transformations를 추가해 변환을 정의합니다. 예를 들어 정규식으로 필드 값을 추출하거나 logfmt 파싱으로 로그 라인에서 값을 뽑아낼 수 있습니다.
- Create를 클릭해 상관관계를 저장합니다.
상관관계 관리
만든 상관관계는 Administration > Correlations 페이지에서 확인하고 편집·삭제할 수 있습니다.
상관관계 사용
만든 상관관계는 Explore의 시각화(로그 패널, 표 등)에서 링크로 나타납니다. 링크를 클릭하면 대상 쿼리가 실행되며, 원본 행의 값이 변수로 동적 치환됩니다.