visualização
Ainda estamos trabalhando nesse recurso, mas adoraríamos que você experimentasse!
Aplica-se apenas às versões a partir de 0.0.5 lançadas em outubro de 2021.
Atualmente, esse recurso é fornecido como parte de um programa de visualização de acordo com nossas políticas de pré-lançamento.
A nossa integração PowerDNS recolhe e envia métricas dimensionais do PowerDNS. Você pode visualizar esses dados métricos em um painel pré-construído, criar políticas de alertas e criar consultas e gráficos personalizados.
Continue lendo para instalar a integração e ver quais dados coletamos.
Compatibilidade e requisitos
Nossa integração é compatível com PowerDNS Recursor e Authoritative Server.
Antes de instalar a integração, certifique-se de atender aos seguintes requisitos:
- Instale o agente de infraestrutura, versão mínima 1.19.2.
- Distribuição Linux compatível com o agente de infraestrutura.
Para obter dados da infraestrutura PowerDNS, nossa integração PowerDNS utiliza um exportador Prometheus terceirizado, que expõe a métrica do Prometheus na porta especificada na configuração. A integração recolhe essas métricas, transforma-as em entidade, filtra-as e depois envia-as para a New Relic.
Para habilitar a API, o servidor web e a API HTTP precisam estar habilitados.
Adicione estas linhas ao pdns.conf:
api=yesapi-key=changeme
E reinicie, os exemplos a seguir devem começar a funcionar:
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
Para obter mais informações, Habilitando Webserver e API
Instalar e ativar
Para instalar a integração PowerDNS, escolha sua configuração:
Este documento ajudou você na instalação?
Configurar a integração
Para configurar a integração, edite a configuração no arquivo de configuração YAML da integração powerdns-config.yml
.
Use a configuração YAML para colocar as credenciais de login necessárias e configurar como seus dados são coletados, dependendo de sua configuração e preferência.
Como esta integração é baseada em um exportador prometheus, as configurações aplicáveis a outras integração, como interval
, timeout
ou inventory_source
não são suportadas.
Configurações da instância PowerDNS
As seguintes opções de configuração estão disponíveis:
Contexto | Descrição | Padrão |
---|---|---|
powerdns_url | URL da API do serviço powerdns | N/A |
exporter_port | Porta para expor endpoint de raspagem. Se isso não for fornecido, uma porta aleatória será usada para lançar o exportador | porta aleatória |
scrape_timeout | Tempo até que uma solicitação de raspagem expire | 5s |
api_key | Chave de API usada para conectar ao servidor PowerDNS | N/A |
Exemplo de configuração
Encontre e use dados
Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.
Métrica estão anexadas à amostra métrica e aos tipos de eventos da entidade POWERDNS_AUTHORITATIVE
e POWERDNS_RECURSOR
. Você pode consultar esses dados para fins de resolução de problemas, ou para criar gráficos e dashboards personalizados.
Dados métricos
São criadas duas entidades: POWERDNS_AUTHORITATIVE
e POWERDNS_RECURSOR
.
As seguintes métricas dimensionais são capturadas raspando o exportador e vinculadas à entidade POWERDNS_AUTHORITATIVE
:
Nome | Descrição | Dimensões |
---|---|---|
| Tempo de operação em segundos do daemon. |
|
| Número de entradas no cache de pacotes. | |
| Número total de consultas recursivas por status. |
|
| Endereços IP de servidores remotos. |
|
| Status de segurança do servidor PDNS com base em | |
| Número total de exceções por erro. |
|
| Número médio de microssegundos que um pacote gasta no PowerDNS. | |
| Número total de consultas de atualização de DNS por status. |
|
| Número de pacotes aguardando atenção do banco de dados. | |
| Distribuição de rcodes. |
|
| Número de entradas no cache de assinaturas. | |
| Consulta para domínios para os quais não temos autoridade. |
|
| Número total de bytes de resposta enviados por protocolo. |
|
| Consulta UDP Recebido. |
|
| Número de erros ao analisar estatísticas JSON do PowerDNS. | |
| Ações de cache adiadas devido à manutenção por tipo. |
|
| A última tentativa do PowerDNS foi bem-sucedida. | |
| Consulta pesquisas de cache por resultado. |
|
| Número de entradas no cache de chaves. | |
| Número total de respostas por protocolo. |
|
| Pesquisas de cache de pacotes por resultado. |
|
| Número de entradas no cache de metadados. | |
| Número total de consultas por protocolo. |
|
| Número de milissegundos de CPU gastos no usuário e no espaço do kernel. |
|
| Contadores DNSSEC. |
|
| Distribuição de tamanho das respostas. |
|
| Total atual de raspagens de PowerDNS. | |
| Hosts remotos consultando domínios sobre os quais não temos autoridade. |
|
As seguintes métricas dimensionais são capturadas raspando o exportador e vinculadas à entidade POWERDNS_RECURSOR
:
Nome | Descrição | Dimensões |
---|---|---|
| Número total de consultas recebidas por rede. |
|
| Número total de consultas realizadas por rede. |
|
| Número de entradas no cache. | |
| Número total de pesquisas de cache por resultado. |
|
| Número de erros ao analisar estatísticas JSON do PowerDNS. | |
| Número total de respostas por código de resposta. |
|
| Total atual de raspagens de PowerDNS. | |
| Número de consultas simultâneas. | |
| Número total de respostas agrupadas por intervalos de tempo de resposta. |
|
| Média móvel exponencial da latência entre perguntas e respostas. | |
| Número total de exceções por erro. |
|
| Histograma do recurso PowerDNS tempo de resposta em segundos. (soma métrica) | |
| Histograma do recurso PowerDNS tempo de resposta em segundos. (métrica de intervalo) |
|
| A última tentativa do PowerDNS foi bem-sucedida. |
Verifique o código-fonte
Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias ou criar seu próprio fork e construí-lo.
Além disso, esta integração aproveita um exportador de código aberto criado pela comunidade.