기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Grafana 버전 10에서의 탐색
<a name="v10-explore"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

Grafana의 대시보드 UI는 시각화를 위한 대시보드를 구축하는 기능을 제공합니다. *탐색*에서는 쿼리에 집중할 수 있도록 대시보드 및 패널 옵션이 사라집니다. 작업 중인 쿼리가 있을 때까지 반복한 다음, 쿼리에서 대시보드를 빌드할 수 있습니다.

**참고**  
데이터를 탐색하고 대시보드를 생성하지 않으려는 경우 탐색을 사용하면 훨씬 더 쉬워집니다. 데이터 소스가 그래프 및 테이블 데이터를 지원하는 경우 탐색은 결과를 그래프와 테이블로 표시합니다. 이렇게 하면 데이터의 추세와 세부 정보를 동시에 확인할 수 있습니다.

이 페이지에서 데이터 탐색을 시작할 수 있습니다. 다음 주제에서는 탐색을 위한 특정 기능 및 사용에 대한 자세한 내용을 제공합니다.
+ [탐색에서의 쿼리 관리](v10-explore-manage.md)
+ [탐색에서의 로그](v10-explore-logs.md)
+ [탐색에서의 추적](v10-explore-tracing.md)
+ [탐색에서의 상관관계 편집기](v10-explore-correlations.md)
+ [탐색에서의 검사기](v10-explore-inspector.md)

## 탐색 시작
<a name="v10-explore-start"></a>

**참고**  
탐색에 액세스하려면 편집자 또는 관리자 역할이 있어야 합니다.

**탐색에 액세스하는 방법**

1. Grafana 워크스페이스의 왼쪽 메뉴 표시줄에서 탐색 메뉴 항목을 선택하세요.

   빈 탐색 탭이 열립니다.

   또는 패널의 기존 쿼리를 시작하려면 패널 메뉴에서 탐색 옵션을 선택하세요. 그러면 패널의 쿼리가 포함된 탐색 탭이 열리고 대시보드 외부에 있는 쿼리에서 조정하거나 반복할 수 있습니다.

1. 왼쪽 상단의 드롭다운에서 데이터 소스를 선택하세요.

   **고급 데이터 소스 선택기 열기**를 선택하여 데이터 소스 추가(관리자만 해당)를 포함한 추가 옵션을 볼 수도 있습니다.

1. 선택한 데이터 소스에서 제공하는 쿼리 편집기를 사용하여 쿼리를 작성하세요.

   쿼리에 대한 자세한 내용은 [데이터 쿼리 및 변환](v10-panels-query-xform.md) 섹션을 참조하세요.

1. 오른쪽 상단의 버튼을 사용하여 쿼리를 실행하세요.

## 분할 및 비교
<a name="v10-explore-compare"></a>

분할 보기에서는 시각화를 나란히 비교하거나 한 페이지에서 관련 데이터를 함께 보는 방법을 제공합니다.

**상단에서 분할 보기 열기**

1. 탐색 보기에서 **분할** 버튼을 선택하여 현재 쿼리를 복제하고 페이지를 나란히 두 개의 쿼리로 분할합니다.
**참고**  
예를 들어 두 개의 서로 다른 서버에 대해 동일한 쿼리를 비교하거나 스테이징 환경을 프로덕션 환경과 비교할 수 있도록 새 쿼리에 대해 다른 데이터 소스를 선택할 수 있습니다.

   분할 보기에서는 시간 선택기 중 하나에 연결된 시간 동기화 버튼 중 하나를 선택하여 두 패널의 시간 선택기를 연결할 수 있습니다(하나를 변경하면 다른 항목도 변경됨). 시간 선택기를 연결하면 분할 보기 쿼리의 시작 시간과 종료 시간을 동기화한 상태로 유지합니다. 이를 통해 두 분할 패널 모두에서 동일한 시간 간격을 확인할 수 있습니다.

1. 새로 생성된 쿼리를 닫으려면 **분할 닫기** 버튼을 선택합니다.

## 콘텐츠 개요
<a name="v10-explore-outline"></a>

콘텐츠 개요는 탐색에서 생성한 쿼리 및 시각화를 추적하는 측면 탐색 표시줄입니다. 이를 통해 빠르게 탐색할 수 있습니다.

콘텐츠 개요는 분할 보기에서도 작동합니다. 분할 보기에 있는 경우 각 창에 대한 콘텐츠 개요가 생성됩니다.

**콘텐츠 개요를 여는 방법**

1. **탐색** 화면의 왼쪽 상단에 있는 **개요** 버튼을 선택하세요.

1. 콘텐츠 개요에서 패널 아이콘을 선택하여 해당 패널로 이동하세요.

## 탐색 URL 공유
<a name="v10-explore-shareurl"></a>

탐색을 사용하면 쿼리를 변경할 때 브라우저 주소 표시줄의 URL이 업데이트됩니다. 이 URL을 공유하거나 북마크할 수 있습니다.

**참고**  
탐색은 비교적 긴 URL을 생성할 수 있습니다. URL이 도구에 비해 너무 긴 경우 [단축 링크](#v10-explore-share)를 생성하고 공유할 수도 있습니다.

**외부 도구에서 탐색 URL 생성**

탐색 URL에는 정의된 구조가 있으므로 외부 도구에서 URL을 빌드하고 Grafana에서 열 수 있습니다. URL 구조는 다음과 같습니다.

```
http://<workspace_url>/explore?panes=<panes>&schemaVersion=<schema_version>&orgId=<org_id>
```

여기서 각 항목은 다음과 같습니다.
+ `org_id`는 조직 ID입니다.
+ `schema_version`은 스키마 버전입니다(최신 버전으로 설정해야 함, 이 경우 `1`).
+ `panes`는 창의 URL 인코딩 JSON 객체로, 각 키는 창 ID이고 각 값은 다음 스키마와 일치하는 객체입니다.

  ```
  {
    datasource: string; // the pane's root datasource UID, or `-- Mixed --` for mixed datasources
    queries: {
      refId: string; // an alphanumeric identifier for this query, must be unique within the pane, i.e. "A", "B", "C", etc.
      datasource: {
        uid: string; // the query's datasource UID ie: "AD7864H6422"
        type: string; // the query's datasource type-id, i.e: "loki"
      }
      // ... any other datasource-specific query parameters
    }[]; // array of queries for this pane
    range: {
      from: string; // the start time, in milliseconds since epoch
      to: string; // the end time, in milliseconds since epoch
    }
  }
  ```
**참고**  
`from` 및 `to` 필드는 [대시보드 시간 범위 설정](v10-dash-using-dashboards.md#v10-dash-setting-dashboard-time-range) 주제에 설명된 대로 상대 범위도 허용합니다.

## 단축 링크 공유
<a name="v10-explore-share"></a>

단축 링크 공유 기능을 사용하면 쿼리 파라미터와 함께 더 긴 URL을 사용하는 대신 /goto/:uid 형식의 더 작고 간단한 URL을 생성할 수 있습니다. 쿼리 결과에 대한 단축 링크를 생성하려면 탐색 도구 모음에서 **공유** 옵션을 선택합니다. 사용되지 않는 단축 링크는 7일 후에 자동으로 삭제됩니다. 링크는 한 번 이상 사용되면 삭제되지 않습니다.

**절대 시간으로 단축 링크 공유**

단축 링크에는 상대 시간(예: 2시간 전부터 현재 시간까지) 또는 절대 시간(예: 오전 8시\$1오전 10시)이라는 두 가지 옵션이 있습니다. 기본적으로 단축 링크를 공유하면 선택한 시간 범위, 상대 시간 또는 절대 시간 범위가 복사됩니다. 단축 링크 공유 버튼 옆의 드롭다운 버튼을 선택하고 **시간-동기화 URL 링크** 아래의 옵션 중 하나를 선택하면 절대 시간으로 단축 링크를 생성할 수 있습니다. 즉, 링크를 받는 모든 사용자가 다른 시간에 링크를 열더라도 현재 표시된 것과 동일한 데이터를 볼 수 있습니다. 이 옵션은 탐색 보기에서 선택한 시간 범위에 영향을 주지 않습니다.

# 탐색에서의 쿼리 관리
<a name="v10-explore-manage"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

실행한 쿼리의 기록과 별표로 표시한 쿼리를 포함하여 탐색에서 생성한 쿼리를 관리할 수 있습니다.

## 쿼리 기록
<a name="v10-explore-manage-history"></a>

쿼리 기록은 탐색에서 사용한 쿼리 목록입니다. 기록은 Grafana 데이터베이스에 저장되며 다른 사용자와 공유되지 않습니다. 기록에서 쿼리 보존 기간은 2주입니다. 2주가 지난 쿼리는 자동으로 삭제됩니다. 기록을 열고 상호 작용하려면 탐색에서 **쿼리 기록** 버튼을 선택합니다.

**참고**  
별표로 표시된(즐겨찾는) 쿼리에는 2주 보존 기간이 적용되지 않으며 해당 쿼리는 삭제되지 않습니다.

## 쿼리 기록 보기
<a name="v10-explore-manage-history-view"></a>

쿼리 기록을 사용하면 쿼리 기록을 볼 수 있습니다. 각 개별 쿼리에 대해 다음을 수행할 수 있습니다.
+ 쿼리를 실행합니다.
+ 설명을 생성 및/또는 편집합니다.
+ 쿼리를 클립보드에 복사합니다.
+ 쿼리가 포함된 단축 링크를 클립보드에 복사합니다.
+ 쿼리에 별표(즐겨찾기)를 지정합니다.

## 즐겨찾기 쿼리 관리
<a name="v10-explore-manage-history-favorites"></a>

쿼리 기록 탭에서 별표가 지정된 모든 쿼리는 별표 탭에 표시됩니다. 이를 통해 자주 사용하는 쿼리에 더 빠르게 액세스하고 처음부터 입력하지 않고 이러한 쿼리를 재사용할 수 있습니다.

## 쿼리 기록 정렬
<a name="v10-explore-manage-history-sort"></a>

기본적으로 쿼리 기록에는 최신 쿼리가 표시됩니다. 날짜 또는 데이터 소스 이름을 기준으로 오름차순 또는 내림차순으로 기록을 정렬할 수 있습니다.

**쿼리 기록을 정렬하는 방법**

1. **쿼리 정렬 기준** 필드를 선택하세요.

1. 다음 옵션 중 하나를 선택합니다.
   + **최신 항목 우선**
   + **가장 오래된 항목 우선**

## 쿼리 기록 필터링
<a name="v10-explore-manage-history-filter"></a>

쿼리 기록 및 별표 탭에서 쿼리 기록을 특정 데이터 소스로 필터링할 수 있습니다.

**데이터 소스로 기록을 필터링하는 방법**

1. **특정 데이터 소스에 대한 쿼리 필터링** 필드를 선택하세요.

1. 기록을 필터링할 데이터 소스를 선택하세요. 여러 데이터 소스를 선택할 수 있습니다.

**참고**  
혼합 데이터 소스를 사용하여 실행된 쿼리는 혼합 데이터 소스를 필터링할 때만 표시되며 개별 데이터 소스를 기준으로 필터링할 때는 표시되지 않습니다.

**쿼리 기록** 탭에서 슬라이더를 사용하여 날짜별로 쿼리를 필터링할 수도 있습니다.
+ 세로 슬라이더를 사용하여 날짜별로 쿼리를 필터링하세요.
+ 하단 핸들을 끌어 시작 날짜를 조정하세요.
+ 상단 핸들을 끌어 종료 날짜를 조정하세요.

## 쿼리 기록에서 검색
<a name="v10-explore-manage-history-search"></a>

기록의 쿼리 및 설명에서 검색할 수 있습니다. 쿼리 기록 탭 및 별표 탭에서 쿼리를 검색할 수 있습니다.

**쿼리 기록에서 검색하는 방법**

1. **쿼리 검색** 필드를 선택하세요.

1. 검색하려는 용어를 검색 필드에 입력하세요.

## 쿼리 편집기 설정
<a name="v10-explore-manage-history-settings"></a>

설정 탭에서 쿼리 기록을 사용자 지정할 수 있습니다. 옵션은 다음 표에 설명되어 있습니다.


| 설정 | 기본값  | 
| --- | --- | 
| 기본 활성 탭 변경 | 쿼리 기록 탭 | 

**참고**  
쿼리 기록 설정은 전역적이며 분할 모드의 두 패널에 적용됩니다.

# 탐색에서의 로그
<a name="v10-explore-logs"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

탐색을 사용하면 다음과 같은 다양한 데이터 소스의 로그를 조사할 수 있습니다.
+ [OpenSearch](using-opensearch-in-AMG.md)
+ [Amazon CloudWatch](using-amazon-cloudwatch-in-AMG.md)
+ [InfluxDB](using-influxdb-in-AMG.md)
+ [Loki](using-loki-in-AMG.md)

인프라 모니터링 및 인시던트 대응 중에 지표와 로그를 더 깊이 검토하여 원인을 찾을 수 있습니다. 또한 탐색을 사용하면 로그를 지표, 추적 또는 프로파일과 같은 다른 원격 측정 신호와 나란히 보고 로그와의 상관관계를 분석할 수 있습니다.

로그 쿼리의 결과는 개별 로그 줄과 선택한 기간의 로그 볼륨을 보여주는 그래프로 표시됩니다.

## 로그 볼륨
<a name="v10-explore-logs-volume"></a>

전체 범위 로그 볼륨을 지원하는 데이터 소스에 대한 작업을 수행할 때 탐색에서는 입력된 모든 로그 쿼리에 대한 로그 분포를 보여주는 그래프를 자동으로 표시합니다. 이 기능은 현재 OpenSearch 및 Loki 데이터 소스에서 지원됩니다.

**참고**  
Loki에서 이 전체 로그 볼륨은 쿼리된 시간 범위에 따라 지표 쿼리로 렌더링됩니다(이 방법은 비용이 많이 들 수 있음). 이 쿼리는 더 작은 Loki 설치를 위해 처리하기 특히 더 어려울 수 있습니다. 이를 완화하기 위해 Loki 앞에 [nginx](https://www.nginx.com/)와 같은 프록시를 사용하여 이러한 쿼리에 대한 사용자 지정 제한 시간(예: 10초)을 설정할 수 있습니다. 로그 볼륨 히스토그램 쿼리는 값이 `Source=logvolhist`인 HTTP 헤더 `X-Query-Tags`를 사용하여 쿼리를 찾아 식별할 수 있습니다. 이러한 헤더는 Grafana에서 모든 로그 볼륨 히스토그램 쿼리에 추가됩니다.

데이터 소스가 전체 범위 로그 볼륨 로드를 지원하지 않는 경우 로그 모델은 로그 행을 계산하고 자동으로 계산된 시간 간격에 따라 버킷으로 구성하여 시계열을 계산합니다. 첫 번째 로그 행의 타임스탬프는 결과에서 로그 볼륨의 시작을 고정하는 데 사용됩니다. 시계열의 끝은 시계 선택기의 **종료** 범위에 고정됩니다. 이렇게 하면 데이터 소스가 전체 범위 지원을 제공하지 않더라도 로그 데이터를 효율적으로 분석하고 시각화할 수 있습니다.

## 로그
<a name="v10-explore-logs-overview"></a>

다음 섹션에서는 탐색에서 개별 로그를 시각화하고 상호 작용하는 방법에 대한 자세한 설명을 확인할 수 있습니다.

## 로그 탐색
<a name="v10-explore-logs-navigation"></a>

로그 줄 오른쪽에 있는 로그 탐색을 사용하여 추가 로그를 쉽게 요청할 수 있습니다. 탐색 하단의 **이전 로그** 버튼을 클릭하여 이 작업을 수행할 수 있습니다. 특히 줄 제한에 도달하고 더 많은 로그를 보고 싶을 때 유용합니다. 그러면 탐색에서 실행되는 각 요청이 탐색에서 별도의 페이지로 표시됩니다. 모든 페이지에는 수신 로그 줄의 `from` 및 `to` 타임스탬프가 표시됩니다. 각 페이지를 클릭하면 이전 결과를 볼 수 있습니다. 탐색은 로그 탐색에서 실행된 마지막 5개의 요청을 캐싱합니다. 이를 통해 페이지를 클릭할 때 동일한 쿼리를 다시 실행하지 않아도 되므로 시간과 리소스가 절약됩니다.

## 시각화 옵션
<a name="v10-explore-log-visualization-options"></a>

 로그가 표시되는 방법을 사용자 지정하고 표시되는 열을 선택할 수 있습니다.


| 옵션 | 설명 | 
| --- | --- | 
| Time | 시간 열을 표시하거나 숨깁니다. 데이터 소스에서 보고된 로그 줄과 연결된 타임스탬프입니다. | 
| 고유 레이블 | 공통 레이블이 아닌 레이블만 포함하는 고유 레이블 열을 표시하거나 숨깁니다. 모든 공통 레이블은 위에 표시됩니다. | 
| 줄 바꿈 | 표시에서 줄 바꿈을 사용하려면 이를 true로 설정합니다. false로 설정하면 가로 스크롤 기능이 생성됩니다. | 
| JSON 정리 |  모든 JSON 로그를 정리 인쇄하려면 이 옵션을 true로 설정합니다. 이 설정은 JSON 이외 형식의 로그에는 영향을 주지 않습니다. | 
| 중복 제거 | 로그 데이터는 매우 반복적일 수 있으며 탐색에서 중복 로그 줄을 숨기면 도움이 될 수 있습니다. 사용할 수 있는 몇 가지 중복 제거 알고리즘이 있습니다. 정확에서는 날짜 필드를 제외한 전체 줄에서 수행됩니다. 숫자에서는 기간, IP 주소 등과 같은 숫자를 제거한 후 줄에서 일치가 수행됩니다. 서명은 모든 문자와 숫자를 제거하고 나머지 공백 및 구두점으로 일치하기 때문에 가장 공격적인 중복 제거 기능입니다. | 
| 결과 순서 표시 | 수신된 로그의 순서를 기본 내림차순(최신 항목 우선)에서 오름차순(가장 오래된 항목 우선)으로 변경할 수 있습니다. | 

## 로그 줄 다운로드
<a name="v10-explore-download-log-lines"></a>

`txt` 또는 `json` 형식으로 로그 결과를 다운로드하려면 **다운로드** 버튼을 사용합니다. 이 기능을 사용하면 추가 분석을 위해 로그 데이터를 저장하거나 편리하고 액세스 가능한 형식으로 다른 사용자와 공유할 수 있습니다.

## 로그 결과 메타 정보
<a name="v10-explore-log-result-meta-information"></a>

수신된 로그 줄 위에서 다음과 같은 필수 메타 정보를 찾을 수 있습니다.
+ **수신된 로그 수** - 현재 쿼리 또는 시간 범위에 대해 수신된 총 로그 수를 나타냅니다.
+ **오류** - 로그 결과에서 가능한 오류를 표시합니다.
+ **공통 레이블** - 공통 레이블을 표시합니다.
+ **처리된 총 바이트 수** - 처리된 로그 데이터의 누적 크기(바이트 단위)를 나타냅니다.

**참고**  
특정 메타 정보의 가용성은 데이터 소스에 따라 달라질 수 있습니다. 따라서 특정 데이터 소스에 대한 이러한 세부 정보 중 일부만 볼 수 있습니다.

## 새 줄 이스케이프 처리
<a name="v10-explore-log-escaping-newlines"></a>

탐색에서는 새 줄(`\n`, `\r`) 또는 탭(`\t`)과 같이 로그 줄에서 잘못 이스케이프 처리된 일부 시퀀스를 자동으로 감지합니다. 이러한 시퀀스를 감지하면 탐색에서는 **새 줄 이스케이프 처리** 옵션을 제공합니다.

**탐색에서 감지한 잘못 이스케이프 처리된 시퀀스를 자동으로 수정하는 방법**

1. 시퀀스를 바꾸려면 **새 줄 이스케이프 처리**를 선택하세요.

1. 올바른지 확인하기 위해 수동으로 대체한 내용을 검토하세요.

탐색에서는 이러한 시퀀스를 대체합니다. 이렇게 하면 옵션이 **새 줄 이스케이프 처리**에서 **이스케이프 처리 제거**로 변경됩니다. 수신된 입력에 따라 구문 분석이 정확하지 않을 수 있으므로 변경 사항을 평가합니다. **이스케이프 처리 제거**를 선택하여 대체 작업을 되돌릴 수 있습니다.

## 로그 수준
<a name="v10-explore-log-level"></a>

`level` 레이블이 지정된 로그의 경우 레이블 값을 사용하여 로그 수준을 결정하고 적절히 각 로그 줄의 색상을 업데이트합니다. 로그에 수준 레이블이 지정되지 않은 경우 해당 콘텐츠가 지원되는 표현식과 일치하는지 확인합니다(자세한 내용은 다음 표 참조). 로그 수준은 항상 첫 번째 일치에 의해 결정됩니다. Grafana에서 로그 수준 필드를 추론할 수 없는 경우 알 수 없음 로그 수준으로 시각화됩니다.

**참고**  
Loki 데이터 소스를 사용하고 `level`이 로그 줄의 일부인 경우 구문 분석기(JSON, logfmt, 정규식,..)를 사용하여 수준 값을 결정하는 데 사용되는 수준 레이블로 수준 정보를 추출할 수 있습니다. 이렇게 하면 히스토그램에서 다양한 로그 수준을 별도의 막대로 표시할 수 있습니다.

**지원되는 로그 수준 및 로그 수준 약어와 표현식 매핑:** 


| 로그 수준 | 색상 | 지원되는 표현식 | 
| --- | --- | --- | 
| 심각 | 보라색 | emerg, fatal, alert, crit, critical | 
| 오류 | red | err, eror, error | 
| warning | yellow | warn, warning | 
| info | green | info, information, informational, notice | 
| debug | blue | dbug, debug | 
| 추적 | 연한 파란색 | 추적 | 
| 알 수 없음 | 회색 | \$1 | 

## 검색된 단어 강조 표시
<a name="v10-explore-highlight-searched-words"></a>

쿼리에 검색할 특정 단어나 표현식이 포함된 경우 탐색은 가시성을 높이기 위해 로그 줄에서 이를 강조 표시합니다. 이 강조 표시 기능을 사용하면 로그의 관련 콘텐츠를 더 쉽게 식별하고 이에 집중할 수 있습니다.

**참고**  
검색어를 강조 표시하는 기능은 데이터 소스에 따라 다를 수 있습니다. 일부 데이터 소스의 경우 검색어 강조 표시를 사용하지 못할 수 있습니다.

## 로그 세부 정보 보기
<a name="v10-explore-log-details-view"></a>

탐색에서 각 로그 줄에는 로그 줄을 선택하여 열 수 있는 *로그 세부 정보*라는 확장 가능한 섹션이 있습니다. 로그 세부 정보 보기에서는 로그 줄에 연결된 *필드* 및 *링크* 양식으로 추가 정보 및 탐색 옵션을 제공하여 보다 강력한 상호 작용 및 분석을 지원합니다.

**필드**

로그 세부 정보 보기에서는 표시된 필드를 두 가지 방법으로 필터링할 수 있습니다(특정 필드에 초점을 맞추는 긍정 필터 및 특정 필드를 제외하는 부정 필터). 이러한 필터는 로그 줄을 생성한 해당 쿼리를 업데이트하여 그에 따라 등호 및 부등호 표현식을 추가합니다. Loki 및 OpenSearch의 경우와 같이 데이터 소스에서 지원하는 경우 로그 세부 정보에서는 필드가 표시되는 현재 쿼리에 이미 있으며 활성 상태인지(긍정 필터만 해당)를 확인합니다. 이를 통해 쿼리에서 해당 필드를 끄거나 긍정에서 부정으로 필터 표현식을 변경할 수 있습니다.

눈 모양 아이콘을 클릭하여 전체 로그 줄 대신 로그 목록에서 시각화할 필드의 하위 세트를 선택할 수 있습니다. 각 필드에는 표시된 모든 로그와 관련된 통계를 표시하는 통계 아이콘이 있습니다.

**링크**

Grafana는 데이터 링크 또는 상관관계의 기능을 제공하므로 로그 메시지의 모든 부분을 내부 또는 외부 링크로 변환할 수 있습니다. 이러한 링크를 사용하여 관련 데이터 또는 외부 리소스로 이동해 추가 정보를 원활하고 편리하게 탐색할 수 있습니다.

## 로그 컨텍스트
<a name="v10-explore-log-context"></a>

로그 컨텍스트는 특정 검색 쿼리와 일치하는 로그 항목을 둘러싼 추가 컨텍스트 줄을 표시합니다. 이 방식은 로그 항목의 컨텍스트를 이해하는 데 도움이 될 수 있으며 `grep` 명령의 `-C` 파라미터와 유사합니다.

각 로그 항목과 관련된 컨텍스트를 읽고 분석하기 어렵게 만드는 긴 텍스트 줄이 발생할 수 있습니다. 여기에서 **줄 바꿈** 토글을 쉽게 사용할 수 있습니다. 이 토글을 활성화하면 Grafana에서 사용자가 볼 수 있는 너비 내에 맞게 긴 텍스트 줄을 자동으로 줄 바꿈합니다. 이렇게 하면 로그 항목을 더 쉽게 읽고 이해할 수 있습니다.

 **분할 보기에서 열기** 버튼을 사용하면 탐색 보기의 분할 화면에서 로그 항목에 대한 컨텍스트 쿼리를 실행할 수 있습니다. 이 버튼을 선택하면 로그 항목과 함께 컨텍스트 쿼리가 표시되는 새 탐색 창이 열립니다. 여기에서 주변 컨텍스트를 더 쉽게 분석하고 이해할 수 있습니다.

로그 컨텍스트 쿼리는 컨텍스트 모달을 열기 위해 버튼을 선택하는 동안 `Ctrl` 또는 `Cmd` 키를 눌러 새 브라우저 탭에서 열 수도 있습니다. 새 탭에서 열면 이전에 선택한 필터도 적용됩니다.

## 로그 줄 복사
<a name="v10-explore-copy-log-line"></a>

**로그 줄 복사** 버튼을 선택하여 선택한 로그 줄의 콘텐츠를 클립보드에 쉽게 복사할 수 있습니다.

## 로그 줄에 링크 복사
<a name="v10-explore-copy-link-to-log-line"></a>

Grafana에서 로그 줄을 연결하면 정확한 분석을 위해 특정 로그 항목으로 빠르게 이동할 수 있습니다. 로그 줄에 대한 **단축 링크 복사** 버튼을 선택하면 절대 시간 범위 내에서 정확한 로그 항목에 직접 액세스할 수 있는 단축 URL을 생성하고 복사할 수 있습니다. 이 링크를 열면 Grafana에서 해당 로그 줄로 자동 스크롤하고 파란색 배경으로 강조 표시하므로 관련 정보를 쉽게 식별하고 이에 집중할 수 있습니다.

**참고**  
이는 Loki 및 `id` 필드를 제공하는 기타 데이터 소스에서만 지원됩니다.

## 라이브 테일링
<a name="v10-explore-log-live-tailing"></a>

지원되는 데이터 소스의 실시간 로그를 보려면 탐색에서 라이브 테일링 기능을 활용할 수 있습니다.

**라이브 테이링을 사용하여 실시간으로 로그를 보는 방법**

1. 탐색 도구 모음에서 **라이브** 버튼을 선택하여 라이브 테일 보기로 전환하세요.

1. 라이브 테일 보기에 있는 동안 화면 하단에 새 로그가 나타나고 대비되는 희미한 배경을 사용하여 새로운 내용을 쉽게 추적할 수 있습니다.

1. 라이브 테일링을 일시 중지하고 중단 없이 이전 로그를 탐색하려면 **일시 중지** 버튼을 선택하거나 로그 보기를 스크롤하면 됩니다.

1. 보기를 지우고 표시에서 모든 로그를 제거하려면 **로그 지우기** 버튼을 선택하세요. 이 작업을 수행하면 로그 보기가 재설정되고 새롭게 로그 분석을 계속할 수 있습니다.

1. 라이브 테일링을 재개하고 실시간 로그를 계속 보려면 **재개** 버튼을 선택하세요.

1. 라이브 테일링을 종료하고 표준 탐색 보기로 돌아가려면 **중지** 버튼을 선택하세요.

라이브 테일링 기능을 사용하면 최신 로그가 들어올 때 해당 로그를 면밀히 관찰하여 실시간 이벤트를 더 쉽게 모니터링하고 문제를 즉시 감지할 수 있습니다.

**로그 샘플**

선택한 데이터 소스에서 로그 샘플을 구현하고 로그 및 지표 쿼리를 모두 지원하는 경우 지표 쿼리에서는 시각화된 지표에 기여하는 로그 줄의 샘플을 자동으로 볼 수 있습니다. 이 기능은 현재 Loki 데이터 소스에서 지원됩니다.

**지표에서 로그로 전환**

 `DataSourceWithQueryExportSupport`를 구현하는 지표 데이터 소스(예: Prometheus)에서 `DataSourceWithQueryImportSupport`를 지원하는 로깅 데이터 소스(예: Loki)로 들어오는 경우 로그에 있는 쿼리의 레이블을 유지하고 로그 스트림을 쿼리하는 데 사용합니다.

예를 들어 Loki 데이터 소스로 전환한 후 다음 Prometheus 쿼리 `grafana_alerting_active_alerts{job='grafana'}`가 `{job='grafana'}`로 변경됩니다. 이 경우 선택한 시간 범위에 있는 로그 청크를 반환합니다. 이를 통해 텍스트를 검색(grep)할 수 있습니다.

# 탐색에서의 추적
<a name="v10-explore-tracing"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

탐색을 사용하여 추적 데이터 소스의 추적을 시각화할 수 있습니다.

지원되는 데이터 소스는 다음과 같습니다.
+ [Tempo](tempo-data-source.md)(지원되는 수집 형식: OpenTelemetry, Jaeger, Zipkin)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

위에 나열된 데이터 소스에 대한 쿼리를 구성하는 방법에 대한 자세한 내용은 특정 데이터 소스에 대한 설명서를 참조하세요.

## 쿼리 편집기
<a name="v10-explore-trace-queryeditor"></a>

데이터 소스의 쿼리 편집기를 사용하여 추적 데이터를 쿼리하고 검색할 수 있습니다.

각 데이터 소스에는 자체 쿼리 편집기가 있을 수 있습니다. Tempo 데이터 소스의 쿼리 편집기는 Jaeger 데이터 소스의 쿼리 편집기와 약간 다릅니다.

각 데이터 소스 쿼리에 대한 자세한 내용은 해당 설명서를 참조하세요.
+ [Tempo](tempo-data-source.md)
+ [Jaeger](jaeger-data-source.md)
+ [AWS X-Ray](x-ray-data-source.md)
+ [Zipkin](zipkin-data-source.md)

## 추적 보기 설명
<a name="v10-explore-trace-view"></a>

이 섹션에서는 추적 보기 대시보드의 요소를 설명합니다.

**헤더**

추적 보기의 헤더에는 다음과 같은 요소가 있습니다.
+ 헤더 제목 - 루트 범위의 이름과 추적 ID를 표시합니다.
+ 검색 - 검색된 텍스트가 포함된 범위를 강조 표시합니다.
+ 메타데이터 - 추적에 대한 다양한 메타데이터.

**미니맵**

요약 보기 또는 추적 타임라인을 표시합니다. 미니맵 위로 포인터를 끌어 더 작은 시간 범위로 확대합니다. 확대/축소는 기본 타임라인도 업데이트하므로 더 짧은 기간을 쉽게 볼 수 있습니다. 확대된 상태에서 미니맵 위로 마우스를 가져가면 **선택 재설정** 버튼이 표시됩니다. 이 버튼을 누르면 확대 상태가 재설정됩니다.

**범위 필터**

범위 필터를 사용하여 추적 타임라인 뷰어에서 범위를 필터링할 수 있습니다. 필터를 더 많이 추가할수록 필터링된 범위가 더 구체적입니다.

다음 필터를 하나 이상 추가할 수 있습니다.
+ 리소스 서비스 이름
+ 범위 이름
+ 지속 시간
+ 태그(태그, 프로세스 태그 및 로그 필드 포함)

매칭한 범위만 표시하려면 **매칭만 표시** 토글을 선택합니다.

**타임라인**

추적 내 범위 목록을 표시합니다. 각 범위 행은 다음과 같은 구성 요소로 이루어집니다.
+ 하위 확장 버튼 - 선택한 범위의 모든 하위 범위를 확장하거나 축소합니다.
+ 서비스 이름 - 범위를 로깅하는 서비스의 이름.
+ 작업 이름 - 이 범위가 나타내는 작업의 이름.
+ 범위 기간 막대 - 추적 내 작업 기간의 시각적 표현.

**범위 세부 정보**

범위 행을 선택하면 다음을 포함하여 범위 세부 정보가 표시됩니다.
+ 작업 이름
+ 범위 메타데이터
+ 태그 - 이 범위와 연결된 모든 태그.
+ 프로세스 메타데이터 - 이 범위를 로깅하는 프로세스에 대한 메타데이터.
+ 로그 - 이 범위 및 연결된 키 값으로 로깅된 로그 목록. Zipkin 로그의 경우 섹션에 Zipkin 주석이 표시됩니다.

**로그에 대한 추적**

추적 보기의 범위로부터 해당 범위와 관련된 로그로 직접 이동할 수 있습니다. 이는 Tempo, Jaeger 및 Zipkin 데이터 소스에서 사용할 수 있습니다. 각 데이터 소스를 구성하는 방법에 대한 지침은 관련 설명서를 참조하세요.

문서 아이콘을 선택하여 구성된 데이터 소스로 탐색에서 분할 보기를 열고 해당 범위에 대한 관련 로그를 쿼리합니다.

**지표로 추적**

**참고**  
이 기능은 현재 베타에서 제공됩니다.

추적 보기의 범위로부터 해당 범위와 관련된 지표로 직접 이동할 수 있습니다. 이 기능은 Tempo, Jaeger 및 Zipkin 데이터 소스에서 사용할 수 있습니다. 구성에 대한 자세한 내용은 관련 설명서를 참조하세요.

**프로파일로 추적**

프로파일로 추적을 사용하면 Grafana의 기능을 사용해 추적과 프로파일을 연결하는 기능을 추가하여 다양한 신호의 상관관계를 파악할 수 있습니다.

## 노드 그래프
<a name="v10-explore-trace-node-graph"></a>

선택적으로 표시된 추적에 대한 노드 그래프를 확장할 수 있습니다. 데이터 소스에 따라 그래프에 추적의 범위를 노드로 표시하거나 현재 추적을 기반으로 한 서비스 그래프를 포함하여 몇 가지 컨텍스트를 추가할 수 있습니다.

## 서비스 그래프 보기
<a name="v10-explore-trace-graph"></a>

서비스 그래프 보기는 범위 지표(속도, 오류 비율 및 기간(RED)에 대한 추적 데이터)와 서비스 그래프를 시각화합니다. 요구 사항이 설정되면 이 사전 구성된 보기를 즉시 사용할 수 있습니다.

자세한 내용은 [Tempo](tempo-data-source.md) 데이터 소스 페이지를 참조하세요. *Grafana Labs Tempo 설명서*의 [service graph view page](https://grafana.com/docs/tempo/latest/metrics-generator/service-graph-view/)를 확인할 수도 있습니다.

## 데이터 API
<a name="v10-explore-trace-dataapi"></a>

이 시각화를 올바르게 표시하려면 데이터 소스에서 반환할 데이터의 특정 형태가 필요합니다.

데이터 소스는 데이터 프레임을 반환하고 `frame.meta.preferredVisualisationType = 'trace'`를 설정해야 합니다.

**데이터 프레임 구조**

필수 필드


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
| traceID | 문자열 | 전체 추적의 식별자. 데이터 프레임에는 하나의 추적만 있어야 합니다. | 
| spanID | 문자열 | 현재 범위의 식별자. SpanID는 추적당 고유해야 합니다. | 
| parentSpanID | 문자열 | 추적 보기에서 하위 상위 관계를 생성하기 위한 상위 범위의 SpanID. 상위가 없는 루트에 대해 undefined일 수 있습니다. | 
| serviceName | 문자열 | 이 범위가 속한 서비스의 이름. | 
| serviceTags | TraceKeyValuePair[] | 서비스와 관련된 태그 목록. | 
| startTime | number | 범위 시작 시간(밀리초 에포크 시간 단위). | 
| 기간 | number | 범위 지속 시간(밀리초 단위). | 

 선택적 필드: 


| 필드 이름 | Type | 설명 | 
| --- | --- | --- | 
| 로그 | TraceLog[] | 현재 범위와 연결된 로그 목록. | 
| tags | TraceKeyValuePair[] | 현재 범위와 연결된 태그 목록. | 
| warnings | string[] | 현재 범위와 연결된 경고 목록. | 
| stackTraces | string[] | 현재 범위와 연결된 스택 추적 목록. | 
| errorIconColor | 문자열 | 범위에 error: true 태그가 지정된 경우 오류 아이콘의 색상. | 

유형에 대한 자세한 내용은 GitHub의 [TraceSpanRow](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L28), [TraceKeyValuePair](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L4) 및 [TraceLog](https://github.com/grafana/grafana/blob/main/packages/grafana-data/src/types/trace.ts#L12)를 참조하세요.

# 탐색에서의 상관관계 편집기
<a name="v10-explore-correlations"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

상관관계를 통해 사용자는 두 데이터 소스 간에 링크를 빌드할 수 있습니다. 상관관계에 대한 개요를 포함하여 자세한 내용은 [Grafana 버전 10에서의 상관관계](v10-correlations.md) 섹션을 참조하세요.

## 상관관계 생성
<a name="v10-explore-corr-create-a-correlation"></a>

탐색 페이지에서 상관관계를 생성할 수 있습니다.

**상관관계를 생성하는 방법**

1. Amazon Managed Grafana 워크스페이스에서 탐색 페이지로 이동하세요.

1. 새 상관관계의 소스로 설정하려는 데이터 소스를 선택하세요.

1. 지원되는 시각화에서 데이터를 생성하는 쿼리를 실행하세요.
**참고**  
지원되는 시각화는 [로그](v10-panels-logs.md) 및 [테이블](v10-panels-table.md)입니다.

1. 상단 도구 모음에서 **\$1 추가**를 선택하고 **상관관계 추가**를 선택하세요. [명령 팔레트](v10-search.md#v10-search-palette)에서 **상관관계 편집기**를 선택할 수도 있습니다.

   탐색은 이제 상관관계 편집기 모드이며 파란색 테두리와 상단 표시줄로 표시됩니다. 상단 표시줄에서 종료를 선택하여 상관관계 편집기를 **종료**할 수 있습니다.

1. 이제 새 쿼리를 빌드하는 데 사용할 수 있는 데이터에 연결된 링크를 사용하여 시각화에 대해 다음과 같은 새 상관관계를 생성할 수 있습니다.
   + *로그* - 링크는 각 로그 행의 로그 세부 정보 내 필드 값 옆에 표시됩니다.
   + *테이블* - 모든 테이블 셀은 링크입니다.

1. 링크를 선택하여 새 상관 관계를 추가하세요. 링크는 상관관계의 결과 필드로 사용되는 필드와 연결됩니다. 자세한 내용은 [상관관계 구성](v10-correlations-config.md) 섹션을 참조하세요.

1. 열리는 분할 보기에서 오른쪽 창을 사용하여 상관관계의 대상 쿼리 소스를 설정하세요. 자세한 내용은 [대상 쿼리](v10-correlations-config.md#v10-correlations-config-target-query) 섹션을 참조하세요.

1. 창 상단에 제공된 목록의 변수와 함께 [변수 구문](v10-dash-variable-syntax.md)을 사용하여 대상 쿼리를 빌드하세요. 목록에는 선택한 데이터 행의 샘플 값이 포함되어 있습니다.

1. 레이블 및 설명(선택 사항)을 제공하세요. 레이블은 시각화 내의 링크 이름으로 사용되며 변수를 포함할 수 있습니다.

1. 변환을 제공하세요(선택 사항, 자세한 내용은 아래 참조).

1. 상단 도구 모음에서 **저장**을 선택하여 상관관계를 저장하고 상관관계 편집기 모드를 종료하세요. 상관관계를 생성하는 데 사용되는 링크는 각 행의 데이터 링크로 대체됩니다. 링크를 선택하면 정의한 쿼리가 다른 창에서 실행되며 변수는 선택한 행의 값으로 동적으로 대체됩니다.

## 변환
<a name="v10-explore-corr-transformations"></a>

변환을 사용하면 필드에 있는 값을 다른 데이터와 함께 추출할 수 있습니다. 예를 들어 변환을 사용하면 상관관계에 사용할 로그 줄의 한 부분을 추출할 수 있습니다. 상관관계의 변환에 대한 자세한 내용은 [상관관계 변환](v10-correlations-config.md#v10-correlations-config-transformations) 섹션을 참조하세요.

편집기 모드에서 생성된 링크 중 하나를 선택한 후 **변환** 드롭다운 메뉴에서 **변환 추가**를 선택하여 변환을 추가할 수 있습니다.

**상관관계에서 변환을 사용하는 방법**

1. 변환을 적용할 필드를 선택하세요. 변환에 사용할 필드 부분을 선택하세요. 예를 들어 로그 줄이 있습니다. 선택하면 이 필드의 값을 사용하여 이 변환을 빌드할 수 있습니다.

1. 변환 유형을 선택하세요. 옵션 및 관련 설정은 [상관관계 변환](v10-correlations-config.md#v10-correlations-config-transformations) 섹션을 참조하세요.

1. 선택에 따라 하나 이상의 변수가 채워지거나 표시되는 옵션에서 더 많은 사양을 제공해야 할 수 있습니다.

1. **상관관계에 변환 추가**를 선택하여 지정된 변수를 사용 가능한 변수 목록에 추가하세요.

**참고**  
이 대화 상자에 있는 정규식의 경우 다른 설명서에서 참조하는 `mapValue`가 여기에서는 `Variable Name`으로 표시됩니다. Grafana는 필드 값의 표현식과 일치하는 모든 텍스트를 강조 표시합니다. 정규식 캡처 그룹을 사용하여 일치 중 추출해야 하는 부분을 선택합니다. 유효한 정규식이 제공되면 변수와 해당 변수의 값이 `Variable Name` 필드 아래에 나타납니다.

## 상관관계 예제
<a name="v10-explore-corr-examples"></a>

다음 예제에서는 탐색의 상관관계 편집기를 사용하여 상관관계를 생성하는 방법을 보여줍니다. 다음 예제를 따르려면 [테스트 데이터 소스](testdata-data-source.md)를 설정해야 합니다.

### 상관관계를 그래프로 작성하도록 텍스트 생성
<a name="v10-explore-corr-text-to-graph"></a>

이 예제에서는 탐색에서 상관관계 편집기를 사용하여 상관관계를 생성하는 방법을 보여줍니다.

상관관계를 사용하면 한 쿼리의 결과를 사용하여 모든 데이터 소스에서 새 쿼리를 실행할 수 있습니다. 이 예제에서는 테이블 형식 데이터를 렌더링하는 쿼리를 실행합니다. 데이터는 그래프 결과를 생성하는 다른 쿼리를 실행하는 데 사용됩니다.

이 예제를 따르려면 [테스트 데이터 소스](testdata-data-source.md)를 설정했는지 확인합니다.

**상관관계를 그래프로 작성하도록 텍스트를 생성하는 방법**

1. Grafana에서 **탐색**으로 이동하세요.

1. 페이지 왼쪽 상단의 드롭다운 메뉴에서 **테스트 데이터 소스**를 선택하세요.

1. 오른쪽의 드롭다운 메뉴에서 **\$1 추가**를 선택하고 **상관관계 추가**를 선택하세요.

1. 탐색은 이제 상관관계 편집기 모드이며 파란색 테두리로 표시됩니다.

1. 시나리오 드롭다운 메뉴에서 **CSV 파일**을 선택하세요.

1. **population\$1by\$1state.csv** 파일을 선택하세요. 각 셀은 클릭하여 새 상관관계 생성을 시작할 수 있는 링크입니다.

1. `State` 열의 셀을 클릭하여 해당 항목에 데이터 링크를 연결하는 새 상관관계를 생성하세요. 예를 들어, `California`을 선택합니다.

1. 분할 보기에서, 왼쪽 창에서 선택한 것과 동일한 데이터 소스를 선택하세요. 쿼리 편집기 위의 도우미에는 대상 쿼리를 사용할 수 있는 사용 가능한 모든 변수가 포함되어 있습니다. 변수에는 선택한 행의 모든 데이터 필드(테이블 열)가 포함됩니다.

1. **시나리오** 메뉴에서 **CSV 지표 값**을 선택하세요. 쿼리 편집기의 `String Input` 필드는 매년 모집단 값이 포함된 변수(`${1980},${2000},${2020}`)를 제공합니다. 그러면 변수 값을 사용하여 그래프가 생성됩니다.

1. 쿼리 편집기 **별칭** 필드에 `${State}`를 입력하세요.

   쿼리를 실행하여 변수의 샘플 값을 사용하여 그래프를 생성하는지 확인하세요.

1. **저장**을 선택하여 상관관계를 저장하고 상관관계 편집기를 종료하세요.

   상관관계가 저장되면 탐색은 왼쪽 창에서 쿼리를 다시 실행합니다. 상태 이름을 클릭하면 오른쪽의 쿼리가 CSV에 삽입되는 행의 값으로 다시 실행되어 그래프가 변경됩니다. 쿼리는 상태 이름을 클릭할 때마다 업데이트된 값으로 다시 실행됩니다.

모든 데이터 소스에 동일한 단계를 적용할 수 있습니다. 상관관계를 사용하면 시각화에서 링크를 생성하여 선택한 데이터를 기반으로 동적 쿼리를 실행할 수 있습니다. 이 예제에서는 쿼리에서 반환된 데이터를 사용하여 동일한 데이터 소스를 사용해여 서로 다른 시각화를 생성하는 새 쿼리를 빌드했습니다. 그러나 모든 데이터 소스 간에 상관관계를 생성하여 사용자 지정 탐색 흐름을 생성할 수 있습니다.

### 테이블 상관관계에 대한 로그 생성
<a name="v10-explore-corr-logs-to-table"></a>

이 예제에서는 변환을 사용하여 로그 줄과 다른 필드에서 값을 추출하는 방법을 보여주는 상관관계를 생성합니다.

이 예제를 따르려면 [테스트 데이터 소스](testdata-data-source.md)를 설정했는지 확인합니다.

**테이블 상관관계에 대한 로그를 생성하는 방법**

1. Grafana에서 **탐색**으로 이동하세요.

1. 페이지 왼쪽 상단의 드롭다운 메뉴에서 **테스트 데이터 소스**를 선택하세요.

1. 오른쪽의 드롭다운 메뉴에서 **\$1 추가**를 선택하고 **상관관계 추가**를 선택하세요.

1. 탐색은 이제 상관관계 편집기 모드이며 파란색 테두리로 표시됩니다.

1. **시나리오** 메뉴에서 **로그**를 선택하세요.

1. 로그 줄을 확장하여 상관관계 링크를 확인하세요. `Correlate with hostname`을 선택합니다.

1. 분할 보기에서 탐색이 열립니다. 왼쪽 창에서 선택한 것과 동일한 데이터 소스를 선택하세요. 쿼리 편집기 위의 도우미에는 대상 쿼리를 사용할 수 있는 사용 가능한 모든 변수가 포함되어 있습니다.

1. 변환 섹션을 확장하고 **변환 추가**를 클릭하세요.

1. **필드** 드롭다운 메뉴에서 **메시지**를 선택하세요. 로그 줄은 예제 데이터로 표시됩니다.

1. **유형**에서 **Logfmt**를 선택하세요. 그러면 변수 목록이 채워집니다.

1. **상관관계에 변환 추가**를 선택하세요.

1. **변환 추가**를 다시 선택하고 **필드** 아래에서 **호스트 이름**을 선택하세요.

1. **유형**에서 **정규식**을 선택하세요.

1. **표현식**에 `-([0-9]\*)`를 입력하세요. 그러면 대시 오른쪽에 있는 숫자를 선택합니다.

1. **변수 이름** 아래에 `hostNumber`를 입력하세요. 그러면 변수 목록이 채워집니다.

1. **상관관계에 변환 추가**를 선택하여 다른 변수에 추가하세요.

1. 데이터 소스 편집기에서 **시나리오** 드롭다운 메뉴를 열고 **CSV 콘텐츠**를 선택하세요.

1. 아래 텍스트 상자에 다음을 제공하고 상관관계를 저장하세요.

   ```
   time,msg,hostNumber,status
   ${time},${msg},${hostNumber},${status}
   ```

   그러면 분할 보기가 닫히고 왼쪽 쿼리가 다시 실행됩니다. 로그 줄을 확장하여 상관관계 버튼을 확인하세요. 상관관계 버튼을 선택하면 `time`(필드), `msg`(로그 줄에서 *logfmt*로 추출), `host number`(`hostname`에서 *정규식*으로 추출) 및 `status`(로그 줄에서 *logfmt*로 추출)를 사용하여 분할 보기가 열립니다.

# 탐색에서의 검사기
<a name="v10-explore-inspector"></a>

****  
이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다.  
Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요.  
Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요.

검사기는 쿼리를 이해하고 문제를 해결하는 데 도움이 됩니다. 원시 데이터를 검사하고, 해당 데이터를 쉼표로 구분된 값(CSV) 파일로 내보내며, 로그 결과를 TXT 형식으로 내보내고, 쿼리 요청을 볼 수 있습니다.

## 검사기 UI
<a name="v10-explore-inspector-ui"></a>

검사기에는 다음 탭이 있습니다.
+ **통계 탭** - 쿼리에 걸리는 시간과 반환되는 양을 보여줍니다.
+ **쿼리 탭** - Grafana에서 데이터 소스를 쿼리할 때 서버로 전송된 요청을 표시합니다.
+ **JSON 탭** - 데이터 JSON 및 데이터 프레임 구조 JSON을 보고 복사할 수 있습니다.
+ **데이터 탭** - 쿼리에서 반환된 원시 데이터를 표시합니다.
+ **오류 탭** - 오류를 표시합니다. 쿼리가 오류를 반환할 때만 표시됩니다.

## 검사기 태스크
<a name="v10-explore-inspector-tasks"></a>

탐색 검사기에서 다양한 태스크를 수행할 수 있습니다.

**검사기 열기**

검사하려는 쿼리를 실행한 후 **검사기** 버튼을 선택합니다.

화면 하단에 검사기 창이 열립니다.

**원시 쿼리 결과 검사**

원시 쿼리 결과(즉 쿼리에서 반환한 데이터)를 테이블에서 볼 수 있습니다.

**검사기** 탭에서 **데이터** 탭을 클릭합니다.

여러 쿼리 또는 여러 노드 쿼리의 경우 추가 옵션이 있습니다.
+ **데이터 프레임 표시:** 보려는 결과 세트 데이터를 선택합니다.
+ **시간별로 조인된 시리즈:** 열당 하나의 결과 세트로 모든 쿼리의 원시 데이터를 한 번에 확인합니다. 열 제목을 클릭하여 데이터를 정렬할 수 있습니다.

**원시 쿼리 결과를 CSV로 다운로드**

Grafana는 기본 브라우저 다운로드 위치에 CSV 파일을 생성합니다. 원하는 뷰어에서 열 수 있습니다.

1. **검사기** 탭에서 위의 지침에 따라 원시 쿼리 결과를 가져오세요.

1. 내보내려는 원시 데이터가 표시될 때까지 쿼리 설정을 세분화하세요.

1. **Download CSV**를 선택합니다.

특별히 Excel에 대해 형식화된 CSV 파일을 다운로드하려면 **CSV 다운로드**를 선택하기 전에 **데이터 옵션** 패널을 확장하고 **Excel용 다운로드** 토글을 켜세요.

**TXT로 로그 결과 다운로드**

**검사기** 탭에서 **로그 다운로드**를 선택하여 현재 보고 있는 로그의 TXT 파일을 생성할 수 있습니다.

**추적 결과를 다운로드**합니다.

Grafana는 데이터 소스 유형에 따라 추적 결과에 대한 JSON 파일을 Jaeger, Zipkin 또는 OTLP 형식 중 하나로 생성합니다.

1. 검사기를 여세요.

1. 로그 쿼리 결과를 검사하세요. 내보내려는 원시 로그가 표시될 때까지 결과를 세분화하세요.

1. **로그 다운로드**를 선택하세요.

**쿼리 성능 검사**

**통계** 탭에는 쿼리 소요 시간, 전송한 쿼리 수, 반환된 행 수를 알려주는 통계가 표시됩니다. 이 정보는 특히 예상치 못하게 높거나 낮은 숫자가 있는 경우 쿼리 문제를 해결하는 데 도움이 될 수 있습니다.

통계는 읽기 전용 형식으로 표시됩니다.

**JSON 모델 보기**

데이터 프레임 JSON 모델뿐만 아니라 데이터를 탐색하고 내보낼 수 있습니다.

**JSON 모델을 보는 방법**

1. 검사기 패널에서 **JSON** 탭을 클릭하세요.

1. **소스 선택** 섹션에서 다음 옵션 중 하나를 선택하세요.
   + **데이터** - 탐색으로 반환된 데이터를 나타내는 JSON 객체를 표시합니다.
   + **DataFrame 구조** - 원시 결과 세트를 표시합니다.

1. JSON의 일부를 확장하거나 축소하여 별도의 섹션을 볼 수 있습니다. **클립보드에 복사** 옵션을 선택하여 JSON 본문을 복사하여 다른 애플리케이션에 붙여넣을 수도 있습니다.

**데이터 소스에 대한 원시 요청 및 응답 보기**

탐색 및 검사기 탭에서 작업하는 경우 쿼리로 생성하는 원시 요청 및 응답 데이터를 볼 수 있습니다. 검사기에서 **쿼리** 탭을 선택하고 **새로 고침**을 선택하여 원시 데이터를 확인합니다.

Grafana는 서버로 쿼리를 전송하고 결과를 표시합니다. 쿼리의 특정 부분을 드릴다운하거나, 모든 쿼리를 확장 또는 축소하거나, 다른 애플리케이션에서 사용할 클립보드에 데이터를 복사할 수 있습니다.