공개 미리보기
이 기능은 현재 공개 미리 보기 상태이며 2021년 10월에 릴리스된 0.0.5 부터 시작하는 버전에만 적용됩니다.
PowerDNS 통합 은 PowerDNS 에서 차원 메트릭을 수집하고 보냅니다. 사전 구축된 대시보드에서 이 메트릭 데이터 를 보고, 경고 정책을 만들고, 사용자 지정 쿼리 및 차트를 만들 수 있습니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
우리의 통합은 PowerDNS Recursor 및 Authoritative Server와 호환됩니다.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
- 인프라 에이전트(최소 버전 1.19.2)를 설치합니다 .
- 인프라 에이전트와 호환되는 Linux 배포판.
통합은 Prometheus 내보내기를 통해 PowerDNS API를 스크랩하여 데이터를 얻습니다.
API를 활성화하려면 웹 서버와 HTTP API를 활성화해야 합니다.
다음 행을 pdns.conf에 추가하십시오.
api=yesapi-key=changeme
그리고 다시 시작하면 다음 예제가 작동하기 시작합니다.
curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1/servers/localhost | jq .curl -v -H 'X-API-Key: changeme' http://127.0.0.1:8081/api/v1
자세한 내용은 웹 서버 및 API 활성화
설치 및 활성화
PowerDNS 통합을 설치하려면 설정을 선택하십시오.
이 문서가 설치하는데 도움이 되셨나요?
통합 구성
통합을 구성하려면 통합의 YAML 구성 파일 powerdns-config.yml
에서 구성을 편집합니다.
YAML 구성을 사용하여 필요한 로그인 자격 증명을 배치하고 설정 및 기본 설정에 따라 데이터 수집 방법을 구성합니다.
이 통합은 prometheus 내보내기를 기반으로 하므로 interval
, timeout
또는 inventory_source
와 같은 다른 통합에 적용 가능한 설정은 지원되지 않습니다.
PowerDNS 인스턴스 설정
다음 구성 옵션을 사용할 수 있습니다.
환경 | 설명 | 기본값 |
---|---|---|
powerdns_url | powerdns 서비스의 API URL | 해당 없음 |
exporter_port | 스크레이프 엔드포인트를 노출할 포트, 이것이 제공되지 않으면 임의의 포트가 내보내기를 시작하는 데 사용됩니다. | 랜덤 포트 |
scrape_timeout | 스크랩 요청이 시간 초과될 때까지의 시간 | 5초 |
api_key | PowerDNS 서버에 연결하는 데 사용되는 API 키 | 해당 없음 |
구성 예
데이터 찾기 및 사용
데이터를 찾고 사용하는 방법에 대한 자세한 내용은 통합 데이터 이해 를 참조하십시오.
측정항목은 항목 POWERDNS_AUTHORITATIVE
및 POWERDNS_RECURSOR
의 측정항목 샘플 및 이벤트 유형 에 연결됩니다. 문제 해결을 위해 이 데이터를 쿼리 하거나 사용자 지정 차트 및 대시보드 를 만들 수 있습니다.
측정항목 데이터
POWERDNS_AUTHORITATIVE
및 POWERDNS_RECURSOR
의 두 항목이 생성됩니다.
다음 차원 측정항목은 내보내기를 스크랩하여 캡처되고 엔티티 POWERDNS_AUTHORITATIVE
에 연결됩니다.
이름 | 설명 | 치수 |
---|---|---|
| 데몬의 가동 시간(초)입니다. |
|
| 패킷 캐시의 항목 수입니다. | |
| 상태별 총 재귀 쿼리 수입니다. |
|
| 원격 서버 IP 주소. |
|
|
| |
| 오류별 총 예외 수입니다. |
|
| PowerDNS 내에서 패킷이 소비하는 평균 마이크로초 수입니다. | |
| 상태별 총 DNS 업데이트 쿼리 수입니다. |
|
| 데이터베이스 주의를 기다리는 패킷 수입니다. | |
| rcode 배포. |
|
| 서명 캐시의 항목 수입니다. | |
| 권한이 없는 도메인에 대한 쿼리입니다. |
|
| 프로토콜에서 보낸 총 응답 바이트 수입니다. |
|
| UDP 쿼리가 수신되었습니다. |
|
| PowerDNS JSON 통계를 구문 분석하는 동안 발생한 오류 수입니다. | |
| 유형별 유지 관리로 인해 캐시 작업이 지연됩니다. |
|
| PowerDNS의 마지막 스크랩이 성공했습니다. | |
| 결과별로 쿼리 캐시 조회. |
|
| 키 캐시의 항목 수입니다. | |
| 프로토콜별 총 답변 수입니다. |
|
| 결과별 패킷 캐시 조회. |
|
| 메타데이터 캐시의 항목 수입니다. | |
| 프로토콜별 총 쿼리 수입니다. |
|
| 사용자 및 커널 공간에서 사용한 CPU 밀리초 수입니다. |
|
| DNSSEC 카운터. |
|
| 응답의 크기 분포. |
|
| 현재 총 PowerDNS 스크랩입니다. | |
| 우리가 권한이 없는 도메인을 쿼리하는 원격 호스트. |
|
다음 차원 측정항목은 내보내기를 스크랩하여 캡처되고 엔티티 POWERDNS_RECURSOR
에 연결됩니다.
이름 | 설명 | 치수 |
---|---|---|
| 네트워크별 수신 쿼리의 총 수입니다. |
|
| 네트워크별 총 발신 쿼리 수입니다. |
|
| 캐시의 항목 수입니다. | |
| 결과별 총 캐시 조회 수입니다. |
|
| PowerDNS JSON 통계를 구문 분석하는 동안 발생한 오류 수입니다. | |
| 응답 코드별 총 답변 수입니다. |
|
| 현재 총 PowerDNS 스크랩입니다. | |
| 동시 쿼리 수입니다. | |
| 응답 시간 슬롯별로 그룹화된 총 답변 수입니다. |
|
| 질문 대 답변 대기 시간의 지수 이동 평균입니다. | |
| 오류별 총 예외 수입니다. |
|
| PowerDNS 재귀 응답 시간의 히스토그램(초). (합계 메트릭) | |
| PowerDNS 재귀 응답 시간의 히스토그램(초). (버킷 메트릭) |
|
| PowerDNS의 마지막 스크랩이 성공했습니다. |
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.
또한 이 통합은 커뮤니티에서 만든 오픈 소스 내보내기를 활용합니다.