Terraform으로 Grafana Cloud의 Frontend Observability 관리

Terraform으로 Grafana Cloud의 Frontend Observability 관리 (Manage Frontend Observability in Grafana Cloud with Terraform)

이 문서는 Terraform을 사용해 Grafana Frontend Observability 리소스를 관리하는 방법을 안내해요. Frontend Observability API에 연결하기 위한 접근 정책과 토큰 생성, Grafana Cloud provider 구성, 그리고 Frontend Observability API를 사용하도록 provider를 구성하는 방법을 다뤄요.

출처: 문서

본문

Terraform을 사용해 Grafana Frontend Observability 리소스(예: 애플리케이션)를 관리하는 방법을 배워요. 이 가이드는 Frontend Observability API에 연결할 수 있도록 Frontend Observability용 접근 정책과 토큰을 만드는 방법을 보여줘요.

시작하기 전에 (Before you begin)

시작하기 전에 다음 항목이 있는지 확인해요:

Get started에 나온 것처럼 Grafana Cloud 계정.
머신에 설치된 Terraform.
Grafana 인스턴스의 관리자 권한.

Note 다음의 모든 Terraform 구성 파일을 같은 디렉터리에 저장해야 해요.

Grafana Cloud용 provider 구성 (Configure a provider for Grafana Cloud)

이 Terraform 구성은 Grafana provider를 Cloud API와 상호작용할 때 필요한 인증을 제공하도록 구성해요. grafana_cloud_stack (Data Source)는 인스턴스의 세부 정보를 검색하는 데 사용돼요.

Grafana Cloud 접근 정책과 토큰을 만들어요. 새로 만들려면 Grafana Cloud Access Policies을 참고해요. realm 목록에 스택을 추가해요. 이 가이드의 예제에 필요한 스코프는 다음과 같아요:

accesspolicies:read
accesspolicies:write
accesspolicies:delete
dashboards:read
dashboards:write
dashboards:delete
orgs:read
orgs:write
stacks:read
stacks:write
stacks:delete
stack-dashboards:read
stack-dashboards:write
stack-dashboards:delete
stack-service-accounts:write

cloud-provider.tf 파일을 만들고 다음 코드 블록을 추가해요:

terraform {
  required_providers {
    grafana = {
      source  = "grafana/grafana"
    }
  }
}

provider "grafana" {
  alias = "cloud"

  cloud_access_policy_token = "<CLOUD_ACCESS_POLICY_TOKEN>"
}

data "grafana_cloud_stack" "stack" {
  provider = grafana.cloud

  slug = "<STACK_SLUG>"
}

다음 필드 값을 바꿔주세요:

<CLOUD_ACCESS_POLICY_TOKEN> — 첫 번째 단계에서 만든 접근 정책 토큰.
<STACK_SLUG> — Grafana Cloud 인스턴스를 사용할 수 있는 하위 도메인인 스택 slug: https://<STACK_SLUG>.grafana.net.

Frontend Observability용 접근 정책과 토큰 생성 (Create an access policy and token for Frontend Observability)

다음이 포함된 Terraform 구성을 만들어야 해요:

grafana_cloud_access_policy (Resource)을 사용한 frontend-observability:read, frontend-observability:write, frontend-observability:delete 스코프의 접근 정책.
grafana_cloud_access_policy_token (Resource)을 사용한 frontend_o11y_api_access_token 토큰.

provider를 Frontend Observability API로 구성 (Configure the provider to use the Frontend Observability API)

토큰을 만든 후에는 다음과 같이 provider를 구성할 수 있어요:

provider "grafana" {
  frontend_o11y_api_access_token = "<access token from previous step>"
}

요약 (Summary)

이 가이드에서는 Terraform을 사용해 Frontend Observability용 접근 정책과 토큰을 만들었어요. Terraform으로 Grafana Cloud를 관리하는 방법에 대해 더 알아보려면 Grafana provider 문서를 참고해요.

더 알아보기

원문 문서