기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
이 설명서 주제는 Grafana 버전 10.x를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 9에서 작업 섹션을 참조하세요.
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 Grafana 버전 8에서 작업 섹션을 참조하세요.
각 상관관계는 다음 옵션으로 구성됩니다.
- Label
-
시각화에 표시된 링크 레이블.
- 설명
-
선택적 설명
- 소스 데이터 소스
-
링크가 표시된 결과의 소스.
- 결과 필드
-
시각화에서 링크가 표시되는 위치를 정의합니다.
- 대상 쿼리
-
대상 쿼리는 링크를 클릭하면 실행됩니다.
- 변환
-
포함된 소스 데이터에 대한 선택적 조작이 대상 쿼리에 전달됩니다.
상관관계 생성에 대한 자세한 내용은 상관관계 생성을 참조하세요.
소스 데이터 소스 및 결과 필드
링크는 상관관계의 소스 데이터 소스로부터 결과에 대한 시각화 탐색에 표시됩니다. 상관관계 구성에 제공된 결과의 필드 중 하나(결과 필드)에 링크가 할당됩니다. 각 시각화는 서로 다른 방식으로 링크가 있는 필드를 표시합니다.
대상 쿼리
대상 쿼리는 시각화에서 링크를 클릭하면 실행됩니다. 선택한 대상 데이터 소스의 쿼리 편집기를 사용하여 대상 쿼리를 지정할 수 있습니다. 소스 데이터 결과는 변수를 사용하여 대상 쿼리 내에서 액세스할 수 있습니다.
상관관계 변수
대상 쿼리 내 변수를 사용하여 쿼리와 관련된 소스 데이터에 액세스할 수 있습니다. 상관관계에서는 Grafana 변수 구문을 사용합니다. 링크를 선택하면 변수가 소스 결과의 값으로 채워집니다. 사용할 수 있는 두 가지 변수 유형이 있습니다.
-
필드 변수(필드 값 및 레이블에 액세스하기 위해).
-
상관관계 변수(필드 값 및 변환에 액세스하기 위해).
예: 소스 결과에 employee 필드가 포함된 경우 다음을 사용하여 필드 값에 액세스할 수 있습니다.
-
필드 변수
${__data.fields.employee}. -
${employee}에 위 필드 값을 매핑하는 상관관계 변수.
필드 값을 더 짧은 변수 이름에 매핑하는 것 외에도 기존 필드에 변환을 적용하여 더 많은 상관관계 변수를 생성할 수 있습니다.
상관관계는 모든 변수가 선택한 데이터 행에 값을 포함하는 경우에만 데이터 링크를 생성합니다. 전역 변수는 이 규칙의 예외이며 반환된 데이터에서 채우지 않아도 됩니다. 이러한 변수는 데이터 소스에 의해 자동으로 보간됩니다.
상관관계 변환
변환에서는 필드 값에서 더 많은 변수를 추출하는 방법을 제공합니다. 변환의 출력은 다른 변수로 액세스할 수 있는 새 변수 세트입니다.
변환에는 logfmt 및 정규식과 같은 두 가지 유형이 있습니다.
각 변환은 선택한 필드 값을 입력으로 사용합니다. 변환의 출력은 변환의 유형 및 옵션을 기반으로 하는 새 변수 세트입니다.
Logfmt 변환
logfmt 변환은 logfmt 키/값 페어
logfmt 변환은 결과 필드와 다른 필드에 변환을 적용하려는 경우에만 입력 필드 이름을 지정하면 됩니다. field = "host=srv001 endpoint=/test
app=foo"에 대한 출력 변수 예제:
| name | 값 |
|---|---|
| host | srv001 |
| 엔드포인트 | /test |
| 앱 | foo |
정규식 변환
정규식 변환은 제공된 정규식을 기반으로 필드 값을 해체합니다.
정규식 변환 옵션:
- 필드
입력 필드 이름
- expression
-
정규식. 이름 지정된 캡처 그룹은 그룹 이름과 일치하는 변수에 매핑됩니다. 이름이 지정되지 않은 일치 그룹을 사용하는 경우 첫 번째 일치 항목에서 변수가 생성됩니다. 값은 입력 필드와 일치하는 변수를 재정의하거나 mapValue가 제공되는 경우 새 변수가 생성됩니다(다음 표의 예제 참조).
- mapValue
-
이름 지정된 일치 그룹 없이 간단한 정규식 그룹과 함께 사용됩니다. 기본적으로 첫 번째 일치는 입력으로 사용되는 필드 이름으로 변수를 재정의합니다. 기본 동작을 변경하도록 mapValue 속성을 지정할 수 있습니다. 제공된 이름은 새 변수를 생성하는 데 사용됩니다. 대상 쿼리에 정확한 값과 변환으로 추출된 값의 일부가 모두 필요한 경우 유용할 수 있습니다.
예: 선택한 필드 이름이 employee이고 필드 값이 John Doe라고 가정합니다.
표현식 및 mapValue 옵션을 기반으로 하는 다양한 출력 변수:
| expression | mapValue | 출력 변수 | 설명 |
|---|---|---|---|
/\w+ (\w+)/ |
- | employee=Doe |
mapValue가 제공되지 않았습니다. 첫 번째 일치는 기존 필드 이름 변수(employee)에 매핑됩니다. |
/(\w+) (\w+)/ |
name | name=John |
첫 번째 일치는 name이라는 새 변수에 매핑됩니다. |
/(?\w+) (?\w+)/ |
- | firstName=John, lastName=Doe |
이름 지정된 그룹을 사용하는 경우 출력 변수의 이름이 되며 mapValue는 무시됩니다. |
/(?\w+) (?\w+)/ |
name | firstName=John, lastName=Doe |
위와 동일 |
