You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: monitoring/mock_uss/tracer/README.md
+22-1Lines changed: 22 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,13 +38,34 @@ container in order to use the tracer subscribe capability.
38
38
Visit /tracer/logs to see a list of log entries recorded by tracer while the
39
39
current session has been running.
40
40
41
+
## Log download
42
+
To download the full set of current tracer logs, visit /tracer/logs.zip
43
+
41
44
## Invocation
42
45
An instance of tracer-enabled mock_uss is brought up as part of the [local deployment](../README.md#local-deployment). It can also be deployed [with Google Cloud Platform](../deployment/gcp) when configured appropriately.
43
46
44
-
## Offline historical KML generator
47
+
## Offline historical KML generation
45
48
46
49
With a large number of log files, KML generation via the server endpoint can
47
50
require a prohibitive amount of time. To generate a historical KML in these
48
51
cases, the [make_historical_kml utility](./make_historical_kml.py) can be used
49
52
to parse a folder of logs (generally acquired from downloading a .zip file of
50
53
logs while the server is active) into a KML file.
54
+
55
+
To use this utility via docker, first set `LOG_PATH` to the folder containing the unzipped log files:
56
+
57
+
```shell
58
+
export LOG_PATH=/path/to/log/files
59
+
```
60
+
61
+
Then, invoke the tool, writing to `historical.kml` in the log file folder:
62
+
63
+
```shell
64
+
docker container run \
65
+
-u "$(id -u):$(id -g)" \
66
+
-v "$LOG_PATH:/logs" \
67
+
interuss/monitoring \
68
+
uv run /app/monitoring/mock_uss/tracer/make_historical_kml.py \
0 commit comments