기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 대시보드 빌드 **** 이 설명서 주제는 **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 워크스페이스를 생성하고 로그인한 후 대시보드를 생성하고 요구 사항에 맞게 설정을 수정할 수 있습니다. 대시보드는 [시각화를 포함하는 패널로](v10-panels-viz.md) 구성됩니다. 각 패널에는 [데이터 원본에 연결](AMG-data-sources.md) 중 하나에서 데이터를 가져오도록 쿼리가 연결되어 있습니다. [변수](v10-dash-variables.md)를 추가 및 사용하여 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 또는 기타 이름을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다. **Topics** + [대시보드 생성](v10-dash-creating.md) + [대시보드 가져오기](v10-dash-importing.md) + [대시보드 내보내기](v10-dash-exporting.md) + [대시보드 설정 수정](v10-dash-modify-settings.md) + [대시보드 URL 변수](v10-dash-dashboard-url-variables.md) + [라이브러리 패널 관리](v10-dash-manage-library-panels.md) + [대시보드 버전 기록 관리](v10-dash-manage-version-history.md) + [대시보드 링크 관리](v10-dash-manage-dashboard-links.md) + [시각화 주석 달기](v10-dash-annotations.md) + [대시보드 JSON 모델](v10-dash-dashboard-json-model.md) + [대시보드 모범 사례](v10-dash-bestpractices.md) # 대시보드 생성 **** 이 설명서 주제는 **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를 사용하여 시각적 형식으로 데이터를 표시할 수 있습니다. 시각화를 표시하려면 각 패널에 하나 이상의 쿼리가 필요합니다. 시작하기 전에 다음 사전 조건을 완료합니다. + 필수 권한이 있는지 확인합니다. 권한에 대한 자세한 내용은 [사용자, 팀 및 권한](Grafana-administration-authorization.md) 섹션을 참조하세요. + 패널을 추가하려는 대시보드를 식별합니다. + 대상 데이터 소스의 쿼리 언어를 이해합니다. + 쿼리를 작성하는 데이터 소스가 추가되었는지 확인합니다. 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 단원을 참조하십시오. 대시보드를 생성하는 방법: 1. Grafana에 로그인하고 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **새로 만들기**를 선택한 다음, **새 대시보드**를 선택하세요. 1. 빈 대시보드에서 **\$1 시각화 추가**를 선택하세요. 그러면 새 시각화 대화 상자가 열립니다. 1. 데이터 소스를 선택하세요. 테스트를 위해 기존 데이터 소스, Grafana의 기본 제공 데이터 소스 중 하나를 선택하거나 **새 데이터 소스 구성**을 선택하여 새 데이터 소스를 설정할 수 있습니다(관리자 권한이 있는 사용자만 새 데이터 소스를 구성할 수 있음). 데이터 소스가 선택된 **편집 패널** 보기가 열립니다. 필요한 경우 패널 편집기의 **쿼리** 탭을 사용하여 나중에 패널의 데이터 소스를 변경할 수 있습니다. 1. 데이터 소스의 쿼리 언어로 쿼리를 작성하거나 구성하세요. 대시보드 새로 고침 아이콘을 선택하여 데이터 소스에 대한 쿼리를 수행하고 결과를 확인하세요. 1. **시각화** 목록에서 시각화 유형을 선택하세요. Grafana에서 시각화가 적용된 쿼리 결과의 미리 보기를 표시합니다. 자세한 내용은 [시각화 옵션](v10-panels-viz.md)을 참조하세요. 1. **패널 옵션**에서 패널의 제목과 설명을 입력할 수 있습니다. 1. 대부분의 시각화는 필요한 정확한 정보를 표시하기 전에 약간의 조정이 필요합니다. 다음과 같은 방법으로 패널 설정을 조정할 수 있습니다. + [값 매핑 구성](v10-panels-configure-value-mappings.md) + [시각화별 옵션](v10-panels-viz.md) + [필드 값 재정의](v10-panels-configure-overrides.md) + [임계치 구성](v10-panels-configure-thresholds.md) + [표준 옵션 구성](v10-panels-configure-standard-options.md) 1. 패널 구성을 완료했으면 **저장**을 선택하여 대시보드를 저장하세요. 또는 **적용**을 선택하여 패널 편집기에서 나가지 않고 변경 사항을 확인하세요. 1. 시각화를 설명하거나 변경 사항을 설명하는 메모를 추가한 다음, 페이지 오른쪽 상단에서 **저장**을 클릭하세요. **참고** 이 메모는 대시보드를 이전 버전으로 되돌려야 하는 경우에 유용합니다. 1. **저장**을 선택합니다. 1. 선택적으로 대시보드 헤더에서 **추가**를 선택하고 드롭다운에서 **시각화**를 선택하여 대시보드에 패널을 더 추가할 수 있습니다. **기존 대시보드 공유** 기존 대시보드를 빠르게 복사하여 새 대시보드 생성을 시작할 수 있습니다. **기존 대시보드를 복사하는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. 복사하려는 대시보드를 선택하여 여세요. 1. 대시보드 오른쪽 상단에서 **설정**(톱니 아이콘)을 선택하세요. 1. 대시보드의 오른쪽 상단에서 **다른 이름으로 저장**을 선택하세요. 1. (선택 사항) 이름, 폴더, 설명 및 복사된 대시보드의 원본 대시보드 태그를 복사할지 여부를 지정하세요. 1. **저장**을 선택합니다. **반복 행 구성** 변수 값을 기반으로 대시보드에 패널 또는 행을 동적으로 추가하도록 Grafana를 구성할 수 있습니다. 변수는 대시보드의 모든 행에서 쿼리를 동적으로 변경합니다. 반복 패널에 대한 자세한 내용은 [반복 패널 구성]()을 참조하세요. `Multi-value` 또는 `Include all values`를 선택하여 설정된 변수가 있는 경우 행을 반복할 수도 있습니다. 시작하기 전에 쿼리에 다중 값 변수가 포함되어 있는지 확인한 후, 다음 단계를 완료해야 합니다. **반복 행을 구성하는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택한 다음, 수정하려는 대시보드를 선택하세요. 1. 대시보드 상단에서 **추가**를 선택한 다음, 드롭다운에서 **행**을 선택하세요. 대시보드가 비어 있는 경우 대시보드 가운데 있는 **\$1 행 추가** 버튼을 번갈아 선택할 수 있습니다. 1. 행 제목 위로 마우스를 가져가서 나타나는 **설정**(톱니) 아이콘을 선택하세요. 1. **행 옵션** 대화 상자에서 제목을 추가하고 반복 행을 추가할 변수를 선택하세요. **참고** 대시보드 사용자에게 컨텍스트를 제공하려면 행 제목에 변수를 추가하세요. 1. **업데이트**를 선택합니다. **행 및 대시보드 특수 데이터 소스 반복** 행이 특수 [대시보드](AMG-data-sources.md#AMG-data-sources-special) 데이터 소스를 사용하는 패널을 포함하는 경우(이때 동일한 대시보드의 다른 패널에 속하는 결과 세트를 사용하는 데이터 소스) 반복된 행의 해당 패널은 반복된 행의 패널이 아닌 원본 행에서 패널을 참조합니다. 예를 들어 대시보드에서 다음과 같습니다. + `Row 1`에는 `Panel 1A` 및 `Panel 1B`가 포함됩니다. + `Panel 1B`에서는 `Dashboard` 데이터 소스를 사용하여 `Panel 1A`의 결과를 사용합니다. + 반복 `Row 2`에는 `Panel 2A` 및 `Panel 2B`가 포함됩니다. + `Panel 2B`에서는 `Panel 2A`가 아닌 `Panel 1A`를 참조하세요. **패널을 이동하는 방법** 1. 대시보드를 엽니다. 1. 패널 제목을 선택하고 패널을 새 위치로 끄세요. 대시보드에서 임의의 위치에 패널을 배치할 수 있습니다. **패널 크기를 조정하는 방법** 1. 대시보드를 엽니다. 1. 패널의 크기를 조정하려면 패널의 오른쪽 하단을 끕니다. 요구 사항에 맞게 대시보드 패널의 크기를 조정할 수 있습니다. # 대시보드 가져오기 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 사전 구성된 대시보드를 Amazon Managed Grafana 워크스페이스로 가져올 수 있습니다. **대시보드를 가져오는 방법** 1. Amazon Managed Grafana 워크스페이스에 로그인하세요. 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **새로 만들기**를 선택하고 드롭다운 메뉴에서 **가져오기**를 선택하세요. 1. 다음으로, 가져올 대시보드 JSON 정의를 선택해야 합니다. JSON을 가져오는 방법에 세 가지 옵션이 있습니다. + 대시보드 JSON이 포함된 파일을 업로드합니다. + JSON 텍스트를 텍스트 영역에 직접 복사합니다. + Grafana Labs 대시보드 URL 또는 ID를 필드에 붙여넣습니다. grafana.com 대시보드 URL에 대한 자세한 내용은 다음 섹션을 참조하세요. + (선택 사항) 변경하려는 대시보드 세부 정보를 변경하세요. + 필요한 경우 데이터 소스를 선택하세요. + **가져오기**를 선택합니다. + 대시보드를 저장합니다. ## grafana.com에서 대시보드 찾기 grafana.com의 [대시보드](https://grafana.com/grafana/dashboards/) 페이지에서는 일반적인 서버 애플리케이션을 위한 대시보드를 제공합니다. 공식 및 커뮤니티에서 빌드한 대시보드의 라이브러리를 검색해 대시보드를 가져와 빠르게 시작하고 실행하세요. **참고** grafana.com 대시보드를 가져오려면 Amazon Managed Grafana 워크스페이스에서 인터넷에 액세스할 수 있어야 합니다. # 대시보드 내보내기 **** 이 설명서 주제는 **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 또는 HTTP API를 사용하여 대시보드를 내보낼 수 있습니다. 대시보드 내보내기 작업은 나중에 대시보드를 가져올 수 있도록 레이아웃, 변수, 스타일, 데이터 소스, 쿼리 등을 포함하여 필요한 모든 항목이 포함된 Grafana JSON 파일을 생성합니다. **이동식 대시보드 설정** 다른 사용자가 사용하도록 대시보드를 내보내려면 지표 접두사(상수 변수 사용) 및 서버 이름과 같은 항목에 대해 템플릿 변수를 추가할 수 있습니다. `Constant` 유형의 템플릿 변수는 대시보드에 자동으로 숨겨지며 대시보드를 가져올 때 필수 입력으로 추가됩니다. **대시보드를 내보내는 방법** 1. 내보내려는 대시보드를 엽니다. 1. 공유 아이콘을 선택하세요. 1. **내보내기**를 선택합니다. 1. **파일에 저장**을 선택하세요. **참고** Grafana는 로컬 시스템에 JSON 파일을 다운로드합니다. # 대시보드 설정 수정 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 대시보드 설정 페이지에서 다음을 수행할 수 있습니다. + 시간 설정을 포함한 일반 대시보드 속성을 편집합니다. + 주석 쿼리를 추가합니다. + 대시보드 변수를 추가합니다. + 링크를 추가합니다. + 대시보드 JSON 모델을 봅니다. **대시보드 설정 페이지에 액세스하는 방법** 1. 편집 모드에서 대시보드를 여세요. 1. 페이지 상단에 있는 **대시보드 설정**(톱니 아이콘)을 클릭하세요. **대시보드 시간 설정 수정** 대시보드 시간대, 로컬 브라우저 시간을 변경하고 자동 새로 고침 시간 간격을 지정하려는 경우 대시보드 시간 설정을 조정합니다. **대시보드 시간 설정을 수정하는 방법** 1. **대시보드** 설정 페이지에서 **일반**을 선택하세요. 1. **시간 옵션** 섹션으로 이동하세요. 1. 다음 설명에 따라 시간 설정을 지정하세요. 1. + **시간대** - 모니터링 중인 서비스 또는 시스템의 로컬 시간대를 지정합니다. 여러 시간대에서 작동하는 시스템 또는 서비스를 모니터링할 때 유용할 수 있습니다. + **기본값** - Grafana는 사용자 프로파일, 팀 또는 조직에 대해 선택한 기본 시간대를 사용합니다. 사용자 프로파일, 사용자가 멤버로 속한 팀 또는 조직에 대해 시간대가 지정되지 않은 경우 Grafana는 로컬 브라우저 시간을 사용합니다. + **로컬 브라우저 시간** - 보고 있는 사용자 브라우저에 대해 구성된 시간대가 사용됩니다. 일반적으로 컴퓨터에 설정된 것과 동일한 시간대입니다. + UTC를 포함한 표준 [ISO 8601 시간대](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)를 사용합니다. + **자동 새로 고침** - 상대적 시간에 대해 표시되는 옵션과 자동 새로 고침 옵션을 사용자 지정합니다. 항목은 쉼표로 구분되며 유효한 시간 단위를 허용합니다. + **지금 지연** - 시간 지연을 입력하여 `now` 시간을 재정의합니다. null 값을 피하기 위해 데이터 집계의 알려진 지연을 수용하려면 이 옵션을 사용합니다. + **시간 선택기 숨기기** - 대시보드에서 시간 선택기를 표시하지 않으려면 이 옵션을 선택합니다. **참고** 시간 제어를 사용하려면 데이터에 시간 열이 포함되어야 합니다. 시간 열을 포함하는 방법에 대한 자세한 내용은 특정 [데이터 소스](AMG-data-sources.md)에 대한 설명서를 참조하세요. **주석 쿼리 추가** 주석 쿼리는 이벤트를 쿼리하는 쿼리입니다. 이러한 이벤트는 여러 대시보드의 그래프에서 세로선으로 시각화할 수 있으며, 마우스로 가리키면 이벤트 정보를 볼 수 있는 작은 아이콘이 함께 표시됩니다. **주석 쿼리를 추가하는 방법** 1. **대시보드 설정** 페이지에서 **주석**을 선택하세요. 1. **주석 쿼리 추가**를 선택하세요. 1. 이름을 입력하고 데이터 소스를 선택하세요. 1. 양식의 나머지 부분을 작성하여 쿼리와 주석을 작성하세요. 쿼리 편집기 UI는 선택한 데이터 소스에 따라 변경됩니다. 쿼리를 구성하는 방법에 대한 자세한 내용은 [데이터 소스](AMG-data-sources.md) 설명서를 참조하세요. 또는[플러그인 카탈로그를 사용하여 플러그인 찾기](grafana-plugins.md#plugin-catalog) 에서 설치하는 데이터 소스 플러그인의 경우 [Grafana Labs 웹 사이트의 설명서](https://grafana.com/docs/grafana/v10.3/datasources/)를 사용할 수 있습니다. **변수 추가** 변수를 사용하면 보다 동적이고 대화형 기능이 강화된 대시보드를 생성할 수 있습니다. 지표 쿼리에서 서버, 애플리케이션 및 센서 이름과 같은 사물을 하드 코딩하는 대신 해당 위치에서 변수를 사용할 수 있습니다. 변수는 대시보드 상단에 드롭다운 목록으로 표시됩니다. 이러한 드롭다운을 사용하면 대시보드에 표시되는 데이터를 쉽게 변경할 수 있습니다. 변수에 대한 자세한 내용은 [변수](v10-dash-variables.md)를 참조하세요. **변수를 추가하는 방법** 1. **대시보드 설정** 페이지의 왼쪽 섹션 메뉴에서 **변수**를 클릭한 다음, **변수 추가** 버튼을 클릭하세요. 1. **일반** 섹션에서 변수의 이름을 추가하세요. 나중에 쿼리에 사용할 이름입니다. 1. 변수 **유형**을 선택하세요. **참고** 선택하는 변수 유형은 페이지에서 채우는 필드에 영향을 미칩니다. 1. 변수를 정의하고 **업데이트**를 클릭하세요. **링크 추가** 대시보드 링크를 사용하면 대시보드 헤더 바로 아래에 다른 대시보드 및 웹 사이트에 대한 링크를 배치할 수 있습니다. 링크를 사용하면 다른 관련 대시보드 및 콘텐츠를 쉽게 탐색할 수 있습니다. **링크를 추가하는 방법** 1. **대시보드 설정** 페이지의 왼쪽 섹션 메뉴에서 **링크**를 선택한 다음, **링크 추가** 버튼을 선택하세요. 1. 제목을 입력하고 **유형** 필드에서 **대시보드** 또는 **링크**를 선택하세요. 1. 대시보드 링크를 추가하려면 선택적 태그를 추가하고 대시보드 링크 옵션 중 하나를 선택한 다음, **적용**을 클릭하세요. **참고** 태그를 사용하면 모든 대시보드에 특정 태그가 있는 동적 드롭다운이 생성됩니다. 1. 웹 링크를 추가하려면 사용자가 링크 위로 마우스를 가져갈 때 나타나는 URL 및 툴팁 텍스트를 추가하고 링크 옆에 나타나는 아이콘을 선택한 다음, 대시보드 링크 옵션 중 하나를 선택하세요. **대시보드 JSON 모델 보기 ** Grafana의 대시보드는 대시보드의 메타데이터를 저장하는 JSON 객체로 표시됩니다. 대시보드 메타데이터에는 대시보드 속성, 패널의 메타데이터, 템플릿 변수, 패널 쿼리 등이 포함됩니다. JSON 메타데이터는 대시보드를 정의합니다. 대시보드 JSON 모델을 보려면 **대시보드 설정** 페이지에서 **JSON**을 클릭합니다. JSON 필드에 대한 자세한 내용은 [JSON 필드](v10-dash-dashboard-json-model.md)를 참조하세요. # 대시보드 URL 변수 **** 이 설명서 주제는 **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는 대시보드 URL에서 쿼리 파라미터로 전달되는 변수 값을 적용할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md) 및 [템플릿 및 변수](v10-dash-variables.md)를 참조하세요. **변수를 쿼리 파라미터로 전달** Grafana는 접두사가 `var-`인 쿼리 문자열 파라미터를 지정된 대시보드에서 변수로 해석합니다. 예를 들어, 이 URL에서 다음과 같습니다. ``` https://${your-domain}/path/to/your/dashboard?var-example=value ``` 쿼리 파라미터 `var-example=value`는 값이 `value`인 대시보드 변수 예제를 나타냅니다. **변수에 대한 여러 값 전달** 여러 값을 전달하려면 각 값에 대해 변수 파라미터를 한 번 반복합니다. ``` https://${your-domain}/path/to/your/dashboard?var-example=value1&var-example=value2 ``` Grafana는 `value1` 및 `value2`의 두 가지 값을 사용하여 대시보드 변수 예제로 `var-example=value1&var-example=value2`를 해석합니다. **대시보드 링크에 변수 추가** Grafana는 대시보드 설정에서 변수를 생성할 때 대시보드 링크에 변수를 추가할 수 있습니다. 변수를 추가하는 자세한 내용과 단계는 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md)를 참조하세요. **임시 필터 전달** 임시 필터는 지정된 데이터 소스를 사용하는 모든 지표 쿼리에 키 또는 값 필터를 적용합니다. 자세한 내용은 [임시 필터](v10-dash-variable-add.md#v10-dash-variable-add-adhoc)를 참조하세요. 임시 필터를 쿼리 파라미터로 전달하려면 변수 구문을 사용하여 임시 필터 변수를 전달하고 키와 연산자를 값으로, 값을 파이프로 구분된 목록으로 제공합니다. 예를 들어, 이 URL에서 다음과 같습니다. `https://${your-domain}/path/to/your/dashboard?var-adhoc=example_key|=|example_value` 쿼리 파라미터 `var-adhoc=key|=|value`는 `example_key` 키, `=` 연산자 및 `example_value` 값을 사용하여 임시 대시보드 변수로 구성된 임시 필터를 적용합니다. **참고** 임시 필터와 URL을 공유할 때는 URL을 인코딩해야 합니다. 위 예제에서 파이프(`|`)를 `%7C`로 바꾸고 등호 연산자(`=`)를 `%3D`로 바꿉니다. **URL을 사용하여 시간 범위 제어** 대시보드의 시간 범위를 설정하려면 `from`, `to`, `time` 및 `time.window` 쿼리 파라미터를 사용합니다. 변수가 아니기 때문에 `var-` 접두사는 필요하지 않습니다. # 라이브러리 패널 관리 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 라이브러리 패널은 모든 대시보드에서 사용할 수 있는 재사용 가능한 패널입니다. 라이브러리 패널을 변경하면 변경 사항이 패널이 사용되는 모든 인스턴스로 전파됩니다. 라이브러리 패널은 여러 대시보드에서 패널의 재사용을 간소화합니다. 저장된 대시보드와 함께 폴더에 라이브러리 패널을 저장할 수 있습니다. **라이브러리 패널 생성** 라이브러리 패널을 생성하면 소스 대시보드의 패널도 라이브러리 패널로 변환됩니다. 패널을 변환한 후 원본 대시보드를 저장해야 합니다. **라이브러리 패널을 생성하는 방법** 1. 편집 모드에서 라이브러리 패널로 변환할 패널을 여세요. 1. 패널 표시 옵션에서 아래쪽 화살표 옵션을 클릭하여 시각화에 대한 변경 사항을 시작하세요. 1. **라이브러리 패널**을 선택한 다음, **\$1 라이브러리 패널 생성**을 선택하세요. 그러면 생성 대화 상자가 열립니다. 1. **라이브러리 패널 이름**에 패널에 사용할 이름을 입력하세요. 1. **폴더에 저장**에서 라이브러리 패널을 저장할 폴더를 선택하세요. 1. **라이브러리 패널 생성**을 선택하여 라이브러리에 변경 사항을 저장하세요. 1. 대시보드를 저장합니다. 라이브러리 패널이 생성된 후 나타나는 대시보드를 사용하여 패널을 수정할 수 있습니다. 변경 사항을 저장하면 라이브러리 패널의 모든 인스턴스에 이러한 수정 사항이 반영됩니다. **추가...**를 선택한 다음, **라이브러리 패널 생성**을 선택하여 패널의 편집 메뉴에서 직접 라이브러리 패널을 생성할 수도 있습니다. **대시보드에 라이브러리 패널 추가** 다른 대시보드 사용자에게 시각화를 제공하려는 경우 Grafana 라이브러리 패널을 대시보드에 추가합니다. **대시보드에 라이브러리 패널을 추가하는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **새로 만들기**를 선택한 다음, 드롭다운에서 **새 대시보드**를 선택하세요. 1. 빈 대시보드에서 **\$1 라이브러리 패널 가져오기**를 선택합니다. 라이브러리 패널 목록이 표시됩니다. 1. 목록을 필터링하거나 검색하여 추가하려는 패널을 찾으세요. 1. 패널을 클릭하여 대시보드에 추가하세요. **라이브러리 패널 연결 해제** 패널을 변경하고 라이브러리 패널의 다른 인스턴스에는 영향을 주지 않으려면 라이브러리 패널의 연결을 해제하세요. **라이브러리 패널의 연결을 해제하는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **라이브러리 패널**을 선택하세요. 1. 다른 대시보드에서 사용 중인 라이브러리 패널을 선택하세요. 1. 연결을 해제할 패널을 선택하세요. 1. 패널 제목을 선택하거나 패널 위 아무 곳이나 포인터로 가리키면 패널의 오른쪽 상단에 작업 메뉴가 표시됩니다. 1. **편집**을 선택합니다. 패널이 편집 모드로 열립니다. 1. 페이지 오른쪽 상단에서 **연결 해제**를 선택하세요. 1. **예, 연결 해제**를 선택하세요. **라이브러리 패널 목록 보기** 사용 가능한 라이브러리 패널 목록을 보고 라이브러리 패널을 검색할 수 있습니다. **라이브러리 패널 목록을 보는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **라이브러리 패널**을 선택하세요. 이전에 정의한 라이브러리 패널 목록을 볼 수 있습니다. 1. 이름을 알고 있는 경우 특정 라이브러리 패널을 검색하세요. 폴더 또는 유형별로 패널을 필터링할 수도 있습니다. **라이브러리 패널 삭제** 더 이상 필요 없는 라이브러리 패널을 삭제합니다. **라이브러리 패널을 삭제하는 방법** 1. 왼쪽 메뉴에서 **대시보드**를 선택하세요. 1. **라이브러리 패널**을 선택하세요. 1. 삭제하려는 패널의 라이브러리 패널 이름 옆에 있는 삭제 아이콘을 선택합하세요. # 대시보드 버전 기록 관리 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 대시보드 버전을 저장할 때마다 이전 버전의 대시보드가 사라지지 않도록 해당 버전의 사본이 저장됩니다. 대시보드 설정을 선택하고 왼쪽 메뉴에서 **버전**을 선택하면 이러한 버전 목록을 사용할 수 있습니다. **참고** 대시보드의 최신 버전 20개가 저장됩니다. 대시보드 버전 기록 기능을 사용하면 이전에 저장된 대시보드 버전을 비교 및 복원할 수 있습니다. **두 대시보드 버전 비교** 두 대시보드 버전을 비교하려면 비교할 두 버전을 목록에서 선택하세요. **버전 비교**를 클릭하여 두 버전 간의 차이를 확인합니다. 그러면 버전 차이 보기가 나타납니다. 기본적으로 변경 사항에 대한 텍스트 요약이 표시됩니다. 대시보드를 나타내는 원시 JSON의 차이를 보려면 하단의 **JSON Diff 보기** 버튼을 클릭하면 됩니다. **이전에 저장된 대시보드 버전으로 복원** 이전에 저장한 대시보드 버전으로 복원해야 하는 경우 대시보드 버전 목록의 행 오른쪽에 있는 **복원** 버튼을 선택하거나 차이 보기에서 **버전 **(으)로 복원** 버튼을 선택할 수 있습니다. 이 중 하나를 선택하면 복원을 확인하라는 프롬프트가 표시됩니다. 이전 버전으로 복원하면 이전 버전과 정확히 동일한 데이터를 포함하지만 버전 번호가 다른 새 버전이 생성됩니다. 이는 새 대시보드 버전의 행에 대한 **참고 열**에 표시됩니다. 이렇게 하면 이전 대시보드 버전이 변경의 영향을 받지 않습니다. # 대시보드 링크 관리 **** 이 설명서 주제는 **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는 대시보드 링크, 패널 링크 및 데이터 링크를 지원합니다. 대시보드 링크는 대시보드 상단에 표시됩니다. 패널 링크는 패널의 왼쪽 상단에 있는 아이콘을 클릭하여 액세스할 수 있습니다. **사용할 링크 선택** 먼저 현재 대시보드 사이를 이동하는 방법부터 살펴봅니다. 대시보드 세트 사이를 자주 이동하고 각 세트에서 동일한 컨텍스트를 찾기 위해 애쓰는 경우 링크를 사용하면 워크플로를 최적화하는 데 도움이 될 수 있습니다. 다음 단계는 워크플로에 적합한 링크 유형을 파악하는 것입니다. Grafana의 모든 링크 유형은 다른 대시보드 또는 외부 웹 사이트에 대한 바로 가기를 생성하는 데 사용되지만 다른 컨텍스트에서도 작동합니다. + 대시보드의 모든 패널이 아니라 대부분과 링크가 관련된 경우 대시보드 링크를 사용합니다. + 특정 패널로 드릴다운하려면 패널 링크를 사용합니다. + 외부 사이트에 연결하려는 경우 대시보드 링크 또는 패널 링크를 사용할 수 있습니다. + 특정 시리즈 또는 단일 측정으로 드릴다운하려면 데이터 링크를 사용합니다. **URL을 사용하여 시간 범위 제어** 패널 또는 대시보드의 시간 범위를 제어하려면 대시보드 URL에서 쿼리 파라미터를 제공할 수 있습니다. + `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다. + `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다. + `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다. **대시보드 링크** 대시보드 링크를 생성할 때 시간 범위와 현재 템플릿 변수를 포함하여 다른 대시보드에서 동일한 컨텍스트로 직접 이동할 수 있습니다. 이렇게 하면 링크를 보내는 사람이 올바른 데이터를 보고 있는지 걱정하지 않아도 됩니다. 다른 유형의 링크는 [데이터 링크 변수]()를 참조하세요. 대시보드 링크는 현재 대시보드 이름으로 GitHub 문제를 제출하는 등 외부 시스템에 대한 바로 가기로도 사용할 수 있습니다. 대시보드 링크를 추가하면 대시보드의 오른쪽 상단에 표시됩니다. **대시보드에 링크 추가** 현재 대시보드 상단에서 다른 대시보드에 대한 링크를 추가하세요. **대시보드에 링크를 추가하는 방법** 1. 연결하려는 대시보드를 보는 동안 화면 상단의 톱니를 클릭하여 **대시보드 설정**을 여세요. 1. **링크**를 선택하고 **대시보드 링크 추가** 또는 **새로 만들기**를 선택하세요. 1. **유형**에서 **대시보드**를 선택하세요. 1. 다음 중에서 링크 옵션을 선택하세요. + **태그 사용** - 입력한 태그가 있는 대시보드로만 연결된 대시보드를 제한하려면 태그를 입력합니다. 그렇지 않으면 Grafana에 다른 모든 대시보드에 대한 링크가 포함됩니다. + **드롭다운** - 여러 대시보드에 연결하는 경우 기본적으로 Grafana는 대시보드 상단에 모두 나란히 표시합니다. 이 옵션을 선택하고 선택적 제목을 추가하면 드롭다운에 링크가 표시됩니다. + **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 표시된 시간 범위가 이미 설정된 상태로 연결된 대시보드가 열립니다. + **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 연결된 대시보드에서 일치하는 모든 템플릿이 링크의 값으로 설정됩니다. 자세한 내용은 [대시보드 URL 변수](v10-dash-dashboard-url-variables.md)를 참조하세요. + **새 탭에서 열기** - 대시보드 링크를 새 탭 또는 새 창에서 열려면 이 옵션을 선택합니다. 1. **추가**를 클릭합니다. **대시보드에 URL 링크 추가** 현재 대시보드 상단에서 URL에 대한 링크를 추가하세요. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다. **대시보드에 URL 링크를 추가하는 방법** 1. 연결하려는 대시보드를 보는 동안 화면 상단의 톱니를 선택하여 **대시보드 설정**을 여세요. 1. **링크**를 선택하고 **대시보드 링크 추가** 또는 **새로 만들기**를 선택하세요. 1. **유형**에서 **링크**를 선택하세요. 1. 다음 중에서 링크 옵션을 선택하세요. + **URL** - 연결할 URL을 입력합니다. 대상에 따라 필드 값을 포함할 수 있습니다. + **제목** - 링크를 표시할 제목을 입력합니다. + **툴팁** - 링크를 표시할 툴팁을 입력합니다. + **아이콘** - 링크와 함께 표시할 아이콘을 선택합니다. + **시간 범위** - 링크에 대시보드 시간 범위를 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 표시된 시간 범위가 설정된 상태로 연결된 대시보드가 열립니다. + `from` - 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다. + `to` - 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다. + `time` 및 `time.window` - `time-time.window/2`에서 `time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다. + **변수 값** - 현재 쿼리 파라미터로 사용되는 템플릿 변수를 링크에 포함하려면 이 옵션을 선택합니다. 사용자가 링크를 클릭하면 연결된 대시보드에서 일치하는 모든 템플릿이 링크의 값으로 설정됩니다. 변수 형식은 다음과 같습니다. ``` https://${you-domain}/path/to/your/dashboard?var-${template-varable1}=value1&var-{template-variable2}=value2 ``` + **새 탭에서 열기** - 대시보드 링크를 새 탭 또는 새 창에서 열려면 이 옵션을 선택합니다. 1. **추가**를 선택합니다. **대시보드 링크 업데이트** 기존 대시보드 링크를 변경하거나 업데이트하려면 다음 절차를 따르세요. **대시보드 링크를 업데이트하는 방법** 1. **대시보드 설정**의 **링크** 탭에서 편집할 기존 링크를 선택하세요. 1. 설정을 변경한 후 **업데이트**를 선택하세요. **대시보드 링크 복제** 기존 대시보드 링크를 복제하려면 복제하려는 기존 링크 옆에 있는 복제 아이콘을 선택하세요. **대시보드 링크 삭제** 기존 대시보드 링크를 삭제하려면 삭제하려는 링크 옆에 있는 휴지통 아이콘을 선택하세요. **패널 링크** 각 패널에는 패널의 왼쪽 상단에 고유한 링크 세트가 표시될 수 있습니다. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다. 사용 가능한 패널 링크를 보려면 패널 제목 오른쪽에 있는 아이콘을 선택하세요. + **패널 링크 추가**: 각 패널에는 패널의 왼쪽 상단에 고유한 링크 세트가 표시될 수 있습니다. 대시보드, 패널 또는 외부 사이트를 포함하여 사용 가능한 URL에 연결할 수 있습니다. Grafana에서 사용자가 올바른 데이터를 확대할 수 있도록 시간 범위를 제어할 수도 있습니다. 패널 왼쪽 상단에 있는 아이콘을 클릭하여 사용 가능한 패널 링크를 확인하세요. 1. 링크를 추가하려는 패널 위에 커서를 놓으세요. 1. 메뉴를 선택하고 **편집**을 선택하거나 키보드 단축키(`e`)를 사용할 수 있습니다. 1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요. 1. **링크 추가**를 선택하세요. 1. **제목**을 입력하세요. 사람이 읽을 수 있는 링크에 대한 레이블로, UI에 표시됩니다. 1. 연결할 **URL**을 입력하세요. `Ctrl+Space` 또는 `Cmd+Space`를 누르고 URL 필드를 선택하여 사용 가능한 변수를 확인하세요. 패널 링크에 템플릿 변수를 추가하면 링크는 관련 변수가 이미 설정된 올바른 컨텍스트로 사용자를 보냅니다. 시간 변수를 사용할 수도 있습니다. + `from`에서는 시간 범위의 하한(밀리초 에포크로 지정됨)을 정의합니다. + `to`에서는 시간 범위의 상한(밀리초 에포크로 지정됨)을 정의합니다. + `time` 및 `time.window`는 `time-time.window/2`\$1`time+time.window/2`의 시간 범위를 정의합니다. 두 파라미터 모두 밀리초 단위로 지정해야 합니다. 예를 들어 `?time=1500000000000&time.window=10000`인 경우 1499999995000에서 1500000005000의 10초 시간 범위에 해당합니다. + **패널 링크 업데이트** 1. 패널 오른쪽 상단에 작업 메뉴를 표시하려면 패널을 선택하거나 패널 위에 커서를 놓으세요. 1. 메뉴에서 **편집**을 선택하세요. 또는 키보드 단축키, `e`를 사용할 수 있습니다. 1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요. 1. 변경하려는 링크를 찾아 옆에 있는 **편집**(연필) 아이콘을 선택하세요. 1. 필요한 경우 변경하세요. 1. **저장**을 선택하여 변경 사항을 저장하고 창을 닫으세요. 1. 오른쪽 상단에서 **저장**을 선택하여 대시보드의 변경 사항을 저장하세요. + **패널 링크 삭제** 1. 패널 오른쪽 상단에 작업 메뉴를 표시하려면 패널을 선택하거나 패널 위에 커서를 놓으세요. 1. 메뉴에서 **편집**을 선택하세요. 또는 키보드 단축키, `e`를 사용할 수 있습니다. 1. **패널 옵션** 섹션을 확장하고 아래로 스크롤하여 **패널 링크 **로 이동하세요. 1. 삭제할 링크를 찾아 옆에 있는 **X** 아이콘을 선택하세요. 1. 오른쪽 상단에서 **저장**을 선택하여 대시보드의 변경 사항을 저장하세요. # 시각화 주석 달기 **** 이 설명서 주제는 **Grafana 버전 10.x**를 지원하는 Grafana 워크스페이스를 위해 설계되었습니다. Grafana 버전 9.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 9에서 작업](using-grafana-v9.md) 섹션을 참조하세요. Grafana 버전 8.x를 지원하는 Grafana 워크스페이스의 경우 [Grafana 버전 8에서 작업](using-grafana-v8.md) 섹션을 참조하세요. 주석은 시각화에서 리치 이벤트로 점을 표시하는 방법을 제공합니다. 모든 그래프 패널에서 세로선과 아이콘으로 시각화됩니다. 주석을 가리키면 이벤트 설명 및 이벤트 태그를 볼 수 있습니다. 텍스트 필드에는 자세한 정보를 제공하기 위해 다른 시스템에 대한 링크가 포함될 수 있습니다. 다음 세 가지 방법으로 시각화에 주석을 작성할 수 있습니다. + [기본 제공 주석 쿼리](#v10-dash-built-in-query)를 사용하여 패널에서 직접 주석 작성. + Grafana HTTP API 사용. + 대시보드 설정에서 주석 쿼리 구성. 처음 두 경우에서는 새 주석을 생성하는 반면, 마지막에서는 데이터 소스에서 기존 주석을 쿼리합니다. 기본 제공 주석 쿼리도 이를 지원합니다. 이 섹션에서는 첫 번째 및 세 번째 옵션을 설명합니다. Grafana HTTP API 사용에 대한 자세한 내용은 [주석 API](Grafana-API-Annotations.md) 섹션을 참조하세요. 주석은 다음 시각화 유형에 대해 지원됩니다. + 시계열 + 상태 타임라인 + 캔들스틱 ## 패널에서 주석 생성 Grafana는 모든 대시보드에 존재하는 [기본 제공 주석 쿼리](#v10-dash-built-in-query)를 사용하여 패널에서 직접 주석 이벤트를 추가하는 기능을 제공합니다. 이러한 방식으로 생성하는 주석은 Grafana에 저장됩니다. 패널에서 직접 주석을 추가하려는 경우: + 대시보드가 이미 저장되어 있어야 합니다. + 기본 제공 쿼리를 활성화해야 합니다. **주석을 추가하는 방법** 1. 대시보드에서 주석을 추가할 패널을 선택하세요. 컨텍스트 메뉴가 나타납니다. 1. 컨텍스트 메뉴에서 **주석 추가**를 선택하세요. 1. (선택 사항) 주석 설명 및 태그를 추가하세요. 1. **저장**을 선택합니다. 또는 주석을 추가하려면 패널을 선택하는 동안 `Ctrl` 또는 `Cmd`를 누르세요. 그러면 **주석 추가** 팝오버가 나타납니다. **리전 주석** 시각화에서 리전 또는 기간을 포함하는 주석을 생성할 수도 있습니다. **리전 주석을 추가하는 방법** 1. 대시보드에서 `Ctrl` 또는 `Cmd`를 누른 상태에서 패널 영역을 선택하세요. 1. 주석 설명 및 태그를 추가하세요(선택 사항). 1. **저장**을 클릭합니다. **주석을 편집하는 방법** 1. 대시보드에서 패널의 주석 표시기 위에 마우스를 올려 놓으세요. 1. 주석 툴팁에서 **편집**(연필) 아이콘을 선택하세요. 1. 설명 및/또는 태그를 수정하세요. 1. **저장**을 선택합니다. **주석을 삭제하는 방법** 1. 대시보드에서 패널의 주석 표시기 위에 마우스를 올려 놓으세요. 1. 주석 툴팁에서 **삭제**(휴지통) 아이콘을 선택하세요. ## 대시보드 설정을 통해 주석 가져오기 대시보드 설정의 **주석** 아래에서 기본 제공 데이터 주석 데이터 소스를 포함한 모든 데이터 소스를 사용하여 새 쿼리를 가져오기 주석에 추가할 수 있습니다. 주석 쿼리는 대시보드 전반의 그래프에서 이벤트 마커로 시각화할 수 있는 이벤트를 반환합니다. **새 주석 쿼리를 추가하는 방법** 1. 대시보드 헤더에서 **설정**(톱니) 아이콘을 선택하여 설정 메뉴를 여세요. 1. **주석**을 선택하세요. 1. **주석 쿼리 추가**를 클릭하세요. 1. 주석 쿼리의 이름을 입력하세요. 이 이름은 토글(확인란)에 지정되며, 이를 통해 이 쿼리에서 주석 이벤트를 표시할 수 있습니다. 1. 주석의 데이터 소스를 선택하세요. **고급 데이터 소스 선택기 열기**를 선택하여 새 데이터 소스 추가를 포함한 추가 옵션을 볼 수도 있습니다(관리자만 사용 가능). 1. 주석 쿼리를 바로 사용하지 않으려면 **활성화됨** 확인란을 선택 취소하세요. 1. 주석 쿼리 토글을 대시보드에 표시하지 않으려면 **숨김** 확인란을 선택하세요. 1. 이벤트 마커의 색상을 선택하세요. 1. **표시 위치** 드롭다운에서 다음 옵션 중 하나를 선택하세요. + **모든 패널** - 주석을 지원하는 모든 패널에 주석이 표시됩니다. + **선택한 패널** - 선택한 모든 패널에 주석이 표시됩니다. + **다음을 제외한 모든 패널** - 주석이 선택한 패널을 제외한 모든 패널에 표시됩니다. 1. 쿼리를 구성하세요. 주석 쿼리 옵션은 데이터 소스마다 다릅니다. 특정 데이터 소스의 주석에 대한 자세한 내용은 [데이터 원본에 연결](AMG-data-sources.md) 섹션을 참조하세요. ## 기본 제공 쿼리 주석을 추가한 후에도 주석은 계속 표시됩니다. 이는 모든 대시보드에 존재하는 기본 제공 주석 쿼리 때문입니다. 이 주석 쿼리는 현재 대시보드에서 시작된 모든 주석 이벤트를 가져와서 생성된 패널에 표시합니다. 여기에는 알림 상태 기록 주석이 포함됩니다. 기본적으로 기본 제공 주석 쿼리는 `Grafana` 특수 데이터 소스를 사용하며 수동 주석은 이 데이터 소스를 통해서만 지원됩니다. 기본 제공 주석 쿼리에서 다른 데이터 소스를 사용할 수 있지만 해당 데이터 소스에 대한 쿼리 편집기를 사용하는 방식으로만 자동화된 주석을 생성할 수 있습니다. 대시보드에 직접 주석을 추가하려면 이 쿼리를 활성화해야 합니다. **기본 제공 쿼리가 활성화되었는지 확인하는 방법** 1. 대시보드 헤더에서 대시보드 **설정**(톱니) 아이콘을 선택하여 대시보드 설정 메뉴를 여세요. 1. **주석**을 선택하세요. 1. **주석 및 알림(기본 제공)** 쿼리를 찾으세요. 쿼리 이름 앞에 **비활성화됨**이 표시되면 쿼리 이름을 선택하여 열고 설정을 업데이트해야 합니다. **주석을 가져오고 그리는 것을 중지하는 방법** 1. 대시보드 헤더에서 대시보드 **설정**(톱니) 아이콘을 선택하여 대시보드 설정 메뉴를 여세요. 1. **주석**을 선택하세요. 1. **주석 및 알림(기본 제공)** 쿼리를 선택하세요. 1. **활성화됨** 토글을 선택하여 끄세요. **다른 이름으로 저장** 기능을 사용하여 대시보드를 복사하는 경우 새 대시보드 ID를 가져오므로 소스 대시보드에서 생성된 주석은 더 이상 사본에 표시되지 않습니다. 새 **주석 쿼리**를 추가하고 태그를 기준으로 필터링하는 경우에도 여전히 표시할 수 있습니다. 그러나 이는 소스 대시보드의 주석에 필터링할 태그가 있는 경우에만 작동합니다. **태그를 기준으로 쿼리 필터링** **필터링 기준**을 `Tags`로 설정하여 `Grafana` 데이터 소스를 통해 기본 제공 주석 쿼리에서 주석을 가져올 새 쿼리를 생성할 수 있습니다. 예를 들어 주석 쿼리 이름 `outages`를 생성하고 `outage` 태그를 지정합니다. 이 쿼리는 모든 대시보드에서 또는 API를 통해 `outage` 태그가 포함된 모든 주석을 표시합니다. 주석 쿼리에 여러 태그가 정의된 경우 Grafana는 모든 태그와 일치하는 주석만 표시합니다. 동작을 수정하려면 **임의 일치**를 활성화합니다. 그러면 Grafana에서 사용자가 제공한 태그 중 하나를 포함하는 주석을 표시합니다. 태그 쿼리에서 템플릿 변수를 사용할 수도 있습니다. 즉, 다양한 서비스에 대한 통계를 보여주는 대시보드와 표시할 서비스를 나타내는 템플릿 변수가 있는 경우 주석 쿼리에서 동일한 템플릿 변수를 사용하여 해당 서비스에 대한 주석만 표시할 수 있습니다. # 대시보드 JSON 모델 **** 이 설명서 주제는 **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의 대시보드는 대시보드의 메타데이터를 저장하는 JSON 객체로 표시됩니다. 대시보드 메타데이터에는 대시보드 속성, 패널의 메타데이터, 템플릿 변수 및 패널 쿼리가 포함됩니다. **대시보드의 JSON을 보는 방법** 1. 대시보드로 이동하세요. 1. 상단 탐색 메뉴에서 **대시보드 설정**(톱니) 아이콘을 선택하세요. 1. **JSON 모델**을 선택하세요. ## JSON 필드 사용자가 새 대시보드를 생성하면 새 대시보드 JSON 객체가 다음 필드로 초기화됩니다. **참고** 다음 JSON에서는 ID가 null로 표시되며, 이는 대시보드가 저장될 때까지 할당된 기본 값입니다. 대시보드가 저장되면 `id` 필드에 정수 값이 할당됩니다. ``` { "id": null, "uid": "cLV5GDCkz", "title": "New dashboard", "tags": [], "timezone": "browser", "editable": true, "graphTooltip": 1, "panels": [], "time": { "from": "now-6h", "to": "now" }, "timepicker": { "time_options": [], "refresh_intervals": [] }, "templating": { "list": [] }, "annotations": { "list": [] }, "refresh": "5s", "schemaVersion": 17, "version": 0, "links": [] } ``` 다음에서는 대시보드 JSON의 각 필드를 설명합니다. | 이름 | 사용법 | | --- | --- | | `id` | 대시보드의 고유 숫자 식별자(db에서 생성됨) | | `uid` | 누구나 생성할 수 있는 고유한 대시보드 식별자, 문자열(8\$140) | | `title` | 대시보드의 현재 제목 | | `tags` | 대시보드와 연결된 태그, 문자열 배열 | | `style` | `dark` 또는 `light`와 같은 대시보드 테마 | | `timezone` | `utc` 또는 `browser`와 같은 대시보드 시간대 | | `editable` | 대시보드 편집 가능 여부 | | `graphTooltip` | 공유 십자선 또는 툴팁이 없는 경우 0(기본값), 공유 십자선의 경우 1, 공유 십자선 및 공유 툴팁의 경우 2 | | `time` | `last 6 hours` 또는 `last 7 days`와 같은 대시보드의 시간 범위 | | `timepicker` | 시간 선택기 메타데이터, 자세한 내용은 [시간 선택기 섹션](#v10-dash-json-panels) 참조 | | `templating` | 템플릿 지정 메타데이터, 자세한 내용은 [템플릿 지정 섹션](#v10-dash-json-panels) 참조 | | `annotations` | 주석 메타데이터, 주석을 추가하는 방법은 [주석](v10-dash-annotations.md) 참조 | | `refresh` | 자동 새로 고침 간격 | | `schemaVersion` | JSON 스키마 버전(정수), Grafana 업데이트에서 이 스키마를 변경할 때마다 증가 | | `version` | 대시보드 버전(정수), 대시보드가 업데이트될 때마다 증가 | | `panels` | 패널 배열(자세한 내용은 다음 섹션 참조) | ## 패널 패널은 대시보드의 구성 요소입니다. 데이터 소스 쿼리, 그래프 유형, 별칭 등으로 구성됩니다. 패널 JSON은 JSON 객체 배열로 구성되며, 각각 서로 다른 패널을 나타냅니다. 대부분의 필드는 모든 패널에 공통이지만 일부 필드는 패널 유형에 따라 다릅니다. 다음은 텍스트 패널의 패널 JSON에 대한 예제입니다. ``` "panels": [ { "type": "text", "title": "Panel Title", "gridPos": { "x": 0, "y": 0, "w": 12, "h": 9 }, "id": 4, "mode": "markdown", "content": "# title" } ``` **패널 크기 및 위치** gridPos 속성은 패널 크기와 위치를 그리드 좌표로 설명합니다. + `w` - 1\$124(대시보드의 너비는 24개 열로 구분됨) + `h` - 그리드 높이 단위로, 각각 30픽셀을 나타냅니다. + `x` - `w`와 동일한 단위의 x 위치. + `y` - `h`와 동일한 단위의 y 위치. 그리드에서 패널 위에 빈 공간이 있는 경우 패널을 위로 이동하는 중력(음의 방향)이 작용합니다. **시간 선택기** ``` "timepicker": { "collapse": false, "enable": true, "notice": false, "now": true, "refresh_intervals": [ "5s", "10s", "30s", "1m", "5m", "15m", "30m", "1h", "2h", "1d" ], "status": "Stable", "type": "timepicker" } ``` **템플릿 지정 ** `templating` 필드에는 저장된 값 및 기타 메타데이터와 함께 템플릿 변수 배열이 포함되어 있습니다. ``` "templating": { "enable": true, "list": [ { "allFormat": "wildcard", "current": { "tags": [], "text": "prod", "value": "prod" }, "datasource": null, "includeAll": true, "name": "env", "options": [ { "selected": false, "text": "All", "value": "*" }, { "selected": false, "text": "stage", "value": "stage" }, { "selected": false, "text": "test", "value": "test" } ], "query": "tag_values(cpu.utilization.average,env)", "refresh": false, "type": "query" }, { "allFormat": "wildcard", "current": { "text": "apache", "value": "apache" }, "datasource": null, "includeAll": false, "multi": false, "multiFormat": "glob", "name": "app", "options": [ { "selected": true, "text": "tomcat", "value": "tomcat" }, { "selected": false, "text": "cassandra", "value": "cassandra" } ], "query": "tag_values(cpu.utilization.average,app)", "refresh": false, "regex": "", "type": "query" } ] } ``` 다음 표는 템플릿 지정 필드의 사용을 설명합니다. | 이름 | 사용법 | | --- | --- | | `enable` | 템플릿 지정 활성화 여부 | | `list` | 각각 하나의 템플릿 변수를 나타내는 객체 배열 | | `allFormat` | `wildcard`, `glob`, `regex`, `pipe`를 포함하여 데이터 소스에서 모든 값을 가져오는 데 사용할 형식. | | `current` | 대시보드에 현재 선택된 변수 텍스트/값 표시 | | `datasource` | 변수의 데이터 소스 표시 | | `includeAll` | 모든 값 옵션을 사용할 수 있는지 여부 | | `multi` | 변수 값 목록에서 다중 값을 선택할 수 있는지 여부 | | `multiFormat` | 데이터 소스에서 시계열을 가져오는 동안 사용할 형식 | | `name` | 변수의 이름 | | `options` | 대시보드에서 선택할 수 있는 다양한 변수 텍스트/값 페어 배열 | | `query` | 변수 값을 가져오는 데 사용되는 데이터 소스 쿼리 | | `refresh` | 변수를 새로 고칠 시기 구성 | | `regex` | 시리즈 이름 또는 지표 노드 세그먼트의 일부 추출 | | `type` | 변수 유형, `custom`, `query` 또는 `interval` | # 대시보드 모범 사례 **** 이 설명서 주제는 **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 대시보드를 구축하고 유지하는 방법에 대한 Grafana 관리자 및 사용자를 위한 모범 사례에 대한 정보를 제공합니다. 생성할 수 있는 다양한 종류의 대시보드에 대한 자세한 내용은 Grafana Labs 웹 사이트의 [Grafana dashboards: A complete guide to all the different types you can build](https://grafana.com/blog/2022/06/06/grafana-dashboards-a-complete-guide-to-all-the-different-types-you-can-build/?pg=webinar-getting-started-with-grafana-dashboard-design-amer&plcmt=related-content-1) 블로그 게시물을 참조하세요. **참고** 이 섹션에서는 모니터링 및 대시보드 유지 관리를 위한 전략을 생성하는 데 도움이 될 수 있습니다. 시스템을 가장 잘 파악하고, 이 섹션을 사용하여 이해도를 높여야 합니다. 궁극적으로 시스템에 가장 적합한 전략을 생성하는 것은 사용자의 몫입니다. ## 일반적인 관찰성 전략 서버 팜과 같이 모니터링해야 할 내용이 많은 경우 모니터링할 만큼 중요한 항목을 결정하는 전략이 필요합니다. 이 페이지에서는 모니터링할 항목을 선택하는 몇 가지 일반적인 방법을 설명합니다. 논리적 전략을 사용하면 균일한 대시보드를 만들고 관찰성 플랫폼을 더 쉽게 확장할 수 있습니다. **전략을 위한 지침** + USE 방법에서는 시스템의 안정성을 알려주고, RED 방법에서는 사용자의 만족도를 알려줍니다. + USE에서는 문제의 원인을 보고합니다. + RED에서는 사용자 경험을 보고하지만 문제의 증상을 보고할 가능성도 큽니다. + 두 가지를 모두 모니터링하는 것은 시스템을 이해하는 데 중요합니다. 가장 좋은 방법은 원인보다는 증상에 주의하는 것입니다. 일반적으로 알림은 RED 대시보드에서 구성됩니다. **USE 방법** USE는 다음의 약어입니다. + **사용률(Utilization)** - 노드 CPU 사용량과 같이 리소스가 사용 중인 시간 비율. + **포화도(Saturation)** - 리소스가 수행해야 하는 작업의 양(종종 대기열 길이 또는 노드 로드). + **오류(Errors)** - 오류 이벤트 수. 이 방법은 CPU, 메모리, 네트워크 디바이스와 같은 인프라의 하드웨어 리소스에 가장 적합합니다. 자세한 내용은 Brendan Gregg의 [The USE Method](http://www.brendangregg.com/usemethod.html) 블로그 게시물을 참조하세요. **RED 방법** RED는 다음의 약어입니다. + **속도(Rate)** - 초당 요청 수 + **오류(Errors)** - 실패한 요청 수. + **기간(Duration)** - 이러한 요청에 걸리는 시간, 지연 시간 측정의 분포. 이 방법은 서비스, 특히 마이크로서비스 환경에 가장 적합합니다. 각 서비스에 대해 코드를 계측하여 각 구성 요소에 대한 이러한 지표를 표시합니다. RED 대시보드는 알림 및 SLA에 적합합니다. 잘 설계된 RED 대시보드는 사용자 경험을 위한 프록시 역할을 합니다. 자세한 내용은 Tom Wilkie의 [The RED method: How to instrument your services](https://grafana.com/blog/2018/08/02/the-red-method-how-to-instrument-your-services) 블로그 게시물을 참조하세요. **네 가지 골든 신호** [Google SRE 핸드북](https://landing.google.com/sre/sre-book/chapters/monitoring-distributed-systems/#xref_monitoring_golden-signals)에 따르면 사용자 대면 시스템의 지표 네 가지만 측정할 수 있는 경우 이 네 가지에 집중하세요. 이 방법은 RED 방법과 유사하지만 포화도를 포함합니다. + **지연 시간** - 요청을 처리하는 데 걸리는 시간. + **트래픽** - 시스템에 대한 수요. + **오류** - 실패한 요청의 비율. + **포화도** - 시스템이 '가득 찬' 정도. ## 대시보드 관리 성숙도 모델 *대시보드 관리 성숙도*는 대시보드 에코시스템이 얼마나 잘 설계되고 효율적인지 나타냅니다. 대시보드 설정을 주기적으로 검토하여 현재 상태와 개선 방법을 측정하는 것이 좋습니다. 일반적으로 대시보드 성숙도는 낮음, 중간 또는 높음으로 정의할 수 있습니다. 이 주제에 대한 대부분의 콘텐츠는 KubeCon 2019 토크 [Fool-Proof Kubernetes Dashboards for Sleep-Deprived Oncalls](https://www.youtube.com/watch?v=YE2aQFiMGfY)에서 발췌했습니다. **낮음 - 기본 상태** 이 단계에서는 일관된 대시보드 관리 전략이 없습니다. 거의 모든 사람이 여기에서 시작합니다. 현재 상태는 어떻게 알 수 있나요? + 누구나 대시보드를 수정할 수 있습니다. + 복사된 대시보드가 많으며, 대시보드 재사용이 거의 또는 전혀 없습니다. + 영구 지속되는 일회성 대시보드. + 버전 제어 없음(버전 제어의 대시보드 JSON). + 많은 대시보드 검색(올바른 대시보드를 찾기 위한 검색). 즉, 필요한 대시보드를 찾는 데 많은 시간이 낭비됩니다. + 올바른 대시보드로 안내하는 알림이 없습니다. **중간 - 체계적인 대시보드** 이 단계에서는 체계적인 대시보드와 함께 사용하여 대시보드 사용을 관리하기 시작합니다. 전략을 세웠을 수도 있지만 개선할 사항이 몇 가지 있습니다. 현재 상태는 어떻게 알 수 있나요? + 템플릿 변수를 사용하여 확장을 방지합니다. 예를 들어 각 노드에 대해 별도의 대시보드가 필요하지 않으므로 쿼리 변수를 사용할 수 있습니다. 또한 데이터 소스를 템플릿 변수로 만들 수 있으므로 다른 클러스터 및 모니터링 백엔드에서 동일한 대시보드를 재사용할 수 있습니다. 아이디어는 [변수](v10-dash-variables.md)의 예제 목록을 참조하세요. + [관찰성 전략](#v10-dash-common-observability-strategies)에 따른 체계적 대시보드. + 다음 수준으로 드릴다운하는 계층적 대시보드. + 대시보드 설계는 서비스 계층 구조를 반영합니다. 예를 들어 서비스당 하나의 행으로 RED 방법을 사용할 수 있습니다. 행 순서는 대시보드를 아래로 스크롤할 때 데이터 흐름을 반영할 수 있습니다. + 비슷한 크기로 비교: 크기에 차이가 있을 때 서비스 대시보드를 분할합니다. 집계된 지표가 중요한 정보를 손상시키지 않도록 하세요. + 의미 있게 색상을 사용하고 가능하면 축을 정규화하는 다양한 표현의 차트. + 의미 있는 색상의 예: 파란색은 양호한 상태이고 빨간색은 불량한 상태입니다. [임계치](v10-panels-configure-thresholds.md)가 도움이 될 수 있습니다. + 축 정규화의 예: CPU 사용량을 비교할 때 시스템의 코어 수가 다를 수 있으므로 원시 수가 아닌 백분율로 측정합니다. 코어 수를 기준으로 CPU 사용량을 정규화하면 최종 사용자가 CPU 수를 알지 않고도 100%에서 모든 코어가 사용되고 있음을 신뢰할 수 있으므로 인지 부하가 줄어듭니다. + 직접 찾아보는 경우 추측이 줄어듭니다. + 템플릿 변수를 사용하면 무작위 또는 무의미한 찾아보기가 어렵습니다. + 대부분의 대시보드는 알림으로 연결되어야 합니다. + 찾아보기는 링크와 함께 표시됩니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md) 단원을 참조하십시오. + 버전 제어 대시보드 JSON. **높음 - 최적화된 사용** 이 단계에서는 일관되고 신중한 전략으로 대시보드 관리 사용을 최적화했습니다. 유지 관리가 필요하지만 그만한 성과를 얻을 수 있습니다. + 확장을 적극적으로 줄입니다. + 기존 대시보드를 정기적으로 검토하여 여전히 관련성이 있는지 확인합니다. + 마스터 대시보드 목록에는 승인된 대시보드만 추가되었습니다. + 대시보드 사용 추적. [사용량 인사이트](v10-dash-assess-dashboard-usage.md)를 활용할 수 있습니다. + 설계에서 지원하는 일관성. + 스크립팅 라이브러리를 사용하여 대시보드를 생성하고 패턴과 스타일의 일관성을 보장합니다. + grafonnet(Jsonnet) + grafanalib(Python) + 브라우저에 편집 기능이 없습니다. 대시보드 최종 사용자는 변수를 사용하여 보기를 변경합니다. + 대시보드 찾아보기는 규칙이 아닌 예외입니다. + 프로덕션 인스턴스가 아닌 해당 목적을 위한 별도의 Grafana 인스턴스에서 실험 및 테스트를 수행합니다. 테스트 환경의 대시보드가 유용한 것으로 입증되면 해당 대시보드를 기본 Grafana 인스턴스에 추가합니다. ## 대시보드 생성 모범 사례 이 섹션에서는 Grafana 대시보드를 생성할 때 따라야 할 몇 가지 모범 사례를 간략하게 설명합니다. **시작하기 전에** 다음은 대시보드를 생성하기 전에 고려해야 할 몇 가지 원칙입니다. **대시보드는 스토리를 전달하거나 질문에 답해야 합니다.** 대시보드로 어떤 스토리를 전달하려고 하나요? 대규모에서 소규모로 또는 일반에서 특정한 상황으로 데이터의 논리적 진행을 생성해 보세요. 이 대시보드의 목표는 무엇인가요? (힌트: 대시보드에 목표가 없는 경우 대시보드가 정말 필요한지 자문해 보세요.) 간단하게 그래프를 작성하고 질문하는 질문에 답변하는 데 집중하세요. 예를 들어, '어떤 서버에 문제가 있나요?'와 같은 질문의 경우 모든 서버 데이터를 표시할 필요가 없을 수 있습니다. 문제가 있는 데이터만 표시하면 됩니다. **대시보드는 인지 부하를 줄여야 하며, 이를 더하지 않아야 합니다.** *인지 부하*는 기본적으로 특정 정보를 파악하기 위해 생각해야 하는 노력을 말합니다. 쉽게 해석할 수 있도록 대시보드를 만드세요. 다른 사용자에게는 물론, 오전 2시에 일어나 상황을 파악하려고 하는 미래를 방지하려면 매우 중요한 기능입니다. 다음을 스스로에게 물어보세요. + 각 그래프의 정확한 의미를 알 수 있나요? 의미가 명확한가요 아니면 더 검토해야 하나요? + 다른 사람에게 제시한 경우 의미를 파악하는 데 시간이 얼마나 걸리나요? 의미를 파악하지 못할까요? **모니터링 전략 보유** 그러면 새 대시보드를 쉽게 만들 수 있습니다. 대시보드 생성을 최적화하고 계획을 준수하는 것이 더 어렵지만 그만한 가치가 있습니다. 이 전략에서는 전체 대시보드 체계를 모두 관리하고 개별 대시보드 설계에서 일관성을 적용해야 합니다. 자세한 내용은 [일반적인 관찰성 전략](#v10-dash-common-observability-strategies) 및 [대시보드 관리 성숙도](#v10-dash-management-maturity-model)를 참조하세요. **기록** 전략 또는 설계 지침이 있으면 시간 경과에 따라 일관성을 유지하는 데 도움이 되도록 이를 기록합니다. **모범 사례 준수** + 새 대시보드를 생성할 때 의미 있는 이름을 사용해야 합니다. + 재생 또는 실험할 대시보드를 생성하는 경우 `TEST` 또는 `TMP` 단어를 이름에 입력합니다. + 대시보드 이름에 또는 태그로 이름이나 이니셜을 포함시켜 사람들이 대시보드를 소유한 사람을 알 수 있도록 하는 것이 좋습니다. + 임시 실험 대시보드는 사용한 후에 제거합니다. + 관련 대시보드를 여러 개 생성하는 경우 쉽게 탐색할 수 있도록 상호 참조하는 방법을 생각해 보세요. 자세한 내용은 이 섹션 뒷부분의 [대시보드 관리 모범 사례](#v10-dash-best-practices-for-managing-dashboards)를 참조하세요. + Grafana는 데이터 소스에서 데이터를 검색합니다. 일반적으로 [데이터 원본에 연결](AMG-data-sources.md) 및 특정 데이터 소스에 대한 기본적인 이해가 중요합니다. + 네트워크 또는 백엔드에 대한 부하를 줄이도록 불필요한 대시보드 새로 고침을 피합니다. 예를 들어 데이터가 1시간마다 변경되면 대시보드 새로 고침 빈도를 30초로 설정할 필요가 없습니다. + 단위 또는 범위가 다른 시계열을 표시할 때는 왼쪽 및 오른쪽 Y축을 사용합니다. + 대시보드 및 패널에 설명서를 추가합니다. + 대시보드에 설명서를 추가하려면 대시보드에 [텍스트 패널 시각화](v10-panels-text.md)를 추가합니다. 대시보드의 목적, 유용한 리소스 링크 및 사용자가 대시보드와 상호 작용하는 데 필요할 수 있는 모든 지침을 기록합니다. + 패널에 설명서를 추가하려면 패널 설정을 편집하고 설명을 추가합니다. 패널의 왼쪽 상단에 있는 작은 `i`에 커서를 놓으면 추가한 텍스트가 표시됩니다. + [템플릿 및 변수](v10-dash-variables.md)를 사용하여 대시보드를 재사용하고 일관성을 적용합니다. + 그래프 데이터를 스택할 때 주의하세요. 시각화에 오해의 소지가 있으며 중요한 데이터를 숨길 수 있습니다. 대부분의 경우 끄는 것이 좋습니다. ## 대시보드 관리 모범 사례 이 페이지에서는 Grafana 대시보드를 관리할 때 따를 수 있는 몇 가지 모범 사례를 간략하게 설명합니다. **시작하기 전에** 다음은 대시보드 관리를 시작하기 전에 고려해야 할 몇 가지 원칙입니다. **전략적 관찰성** 몇 가지 [일반적인 관찰성 전략](#v10-dash-common-observability-strategies)이 있습니다. 이 전략을 검토하고 그 중 사용자에게 적합한 전략이 있는지 아니면 자체적으로 전략을 수립해야 하는지 결정해야 합니다. 어느 쪽이든 계획을 세우고 기록한 후 이를 준수합니다. 필요에 따라 변화하는 요구 사항에 맞게 전략을 조정합니다. **성숙도 수준** 대시보드 성숙도 수준은 어느 정도인가요? 현재 대시보드 설정을 분석하고 [대시보드 관리 성숙도 모델](#v10-dash-management-maturity-model)과 비교합니다. 현재 상태를 파악하면 원하는 목표에 도달하는 방법을 결정하는 데 도움이 될 수 있습니다. **모범 사례 준수** + 대시보드 확장(대시보드의 통제되지 않은 확장)을 방지하세요. 대시보드 확장은 올바른 대시보드를 찾는 데 걸리는 시간에 부정적인 영향을 미칩니다. 대시보드를 복제하고 '하나'만 변경하는 경우(원본 태그를 유지하는 경우 상황이 악화됨)가 가장 쉬운 확장 유형입니다. + 대시보드를 정기적으로 검토하고 불필요한 대시보드를 제거합니다. + 임시 대시보드를 생성하는 경우 테스트하려고 한다면 이름에 `TEST:` 접두사를 추가합니다. 완료되면 대시보드를 삭제합니다. + 큰 변경 사항이 없는 대시보드를 복사하는 것은 좋은 생각이 아닙니다. + 설명서 변경, 버그 수정 또는 지표에 추가와 같은 원본 대시보드에 대한 업데이트를 놓칠 수 있습니다. + 많은 경우 템플릿 파라미터를 설정하여 보기를 사용자 지정하기 위해 사본이 생성됩니다. 대신 마스터 대시보드에 대한 링크를 유지하고 [URL 파라미터](v10-panels-configure-data-links.md#v10-panels-data-link-variables)로 보기를 사용자 지정해야 합니다. + 대시보드를 복사해야 하는 경우 대시보드의 이름을 명확하게 바꾸고 대시보드 태그를 복사하지 *마세요*. 태그는 검색 중에 사용되는 대시보드의 중요한 메타데이터입니다. 태그를 복사하면 잘못된 일치가 발생할 수 있습니다. + 대시보드 또는 상호 참조 대시보드의 대시보드를 유지 관리합니다. 여러 방법으로 수행할 수 있습니다. + 대시보드 링크, 패널 또는 데이터 링크를 생성합니다. 링크는 다른 대시보드 또는 외부 시스템으로 이동할 수 있습니다. 자세한 내용은 [대시보드 링크 관리](v10-dash-manage-dashboard-links.md)를 참조하세요. + [대시보드 목록 패널](v10-panels-dashboard-list.md)을 추가합니다. 그런 다음, 태그 또는 폴더 검색을 수행하여 표시되는 내용을 사용자 지정할 수 있습니다. + [텍스트 패널](v10-panels-dashboard-list.md)을 추가하고 마크다운을 사용하여 표시를 사용자 지정합니다.