Grafana Enterprise 라이선스

Grafana Enterprise 라이선스 (Grafana Enterprise license)

Grafana Enterprise 고객이 되면 엔터프라이즈 데이터 소스 플러그인, 리포트, 역할 기반 접근 제어 등 Grafana의 프리미엄 관측 기능을 사용할 수 있어요. 이 Grafana Enterprise의 향상된 기능을 사용하려면 Grafana Enterprise 라이선스를 구매하고 활성화해야 해요.

출처: 문서

본문

Grafana Enterprise 고객이 되면 Grafana의 프리미엄 관측 기능(엔터프라이즈 데이터 소스 플러그인, 리포트, 역할 기반 접근 제어 등)에 접근할 수 있어요. 이 Grafana Enterprise의 향상된 기능을 사용하려면 Grafana Enterprise 라이선스를 구매하고 활성화해야 해요.

Grafana Labs에서 직접 라이선스를 구매하려면 Grafana Labs 담당자에게 문의하세요. Grafana Labs에서 구매한 Enterprise 라이선스를 활성화하려면 Activate an Enterprise license를 참고해요.

AWS Marketplace를 통해서도 Grafana Enterprise 라이선스를 구매할 수 있어요. AWS를 통해 구매한 라이선스 활성화에 대한 자세한 내용은 Activate a Grafana Enterprise license purchased through AWS Marketplace를 참고해요.

AWS Marketplace를 통해 구매한 Grafana Enterprise 라이선스 활성화

Enterprise 라이선스 활성화 (Activate an Enterprise license)

Grafana Enterprise 라이선스를 활성화하려면 다음 단계를 따르세요:

1단계. 라이선스 파일 다운로드 (Step 1. Download your license file)

Grafana Enterprise 라이선스를 다운로드하려면:

Grafana Cloud 계정에 로그인해요.
My Account로 이동해 페이지 왼쪽 상단의 드롭다운 메뉴에서 조직을 선택해요. 각 조직의 Overview 페이지에서 Grafana Enterprise 라이선스 섹션을 볼 수 있어요. 라이선스 옆의 Details를 클릭해요.
라이선스에 "License not configured"로 표시되거나 URL이 "-"로 나열되어 있다면 세부 정보를 업데이트해야 해요. 이 작업에는 Admin 역할이 필요해요. License Details 옆의 Update를 클릭해요. Update 버튼이 보이지 않으면 Grafana 계정 팀에 문의해요. URL을 입력해요. 이 URL은 Grafana Enterprise 인스턴스의 효과적인 root_url 구성 설정(마지막 슬래시 포함)과 일치해야 해요. 사용자가 브라우저에 입력해 프론트엔드에 접근하는 URL이어야 하며, 노드 호스트네임이 아니에요. URL은 "https://"로 시작해야 하고, localhost일 수 없으며 와일드카드를 포함할 수 없어요. (선택) 라이선스 이름을 편집해요. 이 이름은 표시 목적으로만 사용돼요. Save를 클릭해요.
라이선스 세부 정보 페이지 하단에서 Download token을 선택해 라이선스가 포함된 license.jwt 파일을 다운로드해요.

2단계. Grafana 인스턴스에 라이선스 추가 (Step 2. Add your license to a Grafana instance)

엔터프라이즈 기능을 사용하려면 Grafana Enterprise 빌드를 설치해야 해요. 다운로드할 수 있어요.

Note

이미 Grafana OSS를 사용하고 있다면 같은 버전의 Grafana Enterprise로 교체할 수 있어요. 진행 전에 구성과 데이터베이스를 백업했는지 확인하세요. 자세한 내용은 Back up Grafana를 참고해요.

Grafana 인스턴스에 라이선스를 추가하는 방법은 여러 가지가 있어요:

Grafana 서버 관리자 페이지를 통해 라이선스 파일 업로드

이것은 단일 인스턴스 Grafana Enterprise 설치에서 선호되는 옵션이에요.

Grafana 서버 관리자로 로그인해요.
사이드 내비게이션 메뉴에서 Administration > General > Stats and license를 클릭해요.
Upload a new token을 클릭해요.
라이선스 파일을 선택해 업로드해요.

`license.jwt` 파일을 Grafana의 데이터 디렉터리에 넣기

Linux 시스템에서 데이터 디렉터리는 보통 /var/lib/grafana예요.

grafana.ini 설정을 사용해 라이선스 파일의 사용자 지정 위치를 구성할 수도 있어요:

[enterprise]
license_path = /company/secrets/license.jwt

이 설정은 환경 변수로도 설정할 수 있어요. Docker로 Grafana를 실행하고 라이선스 파일을 배치한 커스텀 볼륨이 있다면 유용해요. 이 경우 GF_ENTERPRISE_LICENSE_PATH 환경 변수를 라이선스 파일의 위치로 설정해요.

라이선스 파일의 내용을 구성 옵션으로 설정

license.jwt의 내용을 grafana.ini 구성 파일에 붙여넣어 라이선스를 추가할 수 있어요:

[enterprise]
license_text = eyJhbG...RuLE

이 옵션은 GF_ENTERPRISE_LICENSE_TEXT 환경 변수로 설정할 수 있어요.

3단계. 라이선스 파일의 root URL이 root_url 구성 옵션과 일치하는지 확인 (Step 3. Ensure that the license file's root URL matches the root_url configuration option)

구성에서 root_url을 업데이트해요. 사용자가 브라우저에 입력해 프론트엔드에 접근하는 URL이어야 하며, 노드 호스트네임이 아니에요.

이것은 스타트업 시 검증 확인의 일부로 Grafana가 라이선스 URL을 구성의 root_url과 비교하기 때문에 중요해요.

구성 파일에서:

[server]
root_url = https://grafana.example.com/

또는 환경 변수로:

GF_SERVER_ROOT_URL=https://grafana.example.com/

4단계. Grafana 재시작 (Step 4. Restart Grafana)

Grafana Enterprise 설치를 마무리하려면 모든 Grafana Enterprise 기능을 활성화하기 위해 Grafana를 재시작해요. 자세한 내용은 restart Grafana를 참고해요.

라이선스 만료 (License expiration)

라이선스가 만료되어도 Grafana의 대부분 기능은 정상적으로 계속 작동해요. 일부 엔터프라이즈 기능은 중단되거나 축소된 기능으로 실행되며, Grafana는 사용자에게 만료된 라이선스로 실행 중임을 알리는 배너를 표시해요. Grafana 관리자는 전체 기능을 복원하려면 새 라이선스 파일을 업로드해야 해요.

가능한 빨리 라이선스를 교체하세요. 만료된 라이선스로 Grafana Enterprise를 실행하는 것은 지원되지 않으며 예기치 않은 결과를 초래할 수 있어요.

라이선스 업데이트 (Update your license)

현재 license.jwt 파일을 찾아요. 표준 설치에서는 Grafana 데이터 디렉터리 안에 저장되는데, 일반적인 Linux 설치에서는 /var/lib/grafana/data예요. 이 위치는 ini 파일 Configuration에서 오버라이드할 수 있어요:

[enterprise]
license_path = /path/to/your/license.jwt

구성 파일의 위치는 GF_ENTERPRISE_LICENSE_PATH 환경 변수로도 오버라이드할 수 있어요.

Grafana Cloud Account에 로그인하고 페이지 상단 드롭다운에서 올바른 조직에 있는지 확인해요.
왼쪽 메뉴 바의 Grafana Enterprise 섹션 아래에서 라이선스를 선택하고, Grafana를 실행하는 데 사용할 현재 유효한 라이선스를 다운로드해요. Grafana.com에 유효한 라이선스가 보이지 않으면 구독을 갱신하려면 Grafana Labs의 계정 관리자에게 문의하세요.
현재 license.jwt 파일을 방금 다운로드한 파일로 교체해요.
Grafana를 재시작해요.

라이선스가 만료되는 경우 (If your license expires)

Grafana Enterprise 라이선스가 만료되면 기능 동작에 다음과 같은 변경이 생겨요.

데이터 소스 권한 (Data source permissions)

현재 데이터 소스 권한은 정상적으로 계속 작동하지만, 라이선스가 갱신될 때까지 새 데이터 소스 권한을 추가할 수 없어요.

LDAP 인증 (LDAP authentication)

LDAP 동기화는 만료된 라이선스의 영향을 받지 않아요.
팀 동기화 디버깅은 사용할 수 없어요.

SAML 인증 (SAML authentication)

SAML 인증은 만료된 라이선스의 영향을 받지 않아요.

역할 기반 접근 제어 (RBAC)

커스텀 역할 생성·업데이트·삭제를 사용할 수 없어요.
커스텀 역할에 대한 권한 수정을 사용할 수 없어요.

리포트 (Reporting)

새 리포트를 구성하거나 미리보기를 생성할 수 없어요.
기존 리포트는 계속 전송돼요.

엔터프라이즈 플러그인 (Enterprise plugins)

엔터프라이즈 플러그인이 작동을 멈출 수 있어요.

커스텀 브랜딩 (Custom branding)

커스텀 브랜딩 기능이 꺼져서, 커스텀 브랜딩 옵션이 아무 효과가 없어요.

사용량 인사이트 (Usage insights)

7일 이상 만료된 라이선스에서는 사용량 인사이트 로그를 Loki로 내보내는 기능이 꺼져요. 다른 모든 사용량 인사이트 기능은 라이선스가 만료되는 즉시 꺼져서, 대시보드 사용량, 존재 표시기(presence indicators), 향상된 검색을 볼 수 없게 돼요. Grafana는 사용량 데이터를 계속 수집하며, 라이선스를 업데이트하면 곧바로 접근할 수 있어요.

Vault 통합 (Vault integration)

Vault 통합은 만료된 라이선스의 영향을 받지 않아요.

감사 (Auditing)

감사는 만료된 라이선스의 영향을 받지 않아요.

라이선스 제한 (License restrictions)

동시 세션 제한은 만료일 후 7일 동안 활성 상태로 유지되며, 이후 꺼져요. 활성 사용자 제한은 즉시 꺼져요.

런타임 설정 업데이트 (Settings updates at runtime)

런타임 설정 업데이트는 만료된 라이선스의 영향을 받지 않아요.

이메일 공유 (Email sharing)

외부 사용자는 더 이상 이메일로 공유된 대시보드에 접근할 수 없어요. 이 대시보드들은 이제 비공개지만, 원하면 공개로 만들어 모든 사람이 접근할 수 있게 할 수도 있어요. Grafana는 공유 구성을 유지하며 라이선스를 업데이트한 후 복원해요.

Grafana Enterprise 라이선스 제한 (Grafana Enterprise license restrictions)

Grafana Enterprise 고객이 되면 Grafana Enterprise 사용을 규율하는 라이선스를 받게 돼요.

활성 사용자 제한 (Active users limit)

Grafana 라이선스에는 최대 활성 사용자 수가 포함돼요.

*활성 사용자(active user)*는 지난 30일 이내에 Grafana에 로그인한 사용자예요. 이것은 매일 업데이트되는 이동 창(rolling window)이에요.
최대 활성 사용자 수에 도달하면 현재 활성 사용자(지난 30일 동안 로그인한 사용자)만 로그인할 수 있어요. 새 사용자나 이전에 비활성이던 사용자가 로그인을 시도하면 Grafana가 라이선스 한도에 도달했음을 알리는 오류 메시지를 보게 돼요.
사용자의 역할, 사용자가 보거나 편집할 수 있는 대시보드 수, 접근할 수 있는 조직 수는 활성 사용자 수에 영향을 주지 않아요.
Grafana가 활성 사용자 한도에 도달하면 관리자에게 라이선스 한도 배너가 나타나요. 편집자와 뷰어는 배너를 보지 못해요.

활성 사용자 수 확인 (Determine the number of active users)

활성 사용자 수를 확인하려면:

시스템 관리자로 Grafana Enterprise에 로그인해요.
사이드 내비게이션 메뉴에서 Administration을 클릭해요.
General을 클릭해요.
Stats and license를 클릭해요.
Utilization 패널에서 사용량 수를 확인해요.

프로덕션 인스턴스 간 사용자 배분 (User allocation across production instances)

여러 프로덕션 인스턴스가 있다면 라이선스 사용자는 공유 풀을 형성해요. 각 인스턴스에 전체 사용자 수를 부여하는 대신, 프로덕션 인스턴스 전체에 총 사용자 수를 나눠요.

예를 들어 계약에 프로덕션 인스턴스 3개와 총 사용자 180명이 포함되어 있다면, 인스턴스당 60명씩 또는 한 인스턴스에 100명, 나머지 2개에 각각 40명씩 배분할 수 있어요. 각 인스턴스에 180명의 활성 사용자로 라이선스되는 건 아니에요.

사용자는 활성 상태인 각 프로덕션 인스턴스에서 별도로 집계돼요. 같은 사용자가 2개의 프로덕션 인스턴스에 로그인하면 각 인스턴스에서 한 번씩 집계되어 총 할당량에서 2명을 소비해요.
인스턴스 간 사용자 배분을 변경하려면 Request a change to your license를 참고해요.

개발·테스트 인스턴스 (Development and test instances)

각 프로덕션 인스턴스에는 짝지어진 개발 인스턴스와 테스트 인스턴스가 포함돼요. 개발·테스트 인스턴스는 짝지어진 프로덕션 인스턴스와 동일한 사용자 수를 받아요.

예를 들어 프로덕션 인스턴스 3개에 각각 60명이 배분되어 있다면, 각 프로덕션 인스턴스의 짝 개발·테스트 인스턴스도 60명을 받아요.

계층형 라이선스 (Tiered licensing, deprecated)

계층형 라이선스는 대시보드 뷰어와 대시보드 편집자·관리자를 각각 자체 사용자 한도가 있는 두 개의 별도 사용자 유형으로 정의해요.

Grafana는 Grafana 인스턴스의 총 활성 사용자 수만 집계하고 집행해요. 예를 들어 활성 사용자 150명을 구매했다면 관리자 20명, 편집자 70명, 뷰어 60명을 가질 수도 있고, 관리자 150명을 가질 수도 있어요. Grafana는 특정 수의 관리자·편집자와 뷰어를 부여하는 라이선스를 사용하더라도 총 활성 사용자 수를 집행해요. 이것은 이전보다 더 관대한 정책으로, 사용자 역할을 변경할 수 있는 유연성을 제공해요.

Grafana Enterprise 9.0 이전 버전을 실행 중이라면 해당 버전의 문서를 참고해 현재 버전의 라이선스 집행에 대해 알아보세요.

추가 라이선스 제한 (Additional license restrictions)

라이선스는 다음 규칙으로 제어돼요:

라이선스 만료일: 라이선스에는 만료일이 포함되며, 이 날짜는 라이선스가 비활성화되는 날이에요. 만료일이 가까워지면 갱신을 권장하는 배너가 Grafana에 표시돼요. 라이선스 갱신 방법과 만료 시 Grafana에서 일어나는 일은 License expiration을 참고해요.

라이선스 토큰 만료: Grafana Enterprise는 자동으로 갱신되는 유효한 토큰을 요구해요. 라이선스 토큰은 라이선스를 활성화하는 디지털 키예요. 기본적으로 라이선스 토큰은 Grafana API를 호출해 24시간마다 갱신돼요. 수명이 짧은 라이선스 토큰은 라이선스가 규정을 준수하는지 더 자주 검증하게 하고, 더 자주 라이선스를 업데이트할 수 있게 해줘요 - 예를 들어 사용자 추가나 손상된 라이선스 무효화 같은 경우에요.

라이선스 토큰의 세부 정보를 보려면 Server Administrator로 Grafana Enterprise에 로그인하고 Administration > General > Statistics and licensing을 방문해요. 토큰 세부 정보는 License Details 아래의 Token 섹션에 있어요.

라이선스 토큰 갱신에는 인터넷 접근이 필요하며 auto_refresh_license 구성 설정이 true로 설정되어 있어야 해요. Grafana Enterprise 인스턴스가 인터넷에 연결할 수 없다면 토큰 갱신과 라이선스 감사를 위한 추가 옵션을 Grafana Labs 계정 팀에 문의하세요.

Grafana License URL: 라이선스는 root URL이 다른 Grafana 인스턴스에서는 작동하지 않아요. License URL은 예를 들어 https://grafana.your-company.com/ 같은 Grafana 인스턴스의 전체 URL이에요. 이것은 root_url 구성 설정에 정의돼요.

동시 세션 제한: Grafana Enterprise 7.5부터 사용자는 Grafana의 동시 세션을 최대 3개까지 시작할 수 있어요. 시스템은 사용자가 새 기기, 다른 브라우저, 또는 시크릿 창에서 Grafana에 로그인할 때 세션을 만든다. 같은 브라우저의 다른 탭이나 창에서 로그인하면 하나의 세션만 사용돼요. 사용자가 세션 한도에 도달하면 네 번째 연결이 성공하고 가장 오래 비활성이던 세션이 로그아웃돼요.

라이선스 변경 요청 (Request a change to your license)

Grafana 내 라이선스 사용자 수를 늘리거나, 라이선스를 연장하거나, 라이선스 URL을 변경하려면 Grafana 지원 또는 Grafana Labs 계정 팀에 문의해요. 그들이 라이선스를 업데이트하면 Grafana 내에서 활성화할 수 있어요.

업데이트 후 라이선스를 활성화하는 방법은 Activate an Enterprise license를 참고해요.

사용량 기반 청구 (Usage billing)

표준 Grafana Enterprise 라이선스에는 사용할 수 있는 특정 수의 시트(seat)가 포함되며, 라이선스된 수보다 많은 사용자가 Grafana에 로그인하지 못하게 해요. 예측 가능한 청구가 선호된다면 이 방식이 합리적이에요. 하지만 시간에 따라 고르지 않은 사용 패턴이 예상되거나, 용량 제약으로 인해 어떤 사용자도 로그인이 막히지 않는 것이 중요할 때는 문제가 될 수 있어요.

이런 사용 사례를 위해 사용량 기반 청구(usage-based billing)를 지원해요. 라이선스에 특정 수의 포함 사용자가 포함되고, 해당 월의 초과 활성 사용자에 대해 월 단위로 청구되는 방식이에요.

사용량 기반 청구는 Grafana Labs와의 계약 협약과 라이선스 업데이트를 수반하며, Grafana Enterprise 버전 10.0.0 이상이 라이선스 토큰 자동 갱신으로 구성된 경우에만 사용할 수 있어요.

사용자 중복 제거 (User deduplication)

조직에 사용량 기반 청구가 활성화된 여러 Grafana Enterprise 인스턴스가 있다면, 각 활성 사용자는 사용자가 로그인한 인스턴스 수와 무관하게 라이선스에 한 번만 집계돼요. 각 Grafana Enterprise 인스턴스는 매일 해시된 사용자 목록을 API를 통해 Grafana Labs에 제출해요. 각 사용자 이메일 주소 또는 익명 기기 ID는 단방향 sha256 알고리즘으로 해시되어 Grafana에 제출되며, 해시된 사용자는 인스턴스 간에 중복 제거돼요.

사용량 기반 청구 요청 (Request usage billing)

사용량 기반 청구를 요청하려면 Grafana Labs 계정 팀에 문의하거나 지원 티켓을 제출해요.