All Integrations / DNS and Elasticsearch Integration

DNS and Elasticsearch Integration

Powerful performance with an easy integration, powered by Telegraf, the open source data connector built by InfluxData.

Get This Integration for Free
info

This is not the recommended configuration for real-time query at scale. For query and compression optimization, high-speed ingest, and high availability, you may want to consider <a href="/integrations/dns-influxdb/">DNS and InfluxDB</a>.

5B+

Telegraf downloads

#1

Time series database
Source: DB Engines

1B+

Downloads of InfluxDB

2,800+

Contributors

Table of Contents

Useful Links

Documentation

Telegraf Quickstart Training

Infrastructure Monitoring with Telegraf

Powerful Performance, Limitless Scale

Collect, organize, and act on massive volumes of high-velocity data. Any data is more valuable when you think of it as time series data. with InfluxDB, the #1 time series platform built to scale with Telegraf.

See Ways to Get Started

Input and output integration overview

<p>The DNS plugin enables users to monitor and gather statistics on DNS query times, facilitating performance analysis of DNS resolutions.</p>

<p>The Telegraf Elasticsearch Plugin seamlessly sends metrics to an Elasticsearch server. The plugin handles template creation and dynamic index management, and supports various Elasticsearch-specific features to ensure data is formatted correctly for storage and retrieval.</p>

Integration details

DNS

<p>This plugin gathers DNS query times in milliseconds, utilizing the capabilities of DNS queries similar to the Dig command. It provides a means to monitor and analyze DNS performance by measuring the response time from specified DNS servers, allowing network administrators and engineers to ensure optimal DNS resolution times. The plugin can be configured to target specific servers and customize the types of records queried, encompassing various DNS features such as resolving domain names to IP addresses, or retrieving details from specific records as needed, while also clearly reporting on the success or failure of each query, alongside relevant metadata.</p>

Elasticsearch

<p>This plugin writes metrics to Elasticsearch, a distributed, RESTful search and analytics engine capable of storing large amounts of data in near real-time. It is designed to handle Elasticsearch versions 5.x through 7.x and utilizes its dynamic template features to manage data type mapping properly. The plugin supports advanced features such as template management, dynamic index naming, and integration with OpenSearch. It also allows configurations for authentication and health monitoring of the Elasticsearch nodes.</p>

Configuration

DNS

<pre><code class="language-toml">[[inputs.dns_query]] servers = ["8.8.8.8"] # network = "udp" # domains = ["."] # record_type = "A" # port = 53 # timeout = "2s" # include_fields = [] </code></pre>

Elasticsearch

<pre><code class="language-toml"> [[outputs.elasticsearch]] ## The full HTTP endpoint URL for your Elasticsearch instance ## Multiple urls can be specified as part of the same cluster, ## this means that only ONE of the urls will be written to each interval urls = [ "http://node1.es.example.com:9200" ] # required. ## Elasticsearch client timeout, defaults to "5s" if not set. timeout = "5s" ## Set to true to ask Elasticsearch a list of all cluster nodes, ## thus it is not necessary to list all nodes in the urls config option enable_sniffer = false ## Set to true to enable gzip compression enable_gzip = false ## Set the interval to check if the Elasticsearch nodes are available ## Setting to "0s" will disable the health check (not recommended in production) health_check_interval = "10s" ## Set the timeout for periodic health checks. # health_check_timeout = "1s" ## HTTP basic authentication details. ## HTTP basic authentication details # username = "telegraf" # password = "mypassword" ## HTTP bearer token authentication details # auth_bearer_token = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9" ## Index Config ## The target index for metrics (Elasticsearch will create if it not exists). ## You can use the date specifiers below to create indexes per time frame. ## The metric timestamp will be used to decide the destination index name # %Y - year (2016) # %y - last two digits of year (00..99) # %m - month (01..12) # %d - day of month (e.g., 01) # %H - hour (00..23) # %V - week of the year (ISO week) (01..53) ## Additionally, you can specify a tag name using the notation {{tag_name}} ## which will be used as part of the index name. If the tag does not exist, ## the default tag value will be used. # index_name = "telegraf-{{host}}-%Y.%m.%d" # default_tag_value = "none" index_name = "telegraf-%Y.%m.%d" # required. ## Optional Index Config ## Set to true if Telegraf should use the "create" OpType while indexing # use_optype_create = false ## Optional TLS Config # tls_ca = "/etc/telegraf/ca.pem" # tls_cert = "/etc/telegraf/cert.pem" # tls_key = "/etc/telegraf/key.pem" ## Use TLS but skip chain &amp; host verification # insecure_skip_verify = false ## Template Config ## Set to true if you want telegraf to manage its index template. ## If enabled it will create a recommended index template for telegraf indexes manage_template = true ## The template name used for telegraf indexes template_name = "telegraf" ## Set to true if you want telegraf to overwrite an existing template overwrite_template = false ## If set to true a unique ID hash will be sent as sha256(concat(timestamp,measurement,series-hash)) string ## it will enable data resend and update metric points avoiding duplicated metrics with different id's force_document_id = false ## Specifies the handling of NaN and Inf values. ## This option can have the following values: ## none -- do not modify field-values (default); will produce an error if NaNs or infs are encountered ## drop -- drop fields containing NaNs or infs ## replace -- replace with the value in "float_replacement_value" (default: 0.0) ## NaNs and inf will be replaced with the given number, -inf with the negative of that number # float_handling = "none" # float_replacement_value = 0.0 ## Pipeline Config ## To use a ingest pipeline, set this to the name of the pipeline you want to use. # use_pipeline = "my_pipeline" ## Additionally, you can specify a tag name using the notation {{tag_name}} ## which will be used as part of the pipeline name. If the tag does not exist, ## the default pipeline will be used as the pipeline. If no default pipeline is set, ## no pipeline is used for the metric. # use_pipeline = "{{es_pipeline}}" # default_pipeline = "my_pipeline" # # Custom HTTP headers # To pass custom HTTP headers please define it in a given below section # [outputs.elasticsearch.headers] # "X-Custom-Header" = "custom-value" ## Template Index Settings ## Overrides the template settings.index section with any provided options. ## Defaults provided here in the config # template_index_settings = { # refresh_interval = "10s", # mapping.total_fields.limit = 5000, # auto_expand_replicas = "0-1", # codec = "best_compression" # } </code></pre>

Input and output integration examples

DNS

<ol> <li> <p><strong>Monitor DNS Performance for Multiple Servers</strong>: By deploying the DNS plugin, a user can simultaneously monitor the performance of different DNS servers, such as Google DNS and Cloudflare DNS, by specifying them in the <code>servers</code> array. This scenario enables comparisons of response times and reliability across different DNS providers, assisting in selecting the best option based on empirical data.</p> </li> <li> <p><strong>Analyze Query Times for High-Traffic Domains</strong>: Integrate the plugin to measure response times specifically for high-traffic domains relevant to an organization’s operations, such as internal services or customer-facing sites. By focusing on performance metrics for these domains, organizations can proactively address latency issues, ensuring service reliability and improving user experiences.</p> </li> <li> <p><strong>Alerting on DNS Timeouts</strong>: Utilize the plugin in combination with alerting systems to notify administrators whenever a DNS query exceeds a defined timeout threshold. This setup can help in proactive troubleshooting of networking issues or server misconfigurations, fostering a rapid response to potential downtime scenarios.</p> </li> <li> <p><strong>Gather Historical Data for Performance Trends</strong>: Use the plugin to collect historical data on DNS query times over extended periods. This data can be used to analyze trends and patterns in DNS performance, enabling better capacity planning, identifying periodic issues, and justifying infrastructure upgrades or changes to DNS architectures.</p> </li> </ol>

Elasticsearch

<ol> <li> <p><strong>Time-based Indexing</strong>: Use this plugin to store metrics in Elasticsearch to index each metric based on the time collected. For example, CPU metrics can be stored in a daily index named<code>telegraf-2023.01.01</code>, allowing easy time-based queries and retention policies.</p> </li> <li> <p><strong>Dynamic Templates Management</strong>: Utilize the template management feature to automatically create a custom template tailored to your metrics. This allows you to define how different fields are indexed and analyzed without manually configuring Elasticsearch, ensuring an optimal data structure for querying.</p> </li> <li> <p><strong>OpenSearch Compatibility</strong>: If you are using AWS OpenSearch, you can configure this plugin to work seamlessly by activating compatibility mode, ensuring your existing Elasticsearch clients remain functional and compatible with newer cluster setups.</p> </li> </ol>

Feedback

Thank you for being part of our community! If you have any general feedback or found any bugs on these pages, we welcome and encourage your input. Please submit your feedback in the InfluxDB community Slack.

Useful Links

Documentation

Telegraf Quickstart Training

Infrastructure Monitoring with Telegraf

Powerful Performance, Limitless Scale

Collect, organize, and act on massive volumes of high-velocity data. Any data is more valuable when you think of it as time series data. with InfluxDB, the #1 time series platform built to scale with Telegraf.

See Ways to Get Started

Related Integrations

HTTP and InfluxDB Integration

The HTTP plugin collects metrics from one or more HTTP(S) endpoints. It supports various authentication methods and configuration options for data formats.

View Integration

Kafka and InfluxDB Integration

This plugin reads messages from Kafka and allows the creation of metrics based on those messages. It supports various configurations including different Kafka settings and message processing options.

View Integration

Kinesis and InfluxDB Integration

The Kinesis plugin allows for reading metrics from AWS Kinesis streams. It supports multiple input data formats and offers checkpointing features with DynamoDB for reliable message processing.

View Integration

Start building now

Download Telegraf today or learn more about InfluxDB.

telegraf Get started with InfluxDB
Product & Solutions
Developers
Company

548 Market St, PMB 77953
San Francisco, California 94104

© 2025 InfluxData Inc. All Rights Reserved.

Legal Security Cookie Policy Comparison