시사
이 기능은 아직 개발 중이지만 꼭 사용해 보시기 바랍니다!
2021년 10월에 출시된 0.0.5 이후 버전에만 적용됩니다.
이 기능은 현재 출시 전 정책 에 따라 미리보기 프로그램의 일부로 제공됩니다.
PowerDNS 통합 은 PowerDNS 에서 차원 메트릭을 수집하고 보냅니다. 사전 구축된 대시보드에서 이 메트릭 데이터 를 보고, 경고 정책을 만들고, 사용자 지정 쿼리 및 차트를 만들 수 있습니다.
통합을 설치하고 수집하는 데이터를 보려면 계속 읽으십시오.
호환성 및 요구 사항
우리의 통합은 PowerDNS Recursor 및 Authoritative Server와 호환됩니다.
통합을 설치하기 전에 다음 요구 사항을 충족하는지 확인하십시오.
- 인프라 에이전트(최소 버전 1.19.2)를 설치합니다 .
- 인프라 에이전트와 호환되는 Linux 배포판.
PowerDNS 인프라에서 데이터를 가져오기 위해 PowerDNS 통합은 구성에 지정된 포트에서 Prometheus 메트릭을 노출하는 타사 Prometheus 내보내기를사용합니다. 통합은 이러한 메트릭을 수집하고 엔터티로 변환하고 필터링한 다음 New Relic으로 보냅니다.
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의 마지막 스크랩이 성공했습니다. |
소스 코드 확인
이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 자신만의 포크를 만들어 빌드할 수 있습니다.
또한 이 통합은 커뮤니티에서 만든 오픈 소스 내보내기를 활용합니다.