기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
상관 관계 구성
이 설명서 항목은 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 |
위와 동일합니다. |