Adding upstream version 1.34.4.

Signed-off-by: Daniel Baumann <daniel@debian.org>

docs/developers/PROFILING.md

@@ -0,0 +1,66 @@
+# Profiling
+
+This article describes how to collect performance traces and memory profiles
+from Telegraf. If you are submitting this for an issue, please include the
+version.txt generated below.
+
+Use the `--pprof-addr` option to enable the profiler, the easiest way to do
+this may be to add this line to `/etc/default/telegraf`:
+
+```shell
+TELEGRAF_OPTS="--pprof-addr localhost:6060"
+```
+
+Restart Telegraf to activate the profile address.
+
+## Trace Profile
+
+Collect a trace during the time where the performance issue is occurring.  This
+example collects a 10 second trace and runs for 10 seconds:
+
+```shell
+curl 'http://localhost:6060/debug/pprof/trace?seconds=10' > trace.bin
+telegraf --version > version.txt
+go env GOOS GOARCH >> version.txt
+```
+
+The `trace.bin` and `version.txt` files can be sent in for analysis or, if desired, you can
+analyze the trace with:
+
+```shell
+go tool trace trace.bin
+```
+
+## Memory Profile
+
+Collect a heap memory profile:
+
+```shell
+curl 'http://localhost:6060/debug/pprof/heap' > mem.prof
+telegraf --version > version.txt
+go env GOOS GOARCH >> version.txt
+```
+
+Analyze:
+
+```shell
+$ go tool pprof mem.prof
+(pprof) top5
+```
+
+## CPU Profile
+
+Collect a 30s CPU profile:
+
+```shell
+curl 'http://localhost:6060/debug/pprof/profile' > cpu.prof
+telegraf --version > version.txt
+go env GOOS GOARCH >> version.txt
+```
+
+Analyze:
+
+```shell
+go tool pprof cpu.prof
+(pprof) top5
+```