Azure Monitor 데이터 소스 문제 해결

Azure Monitor 데이터 소스 문제 해결 (Troubleshoot Azure Monitor data source issues)

이 문서는 Azure Monitor 데이터 소스를 구성하거나 사용할 때 겪을 수 있는 일반적인 문제에 대한 해결책을, 문제가 발생하는 단계별로 정리해 제공해요. 연결, 인증, Grafana 서버 구성, 쿼리, Resource Graph, Traces, Basic Logs, 알림, 템플릿 변수 오류로 나눠 설명합니다.

출처: 문서

본문

연결 및 네트워크 오류

Grafana가 Azure 엔드포인트에 도달할 수 없음을 나타내는 오류예요. 인증이나 쿼리 문제를 조사하기 전에 연결 상태를 먼저 확인하세요.

"Connection refused" 또는 타임아웃 오류: Grafana 서버에서 Azure 엔드포인트로의 네트워크 연결(방화벽, 프록시, DNS)을 확인하고, 데이터 소스 타임아웃 설정을 늘려보세요.
SSL/TLS 인증서 오류: Grafana 서버가 Azure의 TLS 인증서를 신뢰하는지, 시간이 올바른지 확인하세요.

인증 오류

데이터 소스나 Azure에 구성된 자격 증명이 유효하지 않거나 만료되었거나 권한이 없을 때 발생해요.

"Authorization failed" 또는 "Access denied"

원인	해결
앱 등록에 필요한 권한 없음	모니터링하려는 구독/리소스 그룹에 앱 등록에 Reader 역할을 할당
잘못된 tenant ID, client ID, client secret	Azure Portal에서 App registrations > 앱 > Overview(ID)와 Certificates & secrets(secret)에서 자격 증명 확인
Client secret 만료	Azure에서 새 client secret을 만들고 데이터 소스 구성 업데이트
Azure 리소스에 Managed Identity 미활성화	VM은 Azure Portal의 Identity에서, App Service는 앱 설정의 Identity에서 활성화
Managed Identity에 Reader 역할 미할당	대상 구독/리소스에 managed identity에 Reader 역할 할당

"Invalid client secret" 또는 "Client secret not found"

시크릿이 올바른지 확인하고, 만료되었으면 새로 생성해 데이터 소스에 반영하세요.

"Tenant not found" 또는 "Invalid tenant ID"

tenant ID가 올바른지 확인하고 Azure Portal의 디렉터리 ID와 일치하는지 검증하세요.

클라이언트 인증서 인증이 동작하지 않음

원인	해결
인증서 만료	Azure Portal에서 만료일 확인 후 새 인증서 업로드
잘못된 인증서 형식	올바른 형식(PEM/PFX)과 일치하는 내용인지 확인. PEM은 별도의 인증서·프라이빗 키 필드 필요
PFX 비밀번호 오류	암호화된 PFX 인증서의 비밀번호 확인
프라이빗 키가 인증서와 불일치	프라이빗 키가 Azure에 업로드한 인증서와 대응하는지 확인. 필요 시 재생성
인증서를 Azure에 업로드하지 않음	Azure Portal의 Certificates & secrets > Certificates에 공개 인증서 업로드 확인

Grafana 서버 구성 오류

Managed Identity, Workload Identity, Current User 인증에 필요한 Grafana 서버 .ini 구성이 누락됐을 때 발생해요. Azure 자격 증명이 올바른데도 인증이 실패하면 이 섹션을 확인하세요.

Managed Identity가 동작하지 않음

[azure] 섹션에 managed_identity_enabled = true가 있는지, forward_settings_to_plugins에 grafana-azure-monitor-datasource가 포함됐는지 확인하세요.

Workload Identity가 동작하지 않음

workload_identity_enabled = true와 선택적 변수들이 올바른지 확인하세요.

Azure 설정이 올바른데도 "401 Unauthorized"

원인: [azure] 아래의 forward_settings_to_plugins 설정이 Azure Monitor 플러그인을 포함하지 않아, 플러그인이 Grafana 서버에서 Azure 인증 설정을 받지 못해요.
해결: 이 설정에 grafana-azure-monitor-datasource가 포함되도록 수정하세요.

쿼리 오류

"No data" 또는 빈 결과

원인	해결
시간 범위에 데이터 없음	대시보드 시간 범위를 넓히거나 Azure Portal에서 데이터 존재 확인
잘못된 리소스 선택	구독·리소스 그룹·리소스를 올바르게 선택했는지 확인
리소스에 메트릭 없음	모든 리소스에 모든 메트릭이 있는 건 아님. Azure Portal의 Metrics 블레이드에서 확인
메트릭에 값 없음	일부 메트릭은 특정 조건에서만 채워짐(예: 오류 발생 시 오류 개수)
권한 문제	자격 증명이 해당 리소스에 읽기 접근 권한이 있는지 확인

"Bad request" 또는 "Invalid query"

Logs 쿼리: KQL 구문과 시간 필터를 확인하세요.
Metrics 쿼리: 메트릭·차원·집계 선택이 유효한지 확인하세요.

"Resource not found"

올바른 구독, 리소스 그룹, 리소스를 선택했는지 확인하세요.

Logs 쿼리 타임아웃

원인: Grafana의 기본 데이터 소스 타임아웃은 30초지만, Azure Log Analytics 쿼리는 복잡한 KQL이나 긴 시간 범위에서 Azure 쪽 최대 3분까지 걸릴 수 있어요.
해결: 데이터 소스 구성에서 타임아웃을 늘리세요(프로비저닝 시 jsonData.timeout).

Logs 쿼리 결과 잘림

원인: Logs 쿼리가 Logs 결과 형식이면 Grafana는 브라우저 크래시 방지를 위해 결과를 30,000행으로 잘라요.
해결: azureMonitorDisableLogLimit 기능 토글을 활성화하거나, 집계·시간 범위 축소로 행 수를 줄이세요.

리소스에 "Metrics not available"

해당 리소스가 지원하는 메트릭인지, 지역/리소스 유형에서 사용 가능한지 확인하세요.

Azure Resource Graph 오류

"Query execution failed"

ARG는 KQL의 변형이며 모든 Kusto 기능을 지원하지 않아요. 쿼리 구문과 ARG 지원 기능을 확인하세요.

쿼리가 불완전한 결과 반환

중첩 속성은 tostring()으로 캐스팅하고, 구독/디렉터리 범위를 확인하세요.

Application Insights Traces 오류

"No traces found"

시간 범위에 트레이스 데이터가 있는지, 올바른 애플리케이션(작업 영역)을 선택했는지 확인하세요.

Basic Logs 오류

Basic Logs 토글 사용 불가: 데이터 소스 구성에서 Enable Basic Logs를 활성화했는지 확인하세요.
Basic Logs 쿼리 오류: 워크스페이스에 Basic Logs 테이블이 있고 KQL이 유효한지 확인하세요.
예기치 않은 Basic Logs 비용: Basic Logs 쿼리는 쿼리당 비용이 부과되므로 사용 전에 Azure 가격을 검토하세요.

알림 오류

Current User 인증으로 알림 실패

원인: Current User 인증은 로그인한 사용자의 자격 증명에 의존하는데, 이는 알림 같은 백그라운드 작업에 사용할 수 없어요.
해결: fallback service credentials을 구성하세요.

알림 평가 타임아웃

데이터 소스 타임아웃을 늘리고, 알림 평가 간격이 쿼리 지속 시간을 수용하는지 확인하세요.

템플릿 변수 오류

"Properties found in series but missing valueProp and textProp"

원인: Azure Monitor 플러그인의 변수 쿼리 응답 형식이 Grafana가 기대하는 것과 일치하지 않아요. 특정 Grafana 버전에 영향을 준 알려진 버그였어요.
해결: Grafana 버전의 최신 패치 릴리스로 업데이트하세요.

변수가 값을 반환하지 않음

쿼리 유형과 선택 항목(구독, 리소스 등)을 확인하세요.

Grafana 업그레이드 후 변수가 동작하지 않음

최신 패치 릴리스로 업데이트하고, Grafana Cloud는 안정 릴리스 채널인지 확인하세요.

변수 로드가 느림

변수 새로고침 옵션을 On dashboard load로 설정하고, 복잡한 Logs 변수 쿼리를 단순화하세요.

디버그 로깅 활성화

Azure Monitor 문제 해결을 위해 상세 오류 정보를 캡처하려면 Grafana 로그 레벨을 DEBUG로 설정하세요.

Azure Monitor 데이터 소스 문제 해결