Skip to content

Commit f907e26

Browse files
committed
Added debugging help for flow commands
1 parent 0ee897e commit f907e26

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

content/en/docs/measuring/debugging.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,15 @@ If your container fails to boot in the GMT many of the prior mentioned debugging
5050
Since this is usually related to a problem in the `Dockerfile` you can show the output of the docker build client
5151
by adding `--print-logs`
5252

53+
## Debug flow commands
54+
55+
Be sure to activate:
56+
```docker
57+
log-stderr: true
58+
log-stdout: true
59+
```
60+
on the flow commands to debug them.
61+
5362
## Debugging containers via HTTP / exposed ports
5463

5564
If entering the container looks fine and you need to access them through some of their
@@ -62,3 +71,12 @@ To see if the [Metric Providers →]({{< relref "/docs/measuring/metric-provider
6271

6372
- Start them manually from their respective folder under `/metric-providers/...` and look if the output is as expected
6473
- Turn on the `--no-file-cleanup` switch to see if the files generated in `/tmp/green-metrics-tool/[...].log` are in expected format
74+
75+
## Debugging flow commands not ending
76+
77+
This is a tricky problem as it might be "intended" behaviour.
78+
Typically when a *flow command* does not end it is because the process is really working endlessly (daemon) or the process ran into some kind of deadlock (mutex locks, OOM etc.).
79+
80+
We recommend you check if the container ran into configured memory / cpu limits of the docker orchestrator. Either through linux system tools or through *docker stats* if you have system access.
81+
82+
If you are using the **GMT Cluster / SaaS** you can let the process run into the maximum time limit to see the metrics timelines to understand memory and CPU usage and possible limits hit.

0 commit comments

Comments
 (0)