DNS Query Input 🔗
The Splunk Distribution of OpenTelemetry Collector provides this integration as the
telegraf/dns monitor via the Smart Agent Receiver. This is an embedded form of the Telegraf DNS Query plugin.
To install this integration:
Deploy the Splunk Distribution of OpenTelemetry Collector to your host or container platform.
Configure the monitor, as described in the next section.
This Splunk Distribution of OpenTelemetry Collector allows embedding a Smart Agent monitor configuration in an associated Smart Agent Receiver instance.
Note: Providing a DNS Query Input monitor entry in your Smart Agent or Collector configuration is required for its use. Use the appropriate form for your agent type.
Smart Agent 🔗
To activate this monitor in the Smart Agent, add the following to your agent configuration:
monitors: # All monitor config goes under this key - type: telegraf/dns ... # Additional config
See Smart Agent example configuration for an autogenerated example of a YAML configuration file, with default values where applicable.
Splunk Distribution of OpenTelemetry Collector 🔗
To activate this monitor in the Splunk Distribution of OpenTelemetry Collector, add the following to your agent configuration:
receivers: smartagent/dns: type: telegraf/dns ... # Additional config
See configuration examples for specific use cases that show how the collector can integrate and complement existing environments.
Note: Include monitors with event-sending functionality as members of a
logs pipeline that utilizes an exporter that makes the event submission requests. Use a Resource Detection processor to ensure that host identity and other useful information is made available as event dimensions.
Configuration settings 🔗
The following table shows the configuration options for this monitor:
||Domains or subdomains to query. If this is not provided, it is
||Network is the network protocol name. (default:
||DNS server port. (default:
||Servers to query.|
||Query record type (A, AAAA, CNAME, MX, NS, PTR, TXT, SOA, SPF, SRV). (default:
||Query timeout. Use a duration string that is accepted by https://golang.org/pkg/time/#ParseDuration. (default:
These are the metrics available for this monitor.
The following dimensions might occur on metrics emitted by this monitor. Some dimensions may be specific to certain metrics.
||The DNS domain queried.|
||The plugin name "telegraf/dns".|
||The DNS record type queried.|
||The DNS server queried.|