dnsquery

package
v0.0.0-...-6ade924 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 8, 2022 License: GPL-3.0 Imports: 10 Imported by: 0

README

DNS query monitoring with Netdata

This module provides DNS query RTT in milliseconds.

Metrics

All metrics have "dnsquery." prefix.

Metric Scope Dimensions Units
query_time global a dimension per name server ms

Configuration

Edit the go.d/dns_query.conf configuration file using edit-config from the Netdata config directory, which is typically at /etc/netdata.

cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/dns_query.conf

Here is an example:

jobs:
  - name: job1
    domains:
      - google.com
      - github.com
      - reddit.com
    servers:
      - 8.8.8.8
      - 8.8.4.4

For all available options please see module configuration file.

Troubleshooting

To troubleshoot issues with the dns_query collector, run the go.d.plugin with the debug option enabled. The output should give you clues as to why the collector isn't working.

  • Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on your system, open netdata.conf and look for the plugins setting under [directories].

    cd /usr/libexec/netdata/plugins.d/
    
  • Switch to the netdata user.

    sudo -u netdata -s
    
  • Run the go.d.plugin to debug the collector:

    ./go.d.plugin -d -m dns_query
    

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Charts

type Charts = module.Charts

Charts is an alias for module.Charts

type DNSQuery

type DNSQuery struct {
	module.Base

	Domains    []string
	Servers    []string
	Network    string
	RecordType string `yaml:"record_type"`
	Port       int
	Timeout    web.Duration
	// contains filtered or unexported fields
}

DNSQuery dnsquery module

func New

func New() *DNSQuery

New creates DNSQuery with default values

func (DNSQuery) Charts

func (d DNSQuery) Charts() *Charts

Charts creates Charts

func (DNSQuery) Check

func (DNSQuery) Check() bool

Check makes check

func (*DNSQuery) Cleanup

func (d *DNSQuery) Cleanup()

Cleanup makes cleanup

func (*DNSQuery) Collect

func (d *DNSQuery) Collect() map[string]int64

Collect collects metrics

func (*DNSQuery) Init

func (d *DNSQuery) Init() bool

Init makes initialization

type Dim

type Dim = module.Dim

Dim is an alias for module.Dim

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL