Azure Data Explorer 데이터 원본 구성

Azure Data Explorer는 로그 및 원격 분석 데이터 탐색 서비스입니다. 이 가이드에서는 Azure Data Explorer 데이터 원본을 Grafana에 추가하는 방법과 이 데이터 원본에 사용할 수 있는 각 인증 옵션을 사용하여 Azure Data Explorer를 구성하는 방법을 알아봅니다.

필수 조건

• 표준 플랜의 Azure Managed Grafana 인스턴스.
• Azure Data Explorer 데이터베이스

Azure Data Explorer 데이터 원본 추가

아래 단계에 따라 Azure Data Explorer 데이터 원본을 Grafana에 추가합니다.

1. Azure Portal에서 Azure Managed Grafana 인스턴스를 엽니다.

2. 개요 섹션에서 엔드포인트 URL을 엽니다.

3. Grafana 포털에서 왼쪽 메뉴를 배포하고 연결>데이터 연결을 선택합니다.

   

4. 목록에서 Azure Data Explorer 원본 데이터를 선택하고 Azure Data Explorer 원본 데이터 원본 데이터 만들기를 선택하여 Grafana에 추가합니다.

Azure Data Explorer 데이터 원본 구성

Azure Data Explorer 구성 설정을 입력합니다.

1. 설정 탭에서 원하는 경우 데이터 원본 이름을 편집합니다.

   

2. 연결 세부 정보 아래에 Azure Data Explorer 데이터베이스 클러스터 URL을 입력합니다.

3. 관리 ID, 앱 등록(서비스 주체) 또는 현재 사용자(사용자 기반 인증) 중에서 원하는 인증 옵션을 선택합니다.

   관리 ID

   명시적 자격 증명을 사용하지 않고 관리 ID로 인증합니다.

   새 권한 추가

   1. Azure Portal에서 Azure Data Explorer 클러스터를 엽니다.

   2. 개요 섹션에서 데이터가 포함된 데이터베이스를 선택합니다.

   3. 권한 > > 뷰어 추가를 선택합니다.

      

   4. 검색 상자에 Azure Managed Grafana 작업 영역 이름을 입력하고 작업 영역을 선택한 다음 선택을 선택합니다. 성공 알림이 나타납니다.

   Grafana에서 데이터 원본 구성

   1. Grafana로 돌아가서 인증 방법에서 관리 ID를 선택합니다.
   2. 저장 및 테스트를 선택합니다. 표시되는 "성공" 알림은 Grafana가 데이터베이스에서 데이터를 가져올 수 있음을 나타냅니다.

   앱 등록

   Microsoft Entra 서비스 주체를 사용하여 앱 등록으로 인증합니다.

   초기 설정

   1. Microsoft Entra ID로 애플리케이션을 등록하고 서비스 주체 만들기의 단계를 따릅니다.
   2. 가이드의 다음 단계에서 애플리케이션에 읽기 권한자 역할을 할당합니다.
   3. 애플리케이션 세부 정보 검색 가이드의 첫 세 단계에 따라 다음 단계에 필요한 디렉터리(테넌트) ID, 애플리케이션(클라이언트) ID 및 클라이언트 암호 ID를 수집합니다.

   Grafana에서 데이터 원본 구성

   1. Grafana의 인증 방법에서 앱 등록을 선택합니다.

   2. Azure Cloud의 경우 Azure Cloud를 선택합니다. 예: Azure.

      

   3. 디렉터리(테넌트) ID, 애플리케이션(클라이언트) ID 및 클라이언트 암호를 입력합니다.

   4. 선택적으로 쿼리 최적화, 데이터베이스 스키마 설정 및 추적 섹션도 편집할 수 있습니다.

   5. 저장 및 테스트를 선택하여 연결의 유효성을 검사합니다. 표시되는 "성공" 알림은 Grafana가 데이터베이스에 연결할 수 있음을 나타냅니다.

   현재 사용자

   구성된 데이터 원본에서 현재 Grafana 사용자의 Microsoft Entra ID 자격 증명을 활용하는 사용자 기반 인증 방법을 사용합니다.

   현재 사용자 인증 방법을 사용하여 Azure Data Explorer 데이터 원본을 구성하면 Grafana는 사용자 자격 증명을 사용하여 Azure Data Explorer를 쿼리합니다.

   주의

   Grafana 데이터 원본의 사용자 기반 인증은 실험적입니다.

   주의

   이 기능은 경고, 보고, 쿼리 캐싱 및 공용 대시보드를 포함하여 쿼리된 데이터에 대한 상시 액세스 컴퓨터 액세스가 필요한 사용 사례와 호환되지 않습니다. 현재 사용자 인증 방법은 Grafana가 데이터베이스에 연결하기 위해 대화형 세션에서 로그인한 사용자에 따라 다릅니다. 사용자 기반 인증을 사용하고 로그인한 사용자가 없으면 자동화된 작업을 백그라운드에서 실행할 수 없습니다. Azure Data Explorer에 대한 자동화된 작업을 활용하려면 다른 인증 방법을 사용하여 다른 Azure Data Explorer 데이터 원본을 설정하는 것이 좋습니다.

   새 권한 추가

   데이터베이스에 액세스하려면 사용자 계정에 새 권한을 추가합니다.

   1. Azure Portal에서 Azure Data Explorer 데이터베이스 리소스를 열고 권한>추가>뷰어를 선택합니다.

   2. 검색 창에 이름이나 이메일 주소를 입력하고 사용자 계정을 선택한 다음 선택을 선택합니다.

      

   3. 데이터베이스에 권한이 추가되었음을 확인하는 알림이 표시됩니다.

   Grafana에서 데이터 원본 구성

   1. Grafana의 인증 방법에서 현재 사용자를 선택합니다.
   2. 저장 및 테스트를 선택합니다. 표시되는 "성공" 알림은 Grafana가 데이터베이스에서 데이터를 가져올 수 있음을 나타냅니다.

Azure Data Explorer 데이터 원본 만들기

Azure CLI에서 az grafana data-source create 명령을 실행하여 Azure Data Explorer 데이터 원본을 추가하고 구성합니다. 원하는 인증 방법을 선택하고 자세한 내용은 아래 해당 탭을 참조하세요.

이러한 명령을 실행할 때 모든 자리 표시자를 고유한 정보로 바꿉니다.

관리 ID

명시적 자격 증명을 사용하지 않고 관리 ID로 인증합니다.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

앱 등록

Microsoft Entra 서비스 주체를 사용하여 앱 등록으로 인증합니다.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

현재 사용자

현재 사용자 방법으로 인증합니다. 이 방법은 구성된 데이터 원본에서 현재 Grafana 사용자의 Microsoft Entra ID 자격 증명을 활용합니다.

현재 사용자 인증 방법을 사용하여 Azure Data Explorer 데이터 원본을 구성하면 Grafana는 사용자 자격 증명을 사용하여 Azure Data Explorer를 쿼리합니다.

참고 항목

Azure Managed Grafana에서 사용자 기반 인증의 출시가 진행 중이며 2023년 말까지 모든 지역에서 완료될 예정입니다.

주의

Grafana 데이터 원본의 사용자 기반 인증은 실험적입니다.

주의

이 기능은 경고, 보고, 쿼리 캐싱 및 공용 대시보드를 포함하여 쿼리된 데이터에 대한 상시 액세스 컴퓨터 액세스가 필요한 사용 사례와 호환되지 않습니다. 현재 사용자 인증 방법은 Grafana가 데이터베이스에 연결하기 위해 대화형 세션에서 로그인한 사용자에 따라 다릅니다. 사용자 기반 인증을 사용하고 로그인한 사용자가 없으면 자동화된 작업을 백그라운드에서 실행할 수 없습니다. Azure Data Explorer에 대한 자동화된 작업을 활용하려면 다른 인증 방법을 사용하여 다른 Azure Data Explorer 데이터 원본을 설정하는 것이 좋습니다.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Azure Data Explorer 데이터 원본 업데이트

Azure Data Explorer 데이터 원본을 업데이트하려면 아래 단계를 따릅니다. 이러한 명령을 실행할 때 모든 자리 표시자를 고유한 정보로 바꿉니다.

1. az grafana data-source list를 사용하여 업데이트할 Azure Data Explorer 데이터 원본의 ID를 가져옵니다.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. 데이터 원본을 업데이트하려면 az grafana data-source update 명령을 실행합니다.

   예를 들어, 다음 명령을 사용하여 Azure Data Explorer 데이터 원본의 이름과 클러스터 URL을 업데이트합니다.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

다음 단계

대시보드 만들기