| common_metric_data.rs |
|
4699 |
| core |
|
|
| core_metrics.rs |
|
7409 |
| coverage.rs |
Utilities for recording when testing APIs have been called on specific
metrics.
Testing coverage is enabled by setting the GLEAN_TEST_COVERAGE environment
variable to the name of an output file. This output file must run through a
post-processor (in glean_parser's `coverage` command) to convert to a format
understood by third-party coverage reporting tools.
While running a unit test suite, Glean records which database keys were
accessed by the testing APIs, with one entry per line. Database keys are
usually, but not always, the same as metric identifiers, but it is the
responsibility of the post-processor to resolve that difference.
This functionality has no runtime overhead unless the testing API is used. |
1776 |
| database |
|
|
| debug.rs |
# Debug options
The debug options for Glean may be set by calling one of the `set_*` functions
or by setting specific environment variables.
The environment variables will be read only once when the options are initialized.
The possible debugging features available out of the box are:
* **Ping logging** - logging the contents of ping requests that are correctly assembled;
This may be set by calling glean.set_log_pings(value: bool)
or by setting the environment variable GLEAN_LOG_PINGS="true";
* **Debug tagging** - Adding the X-Debug-ID header to every ping request,
allowing these tagged pings to be sent to the ["Ping Debug Viewer"](https://mozilla.github.io/glean/book/dev/core/internal/debug-pings.html).
This may be set by calling glean.set_debug_view_tag(value: &str)
or by setting the environment variable GLEAN_DEBUG_VIEW_TAG=<some tag>;
* **Source tagging** - Adding the X-Source-Tags header to every ping request,
allowing pings to be tagged with custom labels.
This may be set by calling glean.set_source_tags(value: Vec<String>)
or by setting the environment variable GLEAN_SOURCE_TAGS=<some, tags>;
Bindings may implement other debugging features, e.g. sending pings on demand. |
10907 |
| dispatcher |
|
|
| error.rs |
|
4755 |
| error_recording.rs |
# Error Recording
Glean keeps track of errors that occured due to invalid labels or invalid values when recording
other metrics.
Error counts are stored in labeled counters in the `glean.error` category.
The labeled counter metrics that store the errors are defined in the `metrics.yaml` for documentation purposes,
but are not actually used directly, since the `send_in_pings` value needs to match the pings of the metric that is erroring (plus the "metrics" ping),
not some constant value that we could define in `metrics.yaml`. |
8335 |
| event_database |
|
|
| fd_logger.rs |
|
2603 |
| glean.udl |
|
18704 |
| glean_metrics.rs |
|
899 |
| histogram |
|
|
| internal_metrics.rs |
|
10750 |
| internal_pings.rs |
|
2534 |
| lib.rs |
Glean is a modern approach for recording and sending Telemetry data.
It's in use at Mozilla.
All documentation can be found online:
## [The Glean SDK Book](https://mozilla.github.io/glean) |
47569 |
| lib_unit_tests.rs |
|
41835 |
| metrics |
|
|
| ping |
|
|
| scheduler.rs |
# Metrics Ping Scheduler
The Metrics Ping Scheduler (MPS) is responsible for scheduling "metrics" pings.
It implements the spec described in
[the docs](https://mozilla.github.io/glean/book/user/pings/metrics.html#scheduling) |
23631 |
| storage |
|
|
| system.rs |
Detect and expose `target_os` as a constant.
Code adopted from the "platforms" crate: <https://github.com/rustsec/rustsec/tree/2a080f173ad9d8ac7fa260f0a3a6aebf0000de06/platforms>. |
2856 |
| traits |
|
|
| upload |
|
|
| util.rs |
|
10750 |