Skip to content

Commit 4508e02

Browse files
committed
Update stats json docs
1 parent 6de9e8a commit 4508e02

File tree

1 file changed

+13
-3
lines changed

1 file changed

+13
-3
lines changed

README-json.md

+13-3
Original file line numberDiff line numberDiff line change
@@ -122,23 +122,24 @@ Each period has the following subkeys:
122122
* start: the start time (in seconds-since-1-Jan-1970) of this statistics collection period.
123123
* end: the end time (in seconds-since-1-Jan-1970) of this statistics collection period.
124124
* local: statistics about messages received from a local SDR dongle. Not present in --net-only mode. Has subkeys:
125-
* blocks_processed: number of sample blocks processed
126-
* blocks_dropped: number of sample blocks dropped before processing. A nonzero value means CPU overload.
125+
* samples_processed: number of samples processed
126+
* samples_dropped: number of samples dropped before processing. A nonzero value means CPU overload.
127127
* modeac: number of Mode A / C messages decoded
128128
* modes: number of Mode S preambles received. This is *not* the number of valid messages!
129129
* bad: number of Mode S preambles that didn't result in a valid message
130130
* unknown_icao: number of Mode S preambles which looked like they might be valid but we didn't recognize the ICAO address and it was one of the message types where we can't be sure it's valid in this case.
131131
* accepted: array. Index N has the number of valid Mode S messages accepted with N-bit errors corrected.
132132
* signal: mean signal power of successfully received messages, in dbFS; always negative.
133+
* noise: mean noise power of non-message samples, in dbFS; always negative.
133134
* peak_signal: peak signal power of a successfully received message, in dbFS; always negative.
134135
* strong_signals: number of messages received that had a signal power above -3dBFS.
136+
* gain_db: the current SDR gain, floating-point dB. Might be absent depending on SDR type.
135137
* remote: statistics about messages received from remote clients. Only present in --net or --net-only mode. Has subkeys:
136138
* modeac: number of Mode A / C messages received.
137139
* modes: number of Mode S messages received.
138140
* bad: number of Mode S messages that had bad CRC or were otherwise invalid.
139141
* unknown_icao: number of Mode S messages which looked like they might be valid but we didn't recognize the ICAO address and it was one of the message types where we can't be sure it's valid in this case.
140142
* accepted: array. Index N has the number of valid Mode S messages accepted with N-bit errors corrected.
141-
* http_requests: number of HTTP requests handled.
142143
* cpu: statistics about CPU use. Has subkeys:
143144
* demod: milliseconds spent doing demodulation and decoding in response to data from a SDR dongle
144145
* reader: milliseconds spent reading sample data over USB from a SDR dongle
@@ -163,5 +164,14 @@ Each period has the following subkeys:
163164
as a new track.
164165
* all: total tracks created
165166
* single_message: tracks consisting of only a single message. These are usually due to message decoding errors that produce a bad aircraft address.
167+
* unreliable: tracks that were never marked as reliable. These are also usually due to message decoding errors.
166168
* messages: total number of messages accepted by dump1090 from any source
167169
* messages_by_df: an array of integers where entry N (0..31) is the total number of messages accepted with downlink format (DF) = N.
170+
* adaptive: statistics on adaptive gain. Only present if adaptive gain is enabled
171+
* gain_db: latest SDR gain (legacy; prefer to use `local.gain_db` instead)
172+
* dynamic_range_limit_db: latest dynamic-range-controlled upper gain limit, dB
173+
* gain_changes: number of gain changes made in this stats period
174+
* loud_undecoded: number of undecodable loud probably-a-valid-message bursts seen
175+
* loud_decoded: number of correctly decoded mesaages with a high signal level
176+
* noise_dbfs: adaptive gain noise floor estimate, dBFS
177+
* gain_seconds: object, keyed by integer gain step, values are an array of [floating point gain in dB, number of seconds spent at this gain setting]

0 commit comments

Comments
 (0)