telegraf/plugins/inputs/http_response/README.md

45 lines
1.1 KiB
Markdown
Raw Normal View History

2016-03-31 07:33:28 +00:00
# Example Input Plugin
This input plugin will test HTTP/HTTPS connections.
### Configuration:
```
# HTTP/HTTPS request given an address a method and a timeout
2016-03-31 07:33:28 +00:00
[[inputs.http_response]]
## Server address (default http://localhost)
address = "http://github.com"
## Set response_timeout (default 5 seconds)
response_timeout = "5s"
2016-03-31 11:06:47 +00:00
## HTTP Request Method
2016-03-31 07:33:28 +00:00
method = "GET"
## Whether to follow redirects from the server (defaults to false)
follow_redirects = true
## HTTP Request Headers (all values must be strings)
# [inputs.http_response.headers]
# Host = "github.com"
2016-03-31 11:06:47 +00:00
## Optional HTTP Request Body
# body = '''
# {'fake':'data'}
# '''
2016-03-31 07:33:28 +00:00
```
### Measurements & Fields:
- http_response
- response_time (float, seconds)
- http_response_code (int) #The code received
### Tags:
- All measurements have the following tags:
- server
- method
2016-03-31 07:33:28 +00:00
### Example Output:
```
$ ./telegraf -config telegraf.conf -input-filter http_response -test
http_response,method=GET,server=http://www.github.com http_response_code=200i,response_time=6.223266528 1459419354977857955
2016-03-31 07:33:28 +00:00
```