Azure 통합 문서를 사용하여 Prometheus 메트릭 쿼리
Azure 통합 문서를 사용하여 Prometheus용 Azure Monitor 관리 서비스에서 제공하는 대시보드를 만듭니다. 이 문서에서는 Azure Monitor 작업 영역에 대한 통합 문서를 소개하고 Azure 통합 문서 및 PromQL(Prometheus 쿼리 언어)을 사용하여 Prometheus 메트릭을 쿼리하는 방법을 보여 줍니다.
Azure Monitor 작업 영역의 메트릭 탐색기에서 PromQL을 사용하여 Prometheus 메트릭을 쿼리할 수도 있습니다. 자세한 내용은 PromQL을 사용한 Azure Monitor 메트릭 탐색기(미리 보기)를 참조하세요.
필수 조건
Azure Monitor 작업 영역에서 Prometheus 메트릭을 쿼리하려면 다음이 필요합니다.
- Azure Monitor 작업 영역. Azure Monitor 작업 영역을 만드려면 Azure Monitor 작업 영역 만들기를 참조하세요.
- Azure Monitor 작업 영역은 AKS 클러스터, 가상 머신 또는 가상 머신 확장 집합에서 Prometheus 메트릭을 수집해야 합니다. 자세한 내용은 가상 머신, 확장 집합 또는 Kubernetes 클러스터에서 Azure Monitor 작업 영역으로 Prometheus 메트릭 보내기를 참조하세요.
- 사용자는 Azure Monitor 작업 영역에서 microsoft.monitor/accounts/read 작업을 수행할 수 있는 역할을 할당받아야 합니다.
Prometheus Explorer 통합 문서
Azure Monitor 작업 영역에는 Prometheus 메트릭을 쿼리하는 탐색 통합 문서가 포함되어 있습니다.
- Azure Monitor 작업 영역 개요 페이지에서 Prometheus 탐색기를 선택합니다.
- 또는 통합 문서 메뉴 항목과 Azure Monitor 작업 영역 갤러리에서 Prometheus Explorer 통합 문서 타일을 선택합니다.
통합 문서에는 다음과 같은 입력 옵션이 있습니다.
- 시간 범위. 쿼리에 포함할 기간을 선택합니다. 사용자 지정을 선택하여 시작 및 종료 시간을 설정합니다.
- PromQL. PromQL 쿼리를 입력하여 데이터를 검색합니다. PromQL에 대한 자세한 내용은 Prometheus 쿼리를 참조하세요.
- Graph, 그리드 및 차원 탭. 쿼리 출력의 그래픽, 테이블 형식 및 차원 보기 간에 전환합니다.
Prometheus 통합 문서 만들기
통합 문서는 다양한 시각화 및 Azure 통합을 지원합니다. Azure 통합 문서에 대한 자세한 내용은 Azure 통합 문서 만들기를 참조하세요.
Azure Monitor 작업 영역에서 통합 문서를 선택합니다.
새로 만들기를 선택합니다.
새 통합 문서에서 추가를 선택하고 드롭다운에서 쿼리 추가를 선택합니다.
Azure 통합 문서는 데이터 원본을 사용하여 데이터 원본이 제공하는 원본 범위를 설정합니다. Prometheus 메트릭을 쿼리하려면 데이터 원본 드롭다운을 선택하고 Prometheus를 선택합니다.
Azure Monitor 작업 영역 드롭다운에서 작업 영역을 선택합니다.
Prometheus 쿼리 유형 드롭다운에서 쿼리 유형을 선택합니다.
Prometheus 쿼리 필드에 PromQL 쿼리를 작성합니다.
쿼리 실행 단추를 선택합니다.
섹션 아래쪽에서 편집 완료를 선택하고 작업을 저장합니다.
문제 해결
"현재 이 Azure Monitor 작업 영역에 수집된 Prometheus 데이터가 없습니다"라는 메시지가 표시되는 경우:
- Azure Monitor 작업 영역의 모니터링된 클러스터 블레이드에서 메트릭 컬렉션을 설정했는지 확인합니다.
통합 문서 쿼리가 데이터를 반환하지 않고 "쿼리 액세스 권한이 없습니다"라는 메시지와 함께 반환되는 경우:
- Azure Monitor 작업 영역의 Access Control(IAM)을 통해 할당된 microsoft.monitor/accounts/read를 수행할 수 있는 충분한 권한이 있는지 확인합니다.
- 네트워킹 설정이 쿼리 액세스를 지원하는지 확인합니다. 프라이빗 엔드포인트를 통해 프라이빗 액세스를 사용하도록 설정하거나 공용 액세스를 허용하도록 설정을 변경해야 할 수도 있습니다.
- 브라우저에서 광고 블록을 사용하도록 설정한 경우 데이터를 보려면 통합 문서를 일시 중지하거나 사용하지 않도록 설정하고 새로 고쳐야 할 수 있습니다.
자주 묻는 질문
이 섹션에서는 일반적인 질문에 대한 답변을 제공합니다.
메트릭 전체 또는 일부가 누락되었습니다. 어떻게 해결할 수 있나요?
여기에서 관리 에이전트의 Prometheus 메트릭 수집에 대한 문제 해결 가이드를 사용할 수 있습니다.
이름은 같지만 대/소문자가 다른 두 개의 레이블이 있는 메트릭이 누락되는 이유는 무엇인가요?
Azure 관리형 Prometheus는 대/소문자를 구분하지 않는 시스템입니다. 메트릭 이름, 레이블 이름 또는 레이블 값과 같은 문자열은 문자열의 경우에만 다른 시계열과 다를 경우 동일한 시계열로 처리됩니다. 자세한 내용은 Prometheus 메트릭 개요를 참조하세요.
메트릭 데이터에 약간의 차이가 있습니다. 이러한 현상이 발생하는 이유는 무엇인가요?
노드 업데이트 중에 클러스터 수준 수집기에서 수집된 메트릭에 대한 메트릭 데이터에 1~2분 간격이 표시될 수 있습니다. 이 간격은 데이터가 실행되는 노드가 일반 업데이트 프로세스의 일부로 업데이트되기 때문에 발생합니다. 이 업데이트 프로세스는 kube-state-metrics 및 지정된 사용자 지정 애플리케이션 대상과 같은 클러스터 전체 대상에 영향을 미칩니다. 이는 클러스터가 수동으로 업데이트되거나 자동 업데이트를 통해 업데이트되는 경우에 발생합니다. 이 동작은 예상되는 동작이며 업데이트될 때 실행되는 노드로 인해 발생합니다. 권장되는 경고 규칙은 이 동작의 영향을 받지 않습니다.