Skip to content

Commit 85bc5f3

Browse files
committed
Add expected log output to troubleshooting docs
1 parent 040a3c2 commit 85bc5f3

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

docs/troubleshooting.asciidoc

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,30 @@ The most important one is <<config-logging-log-level>>.
2323
Set the log level to `DEBUG` or even `TRACE` to get more information about the behavior of the agent.
2424

2525

26+
Please always post the whole content of your log files when asking for help.
27+
28+
When the agent starts up,
29+
you should see logs similar to these:
30+
31+
----
32+
[main] INFO co.elastic.apm.configuration.StartupInfo - Starting Elastic APM (unknown version) on Java 10 (Oracle Corporation) Mac OS X 10.13.6
33+
[main] DEBUG co.elastic.apm.configuration.StartupInfo - service_name: 'elastic-apm-test' (source: Java System Properties)
34+
[main] DEBUG co.elastic.apm.configuration.StartupInfo - logging.log_level: 'DEBUG' (source: Java System Properties)
35+
----
36+
37+
Make sure to execute some requests to your application before posting your log files.
38+
Each request should at least add some lines similar to these in the logs:
39+
40+
----
41+
[main] DEBUG co.elastic.apm.impl.ElasticApmTracer - startTransaction '' e0d6b9f84cf758a30a303f4fb607a9a6 {
42+
[main] DEBUG co.elastic.apm.impl.ElasticApmTracer - startSpan '' e0d6b9f84cf758a30a303f4fb607a9a6:1 {
43+
[main] DEBUG co.elastic.apm.impl.ElasticApmTracer - } endSpan 'SELECT' e0d6b9f84cf758a30a303f4fb607a9a6:1
44+
[main] DEBUG co.elastic.apm.impl.ElasticApmTracer - } endTransaction 'GET' e0d6b9f84cf758a30a303f4fb607a9a6
45+
----
46+
47+
If you don't see anything in your logs,
48+
the technology stack you are using is probably not <<supported-technologies,supported>>.
49+
2650
[float]
2751
[[trouble-shooting-debugging]]
2852
=== Debugging

0 commit comments

Comments
 (0)