---
title: ''
description: Telegraf plugin for collecting metrics from Network Response
url: https://docs.influxdata.com/telegraf/v1/input-plugins/net_response/
estimated_tokens: 645
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/net_response/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v0.10.3+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/net_response/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/net_response/sample.conf)

# Network Response Input Plugin

This plugin tests UDP/TCP connection and produces metrics from the result, the
response time and optionally verifies text in the response.

**Introduced in:** Telegraf v0.10.3**Tags:** network**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# Collect response time of a TCP or UDP connection
[[inputs.net_response]]
  ## Protocol, must be "tcp" or "udp"
  ## NOTE: because the "udp" protocol does not respond to requests, it requires
  ## a send/expect string pair (see below).
  protocol = "tcp"
  ## Server address (default localhost)
  address = "localhost:80"

  ## Set timeout
  # timeout = "1s"

  ## Set read timeout (only used if expecting a response)
  # read_timeout = "1s"

  ## The following options are required for UDP checks. For TCP, they are
  ## optional. The plugin will send the given string to the server and then
  ## expect to receive the given 'expect' string back.
  ## string sent to the server
  # send = "ssh"
  ## expected string in answer
  # expect = "ssh"

  ## Uncomment to remove deprecated fields; recommended for new deploys
  # fieldexclude = ["result_type", "string_found"]
```

## Metrics

* net\_response
  * tags:
    * server
    * port
    * protocol
    * result

  * fields:
    * response\_time (float, seconds)
    * result\_code (int) success = 0, timeout = 1, connection\_failed = 2,
      read\_failed = 3, string\_mismatch = 4
    * result\_type (string) **DEPRECATED in 1.7; use result tag**
    * string\_found (boolean) **DEPRECATED in 1.4; use result tag**

## Example Output

```text
net_response,port=8086,protocol=tcp,result=success,server=localhost response_time=0.000092948,result_code=0i,result_type="success" 1525820185000000000
net_response,port=8080,protocol=tcp,result=connection_failed,server=localhost result_code=2i,result_type="connection_failed" 1525820088000000000
net_response,port=8080,protocol=udp,result=read_failed,server=localhost result_code=3i,result_type="read_failed",string_found=false 1525820088000000000
```