상관 관계 구성

이 설명서 항목은 Grafana 버전 10.x를 지원하는 Grafana 작업 영역을 위해 설계되었습니다.

Grafana 버전 9.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 9에서 작업하기

Grafana 버전 8.x를 지원하는 Grafana 작업 영역에 대한 내용은 을 참조하십시오. Grafana 버전 8에서 작업하기

각 상관 관계는 다음 옵션으로 구성됩니다.

Label

비주얼리제이션에 표시된 링크 레이블.

설명

선택적 설명

소스 데이터 소스

링크가 표시된 결과의 소스.

결과 필드

시각화에서 링크가 표시되는 위치를 정의합니다.

대상 쿼리

링크를 클릭하면 대상 쿼리가 실행됩니다.

변환

포함된 소스 데이터에 대한 선택적 조작은 대상 쿼리로 전달되었습니다.

상관 관계 생성에 대한 자세한 내용은 상관 관계 만들기를 참조하십시오.

소스 데이터 소스 및 결과 필드

상관 관계 소스 데이터 원본의 결과에 대한 링크는 Explore 시각화에 표시됩니다. 상관 관계 구성에 제공된 결과의 필드 중 하나 (결과 필드) 에 링크가 할당됩니다. 각 시각화는 링크가 있는 필드를 다른 방식으로 표시합니다.

대상 쿼리

대상 쿼리는 시각화에서 링크를 클릭할 때 실행됩니다. 선택한 대상 데이터 원본의 쿼리 편집기를 사용하여 대상 쿼리를 지정할 수 있습니다. 변수를 사용하여 대상 쿼리 내에서 소스 데이터 결과에 액세스할 수 있습니다.

상관 관계 변수

대상 쿼리 내의 변수를 사용하여 쿼리와 관련된 소스 데이터에 액세스할 수 있습니다. 상관 관계는 Grafana 변수 구문을 사용합니다. 링크를 선택하면 소스 결과의 값이 변수에 채워집니다. 다음과 같은 두 가지 유형의 변수를 사용할 수 있습니다.

• 필드 변수 (필드 값 및 레이블에 액세스하기 위한).

• 상관 변수 (필드 값 및 변환에 액세스하기 위한).

예: 소스 결과에 라는 employee 필드가 포함된 경우 다음을 사용하여 필드 값에 액세스할 수 있습니다.

• 필드 변수${__data.fields.employee}.

• 위의 필드 값을 매핑하는 상관 변수. ${employee}

필드 값을 더 짧은 변수 이름에 매핑하는 것 외에도 기존 필드에 변환을 적용하여 더 많은 상관 변수를 만들 수 있습니다.

상관 관계는 선택한 데이터 행에 모든 변수의 값이 있는 경우에만 데이터 링크를 만듭니다. 글로벌 변수는 이 규칙의 예외이며 반환된 데이터에서 채울 필요가 없습니다. 이러한 변수는 데이터 소스에 의해 자동으로 보간됩니다.

상관 관계 변환

변환은 필드 값에서 더 많은 변수를 추출할 수 있는 방법을 제공합니다. 변환의 출력은 다른 변수로 액세스할 수 있는 새 변수 집합입니다.

변환에는 logfmt와 정규 표현식이라는 두 가지 유형이 있습니다.

각 변환은 선택한 필드 값을 입력으로 사용합니다. 변환의 출력은 변환의 유형과 옵션에 따른 새 변수 집합입니다.

Logfmt 변환

logfmt 변환은 logfmt 키/값 쌍으로 포맷된 텍스트를 포함하는 필드 값을 분해합니다. 각 쌍은 변수가 되며 키는 변수 이름입니다.

logfmt 변환 시 결과 필드가 아닌 다른 필드에 변환을 적용하려는 경우에만 입력 필드 이름을 지정하면 됩니다. 출력 변수 예시: field = "host=srv001 endpoint=/test app=foo"

이름	값
host	srv001
엔드포인트	/테스트
앱	음식

정규 표현식 변환

정규 표현식 변환은 제공된 정규 표현식을 기반으로 필드 값을 분해합니다.

정규 표현식 변환 옵션:

필드

입력 필드 이름

expression

정규 표현식. 명명된 캡처 그룹은 그룹 이름과 일치하는 변수에 매핑됩니다. 이름이 지정되지 않은 일치 그룹을 사용하는 경우 첫 번째 일치 항목에서 변수가 생성됩니다. 값은 입력 필드와 일치하는 변수를 재정의하거나 MapValue가 제공되는 경우 새 변수가 생성됩니다 (다음 표의 예 참조).

맵값

이름이 일치하는 그룹이 없는 단순 정규식 그룹과 함께 사용됩니다. 기본적으로 첫 번째 일치 항목은 입력으로 사용되는 필드 이름으로 변수를 대체합니다. 기본 동작을 변경하려면 MapValue 속성을 지정하면 됩니다. 제공된 이름은 새 변수를 만드는 데 사용됩니다. 이는 대상 쿼리에 정확한 값과 변환으로 추출된 값의 일부가 모두 필요한 경우에 유용할 수 있습니다.

예: 선택한 필드 이름이 employee 이고 필드 값이 인 것으로 가정합니다. John Doe

표현식 및 MapValue 옵션을 기반으로 하는 다양한 출력 변수:

expression	맵/값	출력 변수	설명
/\w+ (\w+)/	-	employee=Doe	맵값이 제공되지 않았습니다. 첫 번째 매칭은 기존 필드 이름 변수 () employee 에 매핑됩니다.
/(\w+) (\w+)/	이름	name=John	첫 번째 매칭은 라는 새 변수에 매핑됩니다. name
/(?\w+) (?\w+)/	-	firstName=John, lastName=Doe	명명된 그룹을 사용하면 해당 그룹이 출력 변수의 이름이 되며 MapValue는 무시됩니다.
/(?\w+) (?\w+)/	이름	firstName=John, lastName=Doe	위와 동일합니다.